Merge pull request #1234 from json-api-dotnet/allow-single-constant-in-any-function

Allow at least one constant instead of two in any() filter function

Author: maurei

Diff for: docs/usage/reading/filtering.md

@@ -196,7 +196,7 @@ matchTextExpression:
     ( 'contains' | 'startsWith' | 'endsWith' ) LPAREN fieldChain COMMA literalConstant RPAREN;
 
 anyExpression:
-    'any' LPAREN fieldChain COMMA literalConstant ( COMMA literalConstant )+ RPAREN;
+    'any' LPAREN fieldChain ( COMMA literalConstant )+ RPAREN;
 
 hasExpression:
     'has' LPAREN fieldChain ( COMMA filterExpression )? RPAREN;

Diff for: src/JsonApiDotNetCore/Queries/Expressions/AnyExpression.cs

@@ -17,12 +17,7 @@ public class AnyExpression : FilterExpression
     public AnyExpression(ResourceFieldChainExpression targetAttribute, IImmutableSet<LiteralConstantExpression> constants)
     {
         ArgumentGuard.NotNull(targetAttribute);
-        ArgumentGuard.NotNull(constants);
-
-        if (constants.Count < 2)
-        {
-            throw new ArgumentException("At least two constants are required.", nameof(constants));
-        }
+        ArgumentGuard.NotNullNorEmpty(constants);
 
         TargetAttribute = targetAttribute;
         Constants = constants;

Diff for: src/JsonApiDotNetCore/Queries/Internal/Parsing/FilterParser.cs

@@ -199,11 +199,6 @@ protected AnyExpression ParseAny()
         LiteralConstantExpression constant = ParseConstant();
         constantsBuilder.Add(constant);
 
-        EatSingleCharacterToken(TokenKind.Comma);
-
-        constant = ParseConstant();
-        constantsBuilder.Add(constant);
-
         while (TokenStack.TryPeek(out Token? nextToken) && nextToken.Kind == TokenKind.Comma)
         {
             EatSingleCharacterToken(TokenKind.Comma);

Diff for: test/JsonApiDotNetCoreTests/IntegrationTests/QueryStrings/Filtering/FilterOperatorTests.cs

@@ -466,6 +466,7 @@ await _testContext.RunOnDatabaseAsync(async dbContext =>
     }
 
     [Theory]
+    [InlineData("yes", "no", "'yes'")]
     [InlineData("two", "one two", "'one','two','three'")]
     [InlineData("two", "nine", "'one','two','three','four','five'")]
     public async Task Can_filter_in_set(string matchingText, string nonMatchingText, string filterText)

Diff for: test/JsonApiDotNetCoreTests/UnitTests/QueryStringParameters/FilterParseTests.cs

@@ -86,7 +86,7 @@ public void Reader_Is_Enabled(JsonApiQueryStringParameters parametersDisabled, b
     [InlineData("filter", "any(null,'a','b')", "Attribute 'null' does not exist on resource type 'blogs'.")]
     [InlineData("filter", "any('a','b','c')", "Field name expected.")]
     [InlineData("filter", "any(title,'b','c',)", "Value between quotes expected.")]
-    [InlineData("filter", "any(title,'b')", ", expected.")]
+    [InlineData("filter", "any(title)", ", expected.")]
     [InlineData("filter[posts]", "any(author,'a','b')", "Attribute 'author' does not exist on resource type 'blogPosts'.")]
     [InlineData("filter", "and(", "Filter function expected.")]
     [InlineData("filter", "or(equals(title,'some'),equals(title,'other')", ") expected.")]
@@ -146,6 +146,7 @@ public void Reader_Read_Fails(string parameterName, string parameterValue, strin
     [InlineData("filter", "contains(title,'this')", null, "contains(title,'this')")]
     [InlineData("filter", "startsWith(title,'this')", null, "startsWith(title,'this')")]
     [InlineData("filter", "endsWith(title,'this')", null, "endsWith(title,'this')")]
+    [InlineData("filter", "any(title,'this')", null, "any(title,'this')")]
     [InlineData("filter", "any(title,'this','that','there')", null, "any(title,'that','there','this')")]
     [InlineData("filter", "and(contains(title,'sales'),contains(title,'marketing'),contains(title,'advertising'))", null,
         "and(contains(title,'sales'),contains(title,'marketing'),contains(title,'advertising'))")]