git-alternative 0.2.2__py3-none-any.whl

git_alternative/managers/issues.py

@@ -0,0 +1,292 @@
+"""Issue resource manager."""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+from git_alternative.http import HttpClient
+from git_alternative.models import Comment, Issue, IssueState, Label
+
+
+def _parse_label(data: dict) -> Label:
+    return Label(
+        id=data["id"],
+        name=data["name"],
+        color=data["color"],
+        description=data.get("description"),
+    )
+
+
+def _parse_issue(data: dict) -> Issue:
+    return Issue(
+        id=data["id"],
+        repo_id=data["repo_id"],
+        number=data["number"],
+        title=data["title"],
+        author_id=data["author_id"],
+        state=IssueState(data["state"]),
+        created_at=datetime.fromisoformat(data["created_at"]),
+        updated_at=datetime.fromisoformat(data["updated_at"]),
+        body=data.get("body"),
+        labels=[_parse_label(lb) for lb in data.get("labels", [])],
+        assignees=data.get("assignees", []),
+        milestone_id=data.get("milestone_id"),
+        closed_at=(
+            datetime.fromisoformat(data["closed_at"]) if data.get("closed_at") else None
+        ),
+        comment_count=data.get("comment_count", 0),
+    )
+
+
+def _parse_comment(data: dict) -> Comment:
+    return Comment(
+        id=data["id"],
+        author_id=data["author_id"],
+        body=data["body"],
+        created_at=datetime.fromisoformat(data["created_at"]),
+        updated_at=datetime.fromisoformat(data["updated_at"]),
+    )
+
+
+class IssueManager:
+    """Manages issue operations against the Forge API.
+
+    Args:
+        http: An :class:`~git_alternative.http.HttpClient` instance.
+    """
+
+    def __init__(self, http: HttpClient) -> None:
+        self._http = http
+
+    def list(
+        self,
+        owner: str,
+        repo: str,
+        state: str = "open",
+        labels: list[str] | None = None,
+        page: int = 1,
+        per_page: int = 30,
+    ) -> list[Issue]:
+        """List issues in a repository.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            state: Filter by state: ``"open"``, ``"closed"``, or ``"all"``.
+            labels: Filter by label names.
+            page: Page number (1-based).
+            per_page: Items per page.
+
+        Returns:
+            List of :class:`~git_alternative.models.Issue` objects.
+        """
+        params: dict = {"state": state, "page": page, "per_page": per_page}
+        if labels:
+            params["labels"] = ",".join(labels)
+        data = self._http.get(f"/api/v1/repos/{owner}/{repo}/issues", params=params)
+        return [_parse_issue(i) for i in data]
+
+    def get(self, owner: str, repo: str, issue_number: int) -> Issue:
+        """Fetch a single issue by number.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            issue_number: The issue number.
+
+        Returns:
+            An :class:`~git_alternative.models.Issue` instance.
+        """
+        data = self._http.get(f"/api/v1/repos/{owner}/{repo}/issues/{issue_number}")
+        return _parse_issue(data)
+
+    def create(
+        self,
+        owner: str,
+        repo: str,
+        title: str,
+        body: str | None = None,
+        labels: list[str] | None = None,
+        assignees: list[str] | None = None,
+        milestone_id: str | None = None,
+    ) -> Issue:
+        """Create a new issue.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            title: Issue title.
+            body: Issue body in Markdown.
+            labels: Label names to attach.
+            assignees: Usernames to assign.
+            milestone_id: Milestone ID to associate.
+
+        Returns:
+            The newly created :class:`~git_alternative.models.Issue`.
+        """
+        payload: dict = {"title": title}
+        if body is not None:
+            payload["body"] = body
+        if labels:
+            payload["labels"] = labels
+        if assignees:
+            payload["assignees"] = assignees
+        if milestone_id:
+            payload["milestone_id"] = milestone_id
+        data = self._http.post(f"/api/v1/repos/{owner}/{repo}/issues", json=payload)
+        return _parse_issue(data)
+
+    def update(
+        self,
+        owner: str,
+        repo: str,
+        issue_number: int,
+        title: str | None = None,
+        body: str | None = None,
+        state: str | None = None,
+    ) -> Issue:
+        """Update an existing issue.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            issue_number: The issue number.
+            title: New title (optional).
+            body: New body (optional).
+            state: New state: ``"open"`` or ``"closed"`` (optional).
+
+        Returns:
+            The updated :class:`~git_alternative.models.Issue`.
+        """
+        payload: dict = {}
+        if title is not None:
+            payload["title"] = title
+        if body is not None:
+            payload["body"] = body
+        if state is not None:
+            payload["state"] = state
+        data = self._http.patch(
+            f"/api/v1/repos/{owner}/{repo}/issues/{issue_number}", json=payload
+        )
+        return _parse_issue(data)
+
+    def delete(self, owner: str, repo: str, issue_number: int) -> None:
+        """Delete an issue.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            issue_number: The issue number.
+        """
+        self._http.delete(f"/api/v1/repos/{owner}/{repo}/issues/{issue_number}")
+
+    def list_comments(self, owner: str, repo: str, issue_number: int) -> list[Comment]:
+        """List all comments on an issue.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            issue_number: The issue number.
+
+        Returns:
+            List of :class:`~git_alternative.models.Comment` objects.
+        """
+        data = self._http.get(
+            f"/api/v1/repos/{owner}/{repo}/issues/{issue_number}/comments"
+        )
+        return [_parse_comment(c) for c in data]
+
+    def add_comment(
+        self, owner: str, repo: str, issue_number: int, body: str
+    ) -> Comment:
+        """Add a comment to an issue.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            issue_number: The issue number.
+            body: Comment body in Markdown.
+
+        Returns:
+            The newly created :class:`~git_alternative.models.Comment`.
+        """
+        data = self._http.post(
+            f"/api/v1/repos/{owner}/{repo}/issues/{issue_number}/comments",
+            json={"body": body},
+        )
+        return _parse_comment(data)
+
+    def update_comment(
+        self, owner: str, repo: str, issue_number: int, comment_id: str, body: str
+    ) -> Comment:
+        """Update an existing comment.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            issue_number: The issue number.
+            comment_id: The comment ID.
+            body: New comment body.
+
+        Returns:
+            The updated :class:`~git_alternative.models.Comment`.
+        """
+        data = self._http.patch(
+            f"/api/v1/repos/{owner}/{repo}/issues/{issue_number}/comments/{comment_id}",
+            json={"body": body},
+        )
+        return _parse_comment(data)
+
+    def delete_comment(
+        self, owner: str, repo: str, issue_number: int, comment_id: str
+    ) -> None:
+        """Delete a comment from an issue.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            issue_number: The issue number.
+            comment_id: The comment ID.
+        """
+        self._http.delete(
+            f"/api/v1/repos/{owner}/{repo}/issues/{issue_number}/comments/{comment_id}"
+        )
+
+    def list_labels(self, owner: str, repo: str) -> list[Label]:
+        """List all labels defined in a repository.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+
+        Returns:
+            List of :class:`~git_alternative.models.Label` objects.
+        """
+        data = self._http.get(f"/api/v1/repos/{owner}/{repo}/labels")
+        return [_parse_label(lb) for lb in data]
+
+    def create_label(
+        self,
+        owner: str,
+        repo: str,
+        name: str,
+        color: str,
+        description: str | None = None,
+    ) -> Label:
+        """Create a new label in a repository.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            name: Label name.
+            color: Hex color code (e.g. ``"#ff0000"``).
+            description: Optional label description.
+
+        Returns:
+            The newly created :class:`~git_alternative.models.Label`.
+        """
+        payload: dict = {"name": name, "color": color}
+        if description:
+            payload["description"] = description
+        data = self._http.post(f"/api/v1/repos/{owner}/{repo}/labels", json=payload)
+        return _parse_label(data)

