Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 117 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

Repository files navigation

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

go get github.com/sv-tools/openapi

v0 -Deprecated. The initial version with the full implementation of the v3.1 Specification using generics. See thev0 branch.
v1 - The current version with the in-place validation of the specification.
- The minimum version of Go isv1.22.
- Everything has been moved to the root folder. So, the import path isgithub.com/sv-tools/openapi.
- AddedValidator 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 intomap[string]any type first usingjson.Marshal andjson.Unmarshal.WARNING: the function is slow due to double conversion.
- AddedParseObject function to createSchemaBuilder by parsing an object.The function supportsjson,yaml andopenapi field tags for the structs.
- Use OpenAPIv3.1.1 by default.

The official v3.0 and v3.1examples 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.