chore: correct type-hints for per_page attrbute

JohnVillalovos · JohnVillalovos · commit 447cac5b23ae · 2022-02-03T17:28:11.000-08:00
There are occasions where a GitLab `list()` call does not return the
`x-per-page` header. For example the listing of custom attributes.

Update the type-hints to reflect that.
diff --git a/gitlab/base.py b/gitlab/base.py
@@ -302,7 +302,7 @@ def next_page(self) -> Optional[int]:
         return self._list.next_page
 
     @property
-    def per_page(self) -> int:
+    def per_page(self) -> Optional[int]:
         """The number of items per page."""
         return self._list.per_page
 
diff --git a/gitlab/client.py b/gitlab/client.py
@@ -1039,10 +1039,10 @@ def next_page(self) -> Optional[int]:
         return int(self._next_page) if self._next_page else None
 
     @property
-    def per_page(self) -> int:
+    def per_page(self) -> Optional[int]:
         """The number of items per page."""
-        if TYPE_CHECKING:
-            assert self._per_page is not None
+        if self._per_page is None:
+            return None
         return int(self._per_page)
 
     # NOTE(jlvillal): When a query returns more than 10,000 items, GitLab doesn't return
