builder

package

v0.27.3 Latest Latest Go to latest Published: Apr 19, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

Details

Package builder contains code to generate OpenAPI discovery spec (which initial version of it also known as Swagger 2.0). For more details: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md

View Source

const (
	OpenAPIVersion = "2.0"
)

This section is empty.

func BuildOpenAPIDefinitionsForResource(model interface{}, config *common.Config) (*spec.Definitions, error)

BuildOpenAPIDefinitionsForResource builds a partial OpenAPI spec given a sample object and common.Config to customize it.

func BuildOpenAPIDefinitionsForResources(config *common.Config, names ...string) (*spec.Swagger, error)

BuildOpenAPIDefinitionsForResources returns the OpenAPI spec which includes the definitions for the passed type names.

func BuildOpenAPISpec(routeContainers []*restful.WebService, config *common.Config) (*spec.Swagger, error)

BuildOpenAPISpec builds OpenAPI spec given a list of route containers and common.Config to customize it.

Deprecated: BuildOpenAPISpecFromRoutes should be used instead.

func BuildOpenAPISpecFromRoutes(routeContainers []common.RouteContainer, config *common.Config) (*spec.Swagger, error)

BuildOpenAPISpecFromRoutes builds OpenAPI spec given a list of route containers and common.Config to customize it.

This section is empty.