From 369879b01982bdbf6a2773e947a3c3526c12880f Mon Sep 17 00:00:00 2001
From: Steve Smith <steve@kentsmiths.com>
Date: Fri, 22 Dec 2023 23:12:30 -0500
Subject: [PATCH] StringTooShort with tests

---
 .../GuardAgainstStringLengthExtensions.cs     | 39 ++++++++++++++++
 .../GuardAgainstStringTooShort.cs             | 45 +++++++++++++++++++
 2 files changed, 84 insertions(+)
 create mode 100644 src/GuardClauses/GuardAgainstStringLengthExtensions.cs
 create mode 100644 test/GuardClauses.UnitTests/GuardAgainstStringTooShort.cs

diff --git a/src/GuardClauses/GuardAgainstStringLengthExtensions.cs b/src/GuardClauses/GuardAgainstStringLengthExtensions.cs
new file mode 100644
index 0000000..bd8ae84
--- /dev/null
+++ b/src/GuardClauses/GuardAgainstStringLengthExtensions.cs
@@ -0,0 +1,39 @@
+using System;
+using System.Runtime.CompilerServices;
+using Ardalis.GuardClauses;
+
+namespace GuardClauses;
+public static partial class GuardClauseExtensions
+{
+    /// <summary>
+    /// Throws an <see cref="ArgumentException" /> if string <paramref name="input"/> is too short.
+    /// </summary>
+    /// <param name="guardClause"></param>
+    /// <param name="input"></param>
+    /// <param name="minLength"></param>
+    /// <param name="parameterName"></param>
+    /// <param name="message">Optional. Custom error message</param>
+    /// <returns><paramref name="input" /> if the value is not negative.</returns>
+    /// <exception cref="ArgumentException"></exception>
+#if NETFRAMEWORK || NETSTANDARD2_0
+    public static string StringTooShort(this IGuardClause guardClause,
+        string input,
+        int minLength,
+        string parameterName,
+        string? message = null)
+#else
+    public static string StringTooShort(this IGuardClause guardClause,
+        string input,
+        int minLength,
+        [CallerArgumentExpression("input")] string? parameterName = null,
+        string? message = null)
+#endif
+    {
+        Guard.Against.NegativeOrZero(minLength, nameof(minLength));
+        if (input.Length < minLength)
+        {
+            throw new ArgumentException(message ?? $"Input {parameterName} with length {input.Length} is too short. Minimum length is {minLength}.", parameterName);
+        }
+        return input;
+    }
+}
diff --git a/test/GuardClauses.UnitTests/GuardAgainstStringTooShort.cs b/test/GuardClauses.UnitTests/GuardAgainstStringTooShort.cs
new file mode 100644
index 0000000..959e274
--- /dev/null
+++ b/test/GuardClauses.UnitTests/GuardAgainstStringTooShort.cs
@@ -0,0 +1,45 @@
+using System;
+using Ardalis.GuardClauses;
+using Xunit;
+
+namespace GuardClauses.UnitTests;
+
+public class GuardAgainstStringTooShort
+{
+    [Fact]
+    public void DoesNothingGivenNonEmptyString()
+    {
+        Guard.Against.StringTooShort("a", 1, "string");
+        Guard.Against.StringTooShort("abc", 1, "string");
+        Guard.Against.StringTooShort("a", 1, "string");
+        Guard.Against.StringTooShort("a", 1, "string");
+        Guard.Against.StringTooShort("a", 1, "string");
+    }
+
+    [Fact]
+    public void ThrowsGivenEmptyString()
+    {
+        Assert.Throws<ArgumentException>(() => Guard.Against.StringTooShort("", 1, "string"));
+    }
+
+    [Fact]
+    public void ThrowsGivenNonPositiveMinLength()
+    {
+        Assert.Throws<ArgumentException>(() => Guard.Against.StringTooShort("", 0, "string"));
+        Assert.Throws<ArgumentException>(() => Guard.Against.StringTooShort("", -1, "string"));
+    }
+
+    [Fact]
+    public void ThrowsGivenStringShorterThanMinLength()
+    {
+        Assert.Throws<ArgumentException>(() => Guard.Against.StringTooShort("a", 2, "string"));
+    }
+
+    [Fact]
+    public void ReturnsExpectedValueWhenGivenLongerString()
+    {
+        var expected = "abc";
+        var actual = Guard.Against.StringTooShort("abc", 2, "string");
+        Assert.Equal(expected, actual);
+    }
+}