Skip to content

v10.2.1

Choose a tag to compare

View all tags
@gimlichael gimlichael released this 09 Jul 22:07
· 2 commits to main since this release
v10.2.1
d3aed60
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

What's Changed

This release introduces semantic version normalization for ASP.NET Core API versioning, ensuring that semantically equivalent version formats (1, 1.0, and 1.0.0) are normalized to identical canonical forms for consistent routing and version matching.

Key improvements:

  • RestfulApiVersionReader normalization now treats semantically equivalent API version formats as identical values for routing purposes,
  • ApiVersionReader property added to RestfulApiVersioningOptions for advanced version reader customization and extensibility,
  • Automatic normalization enabled by default when SemanticApiVersion is the default API version; applications not using semantic versioning retain previous behavior,
  • Comprehensive test coverage added to verify version normalization across Accept and Content-Type header scenarios, including matching, mismatched, and unregistered version aliases,
  • Documentation updated to reflect the version normalization feature, new type documentation for ApiVersionAliasParser, and configuration guidance for ServiceCollectionExtensions.

Note

Version normalization is enabled automatically when using SemanticApiVersion as the default API version. Use RestfulApiVersioningOptions.ApiVersionReader to customize or disable this behavior if needed.

Sources:

Full Changelog: v10.2.0...v10.2.1

Contributors

gimlichael
Assets 2
Loading