Function _resolve_package_url_from_registry

ci/compiler/platformio_ini.py:800–916

Resolve a package version to its download URL via PlatformIO Registry API. Args: package_name: Package name (e.g., "toolchain-riscv32-esp") version: Version string (e.g., "14.2.0+20241119") or None for latest package_type: Package type hint ("tool", "framework", etc

(
    package_name: str,
    version: Optional[str],
    package_type: str = "",
    system: Optional[str] = None,
)

def _resolve_package_url_from_registry(
    package_name: str,
    version: Optional[str],
    package_type: str = "",
    system: Optional[str] = None,
) -> Optional[str]:
    """
    Resolve a package version to its download URL via PlatformIO Registry API.

    Args:
        package_name: Package name (e.g., "toolchain-riscv32-esp")
        version: Version string (e.g., "14.2.0+20241119") or None for latest
        package_type: Package type hint ("tool", "framework", etc.)
        system: Target system (e.g., "windows_amd64"). If None, auto-detects.

    Returns:
        Download URL or None if resolution fails.
    """
    import platform as platform_module
    import urllib.request

    # Auto-detect system if not provided
    if system is None:
        os_name = platform_module.system().lower()
        machine = platform_module.machine().lower()

        if os_name == "windows":
            system = (
                "windows_amd64" if machine in ("amd64", "x86_64") else "windows_x86"
            )
        elif os_name == "darwin":
            system = "darwin_arm64" if machine == "arm64" else "darwin_x86_64"
        elif os_name == "linux":
            if machine in ("aarch64", "arm64"):
                system = "linux_aarch64"
            elif machine in ("armv7l", "armv8l"):
                system = "linux_armv7l"
            elif machine == "armv6l":
                system = "linux_armv6l"
            else:
                system = "linux_x86_64"
        else:
            logger.warning(f"Unknown platform: {os_name}/{machine}")
            return None

    # Try both platformio/ and espressif/ owners (common for ESP32 packages)
    owners = ["platformio", "espressif"]

    # Normalize package type for PlatformIO Registry API
    # The API uses "tool" for toolchains, frameworks, debuggers, uploaders, etc.
    if package_type in ("toolchain", "framework", "debugger", "uploader", ""):
        package_type = "tool"
    # If still empty or unknown, default to "tool"
    if not package_type:
        package_type = "tool"

    for owner in owners:
        try: