openapi-json-schema-generator

OpenAPI JSON Schema Generator allows auto-generation of API client libraries with a focus on JSON schema given an OpenAPI document

APACHE-2.0 License

Stars
117
Committers
2.4K
View Code on GitHub
Ecosystems: OpenAPI Specification, JSON Schema, Python, Java

Bot releases are hidden (Show)

openapi-json-schema-generator - 4.2.1 Latest Release

Published by spacether 6 months ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/4.2.0...4.2.1

openapi-json-schema-generator - 4.2.0

Published by spacether 6 months ago

This version marks the release of the stable java generator

  • sending and receiving text/plain and application/json to endpoints is supported

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/4.1.3...4.2.0

openapi-json-schema-generator - 4.1.2

Published by spacether 7 months ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/4.1.1...4.1.2

openapi-json-schema-generator - 4.1.1

Published by spacether 8 months ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/4.1.0...4.1.1

openapi-json-schema-generator - 4.1.0

Published by spacether 9 months ago

Java schema validation now supported for v3.1.0 openapi documents / json schema draft 2020-12

Java client schema validation now works on the majority of v3.1.0 json schema keyword flags, json schema draft 2020-12

Over 67% of the 3.1.0 new json schema keyword features have been implemented in Java
Support includes these json schema keywords:

  • type (array of types supported in addition to one non-array value)
  • const: only string values are working because of bugs in swagger parser
  • contains
  • dependentRequired
  • dependentSchemas
  • if
  • then
  • else
  • maxContains
  • minContains
  • patternProperties
  • prefixItems
  • propertyNames
  • unevaluatedItems
  • unevaluatedProperties

Features are verified by integrating the json schema test suite into a v310 java client and running tests against the generated schemas
Those tests are passing in CI

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/4.0.0...4.1.0

openapi-json-schema-generator - 4.0.0

Published by spacether 10 months ago

What's Changed

New Contributors

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/3.3.1...4.0.0

openapi-json-schema-generator - 3.3.1

Published by spacether 12 months ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/3.3.0...3.3.1

openapi-json-schema-generator - 3.3.0

Published by spacether 12 months ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/3.2.1...3.3.0

openapi-json-schema-generator - 3.2.1

Published by spacether 12 months ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/3.2.0...3.2.1

openapi-json-schema-generator - 3.2.0

Published by spacether almost 1 year ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/3.1.1...3.2.0

openapi-json-schema-generator - 3.1.1

Published by spacether about 1 year ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/3.1.0...3.1.1

openapi-json-schema-generator - 3.1.0

Published by spacether about 1 year ago

Adds preliminary openapi v3.1.0 document processing

Over 50% of the 3.1.0 new json schema keyword features have been implemented
Preliminary 3.1.0 spec support includes these json schema keywords:

  1. type (array of types supported in addition to one non-array value)
  2. const: only string values are working because of bugs in swagger parser
  3. contains
  4. dependentRequired
  5. dependentSchemas
  6. maxContains
  7. minContains
  8. patternProperties
  9. prefixItems
  10. propertyNames
  11. unevaluatedItems
  12. unevaluatedProperties

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/3.0.0...3.1.0

openapi-json-schema-generator - 3.0.0

Published by spacether about 1 year ago

Big Changes

  • Schema classes have been changed from being nested to sequential
  • Schema classes now only store json schema info
  • python code now passes mypy checks, means that this generator can be ported into compiled languages
  • Schema payload output classes are now generated for type: object and type: array payloads
  • Overloads added for SomeSchema.validate with type constraints on inputs and outputs
  • Enums of type string/integer/boolean now have typing.Literal type hints for inputs and outputs
  • python version changed to >= 3.8
  • java version changed to 11
  • java project simplified via refactoring
  • Read about the v3 changes in the python client v3 migration guide here

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/2.0.3...3.0.0

openapi-json-schema-generator - 2.0.3

Published by spacether over 1 year ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/2.0.2...2.0.3

openapi-json-schema-generator - 2.0.2

