Geekeey.SemVer (1.0.0)

Published 2026-05-21 19:48:01 +00:00 by HeyGeekeey in geekeey/semver

Setup this registry from the command line:

dotnet nuget add source --name geekeey --username your_username --password your_token

To install the package using NuGet, run the following command:

dotnet add package --source geekeey --version 1.0.0 Geekeey.SemVer

For more information on the NuGet registry, see the documentation.

A .NET library for parsing, comparing, formatting, and serializing semantic versions and version ranges.

SemVer is a .NET library for parsing, comparing, formatting, and serializing semantic versions and version ranges.

Features

Parsing: parse semantic version strings into structured objects.
Comparison: compare versions with operators or CompareTo.
Ranges: evaluate npm-style and Maven-style version ranges.
Serialization: use System.Text.Json converters for versions and ranges.

Getting Started

Install the NuGet package:

dotnet add package Geekeey.SemVer

You may need to add our NuGet feed to your nuget.config this can be done by running the following command:

dotnet nuget add source -n geekeey https://code.geekeey.de/api/packages/geekeey/nuget/index.json

Usage

using Geekeey.SemVer;

var version = SemanticVersion.Parse("1.2.3-beta+build.7");
var next = new SemanticVersion(1, 3, 0);

Console.WriteLine(version);
Console.WriteLine(version.Major);
Console.WriteLine(version.Prerelease);
Console.WriteLine(version.Metadata);
Console.WriteLine(version < next);

if (SemanticVersion.TryParse("1.2.3-alpha", out var parsed))
{
  Console.WriteLine(parsed);
}

Version ranges support npm-style and Maven-style syntax.

using Geekeey.SemVer;

var npmRange = SemanticVersionRange.Parse("^1.2.3");
var mavenRange = SemanticVersionRange.Parse("[1.2.3,2.0.0)");
var candidate = SemanticVersion.Parse("1.4.2");

Console.WriteLine(npmRange.Contains(candidate));
Console.WriteLine(mavenRange.Contains(candidate));
Console.WriteLine(npmRange.ToString("m", null));
Console.WriteLine(mavenRange.ToString("ns", null));

Both SemanticVersion and SemanticVersionRange integrate with System.Text.Json.

using System.Text.Json;
using Geekeey.SemVer;

var versionJson = JsonSerializer.Serialize(SemanticVersion.Parse("1.2.3-beta+build.7"));
var rangeJson = JsonSerializer.Serialize(SemanticVersionRange.Parse("^1.2.3"));

var roundTrippedVersion = JsonSerializer.Deserialize<SemanticVersion>(versionJson);
var roundTrippedRange = JsonSerializer.Deserialize<SemanticVersionRange>(rangeJson);