ghnova 0.3.0__py3-none-any.whl

ghnova/cli/issue/list.py

@@ -0,0 +1,267 @@
+"""List command for issue CLI."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Annotated, Literal
+
+import typer
+
+
+def list_command(  # noqa: PLR0913
+    ctx: typer.Context,
+    account_name: Annotated[
+        str | None,
+        typer.Option(
+            "--account-name",
+            help="Name of the account to use for authentication.",
+        ),
+    ] = None,
+    token: Annotated[
+        str | None,
+        typer.Option(
+            "--token",
+            help="Token for authentication. If not provided, the token from the specified account will be used.",
+        ),
+    ] = None,
+    base_url: Annotated[
+        str | None,
+        typer.Option(
+            "--base-url",
+            help="Base URL of the GitHub platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+    owner: Annotated[
+        str | None,
+        typer.Option(
+            "--owner",
+            help="The owner of the repository.",
+        ),
+    ] = None,
+    organization: Annotated[
+        str | None,
+        typer.Option(
+            "--organization",
+            help="The organization name.",
+        ),
+    ] = None,
+    repository: Annotated[
+        str | None,
+        typer.Option(
+            "--repository",
+            help="The name of the repository.",
+        ),
+    ] = None,
+    filter_by: Annotated[
+        Literal["assigned", "created", "mentioned", "subscribed", "all"] | None,
+        typer.Option(
+            "--filter-by",
+            help="Filter issues by: assigned, created, mentioned, subscribed, or all.",
+        ),
+    ] = None,
+    state: Annotated[
+        Literal["open", "closed", "all"] | None,
+        typer.Option(
+            "--state",
+            help="Filter by state: open, closed, or all.",
+        ),
+    ] = None,
+    labels: Annotated[list[str] | None, typer.Option("--labels", help="Filter by labels.")] = None,
+    sort: Annotated[
+        Literal["created", "updated", "comments"] | None,
+        typer.Option(
+            "--sort",
+            help="Sort by: created, updated, or comments.",
+        ),
+    ] = None,
+    direction: Annotated[
+        Literal["asc", "desc"] | None,
+        typer.Option(
+            "--direction",
+            help="Sort direction: asc or desc.",
+        ),
+    ] = None,
+    since: Annotated[
+        datetime | None,
+        typer.Option(
+            "--since",
+            help="Only issues updated at or after this time are returned (ISO 8601 format).",
+        ),
+    ] = None,
+    collab: Annotated[
+        bool | None,
+        typer.Option(
+            "--collab/--no-collab",
+            help="Include issues the user is a collaborator on.",
+        ),
+    ] = None,
+    orgs: Annotated[
+        bool | None,
+        typer.Option(
+            "--orgs/--no-orgs",
+            help="Include issues from organizations the user is a member of.",
+        ),
+    ] = None,
+    owned: Annotated[
+        bool | None,
+        typer.Option(
+            "--owned/--no-owned",
+            help="Include issues owned by the authenticated user.",
+        ),
+    ] = None,
+    pulls: Annotated[
+        bool | None,
+        typer.Option(
+            "--pulls/--no-pulls",
+            help="Include pull requests in the results.",
+        ),
+    ] = None,
+    issue_type: Annotated[
+        str | None,
+        typer.Option(
+            "--issue-type",
+            help="Filter by issue type.",
+        ),
+    ] = None,
+    milestone: Annotated[
+        str | None,
+        typer.Option(
+            "--milestone",
+            help="Filter by milestone.",
+        ),
+    ] = None,
+    assignee: Annotated[
+        str | None,
+        typer.Option(
+            "--assignee",
+            help="Filter by assignee.",
+        ),
+    ] = None,
+    creator: Annotated[
+        str | None,
+        typer.Option(
+            "--creator",
+            help="Filter by creator.",
+        ),
+    ] = None,
+    mentioned: Annotated[
+        str | None,
+        typer.Option(
+            "--mentioned",
+            help="Filter by mentioned user.",
+        ),
+    ] = None,
+    per_page: Annotated[
+        int,
+        typer.Option(
+            "--per-page",
+            help="Number of results per page.",
+        ),
+    ] = 30,
+    page: Annotated[
+        int,
+        typer.Option(
+            "--page",
+            help="Page number for pagination.",
+        ),
+    ] = 1,
+    etag: Annotated[
+        str | None,
+        typer.Option(
+            "--etag",
+            help="ETag from a previous request for caching purposes.",
+        ),
+    ] = None,
+    last_modified: Annotated[
+        str | None,
+        typer.Option(
+            "--last-modified",
+            help="Last-Modified header from a previous request for caching purposes.",
+        ),
+    ] = None,
+) -> None:
+    """List issues from a repository or organization.
+
+    Args:
+        ctx: Typer context.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the GitHub platform.
+        owner: The owner of the repository.
+        organization: The organization name.
+        repository: The name of the repository.
+        filter_by: Filter issues by: assigned, created, mentioned, subscribed, or all.
+        state: Filter by state: open, closed, or all.
+        labels: Filter by labels.
+        sort: Sort by: created, updated, or comments.
+        direction: Sort direction: asc or desc.
+        since: Only issues updated at or after this time are returned.
+        collab: Include issues the user is a collaborator on.
+        orgs: Include issues from organizations the user is a member of.
+        owned: Include issues owned by the authenticated user.
+        pulls: Include pull requests in the results.
+        issue_type: Filter by issue type.
+        milestone: Filter by milestone.
+        assignee: Filter by assignee.
+        creator: Filter by creator.
+        mentioned: Filter by mentioned user.
+        per_page: Number of results per page.
+        page: Page number for pagination.
+        etag: ETag from a previous request for caching purposes.
+        last_modified: Last-Modified header from a previous request for caching purposes.
+
+    """
+    import json  # noqa: PLC0415
+    import logging  # noqa: PLC0415
+
+    from ghnova.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from ghnova.client.github import GitHub  # noqa: PLC0415
+
+    logger = logging.getLogger("ghnova")
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj["config_path"],
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    try:
+        with GitHub(token=token, base_url=base_url) as client:
+            issue_client = client.issue
+            data, status_code, etag_value, last_modified_value = issue_client.list_issues(
+                owner=owner,
+                organization=organization,
+                repository=repository,
+                filter_by=filter_by,
+                state=state,
+                labels=labels,
+                sort=sort,
+                direction=direction,
+                since=since,
+                collab=collab,
+                orgs=orgs,
+                owned=owned,
+                pulls=pulls,
+                issue_type=issue_type,
+                milestone=milestone,
+                assignee=assignee,
+                creator=creator,
+                mentioned=mentioned,
+                per_page=per_page,
+                page=page,
+                etag=etag,
+                last_modified=last_modified,
+            )
+            result = {
+                "data": data,
+                "metadata": {
+                    "status_code": status_code,
+                    "etag": etag_value,
+                    "last_modified": last_modified_value,
+                },
+            }
+            print(json.dumps(result, indent=2, default=str))
+    except Exception as e:
+        logger.error("Error listing issues: %s", e)
+        raise typer.Exit(code=1) from e

ghnova/cli/issue/lock.py

@@ -0,0 +1,110 @@
+"""Lock command for issue CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+import typer
+
+
+def lock_command(  # noqa: PLR0913
+    ctx: typer.Context,
+    owner: Annotated[
+        str,
+        typer.Option(
+            "--owner",
+            help="The owner of the repository.",
+        ),
+    ],
+    repository: Annotated[
+        str,
+        typer.Option(
+            "--repository",
+            help="The name of the repository.",
+        ),
+    ],
+    issue_number: Annotated[
+        int,
+        typer.Option(
+            "--issue-number",
+            help="The issue number.",
+        ),
+    ],
+    account_name: Annotated[
+        str | None,
+        typer.Option(
+            "--account-name",
+            help="Name of the account to use for authentication.",
+        ),
+    ] = None,
+    token: Annotated[
+        str | None,
+        typer.Option(
+            "--token",
+            help="Token for authentication. If not provided, the token from the specified account will be used.",
+        ),
+    ] = None,
+    base_url: Annotated[
+        str | None,
+        typer.Option(
+            "--base-url",
+            help="Base URL of the GitHub platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+    lock_reason: Annotated[
+        Literal["off-topic", "too heated", "resolved", "spam"] | None,
+        typer.Option(
+            "--lock-reason",
+            help="Reason for locking: off-topic, too heated, resolved, or spam.",
+        ),
+    ] = None,
+) -> None:
+    """Lock an issue to prevent further comments.
+
+    Args:
+        ctx: Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        issue_number: The issue number.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the GitHub platform.
+        lock_reason: Reason for locking the issue.
+
+    """
+    import json  # noqa: PLC0415
+    import logging  # noqa: PLC0415
+
+    from ghnova.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from ghnova.client.github import GitHub  # noqa: PLC0415
+
+    logger = logging.getLogger("ghnova")
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj["config_path"],
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    try:
+        with GitHub(token=token, base_url=base_url) as client:
+            issue_client = client.issue
+            data, status_code, etag_value, last_modified_value = issue_client.lock_issue(
+                owner=owner,
+                repository=repository,
+                issue_number=issue_number,
+                lock_reason=lock_reason,
+            )
+            result = {
+                "data": data,
+                "metadata": {
+                    "status_code": status_code,
+                    "etag": etag_value,
+                    "last_modified": last_modified_value,
+                },
+            }
+            print(json.dumps(result, indent=2, default=str))
+    except Exception as e:
+        logger.error("Error locking issue: %s", e)
+        raise typer.Exit(code=1) from e

ghnova/cli/issue/main.py

@@ -0,0 +1,31 @@
+"""Issue CLI commands for ghnova."""
+
+from __future__ import annotations
+
+import typer
+
+issue_app = typer.Typer(
+    name="issue",
+    help="Manage GitHub issues.",
+    rich_markup_mode="rich",
+)
+
+
+def register_commands() -> None:
+    """Register issue subcommands."""
+    from ghnova.cli.issue.create import create_command  # noqa: PLC0415
+    from ghnova.cli.issue.get import get_command  # noqa: PLC0415
+    from ghnova.cli.issue.list import list_command  # noqa: PLC0415
+    from ghnova.cli.issue.lock import lock_command  # noqa: PLC0415
+    from ghnova.cli.issue.unlock import unlock_command  # noqa: PLC0415
+    from ghnova.cli.issue.update import update_command  # noqa: PLC0415
+
+    issue_app.command(name="create", help="Create a new issue.")(create_command)
+    issue_app.command(name="get", help="Get a specific issue.")(get_command)
+    issue_app.command(name="list", help="List issues.")(list_command)
+    issue_app.command(name="lock", help="Lock an issue.")(lock_command)
+    issue_app.command(name="unlock", help="Unlock an issue.")(unlock_command)
+    issue_app.command(name="update", help="Update an issue.")(update_command)
+
+
+register_commands()

ghnova/cli/issue/unlock.py

@@ -0,0 +1,101 @@
+"""Unlock command for issue CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def unlock_command(  # noqa: PLR0913
+    ctx: typer.Context,
+    owner: Annotated[
+        str,
+        typer.Option(
+            "--owner",
+            help="The owner of the repository.",
+        ),
+    ],
+    repository: Annotated[
+        str,
+        typer.Option(
+            "--repository",
+            help="The name of the repository.",
+        ),
+    ],
+    issue_number: Annotated[
+        int,
+        typer.Option(
+            "--issue-number",
+            help="The issue number.",
+        ),
+    ],
+    account_name: Annotated[
+        str | None,
+        typer.Option(
+            "--account-name",
+            help="Name of the account to use for authentication.",
+        ),
+    ] = None,
+    token: Annotated[
+        str | None,
+        typer.Option(
+            "--token",
+            help="Token for authentication. If not provided, the token from the specified account will be used.",
+        ),
+    ] = None,
+    base_url: Annotated[
+        str | None,
+        typer.Option(
+            "--base-url",
+            help="Base URL of the GitHub platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+) -> None:
+    """Unlock an issue to allow further comments.
+
+    Args:
+        ctx: Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        issue_number: The issue number.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the GitHub platform.
+
+    """
+    import json  # noqa: PLC0415
+    import logging  # noqa: PLC0415
+
+    from ghnova.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from ghnova.client.github import GitHub  # noqa: PLC0415
+
+    logger = logging.getLogger("ghnova")
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj["config_path"],
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    try:
+        with GitHub(token=token, base_url=base_url) as client:
+            issue_client = client.issue
+            data, status_code, etag_value, last_modified_value = issue_client.unlock_issue(
+                owner=owner,
+                repository=repository,
+                issue_number=issue_number,
+            )
+            result = {
+                "data": data,
+                "metadata": {
+                    "status_code": status_code,
+                    "etag": etag_value,
+                    "last_modified": last_modified_value,
+                },
+            }
+            print(json.dumps(result, indent=2, default=str))
+    except Exception as e:
+        logger.error("Error unlocking issue: %s", e)
+        raise typer.Exit(code=1) from e

ghnova/cli/issue/update.py

@@ -0,0 +1,164 @@
+"""Update command for issue CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+import typer
+
+
+def update_command(  # noqa: PLR0913
+    ctx: typer.Context,
+    owner: Annotated[
+        str,
+        typer.Option(
+            "--owner",
+            help="The owner of the repository.",
+        ),
+    ],
+    repository: Annotated[
+        str,
+        typer.Option(
+            "--repository",
+            help="The name of the repository.",
+        ),
+    ],
+    issue_number: Annotated[
+        int,
+        typer.Option(
+            "--issue-number",
+            help="The issue number.",
+        ),
+    ],
+    account_name: Annotated[
+        str | None,
+        typer.Option(
+            "--account-name",
+            help="Name of the account to use for authentication.",
+        ),
+    ] = None,
+    token: Annotated[
+        str | None,
+        typer.Option(
+            "--token",
+            help="Token for authentication. If not provided, the token from the specified account will be used.",
+        ),
+    ] = None,
+    base_url: Annotated[
+        str | None,
+        typer.Option(
+            "--base-url",
+            help="Base URL of the GitHub platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+    title: Annotated[
+        str | None,
+        typer.Option(
+            "--title",
+            help="The new title of the issue.",
+        ),
+    ] = None,
+    body: Annotated[
+        str | None,
+        typer.Option(
+            "--body",
+            help="The new body of the issue.",
+        ),
+    ] = None,
+    assignee: Annotated[
+        str | None,
+        typer.Option(
+            "--assignee",
+            help="The assignee of the issue.",
+        ),
+    ] = None,
+    milestone: Annotated[
+        str | None,
+        typer.Option(
+            "--milestone",
+            help="The milestone for the issue.",
+        ),
+    ] = None,
+    labels: Annotated[
+        list[str] | None,
+        typer.Option(
+            "--labels",
+            help="A new list of labels to assign to the issue.",
+        ),
+    ] = None,
+    assignees: Annotated[
+        list[str] | None,
+        typer.Option(
+            "--assignees",
+            help="A new list of assignees for the issue.",
+        ),
+    ] = None,
+    state: Annotated[
+        Literal["open", "closed"] | None,
+        typer.Option(
+            "--state",
+            help="The state of the issue (open or closed).",
+        ),
+    ] = None,
+) -> None:
+    """Update an existing issue.
+
+    Args:
+        ctx: Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        issue_number: The issue number.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the GitHub platform.
+        title: The new title of the issue.
+        body: The new body of the issue.
+        assignee: The assignee of the issue.
+        milestone: The milestone for the issue.
+        labels: A new list of labels to assign to the issue.
+        assignees: A new list of assignees for the issue.
+        state: The state of the issue (open or closed).
+
+    """
+    import json  # noqa: PLC0415
+    import logging  # noqa: PLC0415
+
+    from ghnova.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from ghnova.client.github import GitHub  # noqa: PLC0415
+
+    logger = logging.getLogger("ghnova")
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj["config_path"],
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    try:
+        with GitHub(token=token, base_url=base_url) as client:
+            issue_client = client.issue
+            data, status_code, etag_value, last_modified_value = issue_client.update_issue(
+                owner=owner,
+                repository=repository,
+                issue_number=issue_number,
+                title=title,
+                body=body,
+                assignee=assignee,
+                milestone=milestone,
+                labels=labels,
+                assignees=assignees,
+                state=state,
+            )
+            result = {
+                "data": data,
+                "metadata": {
+                    "status_code": status_code,
+                    "etag": etag_value,
+                    "last_modified": last_modified_value,
+                },
+            }
+            print(json.dumps(result, indent=2, default=str))
+    except Exception as e:
+        logger.error("Error updating issue: %s", e)
+        raise typer.Exit(code=1) from e