feat: QueryKitParsingException exception support

Author: pdevito3

QueryKit/Exceptions/QueryKitParsingException.cs

@@ -0,0 +1,9 @@
+namespace QueryKit.Exceptions;
+
+public sealed class QueryKitParsingException : Exception
+{
+    public QueryKitParsingException(string message) 
+        : base(message)
+    {
+    }
+}

QueryKit/Operators/ComparisonOperator.cs

@@ -63,7 +63,7 @@ public static ComparisonOperator GetByOperatorString(string op, bool caseInsensi
         var comparisonOperator = List.FirstOrDefault(x => x.Operator() == op);
         if (comparisonOperator == null)
         {
-            throw new Exception($"Operator {op} is not supported");
+            throw new QueryKitParsingException($"Operator {op} is not supported");
         }
 
         ComparisonOperator? newOperator = null;
@@ -162,7 +162,7 @@ public static ComparisonOperator GetByOperatorString(string op, bool caseInsensi
         }
 
         return newOperator == null 
-            ? throw new Exception($"Operator {op} is not supported")
+            ? throw new QueryKitParsingException($"Operator {op} is not supported")
             : newOperator!;
     }
 
@@ -658,7 +658,7 @@ public override Expression GetExpression<T>(Expression left, Expression right, T
                 return GetCollectionExpression(left, right, Expression.Equal, UsesAll);
             }
 
-            throw new Exception("DoesNotHaveType is only supported for collections");
+            throw new QueryKitParsingException("DoesNotHaveType is only supported for collections");
         }
     }
 
@@ -680,7 +680,7 @@ public override Expression GetExpression<T>(Expression left, Expression right, T
                 return GetCollectionExpression(left, right, Expression.NotEqual, UsesAll);
             }
 
-            throw new Exception("DoesNotHaveType is only supported for collections");
+            throw new QueryKitParsingException("DoesNotHaveType is only supported for collections");
         }
     }
 
@@ -862,22 +862,22 @@ private Expression GetCountExpression(Expression left, Expression right, string
         var leftAsEnumerableType = left.Type.GetInterface(nameof(IEnumerable));
         if (leftAsEnumerableType == null)
         {
-            throw new Exception("Left expression should be of type IEnumerable<T>");
+            throw new QueryKitParsingException("Left expression should be of type IEnumerable<T>");
         }
 
         var leftGenericType = left.Type.GetGenericArguments()[0];
         var rightType = right.Type;
 
         if (rightType != typeof(int))
         {
-            throw new Exception("The right expression should be of type int");
+            throw new QueryKitParsingException("The right expression should be of type int");
         }
         var countMethod = typeof(Enumerable).GetMethods(BindingFlags.Public | BindingFlags.Static)
             .FirstOrDefault(m => m.Name == "Count" && m.GetParameters().Length == 1
                                                    && m.GetParameters()[0].ParameterType.GetGenericTypeDefinition() == typeof(IEnumerable<>));
         if (countMethod == null)
         {
-            throw new Exception("Count method not found");
+            throw new QueryKitParsingException("Count method not found");
         }
 
         var specificCountMethod = countMethod.MakeGenericMethod(leftGenericType);
@@ -886,10 +886,9 @@ private Expression GetCountExpression(Expression left, Expression right, string
         var comparisonMethod = typeof(Expression).GetMethod(methodName, new[] { typeof(Expression), typeof(Expression) });
         if (comparisonMethod == null)
         {
-            throw new Exception($"Comparison method '{methodName}' not found");
+            throw new QueryKitParsingException($"Comparison method '{methodName}' not found");
         }
 
-        // Invoke the comparison method
         return (Expression)comparisonMethod.Invoke(null, new object[] { countExpression, right });
     }
 }

README.md

@@ -402,6 +402,7 @@ If you want to capture errors to easily throw a `400`, you can add error handlin
 * A `SortParsingException` will be thrown if a property or operation is not recognized during sorting
 * A `QueryKitDbContextTypeException` will be thrown when trying to use a `DbContext` specific workflow without passing that context (e.g. SoundEx)
 * A `SoundsLikeNotImplementedException` will be thrown when trying to use `soundex` on a `DbContext` that doesn't have it implemented.
+* A `QueryKitParsingException` is a more generic error that will include specific details on a more granular error in the parsing pipeline.
 
 ## SoundEx