rabits / openapi

OpenAPI v3.1 Spec implementation in Go with generics

OpenAPI v3.1 Specification

The implementation of OpenAPI v3.1 Specification for Go using generics.

Supported Go versions:

• v1.19
• v1.18

Features

• The spec folder contains full implementation of the v3.1 Specification using generics, so the minimum supported version of Go is v1.18.
• The validate folder uses jsonschema/v5 with draft 2020-12 to validate the specifications.
• The official v3.0 and v3.1 examples are tested. In most cases v3.0 specification can be converted to v3.1 by changing the version's parameter only.

  @@ -1,4 +1,4 @@
  -openapi: "3.0.0"
  +openapi: "3.1.0"

NOTE: The descriptions of most structures and their fields are taken from the official documentations.

Links

• OpenAPI Specification: https://github.com/OAI/OpenAPI-Specification and https://spec.openapis.org/oas/v3.1.0
• JSON Schema: https://json-schema.org/understanding-json-schema/index.html and https://json-schema.org/draft/2020-12/json-schema-core.html
• The list of most popular alternatives: https://github.com/OAI/OpenAPI-Specification/blob/main/IMPLEMENTATIONS.md#low-level-tooling

License

MIT licensed. See the bundled LICENSE file for more details.