Function compile_examples

ci/util/meson_example_runner.py:110–247

Compile FastLED examples using Meson. Args: build_dir: Meson build directory examples: List of example names to compile (None = all) verbose: Enable verbose compilation output parallel: Enable parallel compilation (default: True) build_mode: Build mo

(
    build_dir: Path,
    examples: list[str] | None = None,
    verbose: bool = False,
    parallel: bool = True,
    build_mode: str = "quick",
    log_failures: Path | None = None,
)

def compile_examples(
    build_dir: Path,
    examples: list[str] | None = None,
    verbose: bool = False,
    parallel: bool = True,
    build_mode: str = "quick",
    log_failures: Path | None = None,
) -> bool:
    """
    Compile FastLED examples using Meson.

    Args:
        build_dir: Meson build directory
        examples: List of example names to compile (None = all)
        verbose: Enable verbose compilation output
        parallel: Enable parallel compilation (default: True)
        build_mode: Build mode ("quick", "debug", or "release")

    Returns:
        True if compilation successful, False otherwise
    """
    # Build command
    cmd = [get_meson_executable(), "compile", "-C", str(build_dir)]

    if verbose:
        cmd.append("-v")

    if not parallel:
        # Sequential compilation (-j 1)
        cmd.extend(["-j", "1"])

    # Determine targets to build
    # Note: process_group already shows "Compiling: <examples>" status
    if examples is None:
        # Build all examples via the alias target
        cmd.append("examples-host")
        target_desc = "all examples"
    else:
        # Build specific example targets
        for example_name in examples:
            cmd.append(f"example-{example_name}")
        target_desc = ", ".join(examples)

    # Start heartbeat for CI environments during long compilations
    heartbeat = CompilationHeartbeat(interval_seconds=30)
    heartbeat.start(f"Compiling {target_desc} ({build_mode} mode)")

    try:
        # Use RunningProcess for streaming output
        proc = RunningProcess(
            cmd,
            timeout=600,  # 10 minute timeout
            auto_run=True,
            check=False,  # We'll check returncode manually
            # DLLs are auto-deployed by clang-tool-chain 1.0.31+ to output directory
            output_formatter=TimestampFormatter(),
        )