codeberg-cli 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

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/helpers.py

@@ -1,7 +1,82 @@
+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

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/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/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]")

codeberg_cli/routes/actions/run.py

@@ -0,0 +1,40 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.git import infer_repo
+from codeberg_cli.helpers import is_json_mode, output, require_client
+from xclif import Arg, Option, command
+
+
+@command("run")
+def _(
+    run_id: Annotated[int, Arg(description="Run ID")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """View details of a specific action run."""
+    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
+
+    run = client.get(f"/repos/{repo}/actions/runs/{run_id}")
+
+    if is_json_mode():
+        output(run)
+        return
+
+    rich.print(f"[bold]Run #{run['id']}:[/bold] {run['display_title']}")
+    rich.print(f"  Status:      {run.get('status', '?')}")
+    rich.print(f"  Conclusion:  {run.get('conclusion', 'N/A')}")
+    rich.print(f"  Event:       {run.get('event', '?')}")
+    rich.print(f"  Branch:      {run.get('head_branch', '?')}")
+    rich.print(f"  Commit:      {run.get('head_sha', '?')[:12]}")
+    rich.print(f"  Created:     {run.get('created_at', '?')}")
+    rich.print(f"  Updated:     {run.get('updated_at', '?')}")
+    if run.get("url"):
+        rich.print(f"  URL:         {run['url']}")

codeberg_cli/routes/actions/runs.py

@@ -0,0 +1,52 @@
+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 Option, command
+
+
+@command("runs")
+def _(
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+    limit: Annotated[int, Option(description="Maximum runs to show", name="limit")] = 20,
+) -> None:
+    """List action runs for 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
+
+    runs = client.get(f"/repos/{repo}/actions/runs", params={"limit": limit, "page": 1})
+
+    if not runs:
+        rich.print(f"[dim]No action runs in {repo}.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for run in runs:
+        status = run.get("status", "?")
+        conclusion = run.get("conclusion", "")
+        label = f"{status}" if not conclusion else f"{conclusion}"
+        rows.append((str(run["id"]), run["display_title"][:72], label, run["event"]))
+        json_rows.append({
+            "id": run["id"],
+            "title": run["display_title"],
+            "status": status,
+            "conclusion": conclusion,
+            "event": run["event"],
+            "created_at": run.get("created_at", ""),
+            "head_branch": run.get("head_branch", ""),
+        })
+
+    print_table(
+        ["ID", "Title", "Status", "Event"],
+        rows,
+        json_data=json_rows,
+    )

codeberg_cli/routes/actions/workflows.py

@@ -0,0 +1,46 @@
+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 Option, command
+
+
+@command("workflows")
+def _(
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """List workflows for 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
+
+    workflows = client.get(f"/repos/{repo}/actions/workflows")
+
+    if not workflows:
+        rich.print(f"[dim]No workflows in {repo}.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for wf in workflows:
+        state = wf.get("state", "?")
+        rows.append((str(wf["id"]), wf["name"], wf.get("filename", ""), state))
+        json_rows.append({
+            "id": wf["id"],
+            "name": wf["name"],
+            "filename": wf.get("filename", ""),
+            "state": state,
+        })
+
+    print_table(
+        ["ID", "Name", "Filename", "State"],
+        rows,
+        json_data=json_rows,
+    )

codeberg_cli/routes/issue/delete.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("delete")
+def _(
+    id: Annotated[int, Arg(description="Issue number")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Delete 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
+
+    confirm = input(f"Are you sure you want to delete issue #{id} in {repo}? [y/N] ").strip().lower()
+    if confirm != "y":
+        rich.print("[dim]Cancelled.[/dim]")
+        return
+
+    client.delete(f"/repos/{repo}/issues/{id}")
+    rich.print(f"[bold green]Deleted[/bold green] issue #{id} in {repo}")

codeberg_cli/routes/issue/labels/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("labels")
+def _() -> None:
+    """Manage issue labels — list, add, and remove."""

codeberg_cli/routes/issue/labels/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 _(
+    id: Annotated[int, Arg(description="Issue number")],
+    label: Annotated[str, Arg(description="Label name")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Add a label 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/{id}/labels", data={"labels": [label]})
+    rich.print(f"[bold green]Added label[/bold green] \"{label}\" to issue #{id} in {repo}")

codeberg_cli/routes/issue/labels/list.py

@@ -0,0 +1,43 @@
+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")
+def _(
+    id: Annotated[int, Arg(description="Issue number")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """List labels 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
+
+    labels = client.get(f"/repos/{repo}/issues/{id}/labels")
+
+    if not labels:
+        rich.print(f"[dim]No labels on issue #{id} in {repo}.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for label in labels:
+        color = label.get("color", "ffffff")
+        rows.append((str(label["id"]), f"#{color} {label['name']}", f"#{color}", label.get("description", "") or ""))
+        json_rows.append({
+            "id": label["id"],
+            "name": label["name"],
+            "color": f"#{color}",
+            "description": label.get("description", ""),
+        })
+
+    print_table(["#", "Name", "Color", "Description"], rows, json_data=json_rows)

codeberg_cli/routes/issue/labels/remove.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("remove")
+def _(
+    id: Annotated[int, Arg(description="Issue number")],
+    label: Annotated[str, Arg(description="Label identifier")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Remove a label 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
+
+    client.delete(f"/repos/{repo}/issues/{id}/labels/{label}")
+    rich.print(f"[bold green]Removed label[/bold green] \"{label}\" from issue #{id} in {repo}")

codeberg_cli/routes/issue/list.py

@@ -1,10 +1,9 @@
 from typing import Annotated
 
 import rich
-from rich.table import Table
 
 from codeberg_cli.git import infer_repo
-from codeberg_cli.helpers import require_client
+from codeberg_cli.helpers import print_table, require_client
 from xclif import Option, command
 
 
@@ -35,15 +34,21 @@ def _(
         rich.print(f"[dim]No {state} issues in {repo}.[/dim]")
         return
 
-    table = Table("#", "Title", "Author", "Labels")
+    rows = []
+    json_rows = []
     for issue in issues:
         labels_str = ", ".join(l["name"] for l in (issue.get("labels") or []))
-        table.add_row(
-            str(issue["number"]),
-            issue["title"],
-            issue["user"]["login"],
-            labels_str,
-        )
-    rich.print(table)
+        rows.append((str(issue["number"]), issue["title"], issue["user"]["login"], labels_str))
+        json_rows.append({
+            "number": issue["number"],
+            "title": issue["title"],
+            "author": issue["user"]["login"],
+            "state": issue.get("state"),
+            "labels": [l["name"] for l in (issue.get("labels") or [])],
+            "created_at": issue.get("created_at"),
+            "updated_at": issue.get("updated_at"),
+        })
+
+    print_table(["#", "Title", "Author", "Labels"], rows, json_data=json_rows)
 
 

codeberg_cli/routes/issue/pin.py

@@ -0,0 +1,26 @@
+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("pin")
+def _(
+    id: Annotated[int, Arg(description="Issue number")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Pin 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/{id}/pin")
+    rich.print(f"[bold green]Pinned[/bold green] issue #{id} in {repo}")

codeberg_cli/routes/issue/search.py

@@ -0,0 +1,59 @@
+from typing import Annotated
+
+import rich
+
+from codeberg_cli.helpers import print_table, require_client
+from xclif import Arg, Option, command
+
+
+@command("search")
+def _(
+    query: Annotated[str, Arg(description="Search query")],
+    state: Annotated[str, Option(description="Filter by state: open, closed", name="state")] = "open",
+    limit: Annotated[int, Option(description="Maximum results to show", name="limit")] = 30,
+    repo: Annotated[str, Option(description="Repository (owner/repo) to scope search", name="repo")] = "",
+) -> None:
+    """Search issues across repositories."""
+    client = require_client()
+
+    params = {"q": query, "state": state, "limit": limit, "page": 1}
+
+    if repo:
+        # Scope search to a specific repository
+        if "/" in repo:
+            owner, name = repo.split("/", 1)
+            params["owner"] = owner
+            params["repo"] = name
+        else:
+            params["repo"] = repo
+
+    results = client.get("/repos/issues/search", params=params)
+
+    if not results:
+        rich.print(f"[dim]No issues found matching \"{query}\".[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for issue in results:
+        labels_str = ", ".join(l["name"] for l in (issue.get("labels") or []))
+        rows.append((
+            str(issue["number"]),
+            issue["title"],
+            issue["user"]["login"],
+            issue.get("repository", {}).get("full_name", ""),
+            issue["state"],
+            labels_str,
+        ))
+        json_rows.append({
+            "number": issue["number"],
+            "title": issue["title"],
+            "author": issue["user"]["login"],
+            "repo": issue.get("repository", {}).get("full_name", ""),
+            "state": issue["state"],
+            "labels": [l["name"] for l in (issue.get("labels") or [])],
+            "created_at": issue.get("created_at"),
+            "updated_at": issue.get("updated_at"),
+        })
+
+    print_table(["#", "Title", "Author", "Repo", "State", "Labels"], rows, json_data=json_rows)

codeberg_cli/routes/issue/subscribe.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("subscribe")
+def _(
+    id: Annotated[int, Arg(description="Issue number")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """Subscribe 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
+
+    user = client.get("/user")["login"]
+    client.put(f"/repos/{repo}/issues/{id}/subscriptions/{user}")
+    rich.print(f"[bold green]Subscribed[/bold green] to issue #{id} in {repo}")

codeberg_cli/routes/issue/time/__init__.py

@@ -0,0 +1,6 @@
+from xclif import command
+
+
+@command("time")
+def _() -> None:
+    """Manage tracked time on issues — list and add."""

codeberg_cli/routes/issue/time/add.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("add")
+def _(
+    id: Annotated[int, Arg(description="Issue number")],
+    time: Annotated[str, Arg(description="Time to add (e.g. 1h30m)")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+    user: Annotated[str, Option(description="User to add time for", name="user")] = "",
+) -> None:
+    """Add tracked time 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
+
+    if not user:
+        user = client.get("/user")["login"]
+
+    client.post(f"/repos/{repo}/issues/{id}/times", data={"time": time, "user": user})
+    rich.print(f"[bold green]Added[/bold green] {time} to issue #{id} in {repo}")

codeberg_cli/routes/issue/time/list.py

@@ -0,0 +1,42 @@
+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")
+def _(
+    id: Annotated[int, Arg(description="Issue number")],
+    repo: Annotated[str, Option(description="Repository (owner/repo)", name="repo")] = "",
+) -> None:
+    """List tracked time 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
+
+    times = client.get(f"/repos/{repo}/issues/{id}/times")
+
+    if not times:
+        rich.print(f"[dim]No tracked time on issue #{id} in {repo}.[/dim]")
+        return
+
+    rows = []
+    json_rows = []
+    for t in times:
+        rows.append((str(t["id"]), t["user"]["login"], str(t.get("time", "")), t.get("created", "")[:10]))
+        json_rows.append({
+            "id": t["id"],
+            "user": t["user"]["login"],
+            "time": t.get("time"),
+            "created": t.get("created"),
+        })
+
+    print_table(["#", "User", "Time (s)", "Date"], rows, json_data=json_rows)