Class Board

ci/boards.py:45–674

@dataclass
class Board:
    board_name: str
    real_board_name: str | None = None
    platform: str | None = None
    platform_needs_install: bool = False
    use_pio_run: bool = (
        False  # some platforms like esp32-c2-devkitm-1 will only work with pio run
    )
    platform_packages: str | None = None
    framework: str | None = None
    board_build_mcu: str | None = None
    board_build_core: str | None = None
    board_build_filesystem_size: str | None = None
    board_build_flash_size: str | None = (
        None  # Flash size for ESP32 boards (e.g., '4MB')
    )
    build_flags: list[str] | None = None  # Reserved for future use.
    build_unflags: list[str] | None = None  # New: unflag options
    defines: list[str] | None = None
    customsdk: str | None = None
    board_partitions: str | None = None  # Reserved for future use.
    no_board_spec: bool = (
        False  # For platforms like 'native' that don't need a board specification
    )
    add_board_to_all: bool = True
    lib_compat_mode: str | None = (
        None  # Library compatibility mode (e.g., 'off' for native platform)
    )
    lib_ldf_mode: str | None = (
        None  # Library Dependency Finder mode (e.g., 'chain+' for enhanced dependency finding)
    )
    lib_ignore: list[str] | None = (
        None  # Libraries to ignore during compilation (e.g., ['I2S'] for UNO R4 WiFi)
    )
    extra_scripts: list[str] | None = (
        None  # Custom build scripts to run (e.g., ['pre:script.py'] for pre-build hooks)
    )
    # Opt-in for GCC -fopt-info-all -> optimization_report.txt. Default OFF
    # because the file accumulates across every example in the matrix and can
    # exceed 100 MB on no-LTO boards with a large sketch set (nrf52840 with
    # the Adafruit BSP would overrun the GHA log buffer and shut the runner
    # down — see PR #2658). Set True when the board's workflow genuinely
    # needs the optimization-info dump for size/perf debugging.
    generate_optimization_report: bool = False

    def __post_init__(self) -> None:
        # Check if framework is set, warn and auto-set to arduino if missing (except for native/stub platforms)
        if self.framework is None and not self._is_native_or_stub_platform():
            self.framework = "arduino"

        # Auto-detect and exclude problematic libraries based on environmental signals
        self._auto_detect_library_exclusions()

        ALL.append(self)

    def _is_native_or_stub_platform(self) -> bool:
        """Check if this is a native or stub platform that doesn't need a framework"""
        # Check for native platform