git_alternative/managers/repos.py

@@ -0,0 +1,218 @@
+"""Repository resource manager."""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+from git_alternative.http import HttpClient
+from git_alternative.models import (
+    Branch,
+    CommitSummary,
+    CreateRepoRequest,
+    PaginatedResponse,
+    Repository,
+)
+from git_alternative.pagination import paginate_commits
+
+
+def _parse_repo(data: dict) -> Repository:
+    return Repository(
+        id=data["id"],
+        owner_id=data["owner_id"],
+        name=data["name"],
+        description=data.get("description"),
+        is_private=data.get("is_private", False),
+        is_fork=data.get("is_fork", False),
+        default_branch=data.get("default_branch", "main"),
+        created_at=datetime.fromisoformat(data["created_at"]),
+        updated_at=datetime.fromisoformat(data["updated_at"]),
+        star_count=data.get("star_count", 0),
+        fork_count=data.get("fork_count", 0),
+        fork_of=data.get("fork_of"),
+    )
+
+
+def _parse_branch(data: dict) -> Branch:
+    return Branch(
+        name=data["name"],
+        sha=data["sha"],
+        is_default=data.get("is_default", False),
+        is_protected=data.get("is_protected", False),
+    )
+
+
+def _parse_commit(data: dict) -> CommitSummary:
+    return CommitSummary(
+        sha=data["sha"],
+        message=data["message"],
+        author_name=data["author_name"],
+        author_email=data["author_email"],
+        authored_at=datetime.fromisoformat(data["authored_at"]),
+        committer_name=data["committer_name"],
+        committer_email=data["committer_email"],
+        committed_at=datetime.fromisoformat(data["committed_at"]),
+        parents=data.get("parents", []),
+    )
+
+
+class RepoManager:
+    """Manages repository operations against the Forge API.
+
+    Args:
+        http: An :class:`~git_alternative.http.HttpClient` instance.
+    """
+
+    def __init__(self, http: HttpClient) -> None:
+        self._http = http
+
+    def list(self, owner: str) -> list[Repository]:
+        """List all repositories for a user.
+
+        Args:
+            owner: The username whose repositories to list.
+
+        Returns:
+            List of :class:`~git_alternative.models.Repository` objects.
+        """
+        data = self._http.get(f"/api/v1/users/{owner}/repos")
+        return [_parse_repo(r) for r in data]
+
+    def get(self, owner: str, repo: str) -> Repository:
+        """Fetch a single repository by owner and name.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+
+        Returns:
+            A :class:`~git_alternative.models.Repository` instance.
+        """
+        data = self._http.get(f"/api/v1/repos/{owner}/{repo}")
+        return _parse_repo(data)
+
+    def create(self, request: CreateRepoRequest) -> Repository:
+        """Create a new repository.
+
+        Args:
+            request: A :class:`~git_alternative.models.CreateRepoRequest` with
+                the desired repository settings.
+
+        Returns:
+            The newly created :class:`~git_alternative.models.Repository`.
+        """
+        payload = {
+            "name": request.name,
+            "description": request.description,
+            "is_private": request.is_private,
+            "default_branch": request.default_branch,
+            "auto_init": request.auto_init,
+        }
+        data = self._http.post("/api/v1/repos", json=payload)
+        return _parse_repo(data)
+
+    def delete(self, owner: str, repo: str) -> None:
+        """Delete a repository.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+        """
+        self._http.delete(f"/api/v1/repos/{owner}/{repo}")
+
+    def update(
+        self,
+        owner: str,
+        repo: str,
+        description: str | None = None,
+        is_private: bool | None = None,
+        default_branch: str | None = None,
+    ) -> Repository:
+        """Update repository settings.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            description: New description (optional).
+            is_private: New visibility setting (optional).
+            default_branch: New default branch name (optional).
+
+        Returns:
+            The updated :class:`~git_alternative.models.Repository`.
+        """
+        payload: dict = {}
+        if description is not None:
+            payload["description"] = description
+        if is_private is not None:
+            payload["is_private"] = is_private
+        if default_branch is not None:
+            payload["default_branch"] = default_branch
+        data = self._http.patch(f"/api/v1/repos/{owner}/{repo}", json=payload)
+        return _parse_repo(data)
+
+    def list_branches(self, owner: str, repo: str) -> list[Branch]:
+        """List all branches in a repository.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+
+        Returns:
+            List of :class:`~git_alternative.models.Branch` objects.
+        """
+        data = self._http.get(f"/api/v1/repos/{owner}/{repo}/branches")
+        return [_parse_branch(b) for b in data]
+
+    def get_branch(self, owner: str, repo: str, branch: str) -> Branch:
+        """Fetch a single branch by name.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            branch: Branch name.
+
+        Returns:
+            A :class:`~git_alternative.models.Branch` instance.
+        """
+        data = self._http.get(f"/api/v1/repos/{owner}/{repo}/branches/{branch}")
+        return _parse_branch(data)
+
+    def list_commits(
+        self,
+        owner: str,
+        repo: str,
+        page: int = 1,
+        per_page: int = 30,
+    ) -> PaginatedResponse[CommitSummary]:
+        """List commits in a repository with pagination.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            page: Page number (1-based).
+            per_page: Items per page (max 100).
+
+        Returns:
+            A :class:`~git_alternative.models.PaginatedResponse` of
+            :class:`~git_alternative.models.CommitSummary` objects.
+        """
+        capped = min(per_page, 100)
+        data = self._http.get(
+            f"/api/v1/repos/{owner}/{repo}/commits",
+            params={"page": page, "per_page": capped + 1},
+        )
+        raw = [_parse_commit(c) for c in data]
+        return paginate_commits(raw, page=page, per_page=capped)
+
+    def get_commit(self, owner: str, repo: str, sha: str) -> CommitSummary:
+        """Fetch a single commit by SHA.
+
+        Args:
+            owner: Repository owner username.
+            repo: Repository name.
+            sha: Full or abbreviated commit SHA.
+
+        Returns:
+            A :class:`~git_alternative.models.CommitSummary` instance.
+        """
+        data = self._http.get(f"/api/v1/repos/{owner}/{repo}/commits/{sha}")
+        return _parse_commit(data)