Change semver library, again

BepInEx.Core/BepInEx.Core.csproj

@@ -31,6 +31,7 @@
     <PackageReference Include="HarmonyX" Version="2.1.1" />
     <PackageReference Include="Mono.Cecil" Version="0.10.4" />
     <PackageReference Include="MonoMod.Utils" Version="20.11.5.1" />
+    <PackageReference Include="SemanticVersioning" Version="1.3.0" />
   </ItemGroup>
   <ItemGroup>
     <Compile Remove="Contract\IPlugin.cs" />

BepInEx.Core/Bootstrap/BaseChainloader.cs

@@ -160,7 +160,7 @@ namespace BepInEx.Bootstrap
 				var sortedPlugins = ModifyLoadOrder(plugins);
 
 				var invalidPlugins = new HashSet<string>();
-				var processedPlugins = new Dictionary<string, SemVersion>();
+				var processedPlugins = new Dictionary<string, SemVer.Version>();
 				var loadedAssemblies = new Dictionary<string, Assembly>();
 
 				foreach (var plugin in sortedPlugins)
@@ -174,7 +174,7 @@ namespace BepInEx.Bootstrap
 
 						// If the dependency wasn't already processed, it's missing altogether
 						bool dependencyExists = processedPlugins.TryGetValue(dependency.DependencyGUID, out var pluginVersion);
-						if (!dependencyExists || (dependency.MinimumVersion != null && pluginVersion < dependency.MinimumVersion))
+						if (!dependencyExists || (dependency.VersionRange != null && !dependency.VersionRange.IsSatisfied(pluginVersion)))
 						{
 							// If the dependency is hard, collect it into a list to show
 							if (IsHardDependency(dependency))
@@ -203,7 +203,7 @@ namespace BepInEx.Bootstrap
 					if (missingDependencies.Count != 0)
 					{
 						string message = $@"Could not load [{plugin}] because it has missing dependencies: {
-								string.Join(", ", missingDependencies.Select(s => s.MinimumVersion == null ? s.DependencyGUID : $"{s.DependencyGUID} (v{s.MinimumVersion} or newer)").ToArray())
+								string.Join(", ", missingDependencies.Select(s => s.VersionRange == null ? s.DependencyGUID : $"{s.DependencyGUID} ({s.VersionRange})").ToArray())
 							}";
 						DependencyErrors.Add(message);
 						Logger.LogError(message);

BepInEx.Core/Contract/Attributes.cs

@@ -31,7 +31,7 @@ namespace BepInEx
 		/// <summary>
 		/// The specfic version of the plugin.
 		/// </summary>
-		public SemVersion Version { get; protected set; }
+		public SemVer.Version Version { get; protected set; }
 
 		/// <param name="GUID">The unique identifier of the plugin. Should not change between plugin versions.</param>
 		/// <param name="Name">The user friendly name of the plugin. Is able to be changed between versions.</param>
@@ -40,15 +40,7 @@ namespace BepInEx
 		{
 			this.GUID = GUID;
 			this.Name = Name;
-
-			try
-			{
-				this.Version = SemVersion.Parse(Version);
-			}
-			catch
-			{
-				this.Version = null;
-			}
+			this.Version = SemVer.Version.TryParse(Version, out var v) ? v : null;
 		}
 
 		internal static BepInPlugin FromCecilType(TypeDefinition td)
@@ -96,9 +88,9 @@ namespace BepInEx
 		public DependencyFlags Flags { get; protected set; }
 
 		/// <summary>
-		/// The minimum version of the referenced plugin.
+		/// The version <see cref="SemVer.Range">range</see> of the referenced plugin.
 		/// </summary>
-		public SemVersion MinimumVersion { get; protected set; }
+		public SemVer.Range VersionRange { get; protected set; }
 
 		/// <summary>
 		/// Marks this <see cref="BaseUnityPlugin"/> as depenant on another plugin. The other plugin will be loaded before this one.
@@ -110,19 +102,19 @@ namespace BepInEx
 		{
 			this.DependencyGUID = DependencyGUID;
 			this.Flags = Flags;
-			MinimumVersion = null;
+			VersionRange = null;
 		}
 
 		/// <summary>
 		/// Marks this <see cref="BaseUnityPlugin"/> as depenant on another plugin. The other plugin will be loaded before this one.
-		/// If the other plugin doesn't exist or is of a version below <see cref="MinimumVersion"/>, this plugin will not load and an error will be logged instead.
+		/// If the other plugin doesn't exist or is of a version not satisfying <see cref="VersionRange"/>, this plugin will not load and an error will be logged instead.
 		/// </summary>
 		/// <param name="DependencyGUID">The GUID of the referenced plugin.</param>
 		/// <param name="MinimumDependencyVersion">The minimum version of the referenced plugin.</param>
 		/// <remarks>When version is supplied the dependency is always treated as HardDependency</remarks>
 		public BepInDependency(string DependencyGUID, string MinimumDependencyVersion) : this(DependencyGUID)
 		{
-			MinimumVersion = SemVersion.Parse(MinimumDependencyVersion);
+			VersionRange = SemVer.Range.Parse(MinimumDependencyVersion);
 		}
 
 		internal static IEnumerable<BepInDependency> FromCecilType(TypeDefinition td)
@@ -141,14 +133,14 @@ namespace BepInEx
 		{
 			bw.Write(DependencyGUID);
 			bw.Write((int)Flags);
-			bw.Write(MinimumVersion.ToString());
+			bw.Write(VersionRange.ToString());
 		}
 
 		void ICacheable.Load(BinaryReader br)
 		{
 			DependencyGUID = br.ReadString();
 			Flags = (DependencyFlags)br.ReadInt32();
-			MinimumVersion = SemVersion.Parse(br.ReadString());
+			VersionRange = SemVer.Range.Parse(br.ReadString());
 		}
 	}
 

