codeberg-cli 0.1.0__py3-none-any.whl

codeberg_cli/routes/repo/list.py

@@ -0,0 +1,36 @@
+from typing import Annotated
+
+import rich
+from rich.table import Table
+
+from codeberg_cli.helpers import require_client
+from xclif import Option, command
+
+
+@command("list", "ls")
+def _(
+    owner: Annotated[str, Option(description="Owner (user or org)")] = "",
+    limit: Annotated[int, Option(description="Maximum number of repos")] = 30,
+) -> None:
+    """List repositories for a user or organization."""
+    client = require_client()
+
+    if owner:
+        repos = client.get(f"/users/{owner}/repos", params={"limit": limit, "page": 1}, action=f"Fetching {owner}'s repositories")
+    else:
+        repos = client.get("/user/repos", params={"limit": limit, "page": 1}, action="Fetching your repositories")
+
+    if not repos:
+        rich.print("[dim]No repositories found.[/dim]")
+        return
+
+    table = Table("Name", "Visibility", "Description")
+    for repo in repos:
+        table.add_row(
+            repo["full_name"],
+            "[green]public[/green]" if not repo.get("private") else "[yellow]private[/yellow]",
+            repo.get("description") or "",
+        )
+    rich.print(table)
+
+

codeberg_cli/routes/repo/view.py

@@ -0,0 +1,41 @@
+import webbrowser
+from typing import Annotated
+
+import rich
+from rich.markup import escape
+
+from codeberg_cli.git import infer_repo
+from codeberg_cli.helpers import require_client
+from xclif import Arg, Option, command
+
+
+@command("view")
+def _(
+    repo: Annotated[str, Option(description="Repository in owner/repo format")] = "",
+    web: Annotated[bool, Option(description="Open in browser", name="web")] = False,
+) -> None:
+    """View a repository."""
+    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
+
+    if web:
+        webbrowser.open(f"https://codeberg.org/{repo}")
+        return
+
+    data = client.get(f"/repos/{repo}")
+
+    rich.print(f"[bold]{data['full_name']}[/bold]")
+    if data.get("description"):
+        rich.print(escape(data["description"]))
+    rich.print(f"  [dim]Stars:[/dim] {data.get('stars_count', 0)}  [dim]Forks:[/dim] {data.get('forks_count', 0)}")
+    rich.print(f"  [dim]Language:[/dim] {data.get('language', 'N/A')}")
+    rich.print(f"  [dim]Visibility:[/dim] {'Private' if data.get('private') else 'Public'}")
+    rich.print(f"  [dim]URL:[/dim] https://codeberg.org/{repo}")
+
+

