gitea.cli.project.create

create

Create project command.

Functions:

gitea.cli.project.create.create_command

create_command(
    ctx: Context,
    owner: Annotated[
        str,
        Option("--owner", help="Owner of the repository."),
    ],
    title: Annotated[
        str, Option("--title", help="Title of the project.")
    ],
    description: Annotated[
        str | None,
        Option(
            "--description",
            help="Description of the project.",
        ),
    ] = None,
    template_type: Annotated[
        Literal["none", "basic_kanban", "bug_triage"]
        | None,
        Option(
            "--template-type",
            help="Template type of the project.",
        ),
    ] = None,
    card_type: Annotated[
        Literal["text_only", "images_and_text"] | None,
        Option(
            "--card-type", help="Card type of the project."
        ),
    ] = None,
    repository: Annotated[
        str | None,
        Option(
            "--repository",
            help="Name of the repository. Omit for organization projects.",
        ),
    ] = None,
    account_name: Annotated[
        str | None,
        Option(
            "--account-name",
            help="Name of the account to use for authentication.",
        ),
    ] = None,
    token: Annotated[
        str | None,
        Option(
            "--token",
            help="Token for authentication. If not provided, the token from the specified account will be used.",
        ),
    ] = None,
    base_url: Annotated[
        str | None,
        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 project in a repository.

Parameters:

Name	Type	Description	Default
ctx	Context	The Typer context.	required
owner	Annotated[str, Option('--owner', help='Owner of the repository.')]	The owner of the repository.	required
repository	Annotated[str | None, Option('--repository', help='Name of the repository. Omit for organization projects.')]	The name of the repository, or None for organization projects.	None
title	Annotated[str, Option('--title', help='Title of the project.')]	The title of the project.	required
description	Annotated[str | None, Option('--description', help='Description of the project.')]	The description of the project.	None
template_type	Annotated[Literal['none', 'basic_kanban', 'bug_triage'] | None, Option('--template-type', help='Template type of the project.')]	The template type of the project.	None
card_type	Annotated[Literal['text_only', 'images_and_text'] | None, Option('--card-type', help='Card type of the project.')]	The card type of the project.	None
account_name	Annotated[str | None, Option('--account-name', help='Name of the account to use for authentication.')]	Name of the account to use for authentication.	None
token	Annotated[str | None, Option('--token', help='Token for authentication. If not provided, the token from the specified account will be used.')]	Token for authentication.	None
base_url	Annotated[str | None, Option('--base-url', help='Base URL of the Gitea platform. If not provided, the base URL from the specified account will be used.')]	Base URL of the Gitea platform.	None

Source code in src/gitea/cli/project/create.py

def create_command(
    ctx: typer.Context,
    owner: Annotated[str, typer.Option("--owner", help="Owner of the repository.")],
    title: Annotated[str, typer.Option("--title", help="Title of the project.")],
    description: Annotated[
        str | None,
        typer.Option("--description", help="Description of the project."),
    ] = None,
    template_type: Annotated[
        Literal["none", "basic_kanban", "bug_triage"] | None,
        typer.Option("--template-type", help="Template type of the project."),
    ] = None,
    card_type: Annotated[
        Literal["text_only", "images_and_text"] | None,
        typer.Option("--card-type", help="Card type of the project."),
    ] = None,
    repository: Annotated[
        str | None,
        typer.Option("--repository", help="Name of the repository. Omit for organization projects."),
    ] = 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 project in a repository.

    Args:
        ctx: The Typer context.
        owner: The owner of the repository.
        repository: The name of the repository, or None for organization projects.
        title: The title of the project.
        description: The description of the project.
        template_type: The template type of the project.
        card_type: The card type of the project.
        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 project information.

        Returns:
            A tuple containing the project data and metadata.

        """
        with Gitea(token=token, base_url=base_url) as client:
            return client.project.create_project(
                owner=owner,
                repository=repository,
                title=title,
                description=description,
                template_type=template_type,
                card_type=card_type,
            )

    execute_api_command(api_call=api_call, base_url=base_url, command_name="gitea-cli project create")