add extension methods

Author: pwelter34

src/MediatR.CommandQuery/Extensions/EnumerableExtensions.cs

@@ -0,0 +1,26 @@
+namespace MediatR.CommandQuery.Extensions;
+
+/// <summary>
+/// Extension methods for <see cref="T:System.Collection.IEnumerable{T}"/>
+/// </summary>
+public static partial class EnumerableExtensions
+{
+    /// <summary>
+    /// Converts an IEnumerable of values to a delimited string.
+    /// </summary>
+    /// <typeparam name="T">The type of objects to delimit.</typeparam>
+    /// <param name="values">The IEnumerable string values to convert.</param>
+    /// <param name="delimiter">The delimiter.</param>
+    /// <returns>A delimited string of the values.</returns>
+    public static string ToDelimitedString<T>(this IEnumerable<T?> values, string? delimiter = ",")
+        => string.Join(delimiter ?? ",", values);
+
+    /// <summary>
+    /// Converts an IEnumerable of values to a delimited string.
+    /// </summary>
+    /// <param name="values">The IEnumerable string values to convert.</param>
+    /// <param name="delimiter">The delimiter.</param>
+    /// <returns>A delimited string of the values.</returns>
+    public static string ToDelimitedString(this IEnumerable<string?> values, string? delimiter = ",")
+        => string.Join(delimiter ?? ",", values);
+}

src/MediatR.CommandQuery/Extensions/RandomExtensions.cs

@@ -0,0 +1,24 @@
+namespace MediatR.CommandQuery.Extensions;
+
+/// <summary>
+/// <see cref="Random"/> type extension methods
+/// </summary>
+public static class RandomExtensions
+{
+    private const string _chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+
+    /// <summary>
+    /// Generated random alphanumeric string with the specified length.
+    /// </summary>
+    /// <param name="random">The random instance to use.</param>
+    /// <param name="length">The length of the alphanumeric string to generate.</param>
+    /// <returns>A random alphanumeric string with the specified length.</returns>
+    public static string Alphanumeric(this Random random, int length)
+    {
+        Span<char> result = stackalloc char[length];
+        for (int i = 0; i < length; i++)
+            result[i] = _chars[random.Next(_chars.Length)];
+
+        return new string(result);
+    }
+}

src/MediatR.CommandQuery/Extensions/StringExtensions.cs

@@ -1,12 +1,87 @@
 using System.Diagnostics.CodeAnalysis;
+using System.Text;
+using System.Text.RegularExpressions;
 
 namespace MediatR.CommandQuery.Extensions;
 
 /// <summary>
 /// <see cref="String"/> type extension methods
 /// </summary>
-public static class StringExtensions
+public static partial class StringExtensions
 {
+    [GeneratedRegex("([A-Z][a-z]*)|([0-9]+)", RegexOptions.ExplicitCapture, matchTimeoutMilliseconds: 1000)]
+    private static partial Regex WordsExpression();
+
+    /// <summary>
+    /// Truncates the specified text.
+    /// </summary>
+    /// <param name="text">The text to truncate.</param>
+    /// <param name="keep">The number of characters to keep.</param>
+    /// <param name="ellipsis">The ellipsis string to use when truncating. (Default ...)</param>
+    /// <returns>
+    /// A truncate string.
+    /// </returns>
+    [return: NotNullIfNotNull(nameof(text))]
+    public static string? Truncate(this string? text, int keep, string ellipsis = "...")
+    {
+        if (string.IsNullOrEmpty(text))
+            return text;
+
+        if (text!.Length <= keep)
+            return text;
+
+        ellipsis ??= string.Empty;
+
+        if (text.Length <= keep + ellipsis.Length || keep < ellipsis.Length)
+            return text[..keep];
+
+        int prefix = keep - ellipsis.Length;
+        return string.Concat(text[..prefix], ellipsis);
+    }
+
+    /// <summary>
+    /// Indicates whether the specified String object is null or an empty string
+    /// </summary>
+    /// <param name="item">A String reference</param>
+    /// <returns>
+    ///     <c>true</c> if is null or empty; otherwise, <c>false</c>.
+    /// </returns>
+    public static bool IsNullOrEmpty([NotNullWhen(false)] this string? item)
+    {
+        return string.IsNullOrEmpty(item);
+    }
+
+    /// <summary>
+    /// Indicates whether a specified string is null, empty, or consists only of white-space characters
+    /// </summary>
+    /// <param name="item">A String reference</param>
+    /// <returns>
+    ///      <c>true</c> if is null or empty; otherwise, <c>false</c>.
+    /// </returns>
+    public static bool IsNullOrWhiteSpace([NotNullWhen(false)] this string? item)
+    {
+        if (item == null)
+            return true;
+
+        for (int i = 0; i < item.Length; i++)
+            if (!char.IsWhiteSpace(item[i]))
+                return false;
+
+        return true;
+    }
+
+    /// <summary>
+    /// Determines whether the specified string is not <see cref="IsNullOrEmpty"/>.
+    /// </summary>
+    /// <param name="value">The value to check.</param>
+    /// <returns>
+    ///   <c>true</c> if the specified <paramref name="value"/> is not <see cref="IsNullOrEmpty"/>; otherwise, <c>false</c>.
+    /// </returns>
+    public static bool HasValue([NotNullWhen(true)] this string? value)
+    {
+        return !string.IsNullOrEmpty(value);
+    }
+
     /// <summary>
     /// Combines two strings with the specified separator.
     /// </summary>
@@ -30,4 +105,29 @@ public static class StringExtensions
             ? string.Concat(first, second)
             : $"{first}{separator}{second}";
     }
+
+    /// <summary>
+    /// Converts a NameIdentifier and spaces it out into words "Name Identifier".
+    /// </summary>
+    /// <param name="text">The text value to convert.</param>
+    /// <returns>The text converted</returns>
+    [return: NotNullIfNotNull(nameof(text))]
+    public static string? ToTitle(this string? text)
+    {
+        if (text.IsNullOrEmpty() || text.Length < 2)
+            return text;
+
+        var words = WordsExpression().Matches(text);
+
+        var builder = new StringBuilder();
+        foreach (Match word in words)
+        {
+            if (builder.Length > 0)
+                builder.Append(' ');
+
+            builder.Append(word.Value);
+        }
+
+        return builder.ToString();
+    }
 }

src/MediatR.CommandQuery/Extensions/TypeExtensions.cs

@@ -10,7 +10,7 @@ public static class TypeExtensions
     /// </summary>
     /// <typeparam name="TInterface">The type of the interface.</typeparam>
     /// <param name="type">The type to check.</param>
-    /// <returns><c>true</c> if type implements the interface; otherwise <c>false</c></returns>
+    /// <returns><see langword="true"/> if type implements the interface; otherwise <see langword="false"/></returns>
     /// <exception cref="InvalidOperationException">Only interfaces can be implemented.</exception>
     public static bool Implements<TInterface>(this Type type)
         where TInterface : class