Function _run_compile

ci/check_backend_flag_drift.py:431–481

Invoke ``ci/ci-compile.py`` for ``board`` with the chosen ``backend``. Returns True on success. Output is streamed so a slow first-time framework download is visible to the user.

(
    project_root: Path,
    board: str,
    example: str,
    backend: str,
    *,
    timeout_seconds: int,
)

def _run_compile(
    project_root: Path,
    board: str,
    example: str,
    backend: str,
    *,
    timeout_seconds: int,
) -> bool:
    """Invoke ``ci/ci-compile.py`` for ``board`` with the chosen ``backend``.

    Returns True on success. Output is streamed so a slow first-time
    framework download is visible to the user.
    """
    if backend not in {"fbuild", "platformio"}:
        raise ValueError(f"unknown backend {backend!r}")

    backend_flag = "--fbuild" if backend == "fbuild" else "--pio"
    cmd: list[str] = [
        "uv",
        "run",
        "python",
        "ci/ci-compile.py",
        board,
        "--examples",
        example,
        backend_flag,
    ]

    print(
        f"\n>>> Compiling [{backend}]: {subprocess.list2cmdline(cmd)}",
        flush=True,
    )
    try:
        result = RunningProcess.run(
            cmd,
            check=False,
            cwd=str(project_root),
            timeout=timeout_seconds,
        )
    except KeyboardInterrupt as ki:
        handle_keyboard_interrupt(ki)
        raise

    success = result.returncode == 0
    if not success:
        print(
            f"\n!!! Compile failed for backend={backend} board={board} "
            f"(rc={result.returncode})",
            file=sys.stderr,
        )
    return success


# ---------------------------------------------------------------------------