NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #1213 most downloaded on pub.dev
Generate Dart models and HTTP clients from Swagger and OpenAPI. Supports Retrofit, Dio, and package:http.
Latest stable
2.0.1
Last release 5 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
155 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Fixes unnecessary null types with required_by_default: false.
Adds MappableField to the dart_mappable template.
MappableField to the dart_mappable template.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fixes error with nullable in multipart (#211).
Adds new config parameter extras_parameter_by_default from retrofit 4.1.0 for (#208).
extras_parameter_by_default from retrofit
4.1.0 for
(#208).Fixes errors with required_by_default.
required_by_default.Fixes file names derived from schemeUrl.
schemeUrl.* Fixes the web interface.
Adds a wrapping collections variable that replaces arrayDepth and mapType; it stores and resolves all collections wrapping a type in their order of ap
arrayDepth and mapType; it stores and
resolves all collections wrapping a type in their order of appearance
(#128).required_by_default
(#168).squash_clients with merge_clients,
enums_prefix with enums_parent_prefix, and skipp_parameters with skipped_parameters.put_in_folder. Remove this key from config.Supports schema URLs without a file extension (#160).
* Fixes documentation.
Fixes Object request bodies in Retrofit clients (#110).
Object request bodies in Retrofit clients
(#110).Fixes errors with enum names (#163), (#164).
Adds support for multipart requests with references (#154).
Adds new config parameter required_by_default.
required_by_default.Fixes errors with multipart (#144).
Removes check that would avoid generating a map when additional properties has a $ref value.
$ref value.Fixes error with empty content type.
skip_parameters.Fixes a crash with path-level parameters (#147).
dart:io import in template.BREAKING CHANGE: Replaces the freezed config key with json_serializer. Set json_serializer to freezed, dart_mappable, or json_serializable (the defaul…
freezed config key with json_serializer.
Set json_serializer to freezed, dart_mappable, or json_serializable (the default).Fixes enum duplicate names (#140).
Fixes error with ref in a case other than PascalCase (#139).
ref in a case other than PascalCase
(#139).Adds new config parameter export_file.
export_file.Fixes client annotations for non-default content types in Swagger 2.0 schemas.
Adds description of request parameters to the code docs.
Fixes referenced components incorrectly classified as maps.
Adds unknown value to all enums to maintain backward compatibility when adding new values on the backend.
Fixes map objects parsing as separate entities (#124).
Fixes error with parsing dictionary objects (#113).
Fixes error with additionalProperties (#114).
additionalProperties
(#114).Adds new config parameter original_http_response (Dart only) (#115).
original_http_response (Dart only)
(#115).Fixes named body parameters in the Dart template.
body parameters in the Dart template.Fixes error with query parameter named body (#108).
body
(#108).Adds support for generating schemas by URL (see the example).
schema_url.schema_from_url_to_file.prefer_schema_source.Fixes error with required in clients (#101).
required in clients
(#101).Adds support for deprecated annotations for methods.
deprecated annotations for methods.BREAKING CHANGE: Changes the generation command. Use dart run swagger_parser.
Adds support for multiple schemas (see the example).
anyOf.root_client_name.name.put_in_folder.squash_clients.root_interface to root_client. Update this key in config.squish_clients to put_clients_in_folder. Update this key in config.Adds new config parameter mark_files_as_generated.
mark_files_as_generated.allOf, anyOf, and oneOf schemas.Fixes error with allOf results in the schema with type object (#91).
allOf results in the schema with type object
(#91).Fixes grouping words for abbreviations when special characters are present.
Adds summary of the methods to the code docs.
Adds new config parameter path_method_name.
path_method_name.Fixes imports in DTO components (#86).
Fixes grouping words for acronyms and abbreviations (#85).
Fixes method name generation in a language other than English (#83).
BREAKING CHANGE: Requires Dart 3.0 or later. Update the Dart SDK before upgrading.
Makes values nullable and optional by default when processing default values (#76).
Fixes default enum values in DTOs (#79).
Applies enum prefixes only to variable types.
Fixes unique names for unnamed classes (#74).
Fixes replacement rules in allOf.
allOf.* Fixes allOf handling (#72).
allOf handling (#72).Adds possibility to add enum prefix from parent component (#29). Change enums_prefix to true to enable this option.
enums_prefix to true to
enable this option.Fixes names for negative enum values.
* Fixes enum renaming (#69).
Fixes parsing of nullable array items (#68).
Updates retrofit_generator dependency to 7.0.8 and adds a config option to generate .toJson() methods in enums (retrofit_generator will use .toJson()
retrofit_generator dependency to
7.0.8 and adds a config option
to generate .toJson() methods in enums (retrofit_generator will use .toJson() instead of
.name in this case).Updates retrofit_generator dependency to 7.0.7 and removes unused .toJson() generated methods in enums.
retrofit_generator dependency to
7.0.7 and removes
unused .toJson() generated methods in enums.Adds regex replacement for generated class names.
One column per quarter.