v13.0.0

Code/Light.GuardClauses.Performance/CollectionAssertions/SpanMustHaveLengthBenchmark.cs

@@ -2,6 +2,7 @@
 using System.Runtime.CompilerServices;
 using System.Text;
 using BenchmarkDotNet.Attributes;
+using Light.GuardClauses.ExceptionFactory;
 using Light.GuardClauses.Exceptions;
 
 namespace Light.GuardClauses.Performance.CollectionAssertions
@@ -47,23 +48,23 @@ public static class SpanMustHaveLengthExtensions
         public static Span<T> MustHaveLengthCopyByValue<T>(this Span<T> parameter, int length, string parameterName = null, string message = null)
         {
             if (parameter.Length != length)
-                Throw.InvalidSpanLength(parameter, length, parameterName, message);
+                Throw.InvalidSpanLength((ReadOnlySpan<T>) parameter, length, parameterName, message);
             return parameter;
         }
 
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
         public static Span<T> MustHaveLengthInParameter<T>(in this Span<T> parameter, int length, string parameterName = null, string message = null)
         {
             if (parameter.Length != length)
-                Throw.InvalidSpanLength(parameter, length, parameterName, message);
+                Throw.InvalidSpanLength((ReadOnlySpan<T>) parameter, length, parameterName, message);
             return parameter;
         }
 
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
         public static ref Span<T> MustHaveLengthInOut<T>(ref this Span<T> parameter, int length, string parameterName = null, string message = null)
         {
             if (parameter.Length != length)
-                Throw.InvalidSpanLength(parameter, length, parameterName, message);
+                Throw.InvalidSpanLength((ReadOnlySpan<T>) parameter, length, parameterName, message);
             return ref parameter;
         }
     }

Code/Light.GuardClauses.Performance/CommonAssertions/InvalidArgumentBenchmark.cs

@@ -1,5 +1,6 @@
 using System;
 using BenchmarkDotNet.Attributes;
+using Light.GuardClauses.ExceptionFactory;
 
 namespace Light.GuardClauses.Performance.CommonAssertions
 {
@@ -34,7 +35,7 @@ public bool LightGuardClausesCustomException()
         public bool LightGuardClausesCustomExceptionManualInlining()
         {
             if (Condition)
-                Exceptions.Throw.CustomException(() => new ArgumentException(Message, ParameterName));
+                Throw.CustomException(() => new ArgumentException(Message, ParameterName));
             return Condition;
         }
 

Code/Light.GuardClauses.Performance/CommonAssertions/MustHaveValueBenchmark.cs

@@ -1,6 +1,7 @@
 using System;
 using System.Runtime.CompilerServices;
 using BenchmarkDotNet.Attributes;
+using Light.GuardClauses.ExceptionFactory;
 using Light.GuardClauses.Exceptions;
 
 namespace Light.GuardClauses.Performance.CommonAssertions

Code/Light.GuardClauses.Performance/CommonAssertions/MustNotBeNullReferenceBenchmark.cs

@@ -1,7 +1,7 @@
 using System;
 using System.Runtime.CompilerServices;
 using BenchmarkDotNet.Attributes;
-using Light.GuardClauses.Exceptions;
+using Light.GuardClauses.ExceptionFactory;
 
 namespace Light.GuardClauses.Performance.CommonAssertions
 {
@@ -56,7 +56,7 @@ public static T MustNotBeNullReferenceV1<T>(this T parameter, string parameterNa
                     return parameter;
 
                 Throw.ArgumentNull(parameterName, message);
-                return default(T);
+                return default;
             }
 
             return parameter;
@@ -71,7 +71,7 @@ public static T MustNotBeNullReferenceV2<T>(this T parameter, string parameterNa
                 return parameter;
 
             Throw.ArgumentNull(parameterName, message);
-            return default(T);
+            return default;
         }
     }
 }

Code/Light.GuardClauses.Performance/ComparableAssertions/MustBeApproximatelyBenchmark.cs

@@ -0,0 +1,25 @@
+using System;
+using BenchmarkDotNet.Attributes;
+
+namespace Light.GuardClauses.Performance.ComparableAssertions;
+
+[MemoryDiagnoser]
+// ReSharper disable once ClassCanBeSealed.Global -- Benchmark.NET derives from this class with dynamically created code
+public class MustBeApproximatelyBenchmark
+{
+    [Benchmark]
+    public double MustBeApproximately() => 5.100001.MustBeApproximately(5.100000, 0.0001);
+
+    [Benchmark(Baseline = true)]
+    public double Imperative() => Imperative(5.100001, 5.100000, 0.0001);
+
+    private static double Imperative(double parameter, double other, double tolerance)
+    {
+        if (Math.Abs(parameter - other) > tolerance)
+        {
+            throw new ArgumentOutOfRangeException(nameof(parameter), $"Value is not approximately {other}");
+        }
+
+        return parameter;
+    }
+}

