NuGet · #731 most downloaded on NuGet

Semver

3.0.077M downloads/moWalkerCodeRanger/semver ↗New releases in your daily digest, changelog included.

A semantic version library fully compliant with v2.0.0 of the spec found at http://semver.org.

Last release 2 years ago
no release in 18 months
Release timing varies
gaps range from 9 days to 3.2 years
Some releases are documented
notes for 4 of 16 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
16 releases · first in 2013

Release timeline

16 releases since 2013

2013201520172019

Releases

3.0.023 Oct 2024
A major release to support arbitrary-sized version numbers, prevent invalid version numbers, remove obsolete functionality, and strong name the assemb
A major release to support arbitrary-sized version numbers, prevent invalid version numbers, remove obsolete functionality, and strong name the assembly.

Breaking Changes:

SemVersion.Parse and SemVersion.TryParse now default to strict parsing. Use SemVersionStyles to control parsing

SemVersion.Major, SemVersion.Minor, SemVersion.Patch, and PrereleaseIdentifier.NumericValue properties are now BigInteger (#73)

Removed obsolete methods (#70, #47), including:

Implicit conversion from string (#47). Use SemVersion.Parse instead

SemVersion(int major, int minor = 0, int patch = 0, string prerelease = "", string build = "") constructor. Use another constructor or SemVersion.ParsedFrom instead

SemVersion.Parse and SemVersion.TryParse overloads with the strict parameter. They now default to strict. Use SemVersionStyles to control parsing

Comparison with SemVersion.CompareTo, SemVersion.Compare, SemVersion.CompareByPrecedence, <, <=, >, >=, or SemVersion.PrecedenceMatches. Use SemVersion.ComparePrecedenceTo, SemVersion.CompareSortOrderTo, SemVersion.ComparePrecedence, or SemVersion.CompareSortOrder instead.

SemVersion.Build. Use SemVersion.Metadata instead

SemVersion.Change. Use SemVersion.With or SemVersion.WithX methods instead

SemVersion(Version) constructor. Use SemVersion.FromVersion instead

SemVersion no longer implements IComparable<SemVersion> or IComparable. Use SemVersion.PrecedenceComparer or SemVersion.SortOrderComparer instead

Added strong name to assembly (#23)

Dropped support for frameworks older than .NET Standard 2.0 (i.e., .NET Framework < 4.6.2 & .NET Core < 2.0) (#68)

Construction of versions with negative major, minor, or patch is no longer allowed (#40)

Negative maxLength parameter values now throw ArgumentOutOfRangeException (#72)

Other Changes:

Arbitrary-sized version numbers are now supported, including in prerelease identifiers (#73)

2.2.012 Jun 2022

A minor release to improve comparison. Existing comparison methods and operators were confusing ( #15 , #26 ) and had bugs ( #39 , #53 , #69 ).

A minor release to improve comparison. Existing comparison methods and operators were confusing (#15, #26) and had bugs (#39, #53, #69).

New ComparePrecedenceTo(SemVersion), PrecedenceEquals(Semver), and static ComparePrecedence(SemVersion, SemVersion) and PrecedenceEquals(SemVersion, SemVersion) methods for comparing precedence
New CompareSortOrderTo(SemVersion) and static CompareSortOrder(SemVersion, SemVersion) methods for comparing sort order
- Use existing Equals(SemVersion) and Equals(SemVersion, SemVersion) to compare sort order equality
New PrecedenceComparer and SortOrderComparer static properties
- Provide a comparer that implements IEqualityComparer<SemVersion> and IComparer<SemVersion> to compare by precedence and sort order respectively
- These can be used for sorting, binary search, and using SemVersion as a dictionary key
Marked Compare(SemVersion, SemVersion), CompareByPrecedence(SemVersion), CompareTo(SemVersion), CompareTo(object), and PrecedenceMatches(SemVersion) obsolete
Marked comparison operators obsolete (#53)

Open source →

2.1.019 Mar 2022

A minor release to improve parsing, construction, and modification.

Greatly improved doc comments
New Parse() and TryParse() overloads taking SemVersionStyles
- SemVersionStyles provide greater flexibility in what formats to accept (feature #38)
- Improved performance and more detailed exception messages (feature #62)
- New methods enforce rule about leading zeros in prerelease identifiers (bug #16)
- Old Parse() and TryParse() overloads marked obsolete
New With(), WithParsedFrom(), WithX(), WithoutX() methods to replace Change() method (feature #65)
- New methods fully validate parameters to prevent invalid versions
- New method names clearly indicate that the method does not mutate the existing SemVersion
- Old Change() method marked obsolete
Added PrereleaseIdentifiers property providing access to individual identifiers (feature #37)
Added MetadataIdentifiers property providing access to individual identifiers (feature #37)
New Metadata property for consistent terminology use matching the semver spec
- Marked Build property obsolete
Added IsPrerelease and IsRelease properties (feature #44)
New constructor overloads and SemVersion.ParsedFrom() method (bugs #40, #41)
- New overloads accept prerelease portion and metadata as individual identifiers
- New overloads validate all parameters to prevent invalid semantic versions
- Marked old constructor overload obsolete
SemVersion now implements IEquatable<SemVersion> (feature #34)
New SemVersion.FromVersion() and ToVersion() methods for conversion from and to System.Version (bug #32)
- Corrects the mapping between version parts
- Marked old constructor obsolete
Added .NET Standard 2.0 assembly version to avoid warnings about .NET Standard 1.0 (feature #30)
Assembly version fixed at 2.1.0.0 until v3.0 (bug #61)
Marked implicit conversion from string obsolete (feature #46)
Improved hash code calculation

Open source →