Function apply_board_specific_config

ci/compiler/build_config.py:275–346

Apply board-specific build configuration from Board class.

(
    board: "Board",
    platformio_ini_path: Path,
    example: str,
    paths: "FastLEDPaths",
    additional_defines: Optional[list[str]] = None,
    additional_include_dirs: Optional[list[str]] = None,
    additional_libs: Optional[list[str]] = None,
)

def apply_board_specific_config(
    board: "Board",
    platformio_ini_path: Path,
    example: str,
    paths: "FastLEDPaths",
    additional_defines: Optional[list[str]] = None,
    additional_include_dirs: Optional[list[str]] = None,
    additional_libs: Optional[list[str]] = None,
) -> bool:
    """Apply board-specific build configuration from Board class."""
    # Use provided paths object (which may have overrides)
    paths.ensure_directories_exist()

    project_root = _get_project_root()

    # Generate platformio.ini content using the enhanced Board method
    config_content = board.to_platformio_ini(
        additional_defines=additional_defines,
        additional_include_dirs=additional_include_dirs,
        additional_libs=additional_libs,
        include_platformio_section=True,
        core_dir=str(paths.core_dir),
        packages_dir=str(paths.packages_dir),
        project_root=str(project_root),
        build_cache_dir=str(paths.build_cache_dir),
    )

    # Apply PlatformIO cache optimization to speed up builds
    try:
        from ci.compiler.platformio_cache import PlatformIOCache
        from ci.compiler.platformio_ini import PlatformIOIni

        # Parse the generated INI content
        pio_ini = PlatformIOIni.parseString(config_content)

        # Set up global PlatformIO cache
        cache = PlatformIOCache(paths.global_platformio_cache_dir)

        # Optimize by downloading and caching packages, replacing URLs with local file:// paths
        pio_ini.optimize(cache)

        # Use the optimized content
        config_content = str(pio_ini)
        print(
            f"Applied PlatformIO cache optimization using cache directory: {paths.global_platformio_cache_dir}"
        )

    except KeyboardInterrupt as ki:
        handle_keyboard_interrupt(ki)
        raise
    except Exception as e:
        # Graceful fallback to original URLs on cache failures
        print(
            f"Warning: PlatformIO cache optimization failed, using original URLs: {e}"
        )
        # config_content remains unchanged (original URLs)

    platformio_ini_path.write_text(config_content)