codeberg-cli 0.1.0__tar.gz

codeberg_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+on:
+  push:
+  pull_request:
+jobs:
+  test:
+    strategy:
+      matrix:
+        python-version:
+          - "3.12"
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Check out repository code
+        uses: actions/checkout@v4
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Install just
+        uses: extractions/setup-just@v2
+      - name: Install dependencies
+        run: just install
+      - name: Run test suite
+        run: just test
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository code
+        uses: actions/checkout@v4
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+      - name: Install just
+        uses: extractions/setup-just@v2
+      - name: Build project
+        run: just build

codeberg_cli-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,24 @@
+name: Release Asset Uploader
+on:
+  release:
+    types:
+      - created
+permissions:
+  contents: write
+  id-token: write
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+      - name: Build artifacts
+        run: uv build
+      - name: Upload artifacts
+        uses: shogo82148/actions-upload-release-asset@v1
+        with:
+          upload_url: ${{ github.event.release.upload_url }}
+          asset_path: dist/*
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

codeberg_cli-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.env
+.DS_Store

codeberg_cli-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

codeberg_cli-0.1.0/Justfile

@@ -0,0 +1,21 @@
+default: test
+
+# Run the test suite
+test *args:
+    uv run pytest {{ args }}
+
+# Run tests with coverage report
+cov:
+    uv run pytest --cov=src/codeberg_cli --cov-report=term-missing
+
+# Build the distribution (wheel + sdist)
+build:
+    uv build
+
+# Remove build artifacts
+clean:
+    rm -rf dist
+
+# Install all dependency groups
+install:
+    uv sync --all-groups

codeberg_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bryan Hu
+
+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.

codeberg_cli-0.1.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: codeberg-cli
+Version: 0.1.0
+Summary: A Codeberg CLI
+Project-URL: Homepage, https://codeberg.org/ThatXliner/codeberg-cli
+Project-URL: Repository, https://codeberg.org/ThatXliner/codeberg-cli
+Project-URL: Issues, https://codeberg.org/ThatXliner/codeberg-cli/issues
+Author-email: Bryan Hu <thatxliner@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,codeberg,forgejo
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.12
+Requires-Dist: httpx
+Requires-Dist: platformdirs
+Requires-Dist: tomlkit
+Requires-Dist: xclif>=0.4.3
+Description-Content-Type: text/markdown
+
+# cb — A Codeberg CLI
+
+[![CI](https://github.com/ThatXliner/cb/actions/workflows/ci.yml/badge.svg)](https://github.com/ThatXliner/cb/actions/workflows/ci.yml) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/codeberg-cli)](https://pypi.org/project/codeberg-cli)
+[![PyPI](https://img.shields.io/pypi/v/codeberg-cli)](https://pypi.org/project/codeberg-cli)
+[![PyPI - License](https://img.shields.io/pypi/l/codeberg-cli)](#license)
+
+`cb` is a native CLI for [Codeberg](https://codeberg.org) (a [Forgejo](https://forgejo.org) instance) — think `gh` for Codeberg. Built with [Xclif](https://xclif.readthedocs.io).
+
+```text
+# One-time setup
+cb auth login
+
+# Work with repos, issues, PRs, releases
+cb repo list
+cb issue create --title "Fix the thing"
+cb pr create --base main --head fix
+cb release create v0.2.0
+```
+
+## Install
+
+```bash
+pip install codeberg-cli  # or: uv tool install codeberg-cli
+```
+
+Or from source:
+
+```bash
+git clone https://codeberg.org/ThatXliner/codeberg-cli
+cd cb
+uv tool install .
+```
+
+## Quickstart
+
+```bash
+# Authenticate (tokens at https://codeberg.org/user/settings/applications)
+cb auth login
+
+# Who am I?
+cb auth whoami
+
+# List your repos
+cb repo list
+
+# Clone one
+cb repo clone ThatXliner/cb
+
+# Open an issue
+cb issue create --title "suggestion" --body "what about..."
+```
+
+## Commands
+
+### `cb auth` — authentication
+
+| Command | Description |
+|---------|-------------|
+| `login` | Store a Codeberg access token |
+| `logout` | Remove stored credentials |
+| `status` | Show login state |
+| `whoami` | Print current username |
+
+### `cb repo` — repositories
+
+Infer `owner/repo` from `git remote origin`. Override with `--repo`.
+
+| Command | Description |
+|---------|-------------|
+| `create` | Create a repo (`--org`, `--private`, `--description`) |
+| `list` | List repos for a user or org |
+| `clone` | Clone via `git clone` |
+| `view` | Show repo details (`--web` to open browser) |
+| `fork` | Fork a repo |
+| `delete` | Delete a repo (requires confirmation) |
+
+### `cb label` — labels
+
+| Command | Description |
+|---------|-------------|
+| `list` (alias: `ls`) | List repo labels |
+| `create` | Create a label (`--color`, `--description`) |
+| `delete` | Delete a label by ID |
+
+### `cb milestone` — milestones
+
+| Command | Description |
+|---------|-------------|
+| `list` (alias: `ls`) | List milestones (`--state`) |
+| `create` | Create a milestone (`--description`, `--due-on`) |
+
+### `cb issue` — issues
+
+| Command | Description |
+|---------|-------------|
+| `create` | Create an issue (`--labels`, omit `--body` to open stdin) |
+| `list` | List issues (`--state`, `--label`, `--limit`) |
+| `view` | View an issue with comments (`--web`) |
+| `close` | Close an issue |
+| `reopen` | Reopen a closed issue |
+
+### `cb pr` — pull requests
+
+| Command | Description |
+|---------|-------------|
+| `create` | Open a PR (omit `--body` to open `$EDITOR`) |
+| `list` | List PRs (alias: `ls`) |
+| `view` | View a PR (`--web`) |
+| `merge` | Merge with `--style merge|rebase|squash` |
+| `checkout` | Fetch and checkout a PR locally (alias: `co`) |
+| `close` | Close without merging |
+
+### `cb release` — releases
+
+| Command | Description |
+|---------|-------------|
+| `create` | Tag a release (`--prerelease`, `--draft`) |
+| `list` | List releases |
+| `view` | View a release (`--web`) |
+| `upload` | Attach a file to a release |
+
+### `cb api` — raw API access
+
+```bash
+cb api GET /version
+cb api POST /repos/owner/repo/issues --data '{"title": "hi"}'
+```
+
+## Config
+
+Token stored in `$XDG_CONFIG_HOME/cb/config.toml` (managed by `cb auth login` / `cb auth logout`).
+
+## Comparison
+
+There are two other CLI tools you can use with Codeberg:
+
+| | **cb** | **fj** (forgejo-cli) | **berg** (codeberg-cli) |
+|---|---|---|---|
+| Language | Python | Rust | Rust |
+| Codeberg-native | Yes (targets `codeberg.org/api/v1`) | Generic (any Forgejo instance) | Yes |
+| Issues | create, list, view, close, reopen | open, edit, comment, close | yes |
+| Pull requests | create, list, view, merge, checkout, close | create, merge | yes |
+| Releases | create, list, view, upload | publish | — |
+| Repos | create, list, clone, view, fork, delete | create, edit, star, watch | yes |
+| Labels | create, list, delete | — | yes |
+| Milestones | create, list | — | yes |
+| Raw API | `cb api GET /path` | — | — |
+| AGit PRs (no-fork) | — | yes | — |
+| Org/team mgmt | — | yes | — |
+| Install | `pip install codeberg-cli` | prebuilt binaries | `cargo install codeberg-cli` |
+| Size | ~300 lines | Rust binary | Rust binary |
+
+**Choose `fj`** if you self-host Forgejo or need org/team management. **Choose `berg`** if you want labels and milestones from a Rust binary. **Choose `cb`** if you want a minimal, readable Python CLI with release management and raw API access — `cb` is also the only one that uploads release assets.
+
+## License
+
+MIT

codeberg_cli-0.1.0/README.md

@@ -0,0 +1,157 @@
+# cb — A Codeberg CLI
+
+[![CI](https://github.com/ThatXliner/cb/actions/workflows/ci.yml/badge.svg)](https://github.com/ThatXliner/cb/actions/workflows/ci.yml) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/codeberg-cli)](https://pypi.org/project/codeberg-cli)
+[![PyPI](https://img.shields.io/pypi/v/codeberg-cli)](https://pypi.org/project/codeberg-cli)
+[![PyPI - License](https://img.shields.io/pypi/l/codeberg-cli)](#license)
+
+`cb` is a native CLI for [Codeberg](https://codeberg.org) (a [Forgejo](https://forgejo.org) instance) — think `gh` for Codeberg. Built with [Xclif](https://xclif.readthedocs.io).
+
+```text
+# One-time setup
+cb auth login
+
+# Work with repos, issues, PRs, releases
+cb repo list
+cb issue create --title "Fix the thing"
+cb pr create --base main --head fix
+cb release create v0.2.0
+```
+
+## Install
+
+```bash
+pip install codeberg-cli  # or: uv tool install codeberg-cli
+```
+
+Or from source:
+
+```bash
+git clone https://codeberg.org/ThatXliner/codeberg-cli
+cd cb
+uv tool install .
+```
+
+## Quickstart
+
+```bash
+# Authenticate (tokens at https://codeberg.org/user/settings/applications)
+cb auth login
+
+# Who am I?
+cb auth whoami
+
+# List your repos
+cb repo list
+
+# Clone one
+cb repo clone ThatXliner/cb
+
+# Open an issue
+cb issue create --title "suggestion" --body "what about..."
+```
+
+## Commands
+
+### `cb auth` — authentication
+
+| Command | Description |
+|---------|-------------|
+| `login` | Store a Codeberg access token |
+| `logout` | Remove stored credentials |
+| `status` | Show login state |
+| `whoami` | Print current username |
+
+### `cb repo` — repositories
+
+Infer `owner/repo` from `git remote origin`. Override with `--repo`.
+
+| Command | Description |
+|---------|-------------|
+| `create` | Create a repo (`--org`, `--private`, `--description`) |
+| `list` | List repos for a user or org |
+| `clone` | Clone via `git clone` |
+| `view` | Show repo details (`--web` to open browser) |
+| `fork` | Fork a repo |
+| `delete` | Delete a repo (requires confirmation) |
+
+### `cb label` — labels
+
+| Command | Description |
+|---------|-------------|
+| `list` (alias: `ls`) | List repo labels |
+| `create` | Create a label (`--color`, `--description`) |
+| `delete` | Delete a label by ID |
+
+### `cb milestone` — milestones
+
+| Command | Description |
+|---------|-------------|
+| `list` (alias: `ls`) | List milestones (`--state`) |
+| `create` | Create a milestone (`--description`, `--due-on`) |
+
+### `cb issue` — issues
+
+| Command | Description |
+|---------|-------------|
+| `create` | Create an issue (`--labels`, omit `--body` to open stdin) |
+| `list` | List issues (`--state`, `--label`, `--limit`) |
+| `view` | View an issue with comments (`--web`) |
+| `close` | Close an issue |
+| `reopen` | Reopen a closed issue |
+
+### `cb pr` — pull requests
+
+| Command | Description |
+|---------|-------------|
+| `create` | Open a PR (omit `--body` to open `$EDITOR`) |
+| `list` | List PRs (alias: `ls`) |
+| `view` | View a PR (`--web`) |
+| `merge` | Merge with `--style merge|rebase|squash` |
+| `checkout` | Fetch and checkout a PR locally (alias: `co`) |
+| `close` | Close without merging |
+
+### `cb release` — releases
+
+| Command | Description |
+|---------|-------------|
+| `create` | Tag a release (`--prerelease`, `--draft`) |
+| `list` | List releases |
+| `view` | View a release (`--web`) |
+| `upload` | Attach a file to a release |
+
+### `cb api` — raw API access
+
+```bash
+cb api GET /version
+cb api POST /repos/owner/repo/issues --data '{"title": "hi"}'
+```
+
+## Config
+
+Token stored in `$XDG_CONFIG_HOME/cb/config.toml` (managed by `cb auth login` / `cb auth logout`).
+
+## Comparison
+
+There are two other CLI tools you can use with Codeberg:
+
+| | **cb** | **fj** (forgejo-cli) | **berg** (codeberg-cli) |
+|---|---|---|---|
+| Language | Python | Rust | Rust |
+| Codeberg-native | Yes (targets `codeberg.org/api/v1`) | Generic (any Forgejo instance) | Yes |
+| Issues | create, list, view, close, reopen | open, edit, comment, close | yes |
+| Pull requests | create, list, view, merge, checkout, close | create, merge | yes |
+| Releases | create, list, view, upload | publish | — |
+| Repos | create, list, clone, view, fork, delete | create, edit, star, watch | yes |
+| Labels | create, list, delete | — | yes |
+| Milestones | create, list | — | yes |
+| Raw API | `cb api GET /path` | — | — |
+| AGit PRs (no-fork) | — | yes | — |
+| Org/team mgmt | — | yes | — |
+| Install | `pip install codeberg-cli` | prebuilt binaries | `cargo install codeberg-cli` |
+| Size | ~300 lines | Rust binary | Rust binary |
+
+**Choose `fj`** if you self-host Forgejo or need org/team management. **Choose `berg`** if you want labels and milestones from a Rust binary. **Choose `cb`** if you want a minimal, readable Python CLI with release management and raw API access — `cb` is also the only one that uploads release assets.
+
+## License
+
+MIT

codeberg_cli-0.1.0/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "codeberg-cli"
+version = "0.1.0"
+description = "A Codeberg CLI"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+authors = [
+    { name = "Bryan Hu", email = "thatxliner@gmail.com" },
+]
+keywords = ["codeberg", "forgejo", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = [
+    "xclif>=0.4.3",
+    "httpx",
+    "tomlkit",
+    "platformdirs",
+]
+
+[project.urls]
+Homepage = "https://codeberg.org/ThatXliner/codeberg-cli"
+Repository = "https://codeberg.org/ThatXliner/codeberg-cli"
+Issues = "https://codeberg.org/ThatXliner/codeberg-cli/issues"
+
+[project.scripts]
+cb = "codeberg_cli.__main__:cli"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/codeberg_cli"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-httpx>=0.30.0",
+]

codeberg_cli-0.1.0/src/codeberg_cli/__main__.py

@@ -0,0 +1,8 @@
+from xclif import Cli
+
+from . import routes
+
+cli = Cli.from_routes(routes)
+
+if __name__ == "__main__":
+    cli()

codeberg_cli-0.1.0/src/codeberg_cli/client.py

@@ -0,0 +1,70 @@
+import httpx
+from rich.status import Status
+from xclif.context import get_context
+
+BASE_URL = "https://codeberg.org/api/v1"
+
+_VERBS = {
+    "GET": "Fetching",
+    "POST": "Creating",
+    "PATCH": "Updating",
+    "DELETE": "Deleting",
+}
+
+
+class ClientError(RuntimeError):
+    """Raised when the API returns a non-2xx status."""
+
+
+class Client:
+    """HTTP client for the Codeberg API."""
+
+    def __init__(self, token: str | None = None) -> None:
+        headers = {
+            "Accept": "application/json",
+            "User-Agent": "codeberg-cli/0.1.0",
+            "Content-Type": "application/json",
+        }
+        if token:
+            headers["Authorization"] = f"Bearer {token}"
+        self._client = httpx.Client(base_url=BASE_URL, headers=headers, timeout=30.0)
+
+    def get(
+        self, path: str, params: dict | None = None, action: str | None = None
+    ) -> dict | list:
+        return self._request("GET", path, params=params, action=action)
+
+    def post(
+        self, path: str, data: dict | None = None, action: str | None = None
+    ) -> dict | list:
+        return self._request("POST", path, json=data, action=action)
+
+    def patch(
+        self, path: str, data: dict | None = None, action: str | None = None
+    ) -> dict | list:
+        return self._request("PATCH", path, json=data, action=action)
+
+    def delete(self, path: str, action: str | None = None) -> None:
+        self._request("DELETE", path, action=action)
+
+    def _request(
+        self, method: str, path: str, action: str | None = None, **kwargs
+    ) -> dict | list | None:
+        ctx = get_context()
+        label = action or (
+            f"{method} {path}"
+            if ctx.verbosity >= 2
+            else f"{_VERBS.get(method, method)} {path.split('/')[-1]}"
+        )
+        with Status(f"{label}..."):
+            response = self._client.request(method, path, **kwargs)
+        if not response.is_success:
+            msg = (
+                response.json().get("message", "unknown error")
+                if response.text
+                else "unknown error"
+            )
+            raise ClientError(f"{response.status_code} {msg}")
+        if response.status_code == 204:
+            return None
+        return response.json()

codeberg_cli-0.1.0/src/codeberg_cli/config.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+import tomlkit
+from platformdirs import user_config_path
+
+
+def get_config_path() -> Path:
+    """Return the config directory for codeberg-cli."""
+    return user_config_path("codeberg-cli", ensure_exists=False)
+
+
+def config_file_path() -> Path:
+    """Return the path to the config file."""
+    return get_config_path() / "config.toml"
+
+
+def load_config() -> dict:
+    """Load config from ~/.config/codeberg-cli/config.toml. Returns {} if missing."""
+    path = config_file_path()
+    if not path.exists():
+        return {}
+    return dict(tomlkit.parse(path.read_text()))
+
+
+def save_config(data: dict) -> None:
+    """Save config to ~/.config/codeberg-cli/config.toml."""
+    path = config_file_path()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(tomlkit.dumps(data))

codeberg_cli-0.1.0/src/codeberg_cli/git.py

@@ -0,0 +1,49 @@
+import re
+import subprocess
+from pathlib import Path
+
+
+def parse_repo_from_remote(remote_url: str) -> str:
+    """Extract owner/repo from a git remote URL."""
+    # HTTPS: https://codeberg.org/owner/repo.git
+    # SSH: git@codeberg.org:owner/repo.git
+    m = re.search(r"codeberg\.org[:/](.+?)(?:\.git)?/?$", remote_url)
+    if m:
+        return m.group(1)
+    raise ValueError(f"Could not parse repo from remote: {remote_url}")
+
+
+def get_default_branch(cwd: Path) -> str:
+    """Get the default branch name for a repo."""
+    try:
+        result = subprocess.run(
+            ["git", "rev-parse", "--abbrev-ref", "HEAD"],
+            capture_output=True, text=True, check=True, cwd=cwd,
+        )
+        return result.stdout.strip()
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return "main"
+
+
+def get_repo_remote(cwd: Path | None = None) -> str | None:
+    """Get the 'origin' remote URL from a git repo, or None."""
+    try:
+        result = subprocess.run(
+            ["git", "remote", "get-url", "origin"],
+            capture_output=True, text=True, check=True,
+            cwd=cwd or Path.cwd(),
+        )
+        return result.stdout.strip()
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return None
+
+
+def infer_repo(cwd: Path | None = None) -> str | None:
+    """Infer owner/repo from git remote origin."""
+    remote = get_repo_remote(cwd)
+    if remote is None:
+        return None
+    try:
+        return parse_repo_from_remote(remote)
+    except ValueError:
+        return None

codeberg_cli-0.1.0/src/codeberg_cli/helpers.py

@@ -0,0 +1,20 @@
+from codeberg_cli.client import Client, ClientError
+from codeberg_cli.config import load_config
+
+
+def get_authenticated_client() -> Client | None:
+    """Return a Client if token is stored, else None."""
+    config = load_config()
+    token = config.get("token")
+    if not token:
+        return None
+    return Client(token=token)
+
+
+def require_client() -> Client:
+    """Return an authenticated Client or print error and exit."""
+    client = get_authenticated_client()
+    if client is None:
+        from xclif.errors import UsageError
+        raise UsageError("Not logged in. Run 'cb auth login' first.")
+    return client