feat: path (method & service) generation

Author: amirsalarsafaei

go.mod

@@ -8,6 +8,7 @@ require (
 	github.com/google/go-cmp v0.7.0
 	github.com/rogpeppe/fastuuid v1.2.0
 	go.yaml.in/yaml/v3 v3.0.4
+	github.com/stretchr/testify v1.9.0
 	golang.org/x/oauth2 v0.30.0
 	golang.org/x/text v0.28.0
 	google.golang.org/genproto/googleapis/api v0.0.0-20250818200422-3122310a409c
@@ -21,6 +22,7 @@ require (
 	golang.org/x/net v0.41.0 // indirect
 	golang.org/x/sys v0.33.0 // indirect
 	gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c // indirect
+	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/go-openapi/jsonpointer v0.21.0 // indirect
 	github.com/go-openapi/swag v0.23.0 // indirect
 	github.com/josharian/intern v1.0.0 // indirect
@@ -29,6 +31,7 @@ require (
 	github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037 // indirect
 	github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90 // indirect
 	github.com/perimeterx/marshmallow v1.1.5 // indirect
+	github.com/pmezard/go-difflib v1.0.0 // indirect
 	golang.org/x/net v0.37.0 // indirect
 	golang.org/x/sys v0.31.0 // indirect
 )

internal/descriptor/registry.go

@@ -181,6 +181,9 @@ type Registry struct {
 
 	// generateXGoType is a global generator option for generating x-go-type annotations
 	generateXGoType bool
+
+	// indicates how the one ofs are handled
+	oneOfStrategy string
 }
 
 type repeatedFieldSeparator struct {
@@ -930,3 +933,11 @@ func (r *Registry) SetGenerateXGoType(generateXGoType bool) {
 func (r *Registry) GetGenerateXGoType() bool {
 	return r.generateXGoType
 }
+
+func (r *Registry) SetOneOfStrategy(oneOfStrategy string) {
+	r.oneOfStrategy = oneOfStrategy 
+}
+
+func (r *Registry) GetOneOfStrategy() string {
+	return r.oneOfStrategy 
+}

protoc-gen-openapiv3/internal/genopenapiv3/file_options.go

@@ -9,7 +9,9 @@ import (
 
 func (g *generator) extractFileOptions(target *descriptor.File) (*openapi3.T, bool) {
 	if openAPIAno := proto.GetExtension(target.GetOptions(), options.E_Openapiv3Document).(*options.OpenAPI); openAPIAno != nil {
-		doc := &openapi3.T{}
+		doc := &openapi3.T{
+			OpenAPI: "3.0.2",
+		}
 		doc.Info = g.extractInfo(openAPIAno.GetInfo())
 		// TODO: implement other openapi file annotation fields
 		return doc, true