Skip to content

v10.2.0

Choose a tag to compare

@gimlichael gimlichael released this 07 Jul 20:25
· 3 commits to main since this release
0e51dd3

What's Changed

This release introduces API version aliasing support, making it easier for API clients to specify versions using shorter or alternative semantic version formats.

API Version Aliasing:

  • Added ApiVersionAliasParser that resolves friendly API version aliases (such as 1, 1.0, or 1.0.0) to canonical SemanticApiVersion instances, with intelligent fallback to another parser. This enables clients to use shortened version tokens instead of requiring fully-qualified semantic versions.
  • Enhanced AddRestfulApiVersioning to automatically register semantic version aliases when the default API version is a SemanticApiVersion, reducing the need for manual parser configuration.
  • Added AddApiVersionParser<T> extension method for registering custom IApiVersionParser implementations as singletons, giving you fine-grained control over version parsing behavior.

Testing & Quality:

  • Introduced a new functional test project (Codebelt.Extensions.Asp.Versioning.FunctionalTests) with comprehensive test coverage for semantic version compatibility and alias routing.
  • Added tests validating that API endpoints correctly route requests using various semantic version formats and production/non-production behaviors.

Sources:

Full Changelog: v10.1.0...v10.2.0