Published by spacether over 1 year ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/2.0.1...2.0.2

openapi-json-schema-generator - 2.0.1

Published by spacether over 1 year ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/2.0.0...2.0.1

openapi-json-schema-generator - 2.0.0

Published by spacether over 1 year ago

What's Changed

Improvements

  • one documentation file generated for each endpoint
  • ranged responses added 2XX 3XX etc
  • deserialization of redirection responses added 300-399 http status codes
  • code is reused more, python classes are generated and imported for #/components/x
    • headers
    • parameters
    • request_bodies
    • responses
    • schemas
    • security_schemes
  • package structure has been modernized to use src/the_package and pyproject.toml installation
  • configuration info has been refactored to separate concerns and to allow more robust configuration of server and security info
  • Java classes that store openapi document info have been refactored, making them shorter and easier to maintain
  • Python methods and class names updated
    • is_true_oapg -> is_true_
    • is_false_oapg -> is_false_
    • is_none_oapg -> is_none_
    • as_date_oapg -> as_date_
    • as_datetime_oapg -> as_datetime_
    • as_decimal_oapg -> as_decimal_
    • as_uuid_oapg -> as_uuid_
    • as_float_oapg -> as_float_
    • as_int_oapg -> as_int_
    • get_item_oapg -> get_item_
    • from_openapi_data_oapg -> from_openapi_data_
    • from_openapi_data_oapg -> from_openapi_data_
    • _verify_typed_dict_inputs_oapg -> _verify_typed_dict_inputs
    • _configuration -> configuration_
    • _arg -> arg_
    • _args -> args_
    • MetaOapg -> Schema_
    • JsonSchema -> OpenApiSchema

To read more about the details of those changes, and why they were done, read the
2.0.0 Migration guide:

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/1.0.4...2.0.0

openapi-json-schema-generator - 1.0.4

Published by spacether over 1 year ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/1.0.3...1.0.4

openapi-json-schema-generator - 1.0.3

Published by spacether over 1 year ago

What's Changed

Full Changelog: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/compare/1.0.2...1.0.3

Badges
Extracted from project README
CI Tests Apache 2.0 License
Related Projects
openapi-format

Format an OpenAPI document by ordering, formatting and filtering fields.

06 Mar 2021 94
openapi-typescript-codegen

NodeJS library that generates Typescript or Javascript clients based on the OpenAPI specification

05 Nov 2019 2,913
datamodel-code-generator

Pydantic model and dataclasses.dataclass generator for easy conversion of JSON, OpenAPI, JSON Sch...

29 May 2019 2,310
openapicmd

The CLI for all things OpenAPI and Swagger

26 Jan 2019 43
openapi-preprocessor

An authoring tool for OpenAPI specifications

15 Jul 2018 34
zero-rails_openapi

Concise DSL for generating OpenAPI Specification 3 (OAS3) JSON documentation for Ruby application.

11 Sep 2017 167
openapi-jaxrs-client

An OpenAPI JAX-RS client code generator

18 Dec 2021 1
codegenr

Fast handlebars templates based code generator, ingesting swagger/openapi and other json/yaml doc...

01 Nov 2021 27
openapi-client-generator

Generates Python client packages from OpenAPI v3 specifications. The project aims at supporting a...

27 Dec 2020 8
openapi-typescript-code-generator

TypeScript code generator via OpenAPI scheme.

15 Dec 2020 196
sttp-openapi-generator

Generate sttp client from openapi specification with ease!

20 Mar 2021 32
grpc-gateway

gRPC to JSON proxy generator following the gRPC HTTP spec

03 Apr 2015 17,308
openapi-to-java-records-mustache-templates

Generate Java Records from OpenAPI Specifications

05 Sep 2024 1
symbol-openapi-generator

Generates and deploys OpenAPI generated client libraries for Symbol SDKs

25 Oct 2019 3
openapi-generator-cli

A node package wrapper for https://github.com/OpenAPITools/openapi-generator

26 Oct 2018 1,430