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

codeberg_cli/client.py

@@ -84,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)

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}")

codeberg_cli/routes/keys/ssh/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 SSH keys."""
+    client = require_client()
+
+    keys = client.get("/user/keys")
+
+    if not keys:
+        rich.print("[dim]No SSH keys.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for key in keys:
+        rows.append((str(key["id"]), key.get("title", ""), key.get("fingerprint", "")))
+        json_rows.append({
+            "id": key["id"],
+            "title": key.get("title"),
+            "fingerprint": key.get("fingerprint"),
+            "created_at": key.get("created_at"),
+        })
+
+    print_table(["ID", "Title", "Fingerprint"], rows, json_data=json_rows)

codeberg_cli/routes/notify/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("notify")
+def _() -> None:
+    """View and manage notifications."""

codeberg_cli/routes/{notifications.py → notify/list.py}

@@ -6,7 +6,7 @@ from codeberg_cli.helpers import print_table, require_client
 from xclif import Option, command
 
 
-@command("notifications")
+@command("list", "notifications")
 def _(
     limit: Annotated[int, Option(description="Maximum notifications to show", name="limit")] = 30,
     all: Annotated[bool, Option(description="Show all notifications, not just unread", name="all")] = False,
@@ -15,7 +15,9 @@ def _(
     client = require_client()
 
     params: dict = {"limit": limit, "page": 1}
-    if not all:
+    if all:
+        params["all"] = "true"
+    else:
         params["status-types"] = "unread"
 
     notifications = client.get("/notifications", params=params)

codeberg_cli/routes/notify/read.py

@@ -0,0 +1,23 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.helpers import require_client
+from xclif import Option, command
+
+
+@command("read")
+def _(
+    all: Annotated[bool, Option(description="Mark all notifications as read", name="all")] = False,
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Mark notifications as read."""
+    client = require_client()
+
+    params = {"all": "true"} if all else None
+    if repo:
+        client.put(f"/repos/{repo}/notifications", params=params)
+    else:
+        client.put("/notifications", params=params)
+
+    rich.print("[bold green]Marked[/bold green] notifications as read")

codeberg_cli/routes/notify/thread.py

@@ -0,0 +1,31 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.helpers import is_json_mode, output, require_client
+from xclif import Arg, Option, command
+
+
+@command("thread")
+def _(
+    id: Annotated[int, Arg(description="Thread ID")],
+    read: Annotated[bool, Option(description="Mark the thread as read", name="read")] = False,
+) -> None:
+    """View or mark a notification thread."""
+    client = require_client()
+
+    if read:
+        client.patch(f"/notifications/threads/{id}")
+        rich.print(f"[bold green]Marked[/bold green] thread #{id} read")
+        return
+
+    thread = client.get(f"/notifications/threads/{id}")
+
+    if is_json_mode():
+        output(thread)
+        return
+
+    subject = thread.get("subject", {})
+    repo = thread.get("repository", {})
+    rich.print(f"[bold]#{thread['id']}[/bold] [bold]{subject.get('title', '')}[/bold]")
+    rich.print(f"[dim]{subject.get('type', '')}[/dim] in [dim]{repo.get('full_name', '')}[/dim]")

codeberg_cli/routes/pr/review.py

@@ -0,0 +1,44 @@
+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("review")
+def _(
+    id: Annotated[int, Arg(description="PR number")],
+    approve: Annotated[bool, Option(description="Approve the pull request", name="approve")] = False,
+    request_changes: Annotated[bool, Option(description="Request changes", name="request-changes")] = False,
+    comment: Annotated[bool, Option(description="Submit a comment review", name="comment")] = False,
+    body: Annotated[str, Option(description="Review body", name="body")] = "",
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Submit a review on a pull request."""
+    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 sum([approve, request_changes, comment]) > 1:
+        rich.print("[bold red]Error:[/bold red] Choose at most one of --approve/--request-changes/--comment")
+        return 1
+
+    if approve:
+        event = "APPROVED"
+    elif request_changes:
+        event = "REQUEST_CHANGES"
+    elif comment:
+        event = "COMMENT"
+    else:
+        rich.print("[bold red]Error:[/bold red] Specify one of --approve, --request-changes, or --comment")
+        return 1
+
+    client.post(f"/repos/{repo}/pulls/{id}/reviews", data={"event": event, "body": body})
+    rich.print(f"[bold green]Submitted[/bold green] {event} review on PR #{id}")