openapi_generator

7.0.0 (2026-05-30)

⚠ BREAKING CHANGES

• openapi_generator now declares analyzer as a runtime dependency with constraint >5.12.0 <9.0.0 because its public library code imports analyzer APIs.

Features

• generator: add cleanOutputDirectory flag (#19) (e12f1a1)

Bug Fixes

• add support for remote specs without extensions. Closes #176 (c08164d)
• command: simplify argument wrapping for fvm wrapper (1f4da4a)
• Enhance OpenAPI generator with new features and improvements (a0a2594)
• generator: prepend 'flutter' to fvm args and use runInShell: true (#129) (99ad2a1)
• generator: prevent AssetId crash for spec paths outside package root (0df1fc0), closes #198
• generator: use runInShell and auto-create outputDirectory (#164) (e651c09)
• harden generator release pipeline (5922f30)
• Notify build_runner of dependency on inputSpec (#187) (b4c15ee)
• Remove deprecated skipIfSpecIsUnchanged and skipSpecDepMessage (#193) (bc06852)
• update build_test dependency version to >=2.0.0 <4.0.0 in pubspec files (5747abf)
• update README for clarity and formatting; adjust generator arguments and caching logic (2c85976)
• updated analyzer and source_gen dependencies (7b2b4b7), closes #192

⚠ BREAKING CHANGES

• openapi_generator now declares analyzer as a runtime dependency with constraint >5.12.0 <9.0.0 because its public library code imports analyzer APIs.

Features

• generator: add cleanOutputDirectory flag (#19) (e12f1a1)

Bug Fixes

• add support for remote specs without extensions. Closes #176 (c08164d)
• command: simplify argument wrapping for fvm wrapper (1f4da4a)
• Enhance OpenAPI generator with new features and improvements (a0a2594)
• generator: prepend 'flutter' to fvm args and use runInShell: true (#129) (99ad2a1)
• generator: prevent AssetId crash for spec paths outside package root (0df1fc0), closes #198
• generator: use runInShell and auto-create outputDirectory (#164) (e651c09)
• harden generator release pipeline (5922f30)
• Notify build_runner of dependency on inputSpec (#187) (b4c15ee)
• Remove deprecated skipIfSpecIsUnchanged and skipSpecDepMessage (#193) (bc06852)
• update build_test dependency version to >=2.0.0 <4.0.0 in pubspec files (5747abf)
• update README for clarity and formatting; adjust generator arguments and caching logic (2c85976)
• updated analyzer and source_gen dependencies (7b2b4b7), closes #192

6.1.0 (2024-12-15)

Features

• added --enum-name-mappings support (328c9da)

Features

• added --enum-name-mappings support (328c9da)

6.0.0 (2024-11-06)

⚠ BREAKING CHANGES

• forceAlwaysRun is used to represent if the library should run everytime build_runner is executed. This is done by modifying the annotated file after build_runner completes. Previous versions of this library did not have this flag but they had the equivalent of true. However, this now defaults to false. To keep previous behavior, set this flag to true.

Features

• add --name-mappings param support for generator (f5c6aed)
• added fields skipIfSpecUnchanged and forceAlwaysRun (d5555dd)
• annotated file updating made optional by argument (c108469)
• annotations: fixed issue with DioSerializationLibrary and updated tests (c9a179a), closes #152
• Changing to a config based approach for obtaining the official openapi generator jar. (05d61f7)

Bug Fixes

• annotations: added doc for --name-mappings and moved some things around (f2d6c04), closes #114
• dart format (af19a8e)
• fixed ci (fe64d7a)
• fixed failing tests (f1c0a1c)
• fixes some tests (79c9ce7)
• removed unsupported field (27eb1af)
• removed unsupported field (27eb1af)
• removed unsupported field (27eb1af)

⚠ BREAKING CHANGES

• forceAlwaysRun is used to represent if the library should run everytime build_runner is executed. This is done by modifying the annotated file after build_runner completes. Previous versions of this library did not have this flag but they had the equivalent of true. However, this now defaults to false. To keep previous behavior, set this flag to true.

Features

• add --name-mappings param support for generator (f5c6aed)
• added fields skipIfSpecUnchanged and forceAlwaysRun (d5555dd)
• annotated file updating made optional by argument (c108469)
• annotations: fixed issue with DioSerializationLibrary and updated tests (c9a179a), closes #152
• Changing to a config based approach for obtaining the official openapi generator jar. (05d61f7)

Bug Fixes

• annotations: added doc for --name-mappings and moved some things around (f2d6c04), closes #114
• dart format (af19a8e)
• fixed ci (fe64d7a)
• fixed failing tests (f1c0a1c)
• fixes some tests (79c9ce7)
• removed unsupported field (27eb1af)
• removed unsupported field (27eb1af)
• removed unsupported field (27eb1af)

Patched issue with clashing cached spec

Bug Fixes

• fixed spec diff tracking

5.0.0 (2024-01-16)

⚠ BREAKING CHANGES

• cli: removed various deprecated methods and properties such as inputSpecFile

Features

• annotation: removed deprecated properties from annotation (51d3683)
• cli: bumped official generator version to 7.2 (51d3683)
• generator: moved completely to newgen (51d3683)

Bug Fixes

• Apply types to default empty maps (bfb0ec4)
• Consume testing version of the source_gen branch to simplify testing. (37af696)
• Correct most of the tests while using the newest verison of the source gen changes (4156d9a)
• dep override (8266ab1)
• fmt (e63c9b9)
• generator: fixed bad deps (5d6407a)

⚠ BREAKING CHANGES

• cli: removed various deprecated methods and properties such as inputSpecFile

Features

• annotation: removed deprecated properties from annotation (51d3683)
• cli: bumped official generator version to 7.2 (51d3683)
• generator: moved completely to newgen (51d3683)

Bug Fixes

• Apply types to default empty maps (bfb0ec4)
• Consume testing version of the source_gen branch to simplify testing. (37af696)
• Correct most of the tests while using the newest verison of the source gen changes (4156d9a)
• dep override (8266ab1)
• fmt (e63c9b9)
• generator: fixed bad deps (5d6407a)

4.13.1 (2023-09-04)

Bug Fixes

• dependencies: added required dependencies to pubspec (7738439)
• fixes useEnumExtension and other non string additional properties fields throwing error (53b711a)
• updated logs (45af1cf)

Bug Fixes

• dependencies: added required dependencies to pubspec (7738439)
• fixes useEnumExtension and other non string additional properties fields throwing error (53b711a)
• updated logs (45af1cf)

4.13.0 (2023-09-02)

Features

• Add a format stage to the end of nextGen (acac104)
• Add headers options for requests (nextGen only) (bc4a170)

Bug Fixes

• fix incorrect find and replace causing tests to fail (0016a03)
• move to delegate, add tests, revert version requirement (6a32542)
• remove duplicate run test, fix failing tests (677a318)
• remove unused imports (4eb64c9)
• repair the docker run command, update the type_methods to expand out the remote delegate (c00b334)

Features

• Add a format stage to the end of nextGen (acac104)
• Add headers options for requests (nextGen only) (bc4a170)

Bug Fixes

• fix incorrect find and replace causing tests to fail (0016a03)
• move to delegate, add tests, revert version requirement (6a32542)
• remove duplicate run test, fix failing tests (677a318)
• remove unused imports (4eb64c9)
• repair the docker run command, update the type_methods to expand out the remote delegate (c00b334)

What's Changed

• Generate for spec changes by @Nexushunter in #96

New Contributors

• @Nexushunter made their first contribution in #96

Full Changelog: 4.11.0...4.12.0

• Added spec diff tracking. This means you Openapi generator now tracks changes to your spec and only regenerates the code if there are changes. This is useful if you have a large spec and you want to avoid regenerating the code every time you run your build. This is enabled by default. You can read more about it here. Credits - @Nexushunter
• Improved test coverage

• Removed log.severe that shows even though generation is successful
• Updated documentation

• Bumped dart-ogurets (dioAlt) generator to 7.2 with changes
• Bumped official openapi generator to 6.6.0. See change log
• fix endpoints returning null #15433
• Drop default value when unnecessary #15368

• Bumped dart-ogurets (dioAlt) generator to 7.1 with changes
• Bumped official openapi generator to 6.4.0. See change log

• BREAKING CHANGES

  • dioNext (replaced with dio) and jaguar generators are removed

• Bumped dart-ogurets (dioAlt) generator to 5.13 with changes

• Bumped official openapi generator to 6.0.0. See change log

• Fix the enum value retrieval error

• Update the analyzer constraint

• Bumped dart-ogurets (dioAlt) generator to 5.11 with changes
• Bumped official openapi generator to 5.3/0. See change log

• Bumped dart-ogurets (dioAlt) generator to 5.9 with changes
• Bumped official openapi generator to 5.2.1. See change log

• Bumped dart-ogurets (dioAlt) generator to 5.8 with changes
• Bumped official openapi generator to 5.2.0. See change log
• Added support for nullSafe for dioAlt generator
• Added support for import mappings

• fixed boolean additional properties returning null

• Bumped dart-ogurets (dioAlt) generator to 5.3 with changes
• Bumped official openapi generator to 5.1.1. See change log

NEW DART GENERATOR:: A new dart generator has been added (dioNext). However, be careful because its xperimental and might be removed, renamed in the future or it might not even work well. You can read more about it here https://github.com/OpenAPITools/openapi-generator/pull/8869

• BREAKING CHANGES
• Bumped dart-ogurets (dioAlt) generator to 5.0 with breaking changes
• Bumped official openapi generator to 5.1.0. See change log

• Bumped dart-ogurets generator to 4.2 with breaking changes
• Bumped official openapi generator to 5.0.1. See change log

• Bumped generator version to 5.0.0. This has some breaking changes. Click here to view changes
• bumped null safety

• Added support for flutter wrappers
• Bumped dart-ogurets generator to 4.1 with breaking changes

• Bumped generator version to 5.0.0. This has some breaking changes. Click here to view changes

• Migrated to null safety

• Updated dart_2 api to version 3.10
• Added pubname to DioProperties

• Updated dart_2 api to latest
• Added support for reservedWordsMapping

• Added support for skipping post run steps
• Fixed failing post build steps in windows

• Fixed build issue

• Added support for dart2-api from dart-ogurets thanks to Robert Csakany

• fixed issue with wrong path on windows

• added support for -t (templateDirectory)
• minor bug fix

• Updated generator version to 4.3.0

• Updated analyzer to 0.39.4
• removed validation from input spec

• Updated docs

• Initial version.