OpenAPI v3.1 Specification

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

go get github.com/sv-tools/openapi

Supported Go versions

v0 - Deprecated. The initial version with the full implementation of the v3.1 Specification using generics. See the v0 branch.
v1 - The current version with the in-place validation of the specification.
- The minimum version of Go is v1.22.
- Everything has been moved to the root folder. So, the import path is github.com/sv-tools/openapi.
- Added Validator struct for validation of the specification and the data.
  - Validator.ValidateSpec() method validates the specification.
  - Validator.ValidateData() method validates the data.
  - Validator.ValidateDataAsJSON() method validates the data by converting it into map[string]any type first using json.Marshal and json.Unmarshal. WARNING: the function is slow due to double conversion.
- Added ParseObject function to create SchemaBuilder by parsing an object. The function supports json, yaml and openapi field tags for the structs.
- Use OpenAPI v3.1.1 by default.

The official v3.0 and v3.1 examples are tested. In most cases, the v3.0 specification can be converted to v3.1 by changing only the version parameter.
```
@@ -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.

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

Name		Name	Last commit message	Last commit date
Latest commit History 124 Commits
.github		.github
testdata		testdata
.gitignore		.gitignore
.golangci.yml		.golangci.yml
LICENSE		LICENSE
README.md		README.md
bool_or_schema.go		bool_or_schema.go
bool_or_schema_test.go		bool_or_schema_test.go
callback.go		callback.go
components.go		components.go
components_test.go		components_test.go
contact.go		contact.go
discriminator.go		discriminator.go
encoding.go		encoding.go
example.go		example.go
extensions.go		extensions.go
extensions_test.go		extensions_test.go
external-docs.go		external-docs.go
go.mod		go.mod
go.sum		go.sum
header.go		header.go
info.go		info.go
license.go		license.go
link.go		link.go
media_type.go		media_type.go
oauth-flow.go		oauth-flow.go
oauth-flows.go		oauth-flows.go
openapi.go		openapi.go
operation.go		operation.go
parameter.go		parameter.go
parser.go		parser.go
parser_test.go		parser_test.go
path_item.go		path_item.go
paths.go		paths.go
ref.go		ref.go
ref_test.go		ref_test.go
request_body.go		request_body.go
response.go		response.go
responses.go		responses.go
schema.go		schema.go
schema_test.go		schema_test.go
security-requirement.go		security-requirement.go
security-scheme.go		security-scheme.go
server.go		server.go
server_variable.go		server_variable.go
single_or_array.go		single_or_array.go
single_or_array_test.go		single_or_array_test.go
tag.go		tag.go
type_formats.go		type_formats.go
types.go		types.go
validation.go		validation.go
validation_options.go		validation_options.go
validation_test.go		validation_test.go
webhooks.go		webhooks.go
xml.go		xml.go