codeberg_cli-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,49 @@
+codeberg_cli/__main__.py,sha256=ysV0kHP-Q-sUwHOInLcB-QEryJfNNv-amdHP0EubG-8,113
+codeberg_cli/client.py,sha256=wqf5mOR9Uyku7v_GZRjFQUZsYAfqiWXcJv_DMmubQWU,2242
+codeberg_cli/config.py,sha256=bjVHHM1sG3xTIU6EC7sakwR0nnP-ZsCtO4Jn2od6X4A,822
+codeberg_cli/git.py,sha256=oWOU8iV4FUbtZLA7RvDqRur6whYDoJKoIcUPtBxJZto,1544
+codeberg_cli/helpers.py,sha256=0JGASGM_td_q2l9YOF1KybisZFofKeT5jC4q-G_lS48,627
+codeberg_cli/routes/__init__.py,sha256=LPAm_RsDHeREJ-57n8CwFAdkXkTcykx9zjrKhQZFuvI,86
+codeberg_cli/routes/api.py,sha256=o8she7_o32DNuYqr1v9D0hEHjujW1xEZEhHuxIzKO_8,720
+codeberg_cli/routes/auth/__init__.py,sha256=TxwcK78EFqRSsHs2iSVRQ8Og4upvq91P3fcKcOFpbFQ,41
+codeberg_cli/routes/auth/login.py,sha256=jcarfwPedC2xWqbs-ncNNZXI_5Kv4mdHt7IQa3azAqg,656
+codeberg_cli/routes/auth/logout.py,sha256=LfsYchVxrr77R5c2WNGbKNCLbkyQtbobkhcpw1DH8HA,351
+codeberg_cli/routes/auth/status.py,sha256=fkMgFiwEOBNNNDkJ4S0ahx9epfRQZzXVdYu6KEI4oQI,640
+codeberg_cli/routes/auth/whoami.py,sha256=RjXbklkr0ajFX3BT9B8k1Qr6zSooaZWmQ-9oqjFcshs,272
+codeberg_cli/routes/issue/__init__.py,sha256=RRWKFz7LRRGD3shDlBXRdLSO6IebeLLlzdjY3qRCrqQ,42
+codeberg_cli/routes/issue/close.py,sha256=RAAJiFPVV4FrNStlviMzUw9ZZjSj-h80sCfG0mZysl0,774
+codeberg_cli/routes/issue/create.py,sha256=UW-ilstUjQ2Lu16UZJOjBH8eCMNO3DDF0dPSR-0PE3g,1726
+codeberg_cli/routes/issue/list.py,sha256=bolDAmeI7saZ6AGnWsSOQmRHqgRWm21EP8rKINfXbUI,1502
+codeberg_cli/routes/issue/reopen.py,sha256=QsxWU_1Qed6hdmFs9AiNKk191WkJLeeKInAINeSiiTA,782
+codeberg_cli/routes/issue/view.py,sha256=7pU0vJmgGiaRFDQ_MDESOtPVu9SEoWVH8piN9bzClYo,1515
+codeberg_cli/routes/label/__init__.py,sha256=7yTJhxfd1ErLUoYJVKKhtbmSmC6kwIbUwNcIsu7dAas,42
+codeberg_cli/routes/label/create.py,sha256=Oqlf-xouSJg0nbDc-31e5b_d46d-XzCOXNIc9JVnKcc,1124
+codeberg_cli/routes/label/delete.py,sha256=AGffQbsEwsGwFXtgIQltABWcLREAV1p4kpu4Xzamle4,759
+codeberg_cli/routes/label/list.py,sha256=sVFfQsWkQVi4WqGIP03apabWzPFIgUvHktsRuqugw34,1248
+codeberg_cli/routes/milestone/__init__.py,sha256=0LihqWaCxPtc9yYPmXsorKagjKt065qsnPNfnO2MGAY,46
+codeberg_cli/routes/milestone/create.py,sha256=VDA9q3y8uEDRJ3oIOPn2EWsUwvrNpeOviAXQFSLv7E4,1086
+codeberg_cli/routes/milestone/list.py,sha256=LRoUmHMgamOqMuo085cEoIU9tdPhXduqN5DWd-JFUg8,1514
+codeberg_cli/routes/pr/__init__.py,sha256=8WsMUvMJmcd5BJaSfMXVIaTNkEnrgFyCEGynl2VKKZI,39
+codeberg_cli/routes/pr/checkout.py,sha256=B5wYePvASjoFp3G1rMbpBjicbe0DPibFxIlMlO7W204,1221
+codeberg_cli/routes/pr/close.py,sha256=Xge_cP9K0prup9CUvvSjuMj_NgF6ZG00SF0Ciets-t0,795
+codeberg_cli/routes/pr/create.py,sha256=VT5Xu_BQQKsgzZjKnNeVHq7jsQKbf6tMUO_1Rgufa6U,2093
+codeberg_cli/routes/pr/list.py,sha256=bA4C9BN4E9xlmnDTHKkFh-zClLQ2agPU8fWz2lMT6rA,1286
+codeberg_cli/routes/pr/merge.py,sha256=AIP-mm_Fvq0HG7v_vm7eYwtuU61JKLzjJqbFuZqnqgg,915
+codeberg_cli/routes/pr/view.py,sha256=uaIGzGtMY21K9SAF2qRN58lLpMLQ2Dw1D19nbtke6gw,1373
+codeberg_cli/routes/release/__init__.py,sha256=4NdEUIvolvOMJ8XFP-GkPleiTCo0xvf6JIcXbUf25kE,44
+codeberg_cli/routes/release/create.py,sha256=nFTJCWEAc2S_lAoi-moeQqi4b6l_Q10FDdZYcMa24DQ,1387
+codeberg_cli/routes/release/list.py,sha256=81mSZCYM0udIEt4j9-JV4o_A3AKUjbKvBg5D5veFqtg,1289
+codeberg_cli/routes/release/upload.py,sha256=QG_jmUTamOsGajRVhtZ8N7H0_oMY_DWiIMobBkSeu3g,1674
+codeberg_cli/routes/release/view.py,sha256=o9I1I9nkJjTcqMfxQdtXbTITZWxVYGiwmL6JrVPyg84,1683
+codeberg_cli/routes/repo/__init__.py,sha256=UB56y2Kc_0altG6JrTvSYb5cFunqeQsDMdu5d4q_ROc,41
+codeberg_cli/routes/repo/clone.py,sha256=mFk3i4Qf5MZObh_bcQniO36FuNNBJNWZQhB9QR_4lSI,511
+codeberg_cli/routes/repo/create.py,sha256=XUw3TQjhwB6oL0FnshnBVEKvjSQiWTs8fUOZHh-EkwY,2803
+codeberg_cli/routes/repo/delete.py,sha256=ubUotlWGxLZ3MigHIrWd5Y3xV4LVlWdZZxyfVVKEz24,755
+codeberg_cli/routes/repo/fork.py,sha256=ApVdzAFXetNQJ8R9WUk-gejB2BDJ11cTFb3pn0V5MBg,810
+codeberg_cli/routes/repo/list.py,sha256=8Lledw3c_JVmmn3K4CFRxo6kINWErTa6Y2CdIqJ6mH0,1104
+codeberg_cli/routes/repo/view.py,sha256=ypJPFPsQKiQ1xw8LFZ04PFWNcP7N_ce9J5XWD2wlMXo,1311
+codeberg_cli-0.1.0.dist-info/METADATA,sha256=zMqXfnXqXzE2UwiUgnO6ukwF_PLNNL7xyXT3NO3y5Is,5812
+codeberg_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+codeberg_cli-0.1.0.dist-info/entry_points.txt,sha256=7Kg1K5av7D5TzPCqX_qyFCj09JTneIEvW0f2Gp4q1v4,49
+codeberg_cli-0.1.0.dist-info/licenses/LICENSE,sha256=o71itnX05JiF5qOrKHEmWIvuf03sgYcwsc3r6AAW_h0,1065
+codeberg_cli-0.1.0.dist-info/RECORD,,

codeberg_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

codeberg_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cb = codeberg_cli.__main__:cli

codeberg_cli-0.1.0.dist-info/licenses/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.