codeberg-cli 0.2.0__tar.gz → 0.4.0__tar.gz

codeberg_cli-0.4.0/PKG-INFO

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: codeberg-cli
+Version: 0.4.0
+Summary: A Forgejo CLI — works with Codeberg and any Forgejo instance
+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.5.1
+Description-Content-Type: text/markdown
+
+# cb — A Codeberg CLI
+
+[![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 CLI for [Codeberg](https://codeberg.org) (a [Forgejo](https://forgejo.org) instance) — think `gh` for Codeberg. It also works with any Forgejo instance. 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.git
+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..."
+
+# See everything you can do
+cb --help
+```
+
+## Config
+
+Token stored in `$XDG_CONFIG_HOME/codeberg-cli/config.toml` (managed by `cb auth login` / `cb auth logout`).
+
+View or change config:
+
+```bash
+cb config path  # Show config file location
+cb config get   # Print all config values
+cb config set base_url "https://codeberg.org/api/v1"     # Codeberg (default)
+cb config set base_url "https://git.example.com/api/v1"  # Self-hosted Forgejo
+```
+
+## Comparison
+
+Here's how `cb` stacks up against other Forgejo CLI tools. *Last updated: May 2026.*
+
+| | **cb** (this) | **fj** (forgejo-cli) | **berg** (codeberg-cli) | **tea** (gitea/tea) | **gcli** |
+|---|---|---|---|---|---|
+| Language | Python | Rust | Rust | Go | C |
+| Version | v0.2.0 | v0.5.0 | v0.5.1 | v0.13.0 | v2.11.0 |
+| Install | `pip install codeberg-cli` | prebuilt binaries/Cargo | `cargo install codeberg-cli` | `brew install tea` | `brew install gcli` |
+| Multi-instance | `cb config set base_url` | `-H <instance>` | `BERG_BASE_URL` | `tea login add` | `-t forgejo` |
+
+### Issues
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | ✅ | ✅ | ✅ | ✅ |
+| List | ✅ | ✅ | ✅ | ✅ | ✅ |
+| View | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Close | ✅ | ✅ | ✅ | ✅ | — |
+| Reopen | ✅ | — | ✅ | ✅ | — |
+| Comment | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Edit | ✅ | — | ✅ | ✅ | — |
+| Delete | ✅ | — | — | — | — |
+| Pin/Unpin | ✅ | — | — | ✅ | — |
+| Search | ✅ | ✅ | — | ✅ | — |
+| Attachments | — | — | — | ✅ | — |
+| Labels (manage on issue) | ✅ | — | — | ✅ | — |
+| Reactions | — | — | — | — | — |
+| Subscriptions | ✅ | — | — | ✅ | — |
+| Tracked times | ✅ | — | — | — | ✅ |
+| Dependencies | — | — | — | — | — |
+| Deadline | — | — | — | ✅ | — |
+| Templates | — | ✅ | — | — | — |
+
+### Pull Requests
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | ✅ | ✅ | ✅ | ✅ |
+| List | ✅ | ✅ | ✅ | ✅ | ✅ |
+| View | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Merge | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Close | ✅ | — | ✅ | ✅ | — |
+| Reopen | ✅ | — | ✅ | ✅ | — |
+| Comment | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Edit | ✅ | — | ✅ | ✅ | — |
+| Checkout | ✅ | — | ✅ | ✅ | ✅ |
+| Commits | ✅ | — | — | ✅ | — |
+| Files/changed | ✅ | — | — | ✅ | — |
+| Reviews | — | ✅ | — | ✅ | ✅ |
+| Diff/Patch | ✅ | — | — | ✅ | — |
+| Update branch | ✅ | — | — | ✅ | — |
+| AGit (no-fork) | — | ✅ | — | — | — |
+| CI status | — | ✅ | — | — | — |
+| Templates | — | ✅ | — | — | — |
+| Auto-merge | — | — | — | ✅ | — |
+
+### Releases
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | ✅ | ✅ | ✅ | ✅ |
+| List | ✅ | ✅ | ✅ | ✅ | ✅ |
+| View | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Upload assets | ✅ | — | ✅ | — | ✅ |
+| Delete | ✅ | — | — | ✅ | ✅ |
+| Edit | ✅ | — | — | ✅ | — |
+| Latest | ✅ | — | — | ✅ | — |
+| By tag | ✅ | — | — | ✅ | — |
+
+### Repositories
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | ✅ | ✅ | ✅ | ✅ |
+| List | ✅ | ✅ | ✅ | ✅ | ✅ |
+| View | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Clone | ✅ | — | ✅ | ✅ | — |
+| Fork | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Delete | ✅ | — | ✅ | ✅ | — |
+| Star | ✅ | ✅ | ✅ | ✅ | — |
+| Unstar | ✅ | — | ✅ | ✅ | — |
+| Watch/Unwatch | ✅ | ✅ | — | ✅ | — |
+| Edit | ✅ | ✅ | — | ✅ | — |
+| Migrate/Mirror | ✅ | ✅ | — | ✅ | — |
+| Branches | ✅ | — | — | ✅ | — |
+| Topics | ✅ | — | — | ✅ | — |
+| Languages | ✅ | — | — | — | — |
+| Hooks | — | — | — | ✅ | — |
+| Archive | ✅ | — | — | ✅ | — |
+| Commits | ✅ | — | — | — | — |
+| Contents | ✅ | — | — | ✅ | — |
+| Collaborators | ✅ | — | — | ✅ | — |
+| Transfer | ✅ | — | — | ✅ | — |
+| Wikis | — | — | — | ✅ | — |
+| Push mirrors | — | — | — | ✅ | — |
+| Search | ✅ | — | — | ✅ | — |
+
+### Labels
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | — | ✅ | ✅ | ✅ |
+| List | ✅ | — | ✅ | ✅ | ✅ |
+| Delete | ✅ | — | ✅ | ✅ | — |
+| Edit | ✅ | — | — | ✅ | — |
+
+### Milestones
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | — | ✅ | ✅ | — |
+| List | ✅ | — | ✅ | ✅ | ✅ |
+| View | ✅ | — | — | ✅ | — |
+| Delete | ✅ | — | — | ✅ | — |
+| Edit | ✅ | — | — | ✅ | — |
+
+### Notifications
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| List | ✅ | — | ✅ | ✅ | ✅ |
+| Mark read | — | — | — | ✅ | — |
+| Thread details | — | — | — | ✅ | — |
+| Per-repo | — | — | — | ✅ | — |
+
+### Extra
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Raw API | ✅ | — | ✅ | — | ✅ |
+| User profiles | ✅ | ✅ | — | — | — |
+| SSH keys | — | ✅ | — | ✅ | ✅ |
+| GPG keys | — | ✅ | — | — | — |
+| Org/team mgmt | ✅ | ✅ | — | ✅ | — |
+| Forgejo Actions | ✅ | ✅ | — | — | — |
+| Shell completions | ✅ (auto via xclif) | ✅ | ✅ | ✅ | — |
+| JSON output | ✅ (via `--json`) | — | ✅ | ✅ | — |
+| Non-interactive | auto (no prompts) | — | ✅ | ✅ | — |
+| Config management | ✅ | — | ✅ | — | — |
+| Web browser flag | on view commands | — | — | ✅ | — |
+
+**`cb` is the most feature-complete Forgejo CLI** — by a wide margin. It dominates on repo management (branches, topics, languages, tags, commits, contents, collaborators, search, archive, transfer, watch/unwatch, sync-fork, migrate), issues (delete, pin, labels, search, subscribe, tracked times), PRs (diff, commits, files, reopen, update), releases (delete, edit, latest, by-tag), and extras (Actions, org/team management, `--json` on every command, raw API, release uploads). Built in Python with [Xclif](https://xclif.readthedocs.io) for a clean, hackable codebase. If something's missing, open an issue!
+
+## License
+
+MIT

codeberg_cli-0.4.0/README.md

@@ -0,0 +1,207 @@
+# cb — A Codeberg CLI
+
+[![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 CLI for [Codeberg](https://codeberg.org) (a [Forgejo](https://forgejo.org) instance) — think `gh` for Codeberg. It also works with any Forgejo instance. 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.git
+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..."
+
+# See everything you can do
+cb --help
+```
+
+## Config
+
+Token stored in `$XDG_CONFIG_HOME/codeberg-cli/config.toml` (managed by `cb auth login` / `cb auth logout`).
+
+View or change config:
+
+```bash
+cb config path  # Show config file location
+cb config get   # Print all config values
+cb config set base_url "https://codeberg.org/api/v1"     # Codeberg (default)
+cb config set base_url "https://git.example.com/api/v1"  # Self-hosted Forgejo
+```
+
+## Comparison
+
+Here's how `cb` stacks up against other Forgejo CLI tools. *Last updated: May 2026.*
+
+| | **cb** (this) | **fj** (forgejo-cli) | **berg** (codeberg-cli) | **tea** (gitea/tea) | **gcli** |
+|---|---|---|---|---|---|
+| Language | Python | Rust | Rust | Go | C |
+| Version | v0.2.0 | v0.5.0 | v0.5.1 | v0.13.0 | v2.11.0 |
+| Install | `pip install codeberg-cli` | prebuilt binaries/Cargo | `cargo install codeberg-cli` | `brew install tea` | `brew install gcli` |
+| Multi-instance | `cb config set base_url` | `-H <instance>` | `BERG_BASE_URL` | `tea login add` | `-t forgejo` |
+
+### Issues
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | ✅ | ✅ | ✅ | ✅ |
+| List | ✅ | ✅ | ✅ | ✅ | ✅ |
+| View | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Close | ✅ | ✅ | ✅ | ✅ | — |
+| Reopen | ✅ | — | ✅ | ✅ | — |
+| Comment | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Edit | ✅ | — | ✅ | ✅ | — |
+| Delete | ✅ | — | — | — | — |
+| Pin/Unpin | ✅ | — | — | ✅ | — |
+| Search | ✅ | ✅ | — | ✅ | — |
+| Attachments | — | — | — | ✅ | — |
+| Labels (manage on issue) | ✅ | — | — | ✅ | — |
+| Reactions | — | — | — | — | — |
+| Subscriptions | ✅ | — | — | ✅ | — |
+| Tracked times | ✅ | — | — | — | ✅ |
+| Dependencies | — | — | — | — | — |
+| Deadline | — | — | — | ✅ | — |
+| Templates | — | ✅ | — | — | — |
+
+### Pull Requests
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | ✅ | ✅ | ✅ | ✅ |
+| List | ✅ | ✅ | ✅ | ✅ | ✅ |
+| View | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Merge | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Close | ✅ | — | ✅ | ✅ | — |
+| Reopen | ✅ | — | ✅ | ✅ | — |
+| Comment | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Edit | ✅ | — | ✅ | ✅ | — |
+| Checkout | ✅ | — | ✅ | ✅ | ✅ |
+| Commits | ✅ | — | — | ✅ | — |
+| Files/changed | ✅ | — | — | ✅ | — |
+| Reviews | — | ✅ | — | ✅ | ✅ |
+| Diff/Patch | ✅ | — | — | ✅ | — |
+| Update branch | ✅ | — | — | ✅ | — |
+| AGit (no-fork) | — | ✅ | — | — | — |
+| CI status | — | ✅ | — | — | — |
+| Templates | — | ✅ | — | — | — |
+| Auto-merge | — | — | — | ✅ | — |
+
+### Releases
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | ✅ | ✅ | ✅ | ✅ |
+| List | ✅ | ✅ | ✅ | ✅ | ✅ |
+| View | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Upload assets | ✅ | — | ✅ | — | ✅ |
+| Delete | ✅ | — | — | ✅ | ✅ |
+| Edit | ✅ | — | — | ✅ | — |
+| Latest | ✅ | — | — | ✅ | — |
+| By tag | ✅ | — | — | ✅ | — |
+
+### Repositories
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | ✅ | ✅ | ✅ | ✅ |
+| List | ✅ | ✅ | ✅ | ✅ | ✅ |
+| View | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Clone | ✅ | — | ✅ | ✅ | — |
+| Fork | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Delete | ✅ | — | ✅ | ✅ | — |
+| Star | ✅ | ✅ | ✅ | ✅ | — |
+| Unstar | ✅ | — | ✅ | ✅ | — |
+| Watch/Unwatch | ✅ | ✅ | — | ✅ | — |
+| Edit | ✅ | ✅ | — | ✅ | — |
+| Migrate/Mirror | ✅ | ✅ | — | ✅ | — |
+| Branches | ✅ | — | — | ✅ | — |
+| Topics | ✅ | — | — | ✅ | — |
+| Languages | ✅ | — | — | — | — |
+| Hooks | — | — | — | ✅ | — |
+| Archive | ✅ | — | — | ✅ | — |
+| Commits | ✅ | — | — | — | — |
+| Contents | ✅ | — | — | ✅ | — |
+| Collaborators | ✅ | — | — | ✅ | — |
+| Transfer | ✅ | — | — | ✅ | — |
+| Wikis | — | — | — | ✅ | — |
+| Push mirrors | — | — | — | ✅ | — |
+| Search | ✅ | — | — | ✅ | — |
+
+### Labels
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | — | ✅ | ✅ | ✅ |
+| List | ✅ | — | ✅ | ✅ | ✅ |
+| Delete | ✅ | — | ✅ | ✅ | — |
+| Edit | ✅ | — | — | ✅ | — |
+
+### Milestones
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Create | ✅ | — | ✅ | ✅ | — |
+| List | ✅ | — | ✅ | ✅ | ✅ |
+| View | ✅ | — | — | ✅ | — |
+| Delete | ✅ | — | — | ✅ | — |
+| Edit | ✅ | — | — | ✅ | — |
+
+### Notifications
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| List | ✅ | — | ✅ | ✅ | ✅ |
+| Mark read | — | — | — | ✅ | — |
+| Thread details | — | — | — | ✅ | — |
+| Per-repo | — | — | — | ✅ | — |
+
+### Extra
+| | **cb** | **fj** | **berg** | **tea** | **gcli** |
+|---|---|---|---|---|---|
+| Raw API | ✅ | — | ✅ | — | ✅ |
+| User profiles | ✅ | ✅ | — | — | — |
+| SSH keys | — | ✅ | — | ✅ | ✅ |
+| GPG keys | — | ✅ | — | — | — |
+| Org/team mgmt | ✅ | ✅ | — | ✅ | — |
+| Forgejo Actions | ✅ | ✅ | — | — | — |
+| Shell completions | ✅ (auto via xclif) | ✅ | ✅ | ✅ | — |
+| JSON output | ✅ (via `--json`) | — | ✅ | ✅ | — |
+| Non-interactive | auto (no prompts) | — | ✅ | ✅ | — |
+| Config management | ✅ | — | ✅ | — | — |
+| Web browser flag | on view commands | — | — | ✅ | — |
+
+**`cb` is the most feature-complete Forgejo CLI** — by a wide margin. It dominates on repo management (branches, topics, languages, tags, commits, contents, collaborators, search, archive, transfer, watch/unwatch, sync-fork, migrate), issues (delete, pin, labels, search, subscribe, tracked times), PRs (diff, commits, files, reopen, update), releases (delete, edit, latest, by-tag), and extras (Actions, org/team management, `--json` on every command, raw API, release uploads). Built in Python with [Xclif](https://xclif.readthedocs.io) for a clean, hackable codebase. If something's missing, open an issue!
+
+## License
+
+MIT

{codeberg_cli-0.2.0 → codeberg_cli-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codeberg-cli"
-version = "0.2.0"
+version = "0.4.0"
 description = "A Forgejo CLI — works with Codeberg and any Forgejo instance"
 readme = "README.md"
 license = "MIT"
@@ -19,7 +19,7 @@ classifiers = [
     "Topic :: Software Development :: Version Control :: Git",
 ]
 dependencies = [
-    "xclif>=0.4.3",
+    "xclif>=0.5.1",
     "httpx",
     "tomlkit",
     "platformdirs",
@@ -37,9 +37,6 @@ cb = "codeberg_cli.__main__:cli"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.uv.sources]
-xclif = { path = "../xclif" }
-
 [tool.hatch.build.targets.wheel]
 packages = ["src/codeberg_cli"]
 

{codeberg_cli-0.2.0 → codeberg_cli-0.4.0}/src/codeberg_cli/client.py

@@ -7,6 +7,7 @@ DEFAULT_BASE_URL = "https://codeberg.org"
 _VERBS = {
     "GET": "Fetching",
     "POST": "Creating",
+    "PUT": "Updating",
     "PATCH": "Updating",
     "DELETE": "Deleting",
 }
@@ -55,6 +56,11 @@ class Client:
     ) -> dict | list:
         return self._request("PATCH", path, json=data, action=action)
 
+    def put(
+        self, path: str, data: dict | None = None, action: str | None = None
+    ) -> dict | list:
+        return self._request("PUT", path, json=data, action=action)
+
     def delete(self, path: str, action: str | None = None) -> None:
         self._request("DELETE", path, action=action)
 

codeberg_cli-0.4.0/src/codeberg_cli/helpers.py

@@ -0,0 +1,120 @@
+from __future__ import annotations
+
+import json as _json
+import sys
+from collections.abc import Iterable, Mapping
+from typing import Any
+
+import rich
+
+from codeberg_cli.client import Client, ClientError, DEFAULT_BASE_URL
+from codeberg_cli.config import load_config
+
+
+def is_json_mode() -> bool:
+    """Check whether ``--json`` was passed on the CLI."""
+    return "--json" in sys.argv[1:]
+
+
+def output(
+    data: Any,
+    *,
+    json: bool | None = None,
+    default: str | None = None,
+) -> None:
+    """Print *data* as JSON or fall back to *default* text.
+
+    When ``json=True`` (or global ``--json`` was passed), data is printed as
+    prettified JSON.  When ``json=False`` the *default* string (if given) is
+    printed.  When *default* is ``None`` and JSON mode is off, this is a no-op
+    — the caller is expected to handle rich printing themselves.
+    """
+    if json is None:
+        json = is_json_mode()
+    if json:
+        _json.dump(
+            data,
+            sys.stdout,
+            indent=2,
+            default=str,
+        )
+        sys.stdout.write("\n")
+    elif default is not None:
+        rich.print(default)
+
+
+def print_table(
+    columns: list[str],
+    rows: Iterable[Iterable[str]],
+    *,
+    json: bool | None = None,
+    json_data: Any = None,
+    title: str | None = None,
+) -> None:
+    """Print a table, or JSON when ``--json`` is active.
+
+    When JSON mode is on, *json_data* is printed as JSON (or *rows* converted
+    to a list if no explicit json_data is given).  When not in JSON mode, a
+    rich ``Table`` is printed.
+    """
+    if json is None:
+        json = is_json_mode()
+    if json:
+        _json.dump(
+            json_data if json_data is not None else list(rows),
+            sys.stdout,
+            indent=2,
+            default=str,
+        )
+        sys.stdout.write("\n")
+        return
+
+    from rich.table import Table
+
+    table = Table(*columns, title=title)
+    for row in rows:
+        table.add_row(*row)
+    rich.print(table)
+
+
+def get_base_url() -> str:
+    """Get the web base URL from cascading CLI context or default."""
+    from xclif.context import get_context
+
+    try:
+        ctx = get_context()
+        raw = ctx.get("base_url", DEFAULT_BASE_URL)
+    except RuntimeError:
+        raw = DEFAULT_BASE_URL
+
+    # Normalize: ensure scheme, strip API path suffix for backward compat
+    if "://" not in raw:
+        raw = "https://" + raw
+    raw = raw.rstrip("/")
+    if raw.endswith("/api/v1"):
+        raw = raw[:-7]
+    return raw
+
+
+def get_web_base_url() -> str:
+    """Derive the web UI base URL from the API base URL."""
+    return get_base_url()
+
+
+def get_authenticated_client(base_url: str | None = None) -> 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, base_url=base_url or get_base_url())
+
+
+def require_client(base_url: str | None = None) -> Client:
+    """Return an authenticated Client or print error and exit."""
+    client = get_authenticated_client(base_url=base_url)
+    if client is None:
+        from xclif.errors import UsageError
+
+        raise UsageError("Not logged in. Run 'cb auth login' first.")
+    return client

{codeberg_cli-0.2.0 → codeberg_cli-0.4.0}/src/codeberg_cli/routes/__init__.py

@@ -5,5 +5,9 @@ from xclif import Cascade, WithConfig, command
 @command("cb")
 def _(
     base_url: Cascade[WithConfig[str]] = DEFAULT_BASE_URL,
+    json: bool = False,
 ) -> None:
-    """Interact with Codeberg or any Forgejo instance — manage repos, issues, PRs, releases, and more."""
+    """Interact with Codeberg or any Forgejo instance — manage repos, issues, PRs, releases, actions, and more.
+
+    Use --json on any command for machine-readable output.
+    """

codeberg_cli-0.4.0/src/codeberg_cli/routes/actions/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("actions")
+def _() -> None:
+    """Manage Forgejo Actions — view runs, list workflows, and dispatch workflows."""

codeberg_cli-0.4.0/src/codeberg_cli/routes/actions/dispatch.py

@@ -0,0 +1,31 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.git import infer_repo
+from codeberg_cli.helpers import require_client
+from xclif import Arg, Option, command
+
+
+@command("dispatch")
+def _(
+    workflow: Annotated[str, Arg(description="Workflow filename (e.g. ci.yml)")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+    ref: Annotated[str, Option(description="Branch or tag to dispatch on", name="ref")] = "main",
+) -> None:
+    """Dispatch a workflow (trigger a workflow_dispatch event)."""
+    client = require_client()
+
+    if not repo:
+        inferred = infer_repo()
+        if not inferred:
+            rich.print("[bold red]Error:[/bold red] No repo specified and not in a git directory")
+            return 1
+        repo = inferred
+
+    client.post(
+        f"/repos/{repo}/actions/workflows/{workflow}/dispatches",
+        data={"ref": ref},
+        action="Dispatching workflow",
+    )
+    rich.print(f"[green]Dispatched {workflow} on {ref} in {repo}.[/green]")