Function run_package_install_with_retry

ci/util/pio_package_daemon.py:391–533

Run package install with retry logic for network errors. On Windows, this runs pio via cmd.exe shell with a clean environment (no Git Bash indicators) to prevent ESP-IDF tooling from aborting. Args: cmd: Command to execute environment: Environment name (for status updat

(
    cmd: list[str],
    environment: str | None,
    project_dir: str,
    caller_pid: str | int = "unknown",
    caller_cwd: str = "unknown",
    max_retries: int = MAX_NETWORK_RETRIES,
)

def run_package_install_with_retry(
    cmd: list[str],
    environment: str | None,
    project_dir: str,
    caller_pid: str | int = "unknown",
    caller_cwd: str = "unknown",
    max_retries: int = MAX_NETWORK_RETRIES,
) -> tuple[int, str]:
    """Run package install with retry logic for network errors.

    On Windows, this runs pio via cmd.exe shell with a clean environment
    (no Git Bash indicators) to prevent ESP-IDF tooling from aborting.

    Args:
        cmd: Command to execute
        environment: Environment name (for status updates), or None for default
        project_dir: Project directory (for status updates)
        caller_pid: Caller process PID (for status updates)
        caller_cwd: Caller working directory (for status updates)
        max_retries: Maximum retry attempts (default: 3)

    Returns:
        (returncode, full_output)
    """
    # Determine if we should use shell on Windows
    is_windows = platform.system() == "Windows"

    # On Windows: use cmd.exe shell with clean environment (no Git Bash)
    # On Linux/Mac: use direct execution with inherited environment
    if is_windows:
        # Use shell=True on Windows to invoke via cmd.exe
        # Convert list to string for shell execution
        cmd_str = " ".join(cmd)
        shell = True
        env = get_clean_windows_env()
        logging.info("Windows detected: using cmd.exe shell with clean environment")
        logging.debug(f"Command string: {cmd_str}")
    else:
        # Non-Windows: use direct execution (no shell)
        cmd_str = cmd
        shell = False
        env = None  # Inherit environment
        logging.info("Non-Windows platform: using direct execution")

    for attempt in range(max_retries):
        if attempt > 0:
            retry_msg = f"Retry {attempt}/{max_retries - 1} after network error"
            logging.info(retry_msg)
            update_status(
                DaemonState.INSTALLING,
                retry_msg,
                environment=environment,
                project_dir=project_dir,
                caller_pid=caller_pid,
                caller_cwd=caller_cwd,
                current_operation=retry_msg,
            )
            time.sleep(5)  # Brief delay before retry