:openapi: https://www.openapis.org/ :parser: https://github.com/openapi-processor/openapi-parser/tree/master/openapi-parser :parser-bom: https://github.com/openapi-processor/openapi-parser/tree/master/openapi-parser-bom :validator: https://github.com/openapi-processor/openapi-parser/tree/master/json-schema-validator :validator-bom: https://github.com/openapi-processor/openapi-parser/tree/master/json-schema-validator-bom :io-interfaces: https://github.com/openapi-processor/openapi-parser/tree/master/io-interfaces :converter-jackson: https://github.com/openapi-processor/openapi-parser/tree/master/io-jackson :converter-snakeyaml: https://github.com/openapi-processor/openapi-parser/tree/master/io-snakeyaml :memory: https://github.com/openapi-processor/openapi-parser/tree/master/memory-protocol :jackson: https://github.com/FasterXML/jackson :snakeyaml: https://bitbucket.org/snakeyaml/snakeyaml/src/master/

:all-ci: https://github.com/openapi-processor/openapi-parser/actions?query=workflow%3Abuild :all-ci-badge: https://github.com/openapi-processor/openapi-parser/workflows/build/badge.svg

:central-search: https://search.maven.org/search?q=io.openapiprocessor :parser-central-badge: https://img.shields.io/maven-central/v/io.openapiprocessor/openapi-parser?label=Maven%20Central :parser-bom-central-badge: https://img.shields.io/maven-central/v/io.openapiprocessor/openapi-parser-bom?label=Maven%20Central :validator-central-badge: https://img.shields.io/maven-central/v/io.openapiprocessor/json-schema-validator?label=Maven%20Central :validator-bom-central-badge: https://img.shields.io/maven-central/v/io.openapiprocessor/json-schema-validator-bom?label=Maven%20Central :interfaces-central-badge: https://img.shields.io/maven-central/v/io.openapiprocessor/io-interfaces?label=Maven%20Central :jackson-central-badge: https://img.shields.io/maven-central/v/io.openapiprocessor/io-jackson?label=Maven%20Central :snakeyaml-central-badge: https://img.shields.io/maven-central/v/io.openapiprocessor/io-snakeyaml?label=Maven%20Central

It is usable, it is used as the internal openapi parser/validator by openapi-processor.

== openapi-parser & validator

a Java 11 based link:{openapi}[OpenAPI] 3.0.x & 3.1 parser with validation and pluggable document reader & json/yaml converter.

• parse OpenAPI 3.0.x & 3.1
• validate OpenAPI 3.0.x & 3.1 (json schema validation, can follow $ref's in the OpenAPI document)
• separate apis for OpenAPI 3.0 & 3.1
• easily get resolved $ref object
• minimal dependencies
• pluggable document reader
• pluggable json/yaml converter
• pluggable format validators (planned)

== modules

// badges link:{all-ci}[image:{all-ci-badge}[]]

=== link:{parser}[openapi-parser]

link:{central-search}[image:{parser-central-badge}[]]

the link:{openapi}[OpenAPI] parser.

=== link:{parser-bom}[openapi-parser-bom]

link:{central-search}[image:{parser-bom-central-badge}[]]

A "bill of materials" POM for openapi-parser dependencies.

=== link:{validator}[json-schema-validator]

link:{central-search}[image:{validator-central-badge}[]] image:https://img.shields.io/endpoint?url=https%3A%2F%2Fbowtie.report%2Fbadges%2Fjava-io.openapiprocessor.json-schema-validator%2Fsupported_versions.json[Supported Dialects]

the JSON Schema validator used by the openapi-parser.

=== link:{validator-bom}[json-schema-validator-bom]

link:{central-search}[image:{validator-bom-central-badge}[]]

A "bill of materials" POM for json-schema-validator dependencies.

=== link:{converter-jackson}[io-jackson]

link:{central-search}[image:{jackson-central-badge}[]]

json/yaml Reader & Converter based on link:{jackson}[Jackson].

=== link:{converter-snakeyaml}[io-snakeyaml]

link:{central-search}[image:{snakeyaml-central-badge}[]]

yaml Reader & Converter based on link:{snakeyaml}[snakeyaml].

=== link:{io-interfaces}[io-interfaces]

link:{central-search}[image:{interfaces-central-badge}[]]

defines the interfaces for the pluggable document reader and json/yaml converter. Only needed for implementing additional reader or converter.