Add: Add async GitHub API for removing team members

Author: bjoernricks

pontos/github/api/teams.py

@@ -268,3 +268,26 @@ async def update_member(
         data = {"role": role.value}
         response = await self._client.put(api, data=data)
         response.raise_for_status()
+
+    async def remove_member(
+        self,
+        organization: str,
+        team: str,
+        username: str,
+    ) -> None:
+        """
+        Remove a member from a team.
+
+        https://docs.github.com/en/rest/teams/members#remove-team-membership-for-a-user
+
+        Args:
+            organization: GitHub organization to use
+            team: The slug of the team name.
+            username: The handle for the GitHub user account.
+
+        Raises:
+            `httpx.HTTPStatusError` if there was an error in the request
+        """
+        api = f"/orgs/{organization}/teams/{team}/memberships/{username}"
+        response = await self._client.delete(api)
+        response.raise_for_status()

tests/github/api/test_teams.py

@@ -240,3 +240,26 @@ async def test_update_member_failure(self):
         self.client.put.assert_awaited_once_with(
             "/orgs/foo/teams/bar/memberships/baz", data={"role": "member"}
         )
+
+    async def test_remove_member(self):
+        response = create_response()
+        self.client.delete.return_value = response
+
+        await self.api.remove_member("foo", "bar", "baz")
+
+        self.client.delete.assert_awaited_once_with(
+            "/orgs/foo/teams/bar/memberships/baz"
+        )
+
+    async def test_remove_member_failure(self):
+        response = create_response()
+        self.client.delete.side_effect = httpx.HTTPStatusError(
+            "404", request=MagicMock(), response=response
+        )
+
+        with self.assertRaises(httpx.HTTPStatusError):
+            await self.api.remove_member("foo", "bar", "baz")
+
+        self.client.delete.assert_awaited_once_with(
+            "/orgs/foo/teams/bar/memberships/baz"
+        )