pygitcode 0.1.0__tar.gz

pygitcode-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pygitcode contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pygitcode-0.1.0/PKG-INFO

@@ -0,0 +1,249 @@
+Metadata-Version: 2.4
+Name: pygitcode
+Version: 0.1.0
+Summary: A CLI tool for GitCode (api.gitcode.com), modeled after GitHub CLI.
+Author-email: codeasier <825770651@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourusername/pygitcode
+Project-URL: Documentation, https://github.com/yourusername/pygitcode#readme
+Project-URL: Repository, https://github.com/yourusername/pygitcode.git
+Project-URL: Issues, https://github.com/yourusername/pygitcode/issues
+Keywords: gitcode,cli,git,api,vcs,developer-tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.24
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.14; extra == "dev"
+Requires-Dist: respx>=0.21; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: basedpyright>=1.19; extra == "dev"
+Requires-Dist: pre-commit>=3.0; extra == "dev"
+Dynamic: license-file
+
+# pygitcode
+
+> A CLI tool for [GitCode](https://gitcode.com/) (`api.gitcode.com`), modeled after GitHub CLI (`gh`).
+
+[![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
+
+```bash
+pip install pygitcode
+```
+
+This exposes the `gc` command in your shell.
+
+## Quick Start
+
+### Authentication
+
+```bash
+# Login with your GitCode personal access token
+gc auth login
+
+# Or set environment variable
+export GC_TOKEN=your_token_here
+```
+
+### Issues
+
+```bash
+# List issues (with filtering options)
+gc issue list
+gc issue list --state closed --author @me
+gc issue list --label bug --label "help wanted"
+gc issue list --web    # Open in browser
+
+# View an issue (with comments)
+gc issue view 42
+gc issue view 42 --comments
+gc issue view 42 --web
+
+# Create an issue
+gc issue create -t "Bug report" -b "Something is broken"
+gc issue create --web    # Create in browser
+
+# Edit an issue (add/remove labels, assignees)
+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
+
+# 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 close 42
+gc issue reopen 42
+gc issue delete 42
+```
+
+### Pull Requests
+
+```bash
+# List PRs (with filtering options)
+gc pr list
+gc pr list --state merged --author @me
+gc pr list --base main --draft
+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 https://gitcode.com/owner/repo/pulls/42
+gc pr view feature-branch
+
+# Create a PR (auto-detects current branch and default base)
+gc pr create -t "Add new feature"
+
+# Create with auto-fill from commits
+gc pr create --fill              # Use latest commit
+gc pr create --fill-first        # Use first commit
+gc pr create --fill-verbose      # Use all commits for body
+
+# Create with editor
+gc pr create --editor
+
+# Preview without creating
+gc pr create --dry-run
+
+# Create in browser
+gc pr create --web
+
+# Close / merge / reopen (identifier optional)
+gc pr close          # Close PR for current branch
+gc pr close 42 -c "Closing as stale"
+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
+
+# Edit a PR (add/remove labels, assignees, reviewers)
+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
+
+# Mark as ready or convert to draft
+gc pr ready          # Mark current branch's PR as ready
+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 review --approve
+gc pr review --comment -b "Looks good but needs tests"
+gc pr review --request-changes -b "Missing documentation"
+
+gc pr diff           # View diff for current branch's PR
+gc pr diff 42
+
+# Checkout a PR (identifier optional)
+gc pr checkout        # Checkout PR for current branch? (prompts if ambiguous)
+gc pr checkout 42
+gc pr checkout -b local-branch-name
+```
+
+### Global Options
+
+```bash
+# Use a different repo without cd-ing into it
+gc issue list -R owner/repo
+gc pr list -R owner/repo
+
+# Output as JSON with field selection
+gc issue list --json number,title,state,author
+gc pr list --json number,title,state,head,base
+
+# Filter with jq
+gc issue list -q '.[] | select(.state == "open")'
+gc pr list -q '.[] | select(.draft == true)'
+
+# Format with Go-style templates
+gc issue list -t '{{.number}} {{.title}} ({{.state}})'
+gc pr view -t 'PR #{{.number}}: {{.title}}\n{{.body}}'
+
+# Open in browser
+gc issue view 42 -w
+gc pr view -w
+```
+
+## Alignment with `gh` CLI
+
+`pygitcode` aims to be as familiar as possible to `gh` users:
+
+| Feature | `gh` | `gc` |
+|---------|------|------|
+| PR identifier optional (current branch inference) | ✅ | ✅ |
+| `--fill` / `--fill-first` / `--fill-verbose` | ✅ | ✅ |
+| `--editor` | ✅ | ✅ |
+| `--dry-run` | ✅ | ✅ |
+| `--web` (create/view in browser) | ✅ | ✅ |
+| `--remove-*` flags for edit commands | ✅ | ✅ |
+| `pr ready --undo` (convert to draft) | ✅ | ✅ |
+| `pr review --comment` / `--request-changes` | ✅ | ✅ (fallback) |
+| `--json fields` | ✅ | ✅ |
+| `-q jq` filtering | ✅ | ✅ |
+| `-t template` formatting | ✅ | ✅ |
+| Command aliases (`ls` → `list`, `new` → `create`) | ✅ | ✅ |
+| Multi-value options (`--label bug --label feature`) | ✅ | ✅ |
+
+### 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
+- **Issue create/update API**: GitCode puts `repo` in request body, not URL path
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/yourusername/pygitcode.git
+cd pygitcode
+
+# Install in editable mode with dev dependencies
+pip install -e ".[dev]"
+
+# Install pre-commit hooks
+pre-commit install
+
+# Run all checks manually
+pre-commit run --all-files
+
+# Or run individually
+python -m pytest tests/unit/ --cov=gitcode_cli
+python -m ruff check src/ tests/
+python -m ruff format src/ tests/
+python -m basedpyright src/
+```
+
+## Roadmap
+
+See [ROADMAP.md](ROADMAP.md) for planned features and current gaps.
+
+## License
+
+MIT

pygitcode-0.1.0/README.md

@@ -0,0 +1,209 @@
+# pygitcode
+
+> A CLI tool for [GitCode](https://gitcode.com/) (`api.gitcode.com`), modeled after GitHub CLI (`gh`).
+
+[![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
+
+```bash
+pip install pygitcode
+```
+
+This exposes the `gc` command in your shell.
+
+## Quick Start
+
+### Authentication
+
+```bash
+# Login with your GitCode personal access token
+gc auth login
+
+# Or set environment variable
+export GC_TOKEN=your_token_here
+```
+
+### Issues
+
+```bash
+# List issues (with filtering options)
+gc issue list
+gc issue list --state closed --author @me
+gc issue list --label bug --label "help wanted"
+gc issue list --web    # Open in browser
+
+# View an issue (with comments)
+gc issue view 42
+gc issue view 42 --comments
+gc issue view 42 --web
+
+# Create an issue
+gc issue create -t "Bug report" -b "Something is broken"
+gc issue create --web    # Create in browser
+
+# Edit an issue (add/remove labels, assignees)
+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
+
+# 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 close 42
+gc issue reopen 42
+gc issue delete 42
+```
+
+### Pull Requests
+
+```bash
+# List PRs (with filtering options)
+gc pr list
+gc pr list --state merged --author @me
+gc pr list --base main --draft
+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 https://gitcode.com/owner/repo/pulls/42
+gc pr view feature-branch
+
+# Create a PR (auto-detects current branch and default base)
+gc pr create -t "Add new feature"
+
+# Create with auto-fill from commits
+gc pr create --fill              # Use latest commit
+gc pr create --fill-first        # Use first commit
+gc pr create --fill-verbose      # Use all commits for body
+
+# Create with editor
+gc pr create --editor
+
+# Preview without creating
+gc pr create --dry-run
+
+# Create in browser
+gc pr create --web
+
+# Close / merge / reopen (identifier optional)
+gc pr close          # Close PR for current branch
+gc pr close 42 -c "Closing as stale"
+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
+
+# Edit a PR (add/remove labels, assignees, reviewers)
+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
+
+# Mark as ready or convert to draft
+gc pr ready          # Mark current branch's PR as ready
+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 review --approve
+gc pr review --comment -b "Looks good but needs tests"
+gc pr review --request-changes -b "Missing documentation"
+
+gc pr diff           # View diff for current branch's PR
+gc pr diff 42
+
+# Checkout a PR (identifier optional)
+gc pr checkout        # Checkout PR for current branch? (prompts if ambiguous)
+gc pr checkout 42
+gc pr checkout -b local-branch-name
+```
+
+### Global Options
+
+```bash
+# Use a different repo without cd-ing into it
+gc issue list -R owner/repo
+gc pr list -R owner/repo
+
+# Output as JSON with field selection
+gc issue list --json number,title,state,author
+gc pr list --json number,title,state,head,base
+
+# Filter with jq
+gc issue list -q '.[] | select(.state == "open")'
+gc pr list -q '.[] | select(.draft == true)'
+
+# Format with Go-style templates
+gc issue list -t '{{.number}} {{.title}} ({{.state}})'
+gc pr view -t 'PR #{{.number}}: {{.title}}\n{{.body}}'
+
+# Open in browser
+gc issue view 42 -w
+gc pr view -w
+```
+
+## Alignment with `gh` CLI
+
+`pygitcode` aims to be as familiar as possible to `gh` users:
+
+| Feature | `gh` | `gc` |
+|---------|------|------|
+| PR identifier optional (current branch inference) | ✅ | ✅ |
+| `--fill` / `--fill-first` / `--fill-verbose` | ✅ | ✅ |
+| `--editor` | ✅ | ✅ |
+| `--dry-run` | ✅ | ✅ |
+| `--web` (create/view in browser) | ✅ | ✅ |
+| `--remove-*` flags for edit commands | ✅ | ✅ |
+| `pr ready --undo` (convert to draft) | ✅ | ✅ |
+| `pr review --comment` / `--request-changes` | ✅ | ✅ (fallback) |
+| `--json fields` | ✅ | ✅ |
+| `-q jq` filtering | ✅ | ✅ |
+| `-t template` formatting | ✅ | ✅ |
+| Command aliases (`ls` → `list`, `new` → `create`) | ✅ | ✅ |
+| Multi-value options (`--label bug --label feature`) | ✅ | ✅ |
+
+### 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
+- **Issue create/update API**: GitCode puts `repo` in request body, not URL path
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/yourusername/pygitcode.git
+cd pygitcode
+
+# Install in editable mode with dev dependencies
+pip install -e ".[dev]"
+
+# Install pre-commit hooks
+pre-commit install
+
+# Run all checks manually
+pre-commit run --all-files
+
+# Or run individually
+python -m pytest tests/unit/ --cov=gitcode_cli
+python -m ruff check src/ tests/
+python -m ruff format src/ tests/
+python -m basedpyright src/
+```
+
+## Roadmap
+
+See [ROADMAP.md](ROADMAP.md) for planned features and current gaps.
+
+## License
+
+MIT

pygitcode-0.1.0/pyproject.toml

@@ -0,0 +1,128 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pygitcode"
+version = "0.1.0"
+description = "A CLI tool for GitCode (api.gitcode.com), modeled after GitHub CLI."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "codeasier", email = "825770651@qq.com" },
+]
+keywords = ["gitcode", "cli", "git", "api", "vcs", "developer-tools"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+dependencies = [
+    "click>=8.0",
+    "httpx>=0.24",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "pytest-mock>=3.14",
+    "respx>=0.21",
+    "ruff>=0.6",
+    "black>=24.0",
+    "basedpyright>=1.19",
+    "pre-commit>=3.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/pygitcode"
+Documentation = "https://github.com/yourusername/pygitcode#readme"
+Repository = "https://github.com/yourusername/pygitcode.git"
+Issues = "https://github.com/yourusername/pygitcode/issues"
+
+[project.scripts]
+gc = "gitcode_cli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+# --- pytest ---
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = [
+    "--cov=gitcode_cli",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+    "--cov-fail-under=90",
+]
+
+# --- ruff ---
+[tool.ruff]
+target-version = "py39"
+line-length = 120
+src = ["src"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # Pyflakes
+    "I",   # isort
+    "N",   # pep8-naming
+    "UP",  # pyupgrade
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "SIM", # flake8-simplify
+    "ARG", # flake8-unused-arguments
+    "PL",  # Pylint
+]
+ignore = [
+    "PLR2004", # Magic value used in comparison
+    "PLR0913", # Too many arguments in function definition (common for Click commands and API methods)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["ARG", "PLC0415", "SIM117"]
+"tests/conftest.py" = ["ARG", "PLC0415", "F401"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+# --- black ---
+[tool.black]
+line-length = 120
+target-version = ["py39", "py310", "py311", "py312", "py313"]
+include = "\\.pyi?$"
+
+# --- basedpyright ---
+[tool.basedpyright]
+pythonVersion = "3.9"
+include = ["src"]
+typeCheckingMode = "standard"
+reportMissingTypeStubs = false
+reportAny = false
+reportUnknownMemberType = false
+reportUnknownVariableType = false
+reportUnknownArgumentType = false
+reportUnknownParameterType = false
+reportOptionalSubscript = false
+reportOptionalMemberAccess = false
+reportOptionalIterable = false
+reportOptionalOperand = false
+reportMissingImports = false

pygitcode-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pygitcode-0.1.0/src/gitcode_cli/__init__.py

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

pygitcode-0.1.0/src/gitcode_cli/cli.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import click
+
+from . import __version__
+from .commands.auth import auth_group
+from .commands.issue import issue_group
+from .commands.pr import pr_group
+from .config import get_token
+from .context import AppContext
+from .errors import GCError
+
+
+@click.group(context_settings={"help_option_names": ["-h", "--help"]})
+@click.version_option(version=__version__, prog_name="gc")
+@click.option("--repo", "repo_name", "-R", help="Select another repository using the [HOST/]OWNER/REPO format.")
+@click.option("--token", hidden=True, help="Override authentication token.")
+@click.pass_context
+def main(ctx: click.Context, repo_name: str | None, token: str | None) -> None:
+    ctx.ensure_object(dict)
+    try:
+        resolved_token = token or get_token()
+    except GCError:
+        resolved_token = token
+    ctx.obj["app"] = AppContext(token=resolved_token or "", repo=repo_name)
+
+
+@main.result_callback()
+def process_result(*_args: object, **_kwargs: object) -> None:
+    return None
+
+
+@main.command("version")
+def version_command() -> None:
+    click.echo(f"gc version {__version__}")
+
+
+main.add_command(auth_group)
+main.add_command(issue_group)
+main.add_command(pr_group)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()