Function create_pio_process

ci/util/pio_runner.py:32–93

Create a RunningProcess for PlatformIO commands with Git Bash compatibility. On Windows Git Bash: Runs command via cmd.exe with clean environment On other platforms: Runs command directly Args: cmd: Command to execute as list of strings cwd: Working directory for comman

(
    cmd: list[str],
    cwd: Path | str,
    output_formatter: Any | None = None,
    auto_run: bool = True,
)

def create_pio_process(
    cmd: list[str],
    cwd: Path | str,
    output_formatter: Any | None = None,
    auto_run: bool = True,
) -> RunningProcess:
    """Create a RunningProcess for PlatformIO commands with Git Bash compatibility.

    On Windows Git Bash: Runs command via cmd.exe with clean environment
    On other platforms: Runs command directly

    Args:
        cmd: Command to execute as list of strings
        cwd: Working directory for command execution
        output_formatter: Optional formatter for output lines
        auto_run: If True, start the process immediately

    Returns:
        RunningProcess instance configured for the current environment
    """
    env = get_pio_execution_env()

    # Convert cwd to Path if it's a string (RunningProcess expects Path | None)
    cwd_path = Path(cwd) if isinstance(cwd, str) else cwd

    if should_use_cmd_runner():
        # Windows Git Bash: Convert to shell command for cmd.exe
        cmd_str = format_cmd_for_shell(cmd)
        proc = RunningProcess(
            cmd_str,
            cwd=cwd_path,
            auto_run=auto_run,
            output_formatter=output_formatter,
            env=env,
            shell=True,  # Use shell=True for cmd.exe execution
        )
    else:
        # Linux/Mac or native Windows shell: Direct execution
        proc = RunningProcess(
            cmd,
            cwd=cwd_path,
            auto_run=auto_run,
            output_formatter=output_formatter,
            env=env,
        )

    # Register process for orphan cleanup by daemon and for atexit killing
    if auto_run and proc.proc is not None and isinstance(proc.proc, subprocess.Popen):
        popen: subprocess.Popen[Any] = proc.proc
        pid = popen.pid
        register_build_process(
            root_pid=pid,
            project_dir=str(cwd),
        )
        # Unregister on normal exit
        atexit.register(unregister_build_process)

        # Also register with process killer for atexit cleanup