add ArgumentOutOfRangeException extensions

src/Sotsera.Sources.Common/Extensions/Microsoft.Extensions.Primitives/StringValuesExtensions.cs

@@ -10,6 +10,13 @@ namespace Sotsera.Sources.Common.Extensions;
 
 internal static class StringValuesExtensions
 {
+    /// <summary>
+    /// Throws an <see cref="ArgumentException"/> if the provided <see cref="StringValues"/> is empty or composed by only empty values.
+    /// </summary>
+    /// <param name="argument"></param>
+    /// <param name="paramName"></param>
+    /// <returns></returns>
+    /// <exception cref="ArgumentException"></exception>
     public static StringValues ThrowIfEmpty(this StringValues argument, [CallerArgumentExpression(nameof(argument))] string? paramName = null)
     {
         if (argument.Count == 0 || !argument.ToArray().Any(x => x.IsNonEmpty()))
@@ -20,13 +27,23 @@ public static StringValues ThrowIfEmpty(this StringValues argument, [CallerArgum
         return argument;
     }
 
+    /// <summary>
+    /// Determines whether the specified <see cref="StringValues"/> is empty or composed by only empty values.
+    /// </summary>
+    /// <param name="argument"></param>
+    /// <returns></returns>
     public static bool IsEmpty(this StringValues argument)
     {
         var data = argument.ToArray();
 
         return data.Length == 0 || data.All(x => x.IsEmpty());
     }
 
+    /// <summary>
+    /// Determines whether the specified <see cref="StringValues"/> is not empty and contains non-empty values.
+    /// </summary>
+    /// <param name="argument"></param>
+    /// <returns></returns>
     public static bool IsNonEmpty(this StringValues argument)
     {
         var data = argument.ToArray();

src/Sotsera.Sources.Common/Extensions/ThrowExceptionExtensions.cs

@@ -0,0 +1,100 @@
+// Copyright (c) Alessandro Ghidini. All rights reserved.
+// SPDX-License-Identifier: MIT.
+
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.Numerics;
+using System.Runtime.CompilerServices;
+
+namespace Sotsera.Sources.Common.Extensions;
+
+internal static class ThrowExceptionExtensions
+{
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is zero.</summary>
+    /// <param name="value">The argument to validate as non-zero.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfZero<T>(T value, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : INumberBase<T>
+    {
+        ArgumentOutOfRangeException.ThrowIfZero(value, paramName);
+        return value;
+    }
+
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is negative.</summary>
+    /// <param name="value">The argument to validate as non-negative.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfNegative<T>(T value, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : INumberBase<T>
+    {
+        ArgumentOutOfRangeException.ThrowIfNegative(value, paramName);
+        return value;
+    }
+
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is negative or zero.</summary>
+    /// <param name="value">The argument to validate as non-zero or non-negative.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfNegativeOrZero<T>(T value, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : INumberBase<T>
+    {
+        ArgumentOutOfRangeException.ThrowIfNegativeOrZero(value, paramName);
+        return value;
+    }
+
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is equal to <paramref name="other"/>.</summary>
+    /// <param name="value">The argument to validate as not equal to <paramref name="other"/>.</param>
+    /// <param name="other">The value to compare with <paramref name="value"/>.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfEqual<T>(T value, T other, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : IEquatable<T>?
+    {
+        ArgumentOutOfRangeException.ThrowIfEqual(value, other, paramName);
+        return value;
+    }
+
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is not equal to <paramref name="other"/>.</summary>
+    /// <param name="value">The argument to validate as equal to <paramref name="other"/>.</param>
+    /// <param name="other">The value to compare with <paramref name="value"/>.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfNotEqual<T>(T value, T other, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : IEquatable<T>?
+    {
+        ArgumentOutOfRangeException.ThrowIfNotEqual(value, other, paramName);
+        return value;
+    }
+
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is greater than <paramref name="other"/>.</summary>
+    /// <param name="value">The argument to validate as less or equal than <paramref name="other"/>.</param>
+    /// <param name="other">The value to compare with <paramref name="value"/>.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfGreaterThan<T>(T value, T other, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : IComparable<T>
+    {
+        ArgumentOutOfRangeException.ThrowIfGreaterThan(value, other, paramName);
+        return value;
+    }
+
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is greater than or equal <paramref name="other"/>.</summary>
+    /// <param name="value">The argument to validate as less than <paramref name="other"/>.</param>
+    /// <param name="other">The value to compare with <paramref name="value"/>.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfGreaterThanOrEqual<T>(T value, T other, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : IComparable<T>
+    {
+        ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual(value, other, paramName);
+        return value;
+    }
+
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is less than <paramref name="other"/>.</summary>
+    /// <param name="value">The argument to validate as greater than or equal than <paramref name="other"/>.</param>
+    /// <param name="other">The value to compare with <paramref name="value"/>.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfLessThan<T>(T value, T other, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : IComparable<T>
+    {
+        ArgumentOutOfRangeException.ThrowIfLessThan(value, other, paramName);
+        return value;
+    }
+
+    /// <summary>Throws an <see cref="ArgumentOutOfRangeException"/> if <paramref name="value"/> is less than or equal <paramref name="other"/>.</summary>
+    /// <param name="value">The argument to validate as greater than <paramref name="other"/>.</param>
+    /// <param name="other">The value to compare with <paramref name="value"/>.</param>
+    /// <param name="paramName">The name of the parameter with which <paramref name="value"/> corresponds.</param>
+    public static T ThrowIfLessThanOrEqual<T>(T value, T other, [CallerArgumentExpression(nameof(value))] string? paramName = null) where T : IComparable<T>
+    {
+        ArgumentOutOfRangeException.ThrowIfLessThanOrEqual(value, other, paramName);
+        return value;
+    }
+}

src/Sotsera.Sources.Common/Sotsera.Sources.Common.csproj.DotSettings

@@ -1,3 +1,3 @@
-<wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+<wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
 	<s:Boolean x:Key="/Default/CodeInspection/NamespaceProvider/NamespaceFoldersToSkip/=extensions_005Cmicrosoft_002Eextensions_002Eprimitives/@EntryIndexedValue">True</s:Boolean>
 </wpf:ResourceDictionary>