Code/Light.GuardClauses.Performance/ComparableAssertions/MustNotBeApproximatelyBenchmark.cs

@@ -0,0 +1,25 @@
+using System;
+using BenchmarkDotNet.Attributes;
+
+namespace Light.GuardClauses.Performance.ComparableAssertions;
+
+[MemoryDiagnoser]
+// ReSharper disable once ClassCanBeSealed.Global -- Benchmark.NET derives from this class with dynamically created code
+public class MustNotBeApproximatelyBenchmark
+{
+    [Benchmark]
+    public double MustNotBeApproximately() => 5.2.MustNotBeApproximately(5.1, 0.5);
+
+    [Benchmark(Baseline = true)]
+    public double Imperative() => Imperative(5.2, 5.1, 0.5);
+
+    private static double Imperative(double parameter, double other, double tolerance)
+    {
+        if (Math.Abs(parameter - other) < tolerance)
+        {
+            throw new ArgumentOutOfRangeException(nameof(parameter), $"Value is approximately {other}");
+        }
+
+        return parameter;
+    }
+}

Code/Light.GuardClauses.Performance/Light.GuardClauses.Performance.csproj

@@ -8,7 +8,7 @@
 
     <ItemGroup>
         <ProjectReference Include="..\Light.GuardClauses\Light.GuardClauses.csproj" />
-        <PackageReference Include="BenchmarkDotNet" Version="0.13.9" />
+        <PackageReference Include="BenchmarkDotNet" Version="0.14.0" />
     </ItemGroup>
 
 </Project>

Code/Light.GuardClauses.Performance/Program.cs

@@ -4,18 +4,17 @@
 using BenchmarkDotNet.Jobs;
 using BenchmarkDotNet.Running;
 
-namespace Light.GuardClauses.Performance
+namespace Light.GuardClauses.Performance;
+
+public static class Program
 {
-    public static class Program
-    {
-        private static IConfig DefaultConfiguration =>
-            DefaultConfig
-               .Instance
-               .AddJob(Job.Default.WithRuntime(CoreRuntime.Core70))
-               .AddJob(Job.Default.WithRuntime(ClrRuntime.Net48))
-               .AddDiagnoser(MemoryDiagnoser.Default, new DisassemblyDiagnoser(new DisassemblyDiagnoserConfig()));
+    private static IConfig DefaultConfiguration =>
+        DefaultConfig
+           .Instance
+           .AddJob(Job.Default.WithRuntime(CoreRuntime.Core80))
+           .AddJob(Job.Default.WithRuntime(ClrRuntime.Net48))
+           .AddDiagnoser(MemoryDiagnoser.Default, new DisassemblyDiagnoser(new DisassemblyDiagnoserConfig()));
 
-        public static void Main(string[] arguments) =>
-            BenchmarkSwitcher.FromAssembly(typeof(Program).Assembly).Run(arguments, DefaultConfiguration);
-    }
+    public static void Main(string[] arguments) =>
+        BenchmarkSwitcher.FromAssembly(typeof(Program).Assembly).Run(arguments, DefaultConfiguration);
 }

Code/Light.GuardClauses.Source/Light.GuardClauses.Source.csproj

@@ -5,13 +5,13 @@
         <LangVersion>12.0</LangVersion>
         <Authors>Kenny Pflug</Authors>
         <Company>Kenny Pflug</Company>
-        <Copyright>Copyright © Kenny Pflug 2016 - 2023</Copyright>
+        <Copyright>Copyright © Kenny Pflug 2016, 2025</Copyright>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="System.Memory" Version="4.5.5" />
-        <PackageReference Include="System.Runtime.CompilerServices.Unsafe" Version="6.0.0" />
+        <PackageReference Include="System.Memory" Version="4.6.0" />
+        <PackageReference Include="System.Runtime.CompilerServices.Unsafe" Version="6.1.0" />
     </ItemGroup>
 
 </Project>

Code/Light.GuardClauses.SourceCodeTransformation/Light.GuardClauses.SourceCodeTransformation.csproj

@@ -13,7 +13,7 @@
         <PackageReference Include="Microsoft.Extensions.Configuration.CommandLine" Version="8.0.0" />
         <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="8.0.2" />
         <PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="8.0.1" />
-        <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="4.11.0" />
+        <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="4.13.0" />
     </ItemGroup>
 
     <ItemGroup>