Add Random Filter

Fluid.Tests/NumberFiltersTests.cs

@@ -1,6 +1,7 @@
 using Fluid.Values;
 using Fluid.Filters;
 using Xunit;
+using System;
 
 namespace Fluid.Tests
 {
@@ -247,5 +248,35 @@ public void TimesMaintainsScale()
             Assert.Equal(6, result.Result.ToNumberValue());
             Assert.Equal("6.0", result.Result.ToStringValue());
         }
+
+        [Theory]
+        [InlineData(1, 10)]
+        [InlineData(-10, -1)]
+        public void Random(decimal min, decimal max)
+        {
+            var input = NumberValue.Create(0);
+
+            var arguments = new FilterArguments([NumberValue.Create(min), NumberValue.Create(max)]);
+            var context = new TemplateContext();
+
+            var result = NumberFilters.Random(input, arguments, context);
+
+            Assert.InRange(result.Result.ToNumberValue(), min, max);
+        }
+
+        [Theory]
+        [InlineData(10, 1)]
+        [InlineData(-1, -10)]
+        public void Random_ThrowsException_IfMinimumIsGreaterThanMaximum(decimal min, decimal max)
+        {
+            var input = NumberValue.Create(0);
+
+            var arguments = new FilterArguments([NumberValue.Create(min), NumberValue.Create(max)]);
+            var context = new TemplateContext();
+
+            var exception = Assert.Throws<ArgumentOutOfRangeException>(() => NumberFilters.Random(input, arguments, context));
+
+            Assert.Equal("'minValue' cannot be greater than maxValue. (Parameter 'minValue')", exception.Message);
+        }
     }
 }

Fluid/Filters/NumberFilters.cs

@@ -17,6 +17,7 @@ public static FilterCollection WithNumberFilters(this FilterCollection filters)
             filters.AddFilter("plus", Plus);
             filters.AddFilter("round", Round);
             filters.AddFilter("times", Times);
+            filters.AddFilter("random", Random);
 
             return filters;
         }
@@ -158,5 +159,18 @@ public static ValueTask<FluidValue> Times(FluidValue input, FilterArguments argu
 
             return NumberValue.Create(input.ToNumberValue() * first.ToNumberValue());
         }
+
+        public static ValueTask<FluidValue> Random(FluidValue input, FilterArguments arguments, TemplateContext context)
+        {
+            LiquidException.ThrowFilterArgumentsCount("random", expected: 2, arguments);
+
+            var min = arguments.At(0).ToNumberValue();
+            var max = arguments.At(1).ToNumberValue();
+
+            var random = new Random();
+            var value = random.Next((int)min, (int)max + 1);
+
+            return NumberValue.Create(value);
+        }
     }
 }