OpenAPI v3.1 Specification

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

Supported Go versions:

v1.23
v1.22
v1.21

Versions:

v0 - Deprecated. The initial version with the full implementation of the v3.1 Specification using generics. See v0 branch.
v1 - The current version with the in-place validation of the specification. The minimal version of Go is v1.21 and the github.com/santhosh-tekuri/jsonschema/v5 package is not used anymore. See main branch.

Features

The spec folder contains full implementation of the v3.1 Specification using generics and errors.Join function, so the minimum supported version of Go is v1.20.
The spec.ValidateSpec function validates the specification without transforming it to map[string]any.
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://tools.openapis.org

License

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