chore: add bulk methods for get_suites and get_users (#119)

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>

Author: dsayling

testrail_api/_category.py

@@ -1970,6 +1970,22 @@ def get_suites(self, project_id: int, offset: Optional[int] = None, limit: Optio
         """
         return self.s.get(endpoint=f"get_suites/{project_id}", params=self._opt({"offset": offset, "limit": limit}))
 
+    def get_suites_bulk(self, project_id: int, **kwargs) -> list[dict]:
+        """
+        Return a list of test suites for a project with pagination.
+
+        :param project_id:
+            The ID of the project
+        :param kwargs:
+            :key offset: int
+                Where to start counting the suites from (the offset)
+            :key limit: int
+                The number of suites the response should return
+        :return: List of test suites
+        :returns: list[dict]
+        """
+        return _bulk_api_method(self.get_suites, "suites", project_id, **kwargs)
+
     def add_suite(self, project_id: int, name: str, **kwargs) -> dict:
         """
         Creates a new test suite.
@@ -2143,6 +2159,23 @@ def get_users(
             params=self._opt({"offset": offset, "limit": limit}),
         )
 
+    def get_users_bulk(self, project_id: Optional[int] = None, **kwargs) -> list[dict]:
+        """
+        Return a list of users with pagination.
+
+        :param project_id:
+            The ID of the project for which you would like to retrieve user information.
+            (Required for non-administrators. Requires TestRail 6.6 or later.)
+        :param kwargs:
+            :key offset: int
+                Where to start counting the users from (the offset)
+            :key limit: int
+                The number of users the response should return
+        :return: List of users
+        :returns: list[dict]
+        """
+        return _bulk_api_method(self.get_users, "users", project_id, **kwargs)
+
 
 class SharedSteps(_MetaCategory):
     """https://www.gurock.com/testrail/docs/api/reference/api-shared-steps."""

tests/test_suites.py

@@ -45,6 +45,13 @@ def test_get_suites(api, mock, url, offset, limit):
     assert resp["suites"][1]["description"] == "Suite2"
 
 
+def test_get_suites_bulk(api, mock, url):
+    mock.add_callback(responses.GET, url("get_suites/5"), get_suites)
+    resp = api.suites.get_suites_bulk(5)
+    assert resp[0]["id"] == 1
+    assert resp[1]["description"] == "Suite2"
+
+
 def test_add_suite(api, mock, url):
     mock.add_callback(responses.POST, url("add_suite/7"), add_suite)
     resp = api.suites.add_suite(7, "New suite", description="My new suite")

tests/test_users.py

@@ -61,6 +61,20 @@ def test_get_users_no_project_id(api, mock, url, offset, limit):
     assert response["users"][0]["name"] == "John Smith"
 
 
+def test_get_users_bulk(api, mock, url):
+    mock.add_callback(responses.GET, url("get_users/15"), get_users)
+    resp = api.users.get_users_bulk(15)
+    assert resp[0]["id"] == 1
+    assert resp[1]["name"] == "Jane Smith"
+
+
+def test_get_users_bulk_no_project_id(api, mock, url):
+    mock.add_callback(responses.GET, url("get_users"), get_users)
+    resp = api.users.get_users_bulk()
+    assert resp[0]["id"] == 1
+    assert resp[1]["name"] == "Jane Smith"
+
+
 def test_get_current_user(api, mock, url):
     mock.add_callback(
         responses.GET,