feat: add MatchAttributeFilter to ExecutionContext

This reflects the filter type recently added on the backend.

JIRA: CQ-2005
risk: low

Author: no23reason

packages/gooddata-flexconnect/json_schemas/execution-context/filter.json

@@ -59,6 +59,44 @@
                 "values"
             ]
         },
+        {
+            "type": "object",
+            "description": "Filter for matching label values using a literal string pattern.",
+            "properties": {
+                "filterType": {
+                    "const": "matchAttributeFilter"
+                },
+                "labelIdentifier": {
+                    "type": "string",
+                    "description": "Identifier of the label used."
+                },
+                "matchType": {
+                    "type": "string",
+                    "enum": ["CONTAINS", "STARTS_WITH", "ENDS_WITH"],
+                    "description": "The type of string match to apply."
+                },
+                "literal": {
+                    "type": "string",
+                    "description": "The literal value to match against."
+                },
+                "negate": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Whether to negate the match."
+                },
+                "caseSensitive": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Whether the match is case-sensitive."
+                }
+            },
+            "required": [
+                "filterType",
+                "labelIdentifier",
+                "matchType",
+                "literal"
+            ]
+        },
         {
             "type": "object",
             "description": "Filter for relative date ranges.",

packages/gooddata-flexconnect/src/gooddata_flexconnect/__init__.py

@@ -11,6 +11,7 @@
     ExecutionContextAttribute,
     ExecutionContextAttributeSorting,
     ExecutionContextFilter,
+    ExecutionContextMatchAttributeFilter,
     ExecutionContextNegativeAttributeFilter,
     ExecutionContextPositiveAttributeFilter,
     ExecutionContextRelativeDateFilter,

packages/gooddata-flexconnect/src/gooddata_flexconnect/function/execution_context.py

@@ -176,6 +176,38 @@ class ExecutionContextNegativeAttributeFilter:
     """
 
 
+@dataclass
+class ExecutionContextMatchAttributeFilter:
+    """
+    Information about the match attribute filter.
+    """
+
+    label_identifier: str
+    """
+    Identifier of the label used.
+    """
+
+    literal: str
+    """
+    Value to filter by.
+    """
+
+    match_type: str
+    """
+    Match type of the filter.
+    """
+
+    negate: bool
+    """
+    Whether the filter should keep values NOT matching the literal.
+    """
+
+    case_sensitive: bool
+    """
+    Whether the matching should be made in a case-sensitive way.
+    """
+
+
 @dataclass
 class ExecutionContextRelativeDateFilter:
     """
@@ -228,6 +260,7 @@ class ExecutionContextAbsoluteDateFilter:
 ExecutionContextFilter: TypeAlias = Union[
     ExecutionContextPositiveAttributeFilter,
     ExecutionContextNegativeAttributeFilter,
+    ExecutionContextMatchAttributeFilter,
     ExecutionContextRelativeDateFilter,
     ExecutionContextAbsoluteDateFilter,
 ]
@@ -564,6 +597,15 @@ def _dict_to_filter(d: dict) -> ExecutionContextFilter:
     if filter_type == "negativeAttributeFilter":
         return ExecutionContextNegativeAttributeFilter(label_identifier=d["labelIdentifier"], values=d["values"])
 
+    if filter_type == "matchAttributeFilter":
+        return ExecutionContextMatchAttributeFilter(
+            label_identifier=d["labelIdentifier"],
+            literal=d["literal"],
+            match_type=d["matchType"],
+            negate=d.get("negate", False),
+            case_sensitive=d.get("caseSensitive", False),
+        )
+
     if filter_type == "relativeDateFilter":
         return ExecutionContextRelativeDateFilter(
             dataset_identifier=d["datasetIdentifier"],

packages/gooddata-flexconnect/tests/json_schemas/test_filter_schema.py

@@ -16,6 +16,12 @@
             "labelIdentifier": "attribute1",
             "values": ["id1", "id2", "id3", None],
         },
+        {
+            "filterType": "matchAttributeFilter",
+            "labelIdentifier": "attribute1",
+            "literal": "foo",
+            "matchType": "CONTAINS",
+        },
         {
             "filterType": "relativeDateFilter",
             "from": -5,
@@ -42,6 +48,15 @@ def test_valid_filter_schema(value, get_validator):
         {"filterType": "negativeAttributeFilter", "labelIdentifier": "attribute1"},  # missing values
         {"filterType": "relativeDateFilter", "from": -5, "to": 0, "granularity": "DAY"},  # missing datasetIdentifier
         {"filterType": "absoluteDateFilter", "from": "2021-01-01", "to": "2021-12-31"},  # missing datasetIdentifier
+        # missing match type
+        {"filterType": "matchAttributeFilter", "labelIdentifier": "attribute1", "literal": "foo"},
+        # invalid match type
+        {
+            "filterType": "matchAttributeFilter",
+            "labelIdentifier": "attribute1",
+            "literal": "foo",
+            "matchType": "INVALID",
+        },
     ],
 )
 def test_invalid_filter_schema(value, get_validator):