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

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