longping d9e6e61923 first commit 2 lat temu
..
.editorconfig d9e6e61923 first commit 2 lat temu
.gitignore d9e6e61923 first commit 2 lat temu
.golangci.yml d9e6e61923 first commit 2 lat temu
CODE_OF_CONDUCT.md d9e6e61923 first commit 2 lat temu
LICENSE d9e6e61923 first commit 2 lat temu
README.md d9e6e61923 first commit 2 lat temu
appveyor.yml d9e6e61923 first commit 2 lat temu
bindata.go d9e6e61923 first commit 2 lat temu
cache.go d9e6e61923 first commit 2 lat temu
contact_info.go d9e6e61923 first commit 2 lat temu
debug.go d9e6e61923 first commit 2 lat temu
errors.go d9e6e61923 first commit 2 lat temu
expander.go d9e6e61923 first commit 2 lat temu
external_docs.go d9e6e61923 first commit 2 lat temu
header.go d9e6e61923 first commit 2 lat temu
info.go d9e6e61923 first commit 2 lat temu
items.go d9e6e61923 first commit 2 lat temu
license.go d9e6e61923 first commit 2 lat temu
normalizer.go d9e6e61923 first commit 2 lat temu
normalizer_nonwindows.go d9e6e61923 first commit 2 lat temu
normalizer_windows.go d9e6e61923 first commit 2 lat temu
operation.go d9e6e61923 first commit 2 lat temu
parameter.go d9e6e61923 first commit 2 lat temu
path_item.go d9e6e61923 first commit 2 lat temu
paths.go d9e6e61923 first commit 2 lat temu
properties.go d9e6e61923 first commit 2 lat temu
ref.go d9e6e61923 first commit 2 lat temu
resolver.go d9e6e61923 first commit 2 lat temu
response.go d9e6e61923 first commit 2 lat temu
responses.go d9e6e61923 first commit 2 lat temu
schema.go d9e6e61923 first commit 2 lat temu
schema_loader.go d9e6e61923 first commit 2 lat temu
security_scheme.go d9e6e61923 first commit 2 lat temu
spec.go d9e6e61923 first commit 2 lat temu
swagger.go d9e6e61923 first commit 2 lat temu
tag.go d9e6e61923 first commit 2 lat temu
url_go18.go d9e6e61923 first commit 2 lat temu
url_go19.go d9e6e61923 first commit 2 lat temu
validations.go d9e6e61923 first commit 2 lat temu
xml_object.go d9e6e61923 first commit 2 lat temu

README.md

OAI object model

Build Status codecov Slack Status license Go Reference Go Report Card

The object model for OpenAPI specification documents.

FAQ

  • What does this do?
  1. This package knows how to marshal and unmarshal Swagger API specifications into a golang object model
  2. It knows how to resolve $ref and expand them to make a single root document
  • How does it play with the rest of the go-openapi packages ?
  1. This package is at the core of the go-openapi suite of packages and code generator
  2. There is a spec loading package to fetch specs as JSON or YAML from local or remote locations
  3. There is a spec validation package built on top of it
  4. There is a spec analysis package built on top of it, to analyze, flatten, fix and merge spec documents
  • Does this library support OpenAPI 3?

No. This package currently only supports OpenAPI 2.0 (aka Swagger 2.0). There is no plan to make it evolve toward supporting OpenAPI 3.x. This discussion thread relates the full story.

An early attempt to support Swagger 3 may be found at: https://github.com/go-openapi/spec3