feat: add branch protection call to client

nodestream_github/client/githubclient.py

@@ -617,3 +617,27 @@ async def fetch_teams_for_repo(self, *, owner_login: str, repo_name: str):
                 yield team
         except httpx.HTTPError as e:
             _fetch_problem(f"teams for repo {owner_login}/{repo_name}", e)
+
+    async def fetch_branch_protection(
+        self,
+        *,
+        owner_login: str,
+        repo_name: str,
+        branch: str,
+    ) -> types.BranchProtection | None:
+        """Fetches the branch protection for a given branch.
+
+        https://docs.github.com/en/[email protected]/rest/branches/branch-protection?apiVersion=2022-11-28#get-branch-protection
+        """
+
+        try:
+            return await self._get_item(
+                f"repos/{owner_login}/{repo_name}/branches/{branch}/protection"
+            )
+        except httpx.HTTPError as e:
+            _fetch_problem(
+                f"branch protection for branch {branch} on "
+                f"repo {owner_login}/{repo_name}",
+                e,
+            )
+            return None

nodestream_github/types/__init__.py

@@ -1,4 +1,5 @@
 from .github import (
+    BranchProtection,
     GithubAuditLog,
     GithubOrg,
     GithubOrgSummary,
@@ -19,6 +20,7 @@
 from .httpx import HeaderTypes, PrimitiveData, QueryParamTypes
 
 __all__ = [
+    "BranchProtection",
     "GithubAuditLog",
     "GithubOrg",
     "GithubOrgSummary",

nodestream_github/types/github.py

@@ -22,3 +22,5 @@
 
 SimplifiedRepo: TypeAlias = JSONObject
 SimplifiedUser: TypeAlias = JSONObject
+
+BranchProtection: TypeAlias = JSONObject