Method _create_parser

ci/compiler/argument_parser.py:156–291

Create argument parser with all options.

(self)

        return config

    def _create_parser(self) -> argparse.ArgumentParser:
        """Create argument parser with all options."""
        parser = argparse.ArgumentParser(
            description="Compile FastLED examples for various boards using PioCompiler"
        )

        # Positional arguments
        parser.add_argument(
            "boards",
            type=str,
            help="Comma-separated list of boards to compile for",
            nargs="?",
        )
        parser.add_argument(
            "positional_examples",
            type=str,
            help="Examples to compile (positional arguments after board name)",
            nargs="*",
        )

        # Build options
        parser.add_argument(
            "--examples", type=str, help="Comma-separated list of examples to compile"
        )
        parser.add_argument(
            "--exclude-examples", type=str, help="Examples that should be excluded"
        )
        parser.add_argument(
            "--no-filter",
            action="store_true",
            help="Disable @filter directives (compile even if incompatible with board). "
            "By default, filters always apply to prevent compilation failures.",
        )
        parser.add_argument(
            "--defines", type=str, help="Comma-separated list of compiler definitions"
        )
        parser.add_argument(
            "--extra-packages",
            type=str,
            help="Comma-separated list of extra PlatformIO library packages to install (e.g., 'OctoWS2811')",
        )
        parser.add_argument(
            "-v", "--verbose", action="store_true", help="Enable verbose output"
        )
        # Output options
        parser.add_argument(
            "-o",
            "--out",
            type=str,
            help="Output path for build artifact. Requires exactly one sketch. "
            "If path ends with '/', treated as directory. If has suffix, treated as file. "
            "Use '-o .' to save in current directory with sketch name.",
        )
        parser.add_argument(
            "--merged-bin",
            action="store_true",
            help="Generate merged binary for QEMU/flashing (ESP32/ESP8266 only). "
            "Produces a single flash image instead of separate bootloader/firmware/partition files.",