codeberg-cli 0.4.1__py3-none-any.whl → 0.5.0__py3-none-any.whl

codeberg_cli/client.py

@@ -16,6 +16,10 @@ _VERBS = {
 class ClientError(RuntimeError):
     """Raised when the API returns a non-2xx status."""
 
+    def __init__(self, message: str, status_code: int | None = None) -> None:
+        super().__init__(message)
+        self.status_code = status_code
+
 
 def _response_error_message(response: httpx.Response) -> str:
     if not response.text:
@@ -52,7 +56,12 @@ class Client:
         raw = raw.rstrip("/")
         if not raw.endswith("/api/v1"):
             raw += "/api/v1"
-        self._client = httpx.Client(base_url=raw, headers=headers, timeout=30.0)
+        self._client = httpx.Client(
+            base_url=raw,
+            headers=headers,
+            timeout=30.0,
+            follow_redirects=True,
+        )
 
     @property
     def base_url(self) -> str:
@@ -75,9 +84,13 @@ class Client:
         return self._request("PATCH", path, json=data, action=action)
 
     def put(
-        self, path: str, data: dict | None = None, action: str | None = None
+        self,
+        path: str,
+        data: dict | None = None,
+        params: dict | None = None,
+        action: str | None = None,
     ) -> dict | list:
-        return self._request("PUT", path, json=data, action=action)
+        return self._request("PUT", path, json=data, params=params, action=action)
 
     def delete(self, path: str, action: str | None = None) -> None:
         self._request("DELETE", path, action=action)
@@ -99,7 +112,9 @@ class Client:
             response = self._client.request(method, path, **kwargs)
         if not response.is_success:
             msg = _response_error_message(response)
-            raise ClientError(f"{response.status_code} {msg}")
+            raise ClientError(
+                f"{response.status_code} {msg}", status_code=response.status_code
+            )
         if response.status_code == 204:
             return None
         return response.json()

codeberg_cli/routes/actions/_format.py

@@ -1,4 +1,27 @@
-from typing import Any
+from typing import Any, Callable, TypeVar
+
+from codeberg_cli.client import ClientError
+from xclif.errors import UsageError
+
+T = TypeVar("T")
+
+
+def actions_request(repo: str, call: Callable[[], T]) -> T:
+    """Run an Actions API *call*, turning a 404 into a clear message.
+
+    Forgejo returns 404 for Actions endpoints when Actions is not enabled on
+    the repository (or the repo does not exist), which is otherwise surfaced as
+    an opaque ``404 The target couldn't be found.`` traceback.
+    """
+    try:
+        return call()
+    except ClientError as exc:
+        if exc.status_code == 404:
+            raise UsageError(
+                f"No Actions found for {repo}.",
+                hint="Actions may be disabled for this repository, or the repository may not exist.",
+            ) from exc
+        raise
 
 
 def _first(run: dict[str, Any], *keys: str, default: str = "") -> Any:

codeberg_cli/routes/actions/dispatch.py

@@ -23,9 +23,20 @@ def _(
             return 1
         repo = inferred
 
-    client.post(
-        f"/repos/{repo}/actions/workflows/{workflow}/dispatches",
-        data={"ref": ref},
-        action="Dispatching workflow",
-    )
+    from codeberg_cli.client import ClientError
+    from xclif.errors import UsageError
+
+    try:
+        client.post(
+            f"/repos/{repo}/actions/workflows/{workflow}/dispatches",
+            data={"ref": ref},
+            action="Dispatching workflow",
+        )
+    except ClientError as exc:
+        if exc.status_code == 404:
+            raise UsageError(
+                f"No workflow {workflow!r} found in {repo}.",
+                hint="List workflows with 'cb actions workflows', or Actions may be disabled for this repository.",
+            ) from exc
+        raise
     rich.print(f"[green]Dispatched {workflow} on {ref} in {repo}.[/green]")

codeberg_cli/routes/actions/run.py

@@ -24,7 +24,18 @@ def _(
             return 1
         repo = inferred
 
-    run = client.get(f"/repos/{repo}/actions/runs/{run_id}")
+    from codeberg_cli.client import ClientError
+    from xclif.errors import UsageError
+
+    try:
+        run = client.get(f"/repos/{repo}/actions/runs/{run_id}")
+    except ClientError as exc:
+        if exc.status_code == 404:
+            raise UsageError(
+                f"No run #{run_id} found in {repo}.",
+                hint="Check the run ID with 'cb actions runs', or Actions may be disabled for this repository.",
+            ) from exc
+        raise
 
     if is_json_mode():
         output(run)

codeberg_cli/routes/actions/runs.py

@@ -6,7 +6,7 @@ from codeberg_cli.git import infer_repo
 from codeberg_cli.helpers import print_table, require_client
 from xclif import Option, command
 
-from codeberg_cli.routes.actions._format import list_runs, normalize_run
+from codeberg_cli.routes.actions._format import actions_request, list_runs, normalize_run
 
 
 @command("runs")
@@ -24,7 +24,10 @@ def _(
             return 1
         repo = inferred
 
-    response = client.get(f"/repos/{repo}/actions/runs", params={"limit": limit, "page": 1})
+    response = actions_request(
+        repo,
+        lambda: client.get(f"/repos/{repo}/actions/runs", params={"limit": limit, "page": 1}),
+    )
     runs = list_runs(response)
 
     if not runs:

codeberg_cli/routes/actions/workflows.py

@@ -34,7 +34,7 @@ def _(
             action="Fetching workflow files",
         )
     except ClientError as exc:
-        if str(exc).startswith("404 "):
+        if exc.status_code == 404:
             rich.print(f"[dim]No workflows in {repo}.[/dim]")
             return
         raise

codeberg_cli/routes/issue/assets/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("assets")
+def _() -> None:
+    """Manage issue attachments."""

codeberg_cli/routes/issue/assets/delete.py

@@ -0,0 +1,27 @@
+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("delete")
+def _(
+    index: Annotated[int, Arg(description="Issue number")],
+    attachment_id: Annotated[int, Arg(description="Attachment ID")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Delete an issue attachment."""
+    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.delete(f"/repos/{repo}/issues/{index}/assets/{attachment_id}")
+    rich.print(f"[bold green]Deleted[/bold green] attachment #{attachment_id}")

codeberg_cli/routes/issue/assets/list.py

@@ -0,0 +1,47 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.git import infer_repo
+from codeberg_cli.helpers import print_table, require_client
+from xclif import Arg, Option, command
+
+
+@command("list", "ls")
+def _(
+    index: Annotated[int, Arg(description="Issue number")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """List issue attachments."""
+    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
+
+    assets = client.get(f"/repos/{repo}/issues/{index}/assets")
+
+    if not assets:
+        rich.print("[dim]No attachments.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for asset in assets:
+        rows.append((
+            str(asset["id"]),
+            asset["name"],
+            str(asset.get("size", "")),
+            asset.get("browser_download_url", ""),
+        ))
+        json_rows.append({
+            "id": asset["id"],
+            "name": asset["name"],
+            "size": asset.get("size"),
+            "browser_download_url": asset.get("browser_download_url"),
+        })
+
+    print_table(["ID", "Name", "Size", "Download"], rows, json_data=json_rows)

codeberg_cli/routes/issue/assets/upload.py

@@ -0,0 +1,50 @@
+from pathlib import Path
+from typing import Annotated
+
+import httpx
+import rich
+
+from codeberg_cli.git import infer_repo
+from codeberg_cli.helpers import require_client
+from xclif import Arg, Option, command
+
+
+@command("upload")
+def _(
+    index: Annotated[int, Arg(description="Issue number")],
+    file: Annotated[str, Arg(description="File to upload")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Upload an issue attachment."""
+    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
+
+    file_path = Path(file)
+    if not file_path.exists():
+        rich.print(f"[bold red]Error:[/bold red] File not found: {file}")
+        return 1
+
+    with open(file_path, "rb") as f:
+        content = f.read()
+
+    # Direct multipart upload (bypasses Client for multipart support)
+    token = client._client.headers.get("Authorization", "").replace("Bearer ", "")
+    headers = {"Authorization": f"Bearer {token}"}
+
+    response = httpx.post(
+        f"{client.base_url}/repos/{repo}/issues/{index}/assets",
+        headers=headers,
+        files={"attachment": (file_path.name, content)},
+    )
+    if response.is_success:
+        rich.print(f"[bold green]Uploaded[/bold green] {file_path.name} to issue #{index}")
+    else:
+        msg = response.json().get("message", "unknown error") if response.text else "unknown error"
+        rich.print(f"[bold red]Error:[/bold red] {response.status_code} {msg}")
+        return 1

codeberg_cli/routes/issue/deps/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("deps")
+def _() -> None:
+    """Manage issue dependencies (blocked-by)."""

codeberg_cli/routes/issue/deps/add.py

@@ -0,0 +1,27 @@
+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("add")
+def _(
+    index: Annotated[int, Arg(description="Issue number")],
+    depends_on: Annotated[int, Arg(description="Issue number this one depends on")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Add a dependency to an issue."""
+    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}/issues/{index}/dependencies", data={"index": depends_on})
+    rich.print(f"[bold green]Issue[/bold green] #{index} now depends on #{depends_on}")

codeberg_cli/routes/issue/deps/list.py

@@ -0,0 +1,41 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.git import infer_repo
+from codeberg_cli.helpers import print_table, require_client
+from xclif import Arg, Option, command
+
+
+@command("list", "ls")
+def _(
+    index: Annotated[int, Arg(description="Issue number")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """List issue dependencies."""
+    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
+
+    deps = client.get(f"/repos/{repo}/issues/{index}/dependencies")
+
+    if not deps:
+        rich.print("[dim]No dependencies.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for dep in deps:
+        rows.append((str(dep["number"]), dep["title"], dep.get("state", "")))
+        json_rows.append({
+            "number": dep["number"],
+            "title": dep["title"],
+            "state": dep.get("state"),
+        })
+
+    print_table(["#", "Title", "State"], rows, json_data=json_rows)

codeberg_cli/routes/issue/deps/remove.py

@@ -0,0 +1,36 @@
+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("remove")
+def _(
+    index: Annotated[int, Arg(description="Issue number")],
+    depends_on: Annotated[int, Arg(description="Issue number this one depends on")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Remove a dependency from an issue."""
+    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
+
+    response = client._client.request(
+        "DELETE",
+        f"/repos/{repo}/issues/{index}/dependencies",
+        json={"index": depends_on},
+    )
+    if not response.is_success:
+        msg = response.json().get("message", "unknown error") if response.text else "unknown error"
+        rich.print(f"[bold red]Error:[/bold red] {response.status_code} {msg}")
+        return 1
+
+    rich.print(f"[bold green]Removed[/bold green] dependency #{depends_on} from issue #{index}")

codeberg_cli/routes/issue/react.py

@@ -0,0 +1,40 @@
+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("react")
+def _(
+    index: Annotated[int, Arg(description="Issue number")],
+    content: Annotated[str, Arg(description="Reaction emoji, e.g. +1, -1, heart, laugh")],
+    remove: Annotated[bool, Option(description="Remove the reaction instead of adding it", name="remove")] = False,
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Add or remove a reaction on an issue."""
+    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 remove:
+        response = client._client.request(
+            "DELETE",
+            f"/repos/{repo}/issues/{index}/reactions",
+            json={"content": content},
+        )
+        if not response.is_success:
+            msg = response.json().get("message", "unknown error") if response.text else "unknown error"
+            rich.print(f"[bold red]Error:[/bold red] {response.status_code} {msg}")
+            return 1
+        rich.print(f"[bold green]Removed[/bold green] reaction :{content}:")
+    else:
+        client.post(f"/repos/{repo}/issues/{index}/reactions", data={"content": content})
+        rich.print(f"[bold green]Added[/bold green] reaction :{content}:")

codeberg_cli/routes/issue/reactions.py

@@ -0,0 +1,39 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.git import infer_repo
+from codeberg_cli.helpers import print_table, require_client
+from xclif import Arg, Option, command
+
+
+@command("reactions")
+def _(
+    index: Annotated[int, Arg(description="Issue number")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """List reactions on an issue."""
+    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
+
+    reactions = client.get(f"/repos/{repo}/issues/{index}/reactions")
+
+    if not reactions:
+        rich.print("[dim]No reactions.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for reaction in reactions:
+        user = (reaction.get("user") or {}).get("login", "")
+        content = reaction.get("content", "")
+        rows.append((user, content))
+        json_rows.append({"user": user, "content": content})
+
+    print_table(["User", "Reaction"], rows, json_data=json_rows)

codeberg_cli/routes/keys/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("keys")
+def _() -> None:
+    """Manage your SSH and GPG keys."""

codeberg_cli/routes/keys/gpg/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("gpg")
+def _() -> None:
+    """Manage GPG keys."""

codeberg_cli/routes/keys/gpg/add.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.helpers import require_client
+from xclif import Arg, Option, command
+
+
+@command("add")
+def _(
+    armored_key: Annotated[str, Option(description="The armored public GPG key", name="armored-key")] = "",
+    key_file: Annotated[str, Option(description="Read the armored public key from a file path", name="key-file")] = "",
+) -> None:
+    """Add a GPG key."""
+    client = require_client()
+
+    value = armored_key
+    if key_file:
+        file_path = Path(key_file)
+        if not file_path.exists():
+            rich.print(f"[bold red]Error:[/bold red] File not found: {key_file}")
+            return 1
+        value = file_path.read_text().strip()
+
+    if not value:
+        rich.print("[bold red]Error:[/bold red] No key provided (pass an armored_key argument or --key-file)")
+        return 1
+
+    result = client.post("/user/gpg_keys", data={"armored_public_key": value})
+    rich.print(f"[bold green]Added GPG key[/bold green] #{result['id']}")

codeberg_cli/routes/keys/gpg/delete.py

@@ -0,0 +1,17 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.helpers import require_client
+from xclif import Arg, command
+
+
+@command("delete")
+def _(
+    id: Annotated[int, Arg(description="GPG key ID")],
+) -> None:
+    """Delete a GPG key."""
+    client = require_client()
+
+    client.delete(f"/user/gpg_keys/{id}")
+    rich.print(f"[bold green]Deleted GPG key[/bold green] #{id}")

codeberg_cli/routes/keys/gpg/list.py

@@ -0,0 +1,29 @@
+import rich
+
+from codeberg_cli.helpers import print_table, require_client
+from xclif import command
+
+
+@command("list", "ls")
+def _() -> None:
+    """List your GPG keys."""
+    client = require_client()
+
+    keys = client.get("/user/gpg_keys")
+
+    if not keys:
+        rich.print("[dim]No GPG keys.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for key in keys:
+        rows.append((str(key["id"]), key.get("key_id", ""), str(key.get("can_sign", False))))
+        json_rows.append({
+            "id": key["id"],
+            "key_id": key.get("key_id"),
+            "can_sign": key.get("can_sign"),
+            "created_at": key.get("created_at"),
+        })
+
+    print_table(["ID", "Key ID", "Can Sign"], rows, json_data=json_rows)

codeberg_cli/routes/keys/ssh/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("ssh")
+def _() -> None:
+    """Manage SSH keys."""

codeberg_cli/routes/keys/ssh/add.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.helpers import require_client
+from xclif import Arg, Option, command
+
+
+@command("add")
+def _(
+    title: Annotated[str, Arg(description="Title for the SSH key")],
+    key: Annotated[str, Option(description="The public key string", name="key")] = "",
+    key_file: Annotated[str, Option(description="Read the public key from a file path", name="key-file")] = "",
+) -> None:
+    """Add an SSH key."""
+    client = require_client()
+
+    if key_file:
+        file_path = Path(key_file)
+        if not file_path.exists():
+            rich.print(f"[bold red]Error:[/bold red] File not found: {key_file}")
+            return 1
+        key = file_path.read_text().strip()
+
+    if not key:
+        rich.print("[bold red]Error:[/bold red] No key provided (pass a key argument or --key-file)")
+        return 1
+
+    result = client.post("/user/keys", data={"title": title, "key": key})
+    rich.print(f"[bold green]Added SSH key[/bold green] #{result['id']}")

codeberg_cli/routes/keys/ssh/delete.py

@@ -0,0 +1,17 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.helpers import require_client
+from xclif import Arg, command
+
+
+@command("delete")
+def _(
+    id: Annotated[int, Arg(description="SSH key ID")],
+) -> None:
+    """Delete an SSH key."""
+    client = require_client()
+
+    client.delete(f"/user/keys/{id}")
+    rich.print(f"[bold green]Deleted SSH key[/bold green] #{id}")