LoginSign Up
← Back to all sparks
O

OpenAPI Generator

DEVOPS
Velocity5.0

Generates API clients, server stubs and documentation from OpenAPI specs

openapi-generator.tech ↗

OpenAPI Generator ships 150+ fixes a release and keeps its breaking changes on fallbacks.

code generationopenapi specnormalizer rulesbreaking changes with fallbackmulti-language
◆Current state
The project runs a steady stable-release train, each carrying 60 to 190 enhancements across dozens of language generators. The recurring theme is spec fidelity rather than new output: discriminator discovery in oneOf and allOf structures, OAS 3.1 nullable normalization, and a growing set of openapi-normalizer rules for specs that do not quite conform. New generators arrive regularly through community contribution, three in 7.15, three in 7.16, two in 7.20, which makes added targets routine rather than notable here.
◆Where it's heading
Two patterns hold across the window. Breaking changes ship with fallbacks and an option to restore prior behavior, so upgrades stay tractable for teams generating against pinned specs. And the normalizer is becoming the project's answer to imperfect real-world specs, absorbing rule after rule instead of pushing correctness back onto spec authors. The per-language sections are maintenance: race conditions, serialization, and null handling in individual generators.
◆Prediction
Normalizer rules have been added in nearly every release and one of them was flipped on by default in 7.17; expect more of the current opt-in rules to become defaults, each behind the same fallback flag the project uses for breaking changes.

◆Recent moves

  1. 10d ago

    7.24.0: discriminator introspection and OAS 3.1 nullable fixes

    170+ changes led by discriminator introspection for oneOf and allOf polymorphism, correct nullable handling for OAS 3.1 union types, and a CVE-flagged dependency fix. Squarely in the spec-fidelity lane the project has been working for several releases.

    View source ↗
  2. 10d ago

    7.23.0: JAX-RS security annotations and Kotlin naming break, with fallbacks

    Another 170+ change release carrying two breaking changes, both with fallbacks: security annotations in the JAX-RS and Quarkus generators, and Kotlin honoring the global API name prefix and suffix. It also adds a normalizer rule for loose null definitions in 3.0 specs.

    View source ↗
  3. 3mo ago

    7.22.0: oneOf discriminator mapping and template manager fix

    150+ changes centered on a new normalizer rule that replaces oneOf with discriminator mapping, plus a fix for concurrent JAR access in the template manager. Incremental spec handling with no change to what gets generated.

    View source ↗
  4. 3mo ago

    7.21.0: Spring Boot 3 becomes the default

    Flips Spring Boot 3 on by default for the Spring generator, the most widely used target in the project, and adds a fallback to non-pointer number and boolean types. A meaningful default change delivered through the usual fallback mechanism.

    View source ↗
  5. 5mo ago

    7.20.0: Terraform provider and C++ httplib generators

    Adds a Terraform provider generator and a C++ httplib server generator, and makes model property ordering deterministic. New targets land most releases in this project, so this reads as routine breadth rather than a change of direction.

    View source ↗
  6. 6mo ago

    7.19.0: parser bump and 3.1 discriminator regression fix

    A smaller 60+ change release: a parser version bump, vendor extension resolution on referenced parameters, and a fix for a discriminator regression in 3.1 sibling schemas. Maintenance between the larger trains.

    View source ↗