ghnova 0.3.0__py3-none-any.whl

ghnova/__init__.py

@@ -0,0 +1,8 @@
+"""Top-level package for ghnova."""
+
+from __future__ import annotations
+
+from ghnova import client
+from ghnova.version import __version__
+
+__all__ = ["__version__", "client"]

ghnova/__main__.py

@@ -0,0 +1,8 @@
+"""Main entry point for the ghnova package."""
+
+from __future__ import annotations
+
+if __name__ == "__main__":
+    from ghnova.utils.log import setup_logger
+
+    setup_logger(print_version=True)

ghnova/cli/__init__.py

@@ -0,0 +1 @@
+"""Command line interface for ghnova."""

ghnova/cli/config/__init__.py

@@ -0,0 +1 @@
+"""Command line interface for configurations."""

ghnova/cli/config/add.py

@@ -0,0 +1,48 @@
+"""Add command for config CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def add_command(
+    ctx: typer.Context,
+    name: Annotated[
+        str,
+        typer.Option("--name", help="Name of the account. It does not need to be the same as the GitHub account name."),
+    ],
+    token: Annotated[str, typer.Option("--token", help="Token for authentication.")],
+    base_url: Annotated[str, typer.Option("--base-url", help="Base URL of the platform.")] = "https://github.com",
+    is_default: Annotated[bool, typer.Option("--default", help="Set as default account.")] = False,
+) -> None:
+    """Add a new account to the configuration.
+
+    Args:
+        ctx: Typer context.
+        name: Name of the account. It does not need to be the same as the GutHub account name.
+        token: Token for authentication.
+        base_url: Base URL of the platform.
+        is_default: Set as default account.
+
+    """
+    import logging  # noqa: PLC0415
+
+    from ghnova.config.manager import ConfigManager  # noqa: PLC0415
+
+    logger = logging.getLogger("ghnova")
+
+    config_manager = ConfigManager(filename=ctx.obj["config_path"])
+
+    logger.info("Configuration path: %s", config_manager.config_path)
+
+    config_manager.load_config()
+
+    try:
+        config_manager.add_account(name=name, token=token, base_url=base_url, is_default=is_default)
+        config_manager.save_config()
+        logger.info("Account '%s' added successfully.", name)
+    except ValueError as e:
+        logger.error("Error adding account: %s", e)
+        raise typer.Exit(code=1) from e

ghnova/cli/config/delete.py

@@ -0,0 +1,50 @@
+"""Delete command for config CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def delete_command(
+    ctx: typer.Context,
+    name: Annotated[
+        str,
+        typer.Option("--name", help="Name of the account. It does not need to be the same as the GitHub account name."),
+    ],
+    force: Annotated[bool, typer.Option("--force", "-f", help="Force deletion without confirmation.")] = False,
+) -> None:
+    """Delete the configuration of an existing account.
+
+    Args:
+        ctx: Typer context.
+        name: Name of the account.
+        force: Force deletion without confirmation.
+
+    """
+    import logging  # noqa: PLC0415
+
+    from ghnova.config.manager import ConfigManager  # noqa: PLC0415
+
+    if not force:
+        confirm = typer.confirm(f"Are you sure you want to delete the account '{name}'?")
+        if not confirm:
+            typer.echo("Deletion cancelled.")
+            raise typer.Exit()
+
+    logger = logging.getLogger("ghnova")
+
+    config_manager = ConfigManager(filename=ctx.obj["config_path"])
+
+    logger.info("Configuration path: %s", config_manager.config_path)
+
+    config_manager.load_config()
+
+    try:
+        config_manager.delete_account(name=name)
+        config_manager.save_config()
+        logger.info("Account '%s' deleted successfully.", name)
+    except ValueError as e:
+        logger.error("Error deleting account: %s", e)
+        raise typer.Exit(code=1) from e

ghnova/cli/config/list.py

@@ -0,0 +1,40 @@
+"""List command for config CLI."""
+
+from __future__ import annotations
+
+import typer
+
+
+def list_command(ctx: typer.Context) -> None:
+    """List all configured accounts.
+
+    Args:
+        ctx: Typer context.
+
+    """
+    import logging  # noqa: PLC0415
+
+    from ghnova.config.manager import ConfigManager  # noqa: PLC0415
+
+    logger = logging.getLogger("ghnova")
+
+    config_manager = ConfigManager(filename=ctx.obj["config_path"])
+
+    logger.info("Configuration path: %s", config_manager.config_path)
+
+    config_manager.load_config()
+
+    accounts = config_manager._config.accounts
+
+    default_account_name = config_manager._config.default_account
+    if not default_account_name:
+        typer.echo("Default account: None")
+    else:
+        typer.echo(f"Default account: {default_account_name}")
+
+    typer.echo("Configured accounts:")
+
+    for account in accounts.values():
+        typer.echo(f"  Name: {account.name}")
+        typer.echo(f"    Base URL: {account.base_url}")
+        typer.echo("")

ghnova/cli/config/main.py

