OpenShell/tasks/scripts/release.py

#!/usr/bin/env python3

# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0

from __future__ import annotations

import argparse
import fnmatch
import os
import re
import subprocess
from dataclasses import dataclass
from pathlib import Path

from setuptools_scm import get_version as scm_get_version


@dataclass(frozen=True)
class Versions:
    python: str
    cargo: str
    docker: str
    git_tag: str
    git_sha: str


def _repo_root() -> Path:
    return Path(__file__).resolve().parents[2]


def _run(cmd: list[str], *, env: dict[str, str] | None = None) -> None:
    subprocess.run(cmd, check=True, env=env)


def _git(cmd: list[str]) -> str:
    return (
        subprocess.check_output(["git", *cmd], cwd=_repo_root()).decode("utf-8").strip()
    )


def _compute_versions() -> Versions:
    root = _repo_root()
    python_version = scm_get_version(
        # NOTE: Cargo doesn't support .post versions, so when we are releasing,
        # but not on tag, we use a next version (bumps the patch).
        # EXAMPLE: if the last tag was 0.1.0, then the next version will be 0.1.1-dev.0
        version_scheme="guess-next-dev",
        root=str(root),
        fallback_version="0.0.0",
    )

    # Convert PEP 440 to a SemVer-ish string for Cargo:
    # 0.1.0.dev3+gabcdef -> 0.1.0-dev.3+gabcdef
    cargo_version = re.sub(r"\.dev(\d+)", r"-dev.\1", python_version)

    # Docker tags can't contain '+'.
    docker_version = cargo_version.replace("+", "-")

    git_tag = _git(["describe", "--tags", "--abbrev=0"])
    git_sha = _git(["rev-parse", "--short", "HEAD"])

    return Versions(
        python=python_version,
        cargo=cargo_version,
        docker=docker_version,
        git_tag=git_tag,
        git_sha=git_sha,
    )


def python_publish(
    version: str | None = None, wheel_glob: str = "nemoclaw-*.whl"
) -> None:
    if version is None:
        version = _compute_versions().python

    repo_url = os.getenv("NAV_PYPI_REPOSITORY_URL")
    username = os.getenv("NAV_PYPI_USERNAME")
    password = os.getenv("NAV_PYPI_PASSWORD")

    if not repo_url or not username or not password:
        raise SystemExit(
            "Auth is not set up for publishing to PyPI registry, see CONTRIBUTING.md for details."
        )

    env = dict(os.environ)
    env["UV_PUBLISH_USERNAME"] = username
    env["UV_PUBLISH_PASSWORD"] = password

    wheels_dir = _repo_root() / "target" / "wheels"
    wheels_dir.mkdir(parents=True, exist_ok=True)

    wheel_paths = sorted(
        p
        for p in wheels_dir.glob("*.whl")
        if f"-{version}-" in p.name and fnmatch.fnmatch(p.name, wheel_glob)
    )

    if not wheel_paths:
        available = "\n".join(sorted(p.name for p in wheels_dir.glob("*.whl")))
        raise SystemExit(
            f"No wheels found for version {version} in {wheels_dir}.\n"
            f"Available wheels:\n{available or '(none)'}"
        )

    _run(
        [
            "uv",
            "publish",
            "--publish-url",
            repo_url,
            *[str(path) for path in wheel_paths],
        ],
        env=env,
    )


def get_version(format: str) -> None:
    versions = _compute_versions()
    if format == "python":
        print(versions.python)
    elif format == "cargo":
        print(versions.cargo)
    elif format == "docker":
        print(versions.docker)
    else:
        print(f"VERSION_PY={versions.python}")
        print(f"VERSION_CARGO={versions.cargo}")
        print(f"VERSION_DOCKER={versions.docker}")
        print(f"GIT_TAG={versions.git_tag}")
        print(f"GIT_SHA={versions.git_sha}")


def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(description="OpenClaw release tooling.")
    sub = parser.add_subparsers(dest="command", required=True)

    get_version_parser = sub.add_parser("get-version", help="Print computed version.")
    get_version_parser.add_argument(
        "--python", action="store_true", help="Print Python version only."
    )
    get_version_parser.add_argument(
        "--cargo", action="store_true", help="Print Cargo version only."
    )
    get_version_parser.add_argument(
        "--docker", action="store_true", help="Print Docker version only."
    )

    python_publish_parser = sub.add_parser(
        "python-publish", help="Publish python wheel."
    )
    python_publish_parser.add_argument(
        "--version", help="Version to publish (defaults to computed version)."
    )
    python_publish_parser.add_argument(
        "--wheel-glob",
        default="nemoclaw-*.whl",
        help="Filename glob for wheels to publish (defaults to all nemoclaw wheels).",
    )

    return parser


def main() -> None:
    parser = build_parser()
    args = parser.parse_args()

    if args.command == "get-version":
        if args.python:
            get_version("python")
        elif args.cargo:
            get_version("cargo")
        elif args.docker:
            get_version("docker")
        else:
            get_version("all")
    elif args.command == "python-publish":
        python_publish(version=args.version, wheel_glob=args.wheel_glob)


if __name__ == "__main__":
    main()