Function parse_args

scripts/prepare_release.py:383–429

Parse command-line arguments. Args: argv: Raw command-line arguments excluding the executable name. Returns: Parsed CLI arguments. Raises: ReleaseError: Push is requested without commit.

(argv: list[str])

def parse_args(argv: list[str]) -> argparse.Namespace:
    """Parse command-line arguments.

    Args:
        argv: Raw command-line arguments excluding the executable name.

    Returns:
        Parsed CLI arguments.

    Raises:
        ReleaseError: Push is requested without commit.
    """
    parser = argparse.ArgumentParser(
        description="Prepare an AstrBot release branch, version bump, and changelog.",
    )
    parser.add_argument("version", help="Release version without the leading v")
    parser.add_argument("--base-branch", default="master", help="Release base branch")
    parser.add_argument("--remote", default="origin", help="Git remote name")
    parser.add_argument(
        "--generate-api-client",
        action="store_true",
        help="Run dashboard API client generation before validation",
    )
    parser.add_argument(
        "--dashboard-build",
        action="store_true",
        help="Run dashboard install and build validation",
    )
    parser.add_argument(
        "--skip-checks",
        action="store_true",
        help="Skip ruff format and ruff check",
    )
    parser.add_argument(
        "--commit",
        action="store_true",
        help="Commit the generated release preparation changes",
    )
    parser.add_argument(
        "--push",
        action="store_true",
        help="Push the release branch after committing; requires --commit",
    )
    args = parser.parse_args(argv)
    if args.push and not args.commit:
        raise ReleaseError("--push requires --commit")
    return args


def main(argv: list[str] | None = None) -> int: