feat(generator): add upkeep quantity parser (6b)

Author: HandyS11

tests/RustPlusBot.ItemData.Generator.Tests/UpkeepQuantityTests.cs

@@ -0,0 +1,48 @@
+using RustPlusBot.ItemData.Generator.Sources;
+
+namespace RustPlusBot.ItemData.Generator.Tests;
+
+public sealed class UpkeepQuantityTests
+{
+    [Fact]
+    public void Single_value_parses_to_equal_min_max()
+    {
+        var (min, max) = UpkeepQuantity.Parse("1");
+        Assert.Equal(1, min);
+        Assert.Equal(1, max);
+    }
+
+    [Fact]
+    public void EnDash_range_parses_min_and_max()
+    {
+        var (min, max) = UpkeepQuantity.Parse("8–25"); // 8–25
+        Assert.Equal(8, min);
+        Assert.Equal(25, max);
+    }
+
+    [Fact]
+    public void Hyphen_range_parses_min_and_max()
+    {
+        var (min, max) = UpkeepQuantity.Parse("20-67");
+        Assert.Equal(20, min);
+        Assert.Equal(67, max);
+    }
+
+    [Fact]
+    public void Whitespace_is_trimmed()
+    {
+        var (min, max) = UpkeepQuantity.Parse("  5–17 ");
+        Assert.Equal(5, min);
+        Assert.Equal(17, max);
+    }
+
+    [Theory]
+    [InlineData("")]
+    [InlineData("lots")]
+    [InlineData("8–")]
+    [InlineData("a–b")]
+    public void Unparseable_throws(string raw)
+    {
+        Assert.Throws<FormatException>(() => UpkeepQuantity.Parse(raw));
+    }
+}

tools/RustPlusBot.ItemData.Generator/Sources/UpkeepQuantity.cs

@@ -0,0 +1,27 @@
+using System.Globalization;
+
+namespace RustPlusBot.ItemData.Generator.Sources;
+
+/// <summary>Parses a RustLabs upkeep quantity string (e.g. <c>"1"</c> or <c>"8–25"</c>).</summary>
+internal static class UpkeepQuantity
+{
+    /// <summary>Parses <paramref name="raw"/> into a (min, max) pair. A single value yields min == max.</summary>
+    /// <param name="raw">The quantity string: a number or an en-dash/hyphen range.</param>
+    /// <returns>The parsed lower and upper bounds.</returns>
+    /// <exception cref="FormatException">The string is neither a number nor a number range.</exception>
+    public static (int Min, int Max) Parse(string raw)
+    {
+        ArgumentNullException.ThrowIfNull(raw);
+        var trimmed = raw.Trim();
+        var dash = trimmed.IndexOfAny(['–', '-']);
+        if (dash < 0)
+        {
+            var single = int.Parse(trimmed, CultureInfo.InvariantCulture);
+            return (single, single);
+        }
+
+        var min = int.Parse(trimmed[..dash], CultureInfo.InvariantCulture);
+        var max = int.Parse(trimmed[(dash + 1)..], CultureInfo.InvariantCulture);
+        return (min, max);
+    }
+}