feat: Added additional parameter to project/group iteration search

Cristiano Casella · Cristiano Casella · commit 0e44648f875d · 2024-02-12T09:54:59.000+01:00
diff --git a/docs/gl_objects/iterations.rst b/docs/gl_objects/iterations.rst
@@ -31,3 +31,13 @@ List iterations for a project's ancestor groups::
 List iterations for a group::
 
     iterations = group.iterations.list()
+
+Unavailable filters or filters conflicts::
+    
+    In case you are trying to pass a parameter that is not supported or
+    collides with a python keyword (i.e. `in`) you have to use the
+    `query_parameters` argument:
+
+    ```
+    group.iterations.list(query_parameters={"in": "title"}) 
+    ```
diff --git a/gitlab/v4/objects/iterations.py b/gitlab/v4/objects/iterations.py
@@ -16,11 +16,31 @@ class GroupIterationManager(ListMixin, RESTManager):
     _path = "/groups/{group_id}/iterations"
     _obj_cls = GroupIteration
     _from_parent_attrs = {"group_id": "id"}
-    _list_filters = ("state", "search", "include_ancestors")
+    # The "in" keyword collides with python's "in" keyword raising a SyntaxError.
+    # For this reason, we have to use the query_parameters argument:
+    # group.iterations.list(query_parameters={"in": "title"})
+    _list_filters = (
+        "include_ancestors",
+        "include_descendants",
+        "search",
+        "state",
+        "updated_after",
+        "updated_before",
+    )
 
 
 class ProjectIterationManager(ListMixin, RESTManager):
     _path = "/projects/{project_id}/iterations"
     _obj_cls = GroupIteration
     _from_parent_attrs = {"project_id": "id"}
-    _list_filters = ("state", "search", "include_ancestors")
+    # The "in" keyword collides with python's "in" keyword raising a SyntaxError.
+    # For this reason, we have to use the query_parameters argument:
+    # group.iterations.list(query_parameters={"in": "title"})
+    _list_filters = (
+        "include_ancestors",
+        "include_descendants",
+        "search",
+        "state",
+        "updated_after",
+        "updated_before",
+    )
