rebased

Signed-off-by: Pierre Fenoll <pierrefenoll@gmail.com>

.github/docs/openapi2conv.txt

@@ -7,7 +7,7 @@ func FromV3Ref(ref string) string
 func FromV3RequestBody(name string, requestBodyRef *openapi3.RequestBodyRef, ...) (*openapi2.Parameter, error)
 func FromV3RequestBodyFormData(mediaType *openapi3.MediaType) openapi2.Parameters
 func FromV3Response(ref *openapi3.ResponseRef, components *openapi3.Components) (*openapi2.Response, error)
-func FromV3Responses(responses map[string]*openapi3.ResponseRef, components *openapi3.Components) (map[string]*openapi2.Response, error)
+func FromV3Responses(responses *openapi3.Responses, components *openapi3.Components) (map[string]*openapi2.Response, error)
 func FromV3SchemaRef(schema *openapi3.SchemaRef, components *openapi3.Components) (*openapi3.SchemaRef, *openapi2.Parameter)
 func FromV3Schemas(schemas map[string]*openapi3.SchemaRef, components *openapi3.Components) (map[string]*openapi3.SchemaRef, map[string]*openapi2.Parameter)
 func FromV3SecurityRequirements(requirements openapi3.SecurityRequirements) openapi2.SecurityRequirements

.github/docs/openapi3.txt

@@ -23,7 +23,7 @@ func Uint64Ptr(value uint64) *uint64
 func ValidateIdentifier(value string) error
 func WithValidationOptions(ctx context.Context, opts ...ValidationOption) context.Context
 type AdditionalProperties struct{ ... }
-type Callback map[string]*PathItem
+type Callback struct{ ... }
 type CallbackRef struct{ ... }
 type Callbacks map[string]*CallbackRef
 type Components struct{ ... }
@@ -60,6 +60,11 @@ type Loader struct{ ... }
 type MediaType struct{ ... }
     func NewMediaType() *MediaType
 type MultiError []error
+type NewPathsOption func(*Paths)
+    func WithPath(path string, pathItem *PathItem) NewPathsOption
+type NewResponsesOption func(*Responses)
+    func WithName(name string, response *Response) NewResponsesOption
+    func WithStatus(status int, responseRef *ResponseRef) NewResponsesOption
 type OAuthFlow struct{ ... }
 type OAuthFlows struct{ ... }
 type Operation struct{ ... }
@@ -74,7 +79,9 @@ type Parameters []*ParameterRef
     func NewParameters() Parameters
 type ParametersMap map[string]*ParameterRef
 type PathItem struct{ ... }
-type Paths map[string]*PathItem
+type Paths struct{ ... }
+    func NewPaths(opts ...NewPathsOption) *Paths
+    func NewPathsWithCapacity(cap int) *Paths
 type ReadFromURIFunc func(loader *Loader, url *url.URL) ([]byte, error)
     func ReadFromHTTP(cl *http.Client) ReadFromURIFunc
     func ReadFromURIs(readers ...ReadFromURIFunc) ReadFromURIFunc
@@ -88,8 +95,10 @@ type RequestBodyRef struct{ ... }
 type Response struct{ ... }
     func NewResponse() *Response
 type ResponseRef struct{ ... }
-type Responses map[string]*ResponseRef
-    func NewResponses() Responses
+type Responses struct{ ... }
+    func NewEmptyResponses() *Responses
+    func NewResponses(opts ...NewResponsesOption) *Responses
+    func NewResponsesWithCapacity(cap int) *Responses
 type Schema struct{ ... }
     func NewAllOfSchema(schemas ...*Schema) *Schema
     func NewAnyOfSchema(schemas ...*Schema) *Schema