Add: Add async GitHub API for getting members of a team

Author: bjoernricks

pontos/github/api/teams.py

@@ -204,3 +204,34 @@ async def delete(
         api = f"/orgs/{organization}/teams/{team}"
         response = await self._client.delete(api)
         response.raise_for_status()
+
+    async def members(
+        self,
+        organization: str,
+        team: str,
+    ) -> Iterable[JSON_OBJECT]:
+        """
+        Get all members of a team. Team members will include the members of
+        child teams.
+
+        https://docs.github.com/en/rest/teams/members#list-team-members
+
+        Args:
+            organization: GitHub organization to use
+            team: The slug of the team name.
+
+        Raises:
+            `httpx.HTTPStatusError` if there was an error in the request
+        """
+        api = f"/orgs/{organization}/teams/{team}/members"
+        members = []
+        params = {
+            "per_page": "100",
+        }
+
+        async for response in self._client.get_all(api, params=params):
+            response.raise_for_status()
+
+            members.extend(response.json())
+
+        return members

tests/github/api/test_teams.py

@@ -195,3 +195,23 @@ async def test_delete_failure(self):
         self.client.delete.assert_awaited_once_with(
             "/orgs/foo/teams/bar",
         )
+
+    async def test_members(self):
+        response1 = create_response()
+        response1.json.return_value = [{"id": 1}]
+        response2 = create_response()
+        response2.json.return_value = [{"id": 2}, {"id": 3}]
+
+        self.client.get_all.return_value = AsyncIteratorMock(
+            [response1, response2]
+        )
+
+        repos = await self.api.members("foo", "bar")
+
+        self.assertEqual(len(repos), 3)
+        self.assertEqual(repos, [{"id": 1}, {"id": 2}, {"id": 3}])
+
+        self.client.get_all.assert_called_once_with(
+            "/orgs/foo/teams/bar/members",
+            params={"per_page": "100"},
+        )