Function get_or_download_cli

python/copilot/_cli_download.py:307–337

Get the cached CLI binary, downloading it if necessary. Returns None if: - No version is pinned (dev install) - Auto-download is disabled via COPILOT_SKIP_CLI_DOWNLOAD - The platform is unsupported Raises RuntimeError on download/verification failures.

(version: str | None = None)

def get_or_download_cli(version: str | None = None) -> str | None:
    """Get the cached CLI binary, downloading it if necessary.

    Returns None if:
    - No version is pinned (dev install)
    - Auto-download is disabled via COPILOT_SKIP_CLI_DOWNLOAD
    - The platform is unsupported

    Raises RuntimeError on download/verification failures.
    """
    ver = version or CLI_VERSION
    if not ver:
        return None

    # Check cache first
    cached = get_cached_cli_path(ver)
    if cached:
        return cached

    # Check if download is disabled
    if _should_skip_download():
        return None

    # Check platform support before attempting download
    try:
        get_asset_info()
    except RuntimeError:
        return None

    # Download
    return download_cli(ver)


def main() -> None: