feat: use keyset pagination by default for `all=True`

2 files changed, 11 insertions, 0 deletions

diff --git a/docs/api-usage.rst b/docs/api-usage.rst
index dc88684..3e2355c 100644
--- a/docs/api-usage.rst
+++ b/docs/api-usage.rst
@@ -204,6 +204,11 @@ listing methods support the ``page`` and ``per_page`` parameters:
 By default GitLab does not return the complete list of items. Use the ``all``
 parameter to get all the items when using listing methods:
 
+.. warning::
+
+   The all=True option uses keyset pagination by default, if order_by="id"
+   or if order_by is not supplied.
+
 .. code-block:: python
 
    all_groups = gl.groups.list(all=True)
diff --git a/gitlab/__init__.py b/gitlab/__init__.py
index c9716c2..b4adacf 100644
--- a/gitlab/__init__.py
+++ b/gitlab/__init__.py
@@ -640,6 +640,12 @@ class Gitlab(object):
         get_all = kwargs.pop("all", False)
         url = self._build_url(path)
 
+        # use keyset pagination automatically, if all=True
+        order_by = kwargs.get("order_by")
+        if get_all and (not order_by or order_by == "id"):
+            kwargs["pagination"] = "keyset"
+            kwargs["order_by"] = "id"
+
         if get_all is True and as_list is True:
             return list(GitlabList(self, url, query_data, **kwargs))