BepInEx.Core/Paths.cs

@@ -34,7 +34,7 @@ namespace BepInEx
 			PluginPath = Utility.CombinePaths(BepInExRootPath, pluginPath);
 		}
 
-		public static SemVersion BepInExVersion { get; } = SemVersion.Parse(typeof(Paths).Assembly.GetCustomAttribute<AssemblyInformationalVersionAttribute>().InformationalVersion);
+		public static SemVer.Version BepInExVersion { get; } = SemVer.Version.Parse(typeof(Paths).Assembly.GetCustomAttribute<AssemblyInformationalVersionAttribute>().InformationalVersion);
 
 		/// <summary>
 		///     The directory that the core BepInEx DLLs reside in.

BepInEx.Core/SemVersion.cs

@@ -1,616 +0,0 @@
-// Backported to net35 from https://github.com/maxhauser/semver
-
-using System;
-using System.Globalization;
-using System.Runtime.Serialization;
-using System.Security.Permissions;
-using System.Text;
-using System.Text.RegularExpressions;
-
-namespace BepInEx.Core
-{
-	internal static class IntExtensions
-	{
-		/// <summary>
-		/// The number of digits in a non-negative number. Returns 1 for all
-		/// negative numbers. That is ok because we are using it to calculate
-		/// string length for a <see cref="StringBuilder"/> for numbers that
-		/// aren't supposed to be negative, but when they are it is just a little
-		/// slower.
-		/// </summary>
-		/// <remarks>
-		/// This approach is based on https://stackoverflow.com/a/51099524/268898
-		/// where the poster offers performance benchmarks showing this is the
-		/// fastest way to get a number of digits.
-		/// </remarks>
-		public static int Digits(this int n)
-		{
-			if (n < 10)
-				return 1;
-			if (n < 100)
-				return 2;
-			if (n < 1_000)
-				return 3;
-			if (n < 10_000)
-				return 4;
-			if (n < 100_000)
-				return 5;
-			if (n < 1_000_000)
-				return 6;
-			if (n < 10_000_000)
-				return 7;
-			if (n < 100_000_000)
-				return 8;
-			if (n < 1_000_000_000)
-				return 9;
-			return 10;
-		}
-	}
-
-	[Serializable]
-	public sealed class SemVersion : IComparable<SemVersion>, IComparable, ISerializable
-	{
-		private static readonly Regex ParseEx =
-			new Regex(@"^(?<major>\d+)" +
-					  @"(?>\.(?<minor>\d+))?" +
-					  @"(?>\.(?<patch>\d+))?" +
-					  @"(?>\-(?<pre>[0-9A-Za-z\-\.]+))?" +
-					  @"(?>\+(?<build>[0-9A-Za-z\-\.]+))?$",
-				RegexOptions.CultureInvariant | RegexOptions.Compiled | RegexOptions.ExplicitCapture,
-				TimeSpan.FromSeconds(0.5));
-
-#pragma warning disable CA1801 // Parameter unused
-		/// <summary>
-		/// Deserialize a <see cref="SemVersion"/>.
-		/// </summary>
-		/// <exception cref="ArgumentNullException">The <paramref name="info"/> parameter is null.</exception>
-		private SemVersion(SerializationInfo info, StreamingContext context)
-#pragma warning restore CA1801 // Parameter unused
-		{
-			if (info == null)
-				throw new ArgumentNullException(nameof(info));
-			var semVersion = Parse(info.GetString("SemVersion"));
-			Major = semVersion.Major;
-			Minor = semVersion.Minor;
-			Patch = semVersion.Patch;
-			Prerelease = semVersion.Prerelease;
-			Build = semVersion.Build;
-		}
-
-		/// <summary>
-		/// Constructs a new instance of the <see cref="SemVersion" /> class.
-		/// </summary>
-		/// <param name="major">The major version.</param>
-		/// <param name="minor">The minor version.</param>
-		/// <param name="patch">The patch version.</param>
-		/// <param name="prerelease">The prerelease version (e.g. "alpha").</param>
-		/// <param name="build">The build metadata (e.g. "nightly.232").</param>
-		public SemVersion(int major, int minor = 0, int patch = 0, string prerelease = "", string build = "")
-		{
-			Major = major;
-			Minor = minor;
-			Patch = patch;
-
-			Prerelease = prerelease ?? "";
-			Build = build ?? "";
-		}
-
-		/// <summary>
-		/// Constructs a new instance of the <see cref="SemVersion"/> class from
-		/// a <see cref="System.Version"/>.
-		/// </summary>
-		/// <param name="version">The <see cref="Version"/> that is used to initialize
-		/// the Major, Minor, Patch and Build.</param>
-		/// <returns>A <see cref="SemVersion"/> with the same Major and Minor version.
-		/// The Patch version will be the fourth part of the version number. The
-		/// build meta data will contain the third part of the version number if
-		/// it is greater than zero.</returns>
-		public SemVersion(Version version)
-		{
-			if (version == null)
-				throw new ArgumentNullException(nameof(version));
-
-			Major = version.Major;
-			Minor = version.Minor;
-
-			if (version.Revision >= 0)
-				Patch = version.Revision;
-
-			Prerelease = "";
-
-			Build = version.Build > 0 ? version.Build.ToString(CultureInfo.InvariantCulture) : "";
-		}
-
-		/// <summary>
-		/// Converts the string representation of a semantic version to its <see cref="SemVersion"/> equivalent.
-		/// </summary>
-		/// <param name="version">The version string.</param>
-		/// <param name="strict">If set to <see langword="true"/> minor and patch version are required,
-		/// otherwise they are optional.</param>
-		/// <returns>The <see cref="SemVersion"/> object.</returns>
-		/// <exception cref="ArgumentNullException">The <paramref name="version"/> is <see langword="null"/>.</exception>
-		/// <exception cref="ArgumentException">The <paramref name="version"/> has an invalid format.</exception>
-		/// <exception cref="InvalidOperationException">The <paramref name="version"/> is missing Minor or Patch versions and <paramref name="strict"/> is <see langword="true"/>.</exception>
-		/// <exception cref="OverflowException">The Major, Minor, or Patch versions are larger than <code>int.MaxValue</code>.</exception>
-		public static SemVersion Parse(string version, bool strict = false)
-		{
-			var match = ParseEx.Match(version);
-			if (!match.Success)
-				throw new ArgumentException($"Invalid version '{version}'.", nameof(version));
-
-			var major = int.Parse(match.Groups["major"].Value, CultureInfo.InvariantCulture);
-
-			var minorMatch = match.Groups["minor"];
-			int minor = 0;
-			if (minorMatch.Success)
-				minor = int.Parse(minorMatch.Value, CultureInfo.InvariantCulture);
-			else if (strict)
-				throw new InvalidOperationException("Invalid version (no minor version given in strict mode)");
-
-			var patchMatch = match.Groups["patch"];
-			int patch = 0;
-			if (patchMatch.Success)
-				patch = int.Parse(patchMatch.Value, CultureInfo.InvariantCulture);
-			else if (strict)
-				throw new InvalidOperationException("Invalid version (no patch version given in strict mode)");
-
-			var prerelease = match.Groups["pre"].Value;
-			var build = match.Groups["build"].Value;
-
-			return new SemVersion(major, minor, patch, prerelease, build);
-		}
-
-		/// <summary>
-		/// Converts the string representation of a semantic version to its <see cref="SemVersion"/>
-		/// equivalent and returns a value that indicates whether the conversion succeeded.
-		/// </summary>
-		/// <param name="version">The version string.</param>
-		/// <param name="semver">When the method returns, contains a <see cref="SemVersion"/> instance equivalent
-		/// to the version string passed in, if the version string was valid, or <see langword="null"/> if the
-		/// version string was not valid.</param>
-		/// <param name="strict">If set to <see langword="true"/> minor and patch version are required,
-		/// otherwise they are optional.</param>
-		/// <returns><see langword="false"/> when a invalid version string is passed, otherwise <see langword="true"/>.</returns>
-		public static bool TryParse(string version, out SemVersion semver, bool strict = false)
-		{
-			semver = null;
-			if (version is null)
-				return false;
-
-			var match = ParseEx.Match(version);
-			if (!match.Success)
-				return false;
-
-			if (!int.TryParse(match.Groups["major"].Value, NumberStyles.Integer, CultureInfo.InvariantCulture, out var major))
-				return false;
-
-			var minorMatch = match.Groups["minor"];
-			int minor = 0;
-			if (minorMatch.Success)
-			{
-				if (!int.TryParse(minorMatch.Value, NumberStyles.Integer, CultureInfo.InvariantCulture, out minor))
-					return false;
-			}
-			else if (strict)
-				return false;
-
-			var patchMatch = match.Groups["patch"];
-			int patch = 0;
-			if (patchMatch.Success)
-			{
-				if (!int.TryParse(patchMatch.Value, NumberStyles.Integer, CultureInfo.InvariantCulture, out patch))
-					return false;
-			}
-			else if (strict)
-				return false;
-
-			var prerelease = match.Groups["pre"].Value;
-			var build = match.Groups["build"].Value;
-
-			semver = new SemVersion(major, minor, patch, prerelease, build);
-			return true;
-		}
-
-		/// <summary>
-		/// Checks whether two semantic versions are equal.
-		/// </summary>
-		/// <param name="versionA">The first version to compare.</param>
-		/// <param name="versionB">The second version to compare.</param>
-		/// <returns><see langword="true"/> if the two values are equal, otherwise <see langword="false"/>.</returns>
-		public static bool Equals(SemVersion versionA, SemVersion versionB)
-		{
-			if (ReferenceEquals(versionA, versionB))
-				return true;
-			if (versionA is null || versionB is null)
-				return false;
-			return versionA.Equals(versionB);
-		}
-
-		/// <summary>
-		/// Compares the specified versions.
-		/// </summary>
-		/// <param name="versionA">The first version to compare.</param>
-		/// <param name="versionB">The second version to compare.</param>
-		/// <returns>A signed number indicating the relative values of <paramref name="versionA"/> and <paramref name="versionB"/>.</returns>
-		public static int Compare(SemVersion versionA, SemVersion versionB)
-		{
-			if (ReferenceEquals(versionA, versionB))
-				return 0;
-			if (versionA is null)
-				return -1;
-			if (versionB is null)
-				return 1;
-			return versionA.CompareTo(versionB);
-		}
-
-		/// <summary>
-		/// Make a copy of the current instance with changed properties.
-		/// </summary>
-		/// <param name="major">The value to replace the major version or <see langword="null"/> to leave it unchanged.</param>
-		/// <param name="minor">The value to replace the minor version or <see langword="null"/> to leave it unchanged.</param>
-		/// <param name="patch">The value to replace the patch version or <see langword="null"/> to leave it unchanged.</param>
-		/// <param name="prerelease">The value to replace the prerelease version or <see langword="null"/> to leave it unchanged.</param>
-		/// <param name="build">The value to replace the build metadata or <see langword="null"/> to leave it unchanged.</param>
-		/// <returns>The new version object.</returns>
-		/// <remarks>
-		/// The change method is intended to be called using named argument syntax, passing only
-		/// those fields to be changed.
-		/// </remarks>
-		/// <example>
-		/// To change only the patch version:
-		/// <code>version.Change(patch: 4)</code>
-		/// </example>
-		public SemVersion Change(int? major = null, int? minor = null, int? patch = null,
-			string prerelease = null, string build = null)
-		{
-			return new SemVersion(
-				major ?? Major,
-				minor ?? Minor,
-				patch ?? Patch,
-				prerelease ?? Prerelease,
-				build ?? Build);
-		}
-
-		/// <summary>
-		/// Gets the major version.
-		/// </summary>
-		/// <value>
-		/// The major version.
-		/// </value>
-		public int Major { get; }
-
-		/// <summary>
-		/// Gets the minor version.
-		/// </summary>
-		/// <value>
-		/// The minor version.
-		/// </value>
-		public int Minor { get; }
-
-		/// <summary>
-		/// Gets the patch version.
-		/// </summary>
-		/// <value>
-		/// The patch version.
-		/// </value>
-		public int Patch { get; }
-
-		/// <summary>
-		/// Gets the prerelease version.
-		/// </summary>
-		/// <value>
-		/// The prerelease version. Empty string if this is a release version.
-		/// </value>
-		public string Prerelease { get; }
-
-		/// <summary>
-		/// Gets the build metadata.
-		/// </summary>
-		/// <value>
-		/// The build metadata. Empty string if there is no build metadata.
-		/// </value>
-		public string Build { get; }
-
-		/// <summary>
-		/// Returns the <see cref="string" /> equivalent of this version.
-		/// </summary>
-		/// <returns>
-		/// The <see cref="string" /> equivalent of this version.
-		/// </returns>
-		public override string ToString()
-		{
-			// Assume all separators ("..-+"), at most 2 extra chars
-			var estimatedLength = 4 + Major.Digits() + Minor.Digits() + Patch.Digits()
-								  + Prerelease.Length + Build.Length;
-			var version = new StringBuilder(estimatedLength);
-			version.Append(Major);
-			version.Append('.');
-			version.Append(Minor);
-			version.Append('.');
-			version.Append(Patch);
-			if (Prerelease.Length > 0)
-			{
-				version.Append('-');
-				version.Append(Prerelease);
-			}
-
-			if (Build.Length > 0)
-			{
-				version.Append('+');
-				version.Append(Build);
-			}
-
-			return version.ToString();
-		}
-
-		/// <summary>
-		/// Compares the current instance with another object of the same type and returns an integer that indicates
-		/// whether the current instance precedes, follows, or occurs in the same position in the sort order as the
-		/// other object.
-		/// </summary>
-		/// <param name="obj">An object to compare with this instance.</param>
-		/// <returns>
-		/// A value that indicates the relative order of the objects being compared.
-		/// The return value has these meanings:
-		///  Less than zero: This instance precedes <paramref name="obj" /> in the sort order.
-		///  Zero: This instance occurs in the same position in the sort order as <paramref name="obj" />.
-		///  Greater than zero: This instance follows <paramref name="obj" /> in the sort order.
-		/// </returns>
-		/// <exception cref="InvalidCastException">The <paramref name="obj"/> is not a <see cref="SemVersion"/>.</exception>
-		public int CompareTo(object obj)
-		{
-			return CompareTo((SemVersion)obj);
-		}
-
-		/// <summary>
-		/// Compares the current instance with another object of the same type and returns an integer that indicates
-		/// whether the current instance precedes, follows, or occurs in the same position in the sort order as the
-		/// other object.
-		/// </summary>
-		/// <param name="other">An object to compare with this instance.</param>
-		/// <returns>
-		/// A value that indicates the relative order of the objects being compared.
-		/// The return value has these meanings:
-		///  Less than zero: This instance precedes <paramref name="other" /> in the sort order.
-		///  Zero: This instance occurs in the same position in the sort order as <paramref name="other" />.
-		///  Greater than zero: This instance follows <paramref name="other" /> in the sort order.
-		/// </returns>
-		public int CompareTo(SemVersion other)
-		{
-			var r = CompareByPrecedence(other);
-			if (r != 0)
-				return r;
-
-#pragma warning disable CA1062 // Validate arguments of public methods
-			// If other is null, CompareByPrecedence() returns 1
-			return CompareComponent(Build, other.Build);
-#pragma warning restore CA1062 // Validate arguments of public methods
-		}
-
-		/// <summary>
-		/// Returns whether two semantic versions have the same precedence. Versions
-		/// that differ only by build metadata have the same precedence.
-		/// </summary>
-		/// <param name="other">The semantic version to compare to.</param>
-		/// <returns><see langword="true"/> if the version precedences are equal.</returns>
-		public bool PrecedenceMatches(SemVersion other)
-		{
-			return CompareByPrecedence(other) == 0;
-		}
-
-		/// <summary>
-		/// Compares two semantic versions by precedence as defined in the SemVer spec. Versions
-		/// that differ only by build metadata have the same precedence.
-		/// </summary>
-		/// <param name="other">The semantic version.</param>
-		/// <returns>
-		/// A value that indicates the relative order of the objects being compared.
-		/// The return value has these meanings:
-		///  Less than zero: This instance precedes <paramref name="other" /> in the sort order.
-		///  Zero: This instance occurs in the same position in the sort order as <paramref name="other" />.
-		///  Greater than zero: This instance follows <paramref name="other" /> in the sort order.
-		/// </returns>
-		public int CompareByPrecedence(SemVersion other)
-		{
-			if (other is null)
-				return 1;
-
-			var r = Major.CompareTo(other.Major);
-			if (r != 0)
-				return r;
-
-			r = Minor.CompareTo(other.Minor);
-			if (r != 0)
-				return r;
-
-			r = Patch.CompareTo(other.Patch);
-			if (r != 0)
-				return r;
-
-			return CompareComponent(Prerelease, other.Prerelease, true);
-		}
-
-		private static int CompareComponent(string a, string b, bool nonemptyIsLower = false)
-		{
-			var aEmpty = string.IsNullOrEmpty(a);
-			var bEmpty = string.IsNullOrEmpty(b);
-			if (aEmpty && bEmpty)
-				return 0;
-
-			if (aEmpty)
-				return nonemptyIsLower ? 1 : -1;
-			if (bEmpty)
-				return nonemptyIsLower ? -1 : 1;
-
-			var aComps = a.Split('.');
-			var bComps = b.Split('.');
-
-			var minLen = Math.Min(aComps.Length, bComps.Length);
-			for (int i = 0; i < minLen; i++)
-			{
-				var ac = aComps[i];
-				var bc = bComps[i];
-				var aIsNum = int.TryParse(ac, out var aNum);
-				var bIsNum = int.TryParse(bc, out var bNum);
-				int r;
-				if (aIsNum && bIsNum)
-				{
-					r = aNum.CompareTo(bNum);
-					if (r != 0)
-						return r;
-				}
-				else
-				{
-					if (aIsNum)
-						return -1;
-					if (bIsNum)
-						return 1;
-					r = string.CompareOrdinal(ac, bc);
-					if (r != 0)
-						return r;
-				}
-			}
-
-			return aComps.Length.CompareTo(bComps.Length);
-		}
-
-		/// <summary>
-		/// Determines whether the specified <see cref="object" /> is equal to this instance.
-		/// </summary>
-		/// <param name="obj">The <see cref="object" /> to compare with this instance.</param>
-		/// <returns>
-		///   <see langword="true"/> if the specified <see cref="object" /> is equal to this instance, otherwise <see langword="false"/>.
-		/// </returns>
-		/// <exception cref="InvalidCastException">The <paramref name="obj"/> is not a <see cref="SemVersion"/>.</exception>
-		public override bool Equals(object obj)
-		{
-			if (obj is null)
-				return false;
-
-			if (ReferenceEquals(this, obj))
-				return true;
-
-			var other = (SemVersion)obj;
-
-			return Major == other.Major
-				   && Minor == other.Minor
-				   && Patch == other.Patch
-				   && string.Equals(Prerelease, other.Prerelease, StringComparison.Ordinal)
-				   && string.Equals(Build, other.Build, StringComparison.Ordinal);
-		}
-
-		/// <summary>
-		/// Returns a hash code for this instance.
-		/// </summary>
-		/// <returns>
-		/// A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table.
-		/// </returns>
-		public override int GetHashCode()
-		{
-			unchecked
-			{
-				// TODO verify this. Some versions start result = 17. Some use 37 instead of 31
-				int result = Major.GetHashCode();
-				result = result * 31 + Minor.GetHashCode();
-				result = result * 31 + Patch.GetHashCode();
-				result = result * 31 + Prerelease.GetHashCode();
-				result = result * 31 + Build.GetHashCode();
-				return result;
-			}
-		}
-
-		/// <summary>
-		/// Populates a <see cref="SerializationInfo"/> with the data needed to serialize the target object.
-		/// </summary>
-		/// <param name="info">The <see cref="SerializationInfo"/> to populate with data.</param>
-		/// <param name="context">The destination (see <see cref="SerializationInfo"/>) for this serialization.</param>
-		[SecurityPermission(SecurityAction.Demand, SerializationFormatter = true)]
-		public void GetObjectData(SerializationInfo info, StreamingContext context)
-		{
-			if (info == null)
-				throw new ArgumentNullException(nameof(info));
-			info.AddValue("SemVersion", ToString());
-		}
-
-#pragma warning disable CA2225 // Operator overloads have named alternates
-		/// <summary>
-		/// Implicit conversion from <see cref="string"/> to <see cref="SemVersion"/>.
-		/// </summary>
-		/// <param name="version">The semantic version.</param>
-		/// <returns>The <see cref="SemVersion"/> object.</returns>
-		/// <exception cref="ArgumentNullException">The <paramref name="version"/> is <see langword="null"/>.</exception>
-		/// <exception cref="ArgumentException">The version number has an invalid format.</exception>
-		/// <exception cref="OverflowException">The Major, Minor, or Patch versions are larger than <code>int.MaxValue</code>.</exception>
-		public static implicit operator SemVersion(string version)
-#pragma warning restore CA2225 // Operator overloads have named alternates
-		{
-			return Parse(version);
-		}
-
-		/// <summary>
-		/// Compares two semantic versions for equality.
-		/// </summary>
-		/// <param name="left">The left value.</param>
-		/// <param name="right">The right value.</param>
-		/// <returns>If left is equal to right <see langword="true"/>, otherwise <see langword="false"/>.</returns>
-		public static bool operator ==(SemVersion left, SemVersion right)
-		{
-			return Equals(left, right);
-		}
-
-		/// <summary>
-		/// Compares two semantic versions for inequality.
-		/// </summary>
-		/// <param name="left">The left value.</param>
-		/// <param name="right">The right value.</param>
-		/// <returns>If left is not equal to right <see langword="true"/>, otherwise <see langword="false"/>.</returns>
-		public static bool operator !=(SemVersion left, SemVersion right)
-		{
-			return !Equals(left, right);
-		}
-
-		/// <summary>
-		/// Compares two semantic versions.
-		/// </summary>
-		/// <param name="left">The left value.</param>
-		/// <param name="right">The right value.</param>
-		/// <returns>If left is greater than right <see langword="true"/>, otherwise <see langword="false"/>.</returns>
-		public static bool operator >(SemVersion left, SemVersion right)
-		{
-			return Compare(left, right) > 0;
-		}
-
-		/// <summary>
-		/// Compares two semantic versions.
-		/// </summary>
-		/// <param name="left">The left value.</param>
-		/// <param name="right">The right value.</param>
-		/// <returns>If left is greater than or equal to right <see langword="true"/>, otherwise <see langword="false"/>.</returns>
-		public static bool operator >=(SemVersion left, SemVersion right)
-		{
-			return Equals(left, right) || Compare(left, right) > 0;
-		}
-
-		/// <summary>
-		/// Compares two semantic versions.
-		/// </summary>
-		/// <param name="left">The left value.</param>
-		/// <param name="right">The right value.</param>
-		/// <returns>If left is less than right <see langword="true"/>, otherwise <see langword="false"/>.</returns>
-		public static bool operator <(SemVersion left, SemVersion right)
-		{
-			return Compare(left, right) < 0;
-		}
-
-		/// <summary>
-		/// Compares two semantic versions.
-		/// </summary>
-		/// <param name="left">The left value.</param>
-		/// <param name="right">The right value.</param>
-		/// <returns>If left is less than or equal to right <see langword="true"/>, otherwise <see langword="false"/>.</returns>
-		public static bool operator <=(SemVersion left, SemVersion right)
-		{
-			return Equals(left, right) || Compare(left, right) < 0;
-		}
-	}
-}