python-gitea 0.6.0__py3-none-any.whl → 0.7.0__py3-none-any.whl

gitea/cli/comment/add.py

@@ -0,0 +1,79 @@
+"""Add comment command."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def add_command(
+    ctx: typer.Context,
+    owner: Annotated[str, typer.Option("--owner", help="Owner of the repository.")],
+    repository: Annotated[str, typer.Option("--repository", help="Name of the repository.")],
+    index: Annotated[int, typer.Option("--index", help="Index of the issue.")],
+    body: Annotated[str, typer.Option("--body", help="Body of the comment.")],
+    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 Gitea platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+) -> None:
+    """Add a comment to an issue.
+
+    Args:
+        ctx: The Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        index: The index of the issue.
+        body: The body of the comment.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the Gitea platform.
+
+    """
+    from typing import Any  # noqa: PLC0415
+
+    from gitea.cli.utils.api import execute_api_command  # noqa: PLC0415
+    from gitea.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from gitea.client.gitea import Gitea  # noqa: PLC0415
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj.get("config_path"),
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    def api_call() -> tuple[dict[str, Any] | list[dict[str, Any]], dict[str, Any]]:
+        """Add comment information.
+
+        Returns:
+            A tuple containing the comment data and metadata.
+
+        """
+        with Gitea(token=token, base_url=base_url) as client:
+            return client.comment.create_comment(
+                owner=owner,
+                repository=repository,
+                index=index,
+                body=body,
+            )
+
+    execute_api_command(api_call=api_call, command_name="gitea-cli comment add")

gitea/cli/comment/delete.py

@@ -0,0 +1,76 @@
+"""Delete comment command."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def delete_command(
+    ctx: typer.Context,
+    owner: Annotated[str, typer.Option("--owner", help="Owner of the repository.")],
+    repository: Annotated[str, typer.Option("--repository", help="Name of the repository.")],
+    comment_id: Annotated[int, typer.Option("--comment-id", help="ID of the comment.")],
+    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 Gitea platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+) -> None:
+    """Delete a comment.
+
+    Args:
+        ctx: The Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        comment_id: The ID of the comment.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the Gitea platform.
+
+    """
+    from typing import Any  # noqa: PLC0415
+
+    from gitea.cli.utils.api import execute_api_command  # noqa: PLC0415
+    from gitea.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from gitea.client.gitea import Gitea  # noqa: PLC0415
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj.get("config_path"),
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    def api_call() -> tuple[dict[str, Any] | list[dict[str, Any]], dict[str, Any]]:
+        """Delete comment information.
+
+        Returns:
+            A tuple containing the comment data and metadata.
+
+        """
+        with Gitea(token=token, base_url=base_url) as client:
+            return client.comment.delete_comment(
+                owner=owner,
+                repository=repository,
+                comment_id=comment_id,
+            )
+
+    execute_api_command(api_call=api_call, command_name="gitea-cli comment delete")

gitea/cli/comment/edit.py

