Function run_command

scripts/prepare_release.py:20–60

Run a command and return captured stdout when requested. Args: args: Command and arguments to run. cwd: Working directory for the command. capture_output: Whether to capture and return stdout instead of streaming it. Returns: Captured stdout without surround

(
    args: list[str],
    *,
    cwd: Path = REPO_ROOT,
    capture_output: bool = False,
)

def run_command(
    args: list[str],
    *,
    cwd: Path = REPO_ROOT,
    capture_output: bool = False,
) -> str:
    """Run a command and return captured stdout when requested.

    Args:
        args: Command and arguments to run.
        cwd: Working directory for the command.
        capture_output: Whether to capture and return stdout instead of streaming it.

    Returns:
        Captured stdout without surrounding whitespace when capture_output is true;
        otherwise an empty string.

    Raises:
        ReleaseError: The command is missing or exits with a non-zero status.
    """
    printable = " ".join(args)
    print(f"$ {printable}")
    try:
        if capture_output:
            result = subprocess.run(
                args,
                cwd=cwd,
                check=True,
                capture_output=True,
                text=True,
            )
            return result.stdout.strip()

        subprocess.run(args, cwd=cwd, check=True)
        return ""
    except FileNotFoundError as exc:
        raise ReleaseError(f"Command not found: {args[0]}") from exc
    except subprocess.CalledProcessError as exc:
        if capture_output and exc.stderr:
            print(exc.stderr.strip(), file=sys.stderr)
        raise ReleaseError(f"Command failed ({exc.returncode}): {printable}") from exc


def git(args: list[str], *, capture_output: bool = False) -> str: