fix(operators)!: throw QueryKitParsingException for an unknown logical operator

LogicalOperator.GetByOperatorString threw System.Exception for an operator that it does not know. It now throws QueryKitParsingException with the same message. QueryKitParsingException derives from QueryKitException.

BREAKING CHANGE: an unknown logical operator throws QueryKitParsingException, not System.Exception. Catch QueryKitParsingException or QueryKitException instead.

Author: pdevito3

QueryKit.UnitTests/FilterParsingRegressionTests.cs

@@ -317,6 +317,14 @@ public void has_returns_matching_rows(string input, string[] expectedTitles)
         result.Select(x => x.Title).Should().BeEquivalentTo(expectedTitles);
     }
 
+    [Fact]
+    public void unknown_logical_operator_throws_query_kit_parsing_exception()
+    {
+        var act = () => LogicalOperator.GetByOperatorString("xor");
+
+        act.Should().Throw<QueryKitParsingException>().WithMessage("Operator xor is not supported");
+    }
+
     private static TResult WithCulture<TResult>(string cultureName, Func<TResult> action)
     {
         var originalCulture = CultureInfo.CurrentCulture;

QueryKit/Operators/LogicalOperator.cs

@@ -3,6 +3,7 @@ namespace QueryKit.Operators;
 using System.Linq.Expressions;
 using Ardalis.SmartEnum;
 using Configuration;
+using Exceptions;
 
 public abstract class LogicalOperator : SmartEnum<LogicalOperator>
 {
@@ -15,7 +16,7 @@ public static LogicalOperator GetByOperatorString(string op)
         var logicalOperator = List.FirstOrDefault(x => x.Operator() == op);
         if (logicalOperator == null)
         {
-            throw new Exception($"Operator {op} is not supported");
+            throw new QueryKitParsingException($"Operator {op} is not supported");
         }
         return logicalOperator;
     }