Class EnvironmentSection

ci/compiler/platformio_ini.py:73–122

Typed representation of an [env:*] section. Contains environment-specific build and configuration settings.

@dataclass
class EnvironmentSection:
    """
    Typed representation of an [env:*] section.
    Contains environment-specific build and configuration settings.
    """

    # Required/Core Options
    name: str = ""  # The environment name (e.g., "esp32s3" from "env:esp32s3")

    # Platform Options
    platform: Optional[str] = None
    framework: Optional[str] = None
    board: Optional[str] = None

    # Inheritance
    extends: Optional[str] = None

    # Build Options
    build_type: Optional[str] = None
    build_flags: list[str] = field(default_factory=lambda: [])
    build_src_filter: list[str] = field(default_factory=lambda: [])
    targets: list[str] = field(default_factory=lambda: [])

    # Library Options
    lib_deps: list[str] = field(default_factory=lambda: [])
    lib_ignore: list[str] = field(default_factory=lambda: [])
    lib_extra_dirs: list[str] = field(default_factory=lambda: [])
    lib_ldf_mode: Optional[str] = None

    # Upload Options
    upload_port: Optional[str] = None
    upload_protocol: Optional[str] = None
    upload_speed: Optional[str] = None

    # Monitor Options
    monitor_port: Optional[str] = None
    monitor_speed: Optional[str] = None
    monitor_filters: list[str] = field(default_factory=lambda: [])

    # Board-specific Options
    board_build_mcu: Optional[str] = None
    board_build_f_cpu: Optional[str] = None
    board_build_partitions: Optional[str] = None

    # Extra Scripts and Tools
    extra_scripts: list[str] = field(default_factory=lambda: [])
    check_tool: Optional[str] = None

    # Custom Options (for non-standard options)
    custom_options: dict[str, str] = field(default_factory=lambda: {})


@dataclass