@@ -0,0 +1,79 @@
+"""Edit comment command."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def edit_command(
+    ctx: typer.Context,
+    owner: Annotated[str, typer.Option("--owner", help="Owner of the repository.")],
+    repository: Annotated[str, typer.Option("--repository", help="Name of the repository.")],
+    comment_id: Annotated[int, typer.Option("--comment-id", help="ID of the comment.")],
+    body: Annotated[str, typer.Option("--body", help="New body of the comment.")],
+    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 Gitea platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+) -> None:
+    """Edit a comment.
+
+    Args:
+        ctx: The Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        comment_id: The ID of the comment.
+        body: The new body of the comment.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the Gitea platform.
+
+    """
+    from typing import Any  # noqa: PLC0415
+
+    from gitea.cli.utils.api import execute_api_command  # noqa: PLC0415
+    from gitea.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from gitea.client.gitea import Gitea  # noqa: PLC0415
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj.get("config_path"),
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    def api_call() -> tuple[dict[str, Any] | list[dict[str, Any]], dict[str, Any]]:
+        """Edit comment information.
+
+        Returns:
+            A tuple containing the comment data and metadata.
+
+        """
+        with Gitea(token=token, base_url=base_url) as client:
+            return client.comment.edit_comment(
+                owner=owner,
+                repository=repository,
+                comment_id=comment_id,
+                body=body,
+            )
+
+    execute_api_command(api_call=api_call, command_name="gitea-cli comment edit")

gitea/cli/comment/list.py

@@ -0,0 +1,88 @@
+"""List comments command."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def list_command(
+    ctx: typer.Context,
+    owner: Annotated[str, typer.Option("--owner", help="Owner of the repository.")],
+    repository: Annotated[str, typer.Option("--repository", help="Name of the repository.")],
+    index: Annotated[int, typer.Option("--index", help="Index of the issue.")],
+    page: Annotated[
+        int | None,
+        typer.Option("--page", help="The page number for pagination."),
+    ] = None,
+    limit: Annotated[
+        int | None,
+        typer.Option("--limit", help="The number of comments per page."),
+    ] = None,
+    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 Gitea platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+) -> None:
+    """List comments on an issue.
+
+    Args:
+        ctx: The Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        index: The index of the issue.
+        page: The page number for pagination.
+        limit: The number of comments per page.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the Gitea platform.
+
+    """
+    from typing import Any  # noqa: PLC0415
+
+    from gitea.cli.utils.api import execute_api_command  # noqa: PLC0415
+    from gitea.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from gitea.client.gitea import Gitea  # noqa: PLC0415
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj.get("config_path"),
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    def api_call() -> tuple[dict[str, Any] | list[dict[str, Any]], dict[str, Any]]:
+        """List comment information.
+
+        Returns:
+            A tuple containing the comment data and metadata.
+
+        """
+        with Gitea(token=token, base_url=base_url) as client:
+            return client.comment.list_comments(
+                owner=owner,
+                repository=repository,
+                index=index,
+                page=page,
+                limit=limit,
+            )
+
+    execute_api_command(api_call=api_call, command_name="gitea-cli comment list")

gitea/cli/comment/main.py

@@ -0,0 +1,27 @@
+"""CLI commands for managing comments."""
+
+from __future__ import annotations
+
+import typer
+
+comment_app = typer.Typer(
+    name="comment",
+    help="Commands for managing comments.",
+    rich_markup_mode="rich",
+)
+
+
+def register_commands() -> None:
+    """Register comment-related commands to the comment_app."""
+    from gitea.cli.comment.add import add_command  # noqa: PLC0415
+    from gitea.cli.comment.delete import delete_command  # noqa: PLC0415
+    from gitea.cli.comment.edit import edit_command  # noqa: PLC0415
+    from gitea.cli.comment.list import list_command  # noqa: PLC0415
+
+    comment_app.command("add", help="Add a comment to an issue.")(add_command)
+    comment_app.command("delete", help="Delete a comment.")(delete_command)
+    comment_app.command("edit", help="Edit a comment.")(edit_command)
+    comment_app.command("list", help="List comments on an issue.")(list_command)
+
+
+register_commands()

gitea/cli/issue/create.py

