Function run_fbuild_compile

ci/util/fbuild_runner.py:287–391

Compile the project using fbuild CLI subprocess. Uses ``fbuild build`` as a subprocess so that Ctrl+C terminates it immediately (the Rust binary handles SIGINT natively). Args: build_dir: Project directory containing platformio.ini environment: Build environment (None =

(
    build_dir: Path,
    environment: str | None = None,
    verbose: bool = False,
    clean: bool = False,
    timeout: float = 1800,
    quiet: bool = False,
    log_file: IO[str] | None = None,
)

def run_fbuild_compile(
    build_dir: Path,
    environment: str | None = None,
    verbose: bool = False,
    clean: bool = False,
    timeout: float = 1800,
    quiet: bool = False,
    log_file: IO[str] | None = None,
) -> FbuildCommandResult:
    """Compile the project using fbuild CLI subprocess.

    Uses ``fbuild build`` as a subprocess so that Ctrl+C terminates it
    immediately (the Rust binary handles SIGINT natively).

    Args:
        build_dir: Project directory containing platformio.ini
        environment: Build environment (None = auto-detect)
        verbose: Enable verbose output
        clean: Perform clean build
        timeout: Maximum build time in seconds (default: 30 minutes)
        quiet: Suppress verbose output (emit single summary line)
        log_file: File to redirect verbose output to in quiet mode

    Returns:
        Result containing success flag, return code, and captured output
    """
    import subprocess

    from running_process import RunningProcess

    if environment is None:
        raise ValueError("environment must be specified for fbuild compilation")

    out = _get_output(quiet, log_file)
    print("=" * 60, file=out)
    print("COMPILING (fbuild)", file=out)
    print("=" * 60, file=out)

    fbuild_exe = get_fbuild_executable()
    if fbuild_exe is None:
        message = "BUILD FAIL fbuild not found on PATH"
        print(message, file=out)
        return FbuildCommandResult(success=False, output=message)

    cmd: list[str] = [
        fbuild_exe,
        str(build_dir),
        "build",
        "-e",
        environment,
    ]
    if verbose:
        cmd.append("-v")
    if clean:
        cmd.append("-c")

    print(f"Running: {subprocess.list2cmdline(cmd)}", file=out)
    print(file=out)