Blimmo.SemanticVersion 2.0.0

Blimmo.SemanticVersion

A semantic versioning parser and formatter for .NET that provides robust support for parsing, manipulating, and formatting semantic version strings according to the Semantic Versioning 2.0.0 specification.

Features

• ✅ Full SemVer 2.0.0 specification support
• ✅ Parse semantic version strings (e.g., 1.2.3, 1.0.0-alpha+build.123)
• ✅ Support for major, minor, patch, prerelease, and build metadata
• ✅ Custom format strings for flexible version display
• ✅ Strong typing and null safety with nullable reference types
• ✅ Multi-target support: .NET 8, .NET 9, .NET 10

Installation

Install via NuGet Package Manager:

dotnet add package Blimmo.SemanticVersion

Or via Package Manager Console:

Install-Package Blimmo.SemanticVersion

Quick Start

Parsing Versions

using Blimmo.SemanticVersion;

// Parse a semantic version
var version = SemVer.Parse("1.2.3-alpha+build.42");

// Access version components
Console.WriteLine($"Major: {version.Major}");        // 1
Console.WriteLine($"Minor: {version.Minor}");        // 2
Console.WriteLine($"Patch: {version.Patch}");        // 3
Console.WriteLine($"Prerelease: {version.Prerelease}"); // alpha
Console.WriteLine($"Build: {version.Build}");        // build.42

Try Parse

if (SemVerParser.Default.TryParse("1.0.0-beta", out var semVer))
{
	Console.WriteLine($"Successfully parsed: {semVer}");
}

Creating Versions

// Create a new semantic version
var version = new SemVer(1, 2, 3, "alpha", "build.123");

// Create without prerelease or build metadata
var simpleVersion = new SemVer(2, 0, 0);

Formatting Versions

var version = new SemVer(1, 2, 3, "alpha", "build");

// Format using custom format strings
version.TryFormat("VF", out var fullVersion);     // 1.2.3-alpha+build
version.TryFormat("p", out var patchOnly);        // 3
version.TryFormat("s", out var statusOnly);       // alpha

Version Format

Semantic versions follow this format:

MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]

• MAJOR: Incremented for incompatible API changes
• MINOR: Incremented for backwards-compatible functionality additions
• PATCH: Incremented for backwards-compatible bug fixes
• PRERELEASE (optional): Indicates pre-release version (e.g., alpha, beta, rc.1)
• BUILD (optional): Build metadata (e.g., build.123, commit.abc123)

Examples

// Valid semantic versions
1.0.0
1.2.3
1.0.0-alpha
1.0.0-beta.1
1.0.0-rc.1+build.123
2.1.3-preview.2+sha.abc123

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests to the GitHub repository.

Repository

https://github.com/blimgr/SemanticVersion