pygitcode 0.1.0__tar.gz → 0.1.2__tar.gz

{pygitcode-0.1.0 → pygitcode-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygitcode
-Version: 0.1.0
+Version: 0.1.2
 Summary: A CLI tool for GitCode (api.gitcode.com), modeled after GitHub CLI.
 Author-email: codeasier <825770651@qq.com>
 License-Expression: MIT
@@ -45,7 +45,6 @@ Dynamic: license-file
 [![PyPI](https://img.shields.io/pypi/v/pygitcode)](https://pypi.org/project/pygitcode/)
 [![Python](https://img.shields.io/pypi/pyversions/pygitcode)](https://pypi.org/project/pygitcode/)
 [![License](https://img.shields.io/pypi/l/pygitcode)](https://github.com/yourusername/pygitcode/blob/main/LICENSE)
-[![Tests](https://github.com/yourusername/pygitcode/workflows/Tests/badge.svg)](https://github.com/yourusername/pygitcode/actions)
 
 ## Installation
 
@@ -53,7 +52,27 @@ Dynamic: license-file
 pip install pygitcode
 ```
 
-This exposes the `gc` command in your shell.
+This exposes the `gc` (or `gitcode`) command in your shell.
+
+## Windows PowerShell Users
+
+On Windows PowerShell, `gc` is a built-in alias for the `Get-Content` cmdlet, which shadows the GitCode CLI. Use `gitcode` instead:
+
+```powershell
+gitcode auth login
+gitcode issue list
+gitcode pr list
+```
+
+Alternatively, you can remove or override the alias in your PowerShell profile:
+
+```powershell
+# Remove for the current session
+Remove-Item Alias:gc -Force
+
+# Or persist the override in your profile
+Set-Alias -Name gc -Value 'C:\Users\<user>\AppData\Roaming\Python\Python313\Scripts\gc.exe'
+```
 
 ## Quick Start
 
@@ -63,6 +82,15 @@ This exposes the `gc` command in your shell.
 # Login with your GitCode personal access token
 gc auth login
 
+# Check auth status
+gc auth status
+
+# Print the current auth token
+gc auth token
+
+# Logout
+gc auth logout
+
 # Or set environment variable
 export GC_TOKEN=your_token_here
 ```
@@ -83,21 +111,24 @@ gc issue view 42 --web
 
 # Create an issue
 gc issue create -t "Bug report" -b "Something is broken"
+gc issue create --label bug --label "help wanted"   # Multiple labels
 gc issue create --web    # Create in browser
 
-# Edit an issue (add/remove labels, assignees)
+# Edit an issue (title, labels, assignee, milestone)
 gc issue edit 42 -t "Updated title"
-gc issue edit 42 --add-label bug --remove-label "in progress"
-gc issue edit 42 --add-assignee @me --remove-assignee otheruser
+gc issue edit 42 --add-label bug --add-label docs
+gc issue edit 42 --add-assignee @me
+gc issue edit 42 --milestone v1.0 --remove-milestone
 
 # Comment on an issue
 gc issue comment 42 -b "Thanks for the report!"
 gc issue comment 42 --editor    # Use system editor
 
-# Close / reopen / delete
+gc issue delete 42              # Unsupported by GitCode API
+
+# Close / reopen
 gc issue close 42
-gc issue reopen 42
-gc issue delete 42
+gc issue close 42 -c "Fixed in #50" --reason completed
 ```
 
 ### Pull Requests
@@ -112,6 +143,7 @@ gc pr list --web    # Open in browser
 # View a PR (identifier optional - infers from current branch)
 gc pr view           # View PR for current branch
 gc pr view 42        # By number
+gc pr view 42 --comments   # Include comments
 gc pr view https://gitcode.com/owner/repo/pulls/42
 gc pr view feature-branch
 
@@ -140,11 +172,13 @@ gc pr close --delete-branch    # Delete remote branch too
 gc pr merge          # Merge PR for current branch
 gc pr merge 42 -s    # Squash merge
 gc pr merge --rebase
+gc pr merge --delete-branch    # Delete remote branch after merge
 
-# Edit a PR (add/remove labels, assignees, reviewers)
+# Edit a PR (add/remove labels, assignees, reviewers, milestones)
 gc pr edit 42 -t "New title"
 gc pr edit --add-label bug --remove-label "needs review"
 gc pr edit --add-reviewer @me --remove-reviewer otheruser
+gc pr edit --milestone v1.0 --remove-milestone
 
 # Mark as ready or convert to draft
 gc pr ready          # Mark current branch's PR as ready
@@ -153,6 +187,8 @@ gc pr ready --undo   # Convert back to draft
 # Comment / review / diff (identifier optional)
 gc pr comment -b "LGTM"
 gc pr comment --path src/file.py --position 5 -b "Suggestion"
+gc pr comment --body-file comment.txt
+gc pr comment --editor
 
 gc pr review --approve
 gc pr review --comment -b "Looks good but needs tests"
@@ -204,7 +240,7 @@ gc pr view -w
 | `--web` (create/view in browser) | ✅ | ✅ |
 | `--remove-*` flags for edit commands | ✅ | ✅ |
 | `pr ready --undo` (convert to draft) | ✅ | ✅ |
-| `pr review --comment` / `--request-changes` | ✅ | ✅ (fallback) |
+| `pr review --request-changes` | ✅ | ✅ (fallback) |
 | `--json fields` | ✅ | ✅ |
 | `-q jq` filtering | ✅ | ✅ |
 | `-t template` formatting | ✅ | ✅ |
@@ -214,7 +250,8 @@ gc pr view -w
 ### Known Limitations (GitCode API differences)
 
 - **PR comment model**: GitCode uses `path + position`, not GitHub's `line/side/commit`
-- **PR review**: GitCode review API differs from GitHub; `--comment` and `--request-changes` fall back to PR comments
+- **PR review**: GitCode review API differs from GitHub; `--request-changes` falls back to PR comments
+- **Issue deletion**: `gc issue delete` is exposed for CLI parity, but GitCode API does not support deleting issues
 - **Issue create/update API**: GitCode puts `repo` in request body, not URL path
 
 ## Development

{pygitcode-0.1.0 → pygitcode-0.1.2}/README.md

@@ -5,7 +5,6 @@
 [![PyPI](https://img.shields.io/pypi/v/pygitcode)](https://pypi.org/project/pygitcode/)
 [![Python](https://img.shields.io/pypi/pyversions/pygitcode)](https://pypi.org/project/pygitcode/)
 [![License](https://img.shields.io/pypi/l/pygitcode)](https://github.com/yourusername/pygitcode/blob/main/LICENSE)
-[![Tests](https://github.com/yourusername/pygitcode/workflows/Tests/badge.svg)](https://github.com/yourusername/pygitcode/actions)
 
 ## Installation
 
@@ -13,7 +12,27 @@
 pip install pygitcode
 ```
 
-This exposes the `gc` command in your shell.
+This exposes the `gc` (or `gitcode`) command in your shell.
+
+## Windows PowerShell Users
+
+On Windows PowerShell, `gc` is a built-in alias for the `Get-Content` cmdlet, which shadows the GitCode CLI. Use `gitcode` instead:
+
+```powershell
+gitcode auth login
+gitcode issue list
+gitcode pr list
+```
+
+Alternatively, you can remove or override the alias in your PowerShell profile:
+
+```powershell
+# Remove for the current session
+Remove-Item Alias:gc -Force
+
+# Or persist the override in your profile
+Set-Alias -Name gc -Value 'C:\Users\<user>\AppData\Roaming\Python\Python313\Scripts\gc.exe'
+```
 
 ## Quick Start
 
@@ -23,6 +42,15 @@ This exposes the `gc` command in your shell.
 # Login with your GitCode personal access token
 gc auth login
 
+# Check auth status
+gc auth status
+
+# Print the current auth token
+gc auth token
+
+# Logout
+gc auth logout
+
 # Or set environment variable
 export GC_TOKEN=your_token_here
 ```
@@ -43,21 +71,24 @@ gc issue view 42 --web
 
 # Create an issue
 gc issue create -t "Bug report" -b "Something is broken"
+gc issue create --label bug --label "help wanted"   # Multiple labels
 gc issue create --web    # Create in browser
 
-# Edit an issue (add/remove labels, assignees)
+# Edit an issue (title, labels, assignee, milestone)
 gc issue edit 42 -t "Updated title"
-gc issue edit 42 --add-label bug --remove-label "in progress"
-gc issue edit 42 --add-assignee @me --remove-assignee otheruser
+gc issue edit 42 --add-label bug --add-label docs
+gc issue edit 42 --add-assignee @me
+gc issue edit 42 --milestone v1.0 --remove-milestone
 
 # Comment on an issue
 gc issue comment 42 -b "Thanks for the report!"
 gc issue comment 42 --editor    # Use system editor
 
-# Close / reopen / delete
+gc issue delete 42              # Unsupported by GitCode API
+
+# Close / reopen
 gc issue close 42
-gc issue reopen 42
-gc issue delete 42
+gc issue close 42 -c "Fixed in #50" --reason completed
 ```
 
 ### Pull Requests
@@ -72,6 +103,7 @@ gc pr list --web    # Open in browser
 # View a PR (identifier optional - infers from current branch)
 gc pr view           # View PR for current branch
 gc pr view 42        # By number
+gc pr view 42 --comments   # Include comments
 gc pr view https://gitcode.com/owner/repo/pulls/42
 gc pr view feature-branch
 
@@ -100,11 +132,13 @@ gc pr close --delete-branch    # Delete remote branch too
 gc pr merge          # Merge PR for current branch
 gc pr merge 42 -s    # Squash merge
 gc pr merge --rebase
+gc pr merge --delete-branch    # Delete remote branch after merge
 
-# Edit a PR (add/remove labels, assignees, reviewers)
+# Edit a PR (add/remove labels, assignees, reviewers, milestones)
 gc pr edit 42 -t "New title"
 gc pr edit --add-label bug --remove-label "needs review"
 gc pr edit --add-reviewer @me --remove-reviewer otheruser
+gc pr edit --milestone v1.0 --remove-milestone
 
 # Mark as ready or convert to draft
 gc pr ready          # Mark current branch's PR as ready
@@ -113,6 +147,8 @@ gc pr ready --undo   # Convert back to draft
 # Comment / review / diff (identifier optional)
 gc pr comment -b "LGTM"
 gc pr comment --path src/file.py --position 5 -b "Suggestion"
+gc pr comment --body-file comment.txt
+gc pr comment --editor
 
 gc pr review --approve
 gc pr review --comment -b "Looks good but needs tests"
@@ -164,7 +200,7 @@ gc pr view -w
 | `--web` (create/view in browser) | ✅ | ✅ |
 | `--remove-*` flags for edit commands | ✅ | ✅ |
 | `pr ready --undo` (convert to draft) | ✅ | ✅ |
-| `pr review --comment` / `--request-changes` | ✅ | ✅ (fallback) |
+| `pr review --request-changes` | ✅ | ✅ (fallback) |
 | `--json fields` | ✅ | ✅ |
 | `-q jq` filtering | ✅ | ✅ |
 | `-t template` formatting | ✅ | ✅ |
@@ -174,7 +210,8 @@ gc pr view -w
 ### Known Limitations (GitCode API differences)
 
 - **PR comment model**: GitCode uses `path + position`, not GitHub's `line/side/commit`
-- **PR review**: GitCode review API differs from GitHub; `--comment` and `--request-changes` fall back to PR comments
+- **PR review**: GitCode review API differs from GitHub; `--request-changes` falls back to PR comments
+- **Issue deletion**: `gc issue delete` is exposed for CLI parity, but GitCode API does not support deleting issues
 - **Issue create/update API**: GitCode puts `repo` in request body, not URL path
 
 ## Development
@@ -206,4 +243,4 @@ See [ROADMAP.md](ROADMAP.md) for planned features and current gaps.
 
 ## License
 
-MIT
+MIT

{pygitcode-0.1.0 → pygitcode-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pygitcode"
-version = "0.1.0"
+dynamic = ["version"]
 description = "A CLI tool for GitCode (api.gitcode.com), modeled after GitHub CLI."
 readme = "README.md"
 license = "MIT"
@@ -53,10 +53,14 @@ Issues = "https://github.com/yourusername/pygitcode/issues"
 
 [project.scripts]
 gc = "gitcode_cli.cli:main"
+gitcode = "gitcode_cli.cli:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.dynamic]
+version = {attr = "gitcode_cli.__version__"}
+
 # --- pytest ---
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{pygitcode-0.1.0 → pygitcode-0.1.2}/src/gitcode_cli/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"

pygitcode-0.1.2/src/gitcode_cli/adapters/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from .base import AdapterActionResult
+from .issues import IssueAdapter
+from .pulls import PullRequestAdapter
+
+__all__ = ["AdapterActionResult", "IssueAdapter", "PullRequestAdapter"]

pygitcode-0.1.2/src/gitcode_cli/adapters/base.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+
+@dataclass
+class AdapterActionResult:
+    item: dict[str, Any] | None = None
+    items: list[dict[str, Any]] | None = None
+    message: str | None = None
+    warning: str | None = None
+    degraded: bool = False
+    approximated: bool = False

pygitcode-0.1.2/src/gitcode_cli/adapters/capabilities.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import click
+
+CAPABILITY_MESSAGES = {
+    "ISSUE_COMMENT_LAST_NOT_FOUND": "No editable issue comment from the current user was found.",
+    "ISSUE_COMMENT_OWNERSHIP_UNVERIFIABLE": (
+        "Unable to verify the current user's issue comments on GitCode; refusing to edit or delete comments safely."
+    ),
+    "ISSUE_CREATE_IF_NONE_REQUIRES_EDIT_LAST": "--create-if-none can only be used together with --edit-last.",
+    "ISSUE_DELETE": "GitCode API does not support deleting issues.",
+    "ISSUE_DEVELOP_BASE": "--base and --name are not supported by 'gc issue develop'",
+    "ISSUE_DEVELOP_NAME": "--base and --name are not supported by 'gc issue develop'",
+    "ISSUE_STATUS_GH_SEMANTICS": "GitCode-limited approximation of gh issue status",
+    "PR_MERGE_AUTHOR_EMAIL": "GitCode merge API does not support --author-email.",
+    "PR_MERGE_AUTO": "GitCode merge API does not support --auto.",
+    "PR_REVIEW_REQUEST_CHANGES": (
+        "GitCode review API does not support request-changes reviews; the pull request comment was posted instead."
+    ),
+    "PR_STATUS_GH_SEMANTICS": ("GitCode API approximation -- user-specific filtering is not available"),
+}
+
+
+def capability_message(feature: str) -> str:
+    return CAPABILITY_MESSAGES[feature]
+
+
+def unsupported(feature: str) -> click.ClickException:
+    return click.ClickException(capability_message(feature))

pygitcode-0.1.2/src/gitcode_cli/adapters/issues.py

@@ -0,0 +1,239 @@
+from __future__ import annotations
+
+from typing import Any
+
+import click
+
+from ..errors import APIError
+from ..services import IssueService, UserService
+from .base import AdapterActionResult
+from .capabilities import capability_message, unsupported
+
+
+def _normalize_multi_values(values: tuple[str, ...] | None) -> str | None:
+    if not values:
+        return None
+    return ",".join(values)
+
+
+def _extract_label_names(issue: dict[str, Any] | None) -> list[str]:
+    labels = issue.get("labels") if isinstance(issue, dict) else None
+    if not labels:
+        return []
+    if isinstance(labels, str):
+        return [part.strip() for part in labels.split(",") if part.strip()]
+
+    names: list[str] = []
+    if isinstance(labels, list):
+        for label in labels:
+            if isinstance(label, dict):
+                name = label.get("name") or label.get("title")
+                if name:
+                    names.append(str(name))
+            elif label:
+                names.append(str(label))
+    return names
+
+
+def _extract_login(data: dict[str, Any] | None) -> str | None:
+    if not isinstance(data, dict):
+        return None
+    for key in ("login", "username", "name"):
+        value = data.get(key)
+        if isinstance(value, str) and value.strip():
+            return value.strip()
+    user = data.get("user")
+    if isinstance(user, dict):
+        return _extract_login(user)
+    author = data.get("author")
+    if isinstance(author, dict):
+        return _extract_login(author)
+    return None
+
+
+class IssueAdapter:
+    def __init__(self, service: IssueService, user_service: UserService | None = None):
+        self.service = service
+        self.user_service = user_service
+
+    def list_issues(
+        self,
+        owner: str,
+        repo: str,
+        *,
+        state: str | None,
+        labels: tuple[str, ...] | None,
+        author: str | None,
+        assignee: str | None,
+        milestone: str | None,
+        mention: str | None,
+        search: str | None,
+        limit: int | None,
+    ) -> Any:
+        items = self.service.list(
+            owner,
+            repo,
+            state=state,
+            labels=_normalize_multi_values(labels),
+            creator=author,
+            assignee=assignee,
+            milestone=milestone,
+            mention=mention,
+            search=search,
+        )
+        if limit is not None:
+            return items[:limit]
+        return items
+
+    def create_issue(
+        self,
+        owner: str,
+        repo: str,
+        *,
+        title: str,
+        body: str | None,
+        assignee: str | None,
+        labels: tuple[str, ...] | None,
+        milestone: str | None,
+    ) -> dict[str, Any] | None:
+        return self.service.create(
+            owner,
+            repo,
+            title=title,
+            body=body,
+            assignee=assignee,
+            labels=_normalize_multi_values(labels),
+            milestone=milestone,
+        )
+
+    def close_issue(
+        self,
+        owner: str,
+        repo: str,
+        number: str,
+        *,
+        comment: str | None,
+        reason: str | None,
+    ) -> AdapterActionResult:
+        current = self.service.get(owner, repo, number)
+        if current and current.get("state") == "closed":
+            if comment:
+                self.service.comment(owner, repo, number, comment)
+                return AdapterActionResult(item=current, message="already_closed_commented")
+            return AdapterActionResult(item=current, message="already_closed")
+        if comment:
+            self.service.comment(owner, repo, number, comment)
+        payload: dict[str, Any] = {"state": "close"}
+        if reason:
+            payload["state_reason"] = reason
+        item = self.service.update(owner, repo, number, **payload)
+        return AdapterActionResult(item=item, message="closed")
+
+    def comment_issue(self, owner: str, repo: str, number: str, *, body: str) -> dict[str, Any] | None:
+        return self.service.comment(owner, repo, number, body)
+
+    def manage_comment_history(
+        self,
+        owner: str,
+        repo: str,
+        number: str,
+        *,
+        body: str | None,
+        delete_last: bool,
+        create_if_none: bool,
+    ) -> AdapterActionResult:
+        comment = self._find_last_owned_comment(owner, repo, number)
+        if delete_last:
+            if comment is None:
+                raise click.ClickException(capability_message("ISSUE_COMMENT_LAST_NOT_FOUND"))
+            self.service.delete_comment(owner, repo, comment["id"])
+            return AdapterActionResult(item=comment, message="deleted")
+        if comment is None:
+            if create_if_none:
+                item = self.service.comment(owner, repo, number, body or "")
+                return AdapterActionResult(item=item, message="created")
+            raise click.ClickException(capability_message("ISSUE_COMMENT_LAST_NOT_FOUND"))
+        item = self.service.update_comment(owner, repo, comment["id"], body or "")
+        return AdapterActionResult(item=item, message="edited")
+
+    def _find_last_owned_comment(self, owner: str, repo: str, number: str) -> dict[str, Any] | None:
+        if self.user_service is None:
+            raise click.ClickException(capability_message("ISSUE_COMMENT_OWNERSHIP_UNVERIFIABLE"))
+        try:
+            current_user = self.user_service.current()
+        except APIError as exc:
+            raise click.ClickException(capability_message("ISSUE_COMMENT_OWNERSHIP_UNVERIFIABLE")) from exc
+        current_login = _extract_login(current_user)
+        if not current_login:
+            raise click.ClickException(capability_message("ISSUE_COMMENT_OWNERSHIP_UNVERIFIABLE"))
+        comments = self.service.list_comments(owner, repo, number) or []
+        for comment in reversed(comments):
+            if not isinstance(comment, dict):
+                continue
+            if _extract_login(comment) == current_login:
+                return comment
+        return None
+
+    def reopen_issue(self, owner: str, repo: str, number: str) -> AdapterActionResult:
+        current = self.service.get(owner, repo, number)
+        if current and current.get("state") == "open":
+            return AdapterActionResult(item=current, message="already_open")
+        item = self.service.update(owner, repo, number, state="reopen")
+        return AdapterActionResult(item=item, message="reopened")
+
+    def delete_issue(self, owner: str, repo: str, number: str) -> AdapterActionResult:  # noqa: ARG002
+        raise unsupported("ISSUE_DELETE")
+
+    def edit_issue(
+        self,
+        owner: str,
+        repo: str,
+        number: str,
+        *,
+        title: str | None,
+        body: str | None,
+        add_assignee: str | None,
+        add_labels: tuple[str, ...] | None,
+        milestone: str | None,
+        remove_milestone: bool,
+    ) -> dict[str, Any] | None:
+        data = {k: v for k, v in {"title": title, "body": body}.items() if v is not None}
+
+        if add_assignee is not None:
+            data["assignee"] = add_assignee
+
+        if add_labels:
+            current = self.service.get(owner, repo, number)
+            existing = _extract_label_names(current)
+            merged: list[str] = []
+            seen: set[str] = set()
+            for label in [*existing, *list(add_labels)]:
+                normalized = label.strip()
+                if normalized and normalized not in seen:
+                    seen.add(normalized)
+                    merged.append(normalized)
+            data["labels"] = ",".join(merged)
+
+        if milestone is not None:
+            data["milestone"] = milestone
+        if remove_milestone:
+            data["milestone"] = ""
+        return self.service.update(owner, repo, number, **data)
+
+    def status(self, owner: str, repo: str) -> AdapterActionResult:
+        items = self.service.list(owner, repo, state="open")
+        return AdapterActionResult(
+            items=items,
+            message=capability_message("ISSUE_STATUS_GH_SEMANTICS"),
+            approximated=True,
+        )
+
+    def develop(self, owner: str, repo: str, number: str, *, base: str | None, name: str | None) -> AdapterActionResult:  # noqa: ARG002
+        if base is not None:
+            raise unsupported("ISSUE_DEVELOP_BASE")
+        if name is not None:
+            raise unsupported("ISSUE_DEVELOP_NAME")
+        return AdapterActionResult(
+            message=f"Opening issue #{number} in the browser instead.",
+            warning="Note: 'issue develop' does not create a local branch on GitCode.",
+        )