@@ -0,0 +1,27 @@
+"""Configuration CLI commands for ghnova."""
+
+from __future__ import annotations
+
+import typer
+
+config_app = typer.Typer(
+    name="config",
+    help="Manage github configuration.",
+    rich_markup_mode="rich",
+)
+
+
+def register_commands() -> None:
+    """Register config subcommands."""
+    from ghnova.cli.config.add import add_command  # noqa: PLC0415
+    from ghnova.cli.config.delete import delete_command  # noqa: PLC0415
+    from ghnova.cli.config.list import list_command  # noqa: PLC0415
+    from ghnova.cli.config.update import update_command  # noqa: PLC0415
+
+    config_app.command(name="add")(add_command)
+    config_app.command(name="delete")(delete_command)
+    config_app.command(name="list")(list_command)
+    config_app.command(name="update")(update_command)
+
+
+register_commands()

ghnova/cli/config/update.py

@@ -0,0 +1,59 @@
+"""Update command for config CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def update_command(
+    ctx: typer.Context,
+    name: Annotated[str, typer.Option("--name", help="Name of the account.")],
+    token: Annotated[str | None, typer.Option("--token", help="Token for authentication.")] = None,
+    base_url: Annotated[str | None, typer.Option("--base-url", help="Base URL of the GitHub platform.")] = None,
+    default: Annotated[bool | None, typer.Option("--default", help="Set as default account.")] = None,
+) -> None:
+    """Update the configuration of an existing platform.
+
+    Args:
+        ctx: Typer context.
+        name: Name of the account.
+        token: Token for authentication.
+        base_url: Base URL of the platform.
+        default: Set as default account.
+
+    """
+    import logging  # noqa: PLC0415
+
+    from ghnova.config.manager import ConfigManager  # noqa: PLC0415
+
+    logger = logging.getLogger("ghnova")
+
+    config_manager = ConfigManager(filename=ctx.obj["config_path"])
+
+    logger.info("Configuration path: %s", config_manager.config_path)
+
+    config_manager.load_config()
+
+    try:
+        config_manager.update_account(name=name, token=token, base_url=base_url, is_default=default)
+        config_manager.save_config()
+        updated_entries = []
+        if token is not None:
+            updated_entries.append("token")
+        if base_url is not None:
+            updated_entries.append("base_url")
+        if default is not None:
+            updated_entries.append("default_account")
+        if updated_entries:
+            logger.info(
+                "Account '%s' updated successfully. Updated fields: %s",
+                name,
+                ", ".join(updated_entries),
+            )
+        else:
+            logger.info("Account '%s' updated successfully. No fields changed.", name)
+    except ValueError as e:
+        logger.error("Error updating account: %s", e)
+        raise typer.Exit(code=1) from e

ghnova/cli/issue/__init__.py

@@ -0,0 +1,7 @@
+"""Command line interface for issue-related operations."""
+
+from __future__ import annotations
+
+from ghnova.cli.issue.main import issue_app
+
+__all__ = ["issue_app"]

ghnova/cli/issue/create.py

@@ -0,0 +1,155 @@
+"""Create command for issue CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def create_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.",
+        ),
+    ],
+    title: Annotated[
+        str,
+        typer.Option(
+            "--title",
+            help="The title of the issue.",
+        ),
+    ],
+    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,
+    body: Annotated[
+        str | None,
+        typer.Option(
+            "--body",
+            help="The 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 list of labels to assign to the issue.",
+        ),
+    ] = None,
+    assignees: Annotated[
+        list[str] | None,
+        typer.Option(
+            "--assignees",
+            help="A list of assignees to assign to the issue.",
+        ),
+    ] = None,
+    issue_type: Annotated[
+        str | None,
+        typer.Option(
+            "--issue-type",
+            help="The type of the issue (e.g., 'bug', 'feature').",
+        ),
+    ] = None,
+) -> None:
+    """Create a new issue in a repository.
+
+    Args:
+        ctx: Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        title: The title of the issue.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the GitHub platform.
+        body: The body of the issue.
+        assignee: The assignee of the issue.
+        milestone: The milestone for the issue.
+        labels: A list of labels to assign to the issue.
+        assignees: A list of assignees to assign to the issue.
+        issue_type: The type of 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.create_issue(
+                owner=owner,
+                repository=repository,
+                title=title,
+                body=body,
+                assignee=assignee,
+                milestone=milestone,
+                labels=labels,
+                assignees=assignees,
+                issue_type=issue_type,
+            )
+            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 creating issue: %s", e)
+        raise typer.Exit(code=1) from e

ghnova/cli/issue/get.py

@@ -0,0 +1,119 @@
+"""Get command for issue CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def get_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,
+    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:
+    """Get a specific issue by owner, repository, and issue number.
+
+    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.
+        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.get_issue(
+                owner=owner,
+                repository=repository,
+                issue_number=issue_number,
+                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 retrieving issue: %s", e)
+        raise typer.Exit(code=1) from e