Function build_library

ci/wasm_build_library.py:529–845

Build the FastLED static library. Args: build_mode: Build mode (debug, fast_debug, quick, release) force: Force rebuild all objects verbose: Enable verbose output parallel: Number of parallel jobs (None = CPU count) unity_chunks: Number of unity buil

(
    build_mode: str = "quick",
    force: bool = False,
    verbose: bool = False,
    parallel: int | None = None,
    unity_chunks: int = 0,
)

def build_library(
    build_mode: str = "quick",
    force: bool = False,
    verbose: bool = False,
    parallel: int | None = None,
    unity_chunks: int = 0,
) -> int:
    """
    Build the FastLED static library.

    Args:
        build_mode: Build mode (debug, fast_debug, quick, release)
        force: Force rebuild all objects
        verbose: Enable verbose output
        parallel: Number of parallel jobs (None = CPU count)
        unity_chunks: Number of unity build chunks (0 = disabled, >0 = enabled)

    Returns:
        Exit code (0 = success)
    """
    try:
        import time

        start_time = time.time()

        unity_mode = unity_chunks > 0
        if unity_mode:
            print(
                f"Building FastLED library (mode: {build_mode}, UNITY: {unity_chunks} chunks)..."
            )
        else:
            print(f"Building FastLED library (mode: {build_mode})...")

        # Step 1: Create build directories (including LTO cache and unity)
        BUILD_DIR.mkdir(parents=True, exist_ok=True)
        LTO_CACHE_DIR.mkdir(parents=True, exist_ok=True)
        if unity_mode:
            UNITY_DIR.mkdir(parents=True, exist_ok=True)

        # Step 2: Ensure PCH is built
        pch_result = ensure_pch_built(build_mode, verbose)
        if pch_result != 0:
            return pch_result

        # Step 2b: Generate unity build files (if enabled)
        if unity_mode:
            unity_result = ensure_unity_files_generated(unity_chunks, verbose)
            if unity_result != 0:
                return unity_result

        # Step 3: Get tool commands
        emcc = get_emcc()
        emar = get_emar()
        wasm_ld = get_wasm_ld()

        if verbose:
            print(f"Using emscripten: {emcc}")
            print(f"Using archiver: {emar}")