@@ -0,0 +1,125 @@
+"""Create issues command."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Annotated
+
+import typer
+
+
+def create_command(
+    ctx: typer.Context,
+    owner: Annotated[str, typer.Option("--owner", help="Owner of the repository.")],
+    repository: Annotated[str, typer.Option("--repository", help="Name of the repository.")],
+    title: Annotated[str, typer.Option("--title", help="Title of the new issue.")],
+    assignee: Annotated[
+        str | None,
+        typer.Option("--assignee", help="The username to assign the issue to."),
+    ] = None,
+    assignees: Annotated[
+        list[str] | None,
+        typer.Option("--assignees", help="The usernames to assign the issue to."),
+    ] = None,
+    body: Annotated[
+        str | None,
+        typer.Option("--body", help="The body of the new issue."),
+    ] = None,
+    closed: Annotated[
+        bool | None,
+        typer.Option("--closed", help="Whether the issue is created closed."),
+    ] = None,
+    due_date: Annotated[
+        datetime | None,
+        typer.Option("--due-date", help="The due date of the new issue."),
+    ] = None,
+    labels: Annotated[
+        list[int] | None,
+        typer.Option("--labels", help="The label IDs to apply to the new issue."),
+    ] = None,
+    milestone: Annotated[
+        int | None,
+        typer.Option("--milestone", help="The milestone ID to associate with the new issue."),
+    ] = None,
+    ref: Annotated[
+        str | None,
+        typer.Option("--ref", help="The reference of the new issue."),
+    ] = None,
+    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 Gitea platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+) -> None:
+    """Create a new issue in a repository.
+
+    Args:
+        ctx: The Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        title: The title of the new issue.
+        assignee: The username to assign the issue to.
+        assignees: The usernames to assign the issue to.
+        body: The body of the new issue.
+        closed: Whether the issue is created closed.
+        due_date: The due date of the new issue.
+        labels: The label IDs to apply to the new issue.
+        milestone: The milestone ID to associate with the new issue.
+        ref: The reference of the new issue.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the Gitea platform.
+
+    """
+    from typing import Any  # noqa: PLC0415
+
+    from gitea.cli.utils.api import execute_api_command  # noqa: PLC0415
+    from gitea.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from gitea.client.gitea import Gitea  # noqa: PLC0415
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj.get("config_path"),
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    def api_call() -> tuple[dict[str, Any] | list[dict[str, Any]], dict[str, Any]]:
+        """Create issue information.
+
+        Returns:
+            A tuple containing the issue data and metadata.
+
+        """
+        with Gitea(token=token, base_url=base_url) as client:
+            return client.issue.create_issue(
+                owner=owner,
+                repository=repository,
+                title=title,
+                assignee=assignee,
+                assignees=assignees,
+                body=body,
+                closed=closed,
+                due_date=due_date,
+                labels=labels,
+                milestone=milestone,
+                ref=ref,
+            )
+
+    execute_api_command(api_call=api_call, command_name="gitea-cli issue create")

gitea/cli/issue/dependency/__init__.py

@@ -0,0 +1 @@
+"""CLI commands for managing issue dependencies."""

gitea/cli/issue/dependency/add.py

@@ -0,0 +1,94 @@
+"""Add issue dependency command."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def add_command(
+    ctx: typer.Context,
+    owner: Annotated[str, typer.Option("--owner", help="Owner of the repository.")],
+    repository: Annotated[str, typer.Option("--repository", help="Name of the repository.")],
+    index: Annotated[int, typer.Option("--index", help="Index of the target issue.")],
+    dependency_owner: Annotated[
+        str,
+        typer.Option("--dependency-owner", help="Owner of the dependency issue's repository."),
+    ],
+    dependency_repository: Annotated[
+        str,
+        typer.Option("--dependency-repository", help="Name of the dependency issue's repository."),
+    ],
+    dependency_index: Annotated[
+        int,
+        typer.Option("--dependency-index", help="Index of the dependency 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 Gitea platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+) -> None:
+    """Make an issue depend on another issue.
+
+    Args:
+        ctx: The Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        index: The index of the target issue.
+        dependency_owner: The owner of the dependency issue's repository.
+        dependency_repository: The name of the dependency issue's repository.
+        dependency_index: The index of the dependency issue.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the Gitea platform.
+
+    """
+    from typing import Any  # noqa: PLC0415
+
+    from gitea.cli.utils.api import execute_api_command  # noqa: PLC0415
+    from gitea.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from gitea.client.gitea import Gitea  # noqa: PLC0415
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj.get("config_path"),
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    def api_call() -> tuple[dict[str, Any] | list[dict[str, Any]], dict[str, Any]]:
+        """Add issue dependency information.
+
+        Returns:
+            A tuple containing the target issue data and metadata.
+
+        """
+        with Gitea(token=token, base_url=base_url) as client:
+            return client.issue.create_issue_dependency(
+                owner=owner,
+                repository=repository,
+                index=index,
+                dependency_owner=dependency_owner,
+                dependency_repository=dependency_repository,
+                dependency_index=dependency_index,
+            )
+
+    execute_api_command(api_call=api_call, command_name="gitea-cli issue dependency add")

gitea/cli/issue/dependency/list.py

@@ -0,0 +1,88 @@
+"""List issue dependencies command."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+
+def list_command(
+    ctx: typer.Context,
+    owner: Annotated[str, typer.Option("--owner", help="Owner of the repository.")],
+    repository: Annotated[str, typer.Option("--repository", help="Name of the repository.")],
+    index: Annotated[int, typer.Option("--index", help="Index of the issue.")],
+    page: Annotated[
+        int | None,
+        typer.Option("--page", help="Page number for pagination."),
+    ] = None,
+    limit: Annotated[
+        int | None,
+        typer.Option("--limit", help="Number of dependencies per page."),
+    ] = None,
+    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 Gitea platform. If not provided, the base URL from the specified account will be used.",
+        ),
+    ] = None,
+) -> None:
+    """List an issue's dependencies.
+
+    Args:
+        ctx: The Typer context.
+        owner: The owner of the repository.
+        repository: The name of the repository.
+        index: The index of the issue.
+        page: The page number for pagination.
+        limit: The number of dependencies per page.
+        account_name: Name of the account to use for authentication.
+        token: Token for authentication.
+        base_url: Base URL of the Gitea platform.
+
+    """
+    from typing import Any  # noqa: PLC0415
+
+    from gitea.cli.utils.api import execute_api_command  # noqa: PLC0415
+    from gitea.cli.utils.auth import get_auth_params  # noqa: PLC0415
+    from gitea.client.gitea import Gitea  # noqa: PLC0415
+
+    token, base_url = get_auth_params(
+        config_path=ctx.obj.get("config_path"),
+        account_name=account_name,
+        token=token,
+        base_url=base_url,
+    )
+
+    def api_call() -> tuple[dict[str, Any] | list[dict[str, Any]], dict[str, Any]]:
+        """List issue dependency information.
+
+        Returns:
+            A tuple containing the dependency issues and metadata.
+
+        """
+        with Gitea(token=token, base_url=base_url) as client:
+            return client.issue.list_issue_dependencies(
+                owner=owner,
+                repository=repository,
+                index=index,
+                page=page,
+                limit=limit,
+            )
+
+    execute_api_command(api_call=api_call, command_name="gitea-cli issue dependency list")

gitea/cli/issue/dependency/main.py

@@ -0,0 +1,25 @@
+"""CLI commands for managing issue dependencies."""
+
+from __future__ import annotations
+
+import typer
+
+dependency_app = typer.Typer(
+    name="dependency",
+    help="Commands for managing issue dependencies.",
+    rich_markup_mode="rich",
+)
+
+
+def register_commands() -> None:
+    """Register dependency-related commands to the dependency_app."""
+    from gitea.cli.issue.dependency.add import add_command  # noqa: PLC0415
+    from gitea.cli.issue.dependency.list import list_command  # noqa: PLC0415
+    from gitea.cli.issue.dependency.remove import remove_command  # noqa: PLC0415
+
+    dependency_app.command("add", help="Make an issue depend on another issue.")(add_command)
+    dependency_app.command("list", help="List an issue's dependencies.")(list_command)
+    dependency_app.command("remove", help="Remove an issue dependency.")(remove_command)
+
+
+register_commands()