Skip to content
Documentation

HAKOM.Versioning.Core.Net Assembly

Provides semantic versioning support for HAKOM software.

This assembly implements version parsing, comparison and compatibility checking based on Semantic Versioning 2.0.0. It also supports a legacy four-part version format (major.minor.revision.patch) for backwards compatibility with older HAKOM assemblies.

The core abstractions are:

  • IVersion — Represents a version, supporting comparison, equality, compatibility checks, and range matching via wildcard segments.
  • IVersionFactory — Creates IVersion instances from strings or from System.Reflection.Assembly metadata.
  • IVersionProvider — Supplies the list of all versions available within an application context, including versions derived from namespace conventions.

Register the module with the HAKOM dependency injection container using UseVersioning(this IContainer) or UseVersionsFromAssemblyAndNamespaces<TTypeInAssembly>(this IContainer):

// Register the version factory only:
container
.UseVersioning();
// Or register version information derived from an assembly and its namespaces:
container
.UseVersionsFromAssemblyAndNamespaces<MyController>();

To parse a version string directly:

IVersionFactory factory = container.Get<IVersionFactory>();
IVersion version = factory.Create("4.3.1-beta.2+build.42");
// Or use the non-throwing variant:
bool success = factory.TryCreate("4.3.1", out IVersion? parsed);
Namespaces
HAKOM.Versioning.Core.Net.Api Contains the public API surface of the HAKOM versioning module.
HAKOM.Versioning.Core.Net.Api.Exceptions Contains exception types thrown when version parsing or retrieval operations fail.
HAKOM.Versioning.Core.Net.Api.Extensions Contains extension methods for integrating the versioning module with dependency injection, assemblies, media types and namespaces.
© 2026 Volue.Version v0.6.38017 November 2026