Function main

ci/check_backend_flag_drift.py:489–629

(argv: list[str] | None = None)

def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(
        description=(
            "Detect compiler-flag drift between the fbuild and PlatformIO "
            "backends for a single board. Exits non-zero on drift."
        )
    )
    parser.add_argument(
        "--board",
        required=True,
        help="Board to check (e.g. teensy41, esp32dev).",
    )
    parser.add_argument(
        "--example",
        default="Blink",
        help="Sketch to compile in each backend (default: Blink).",
    )
    parser.add_argument(
        "--skip-build",
        action="store_true",
        help=(
            "Skip the actual compiles and reuse any existing "
            "build_info_*.json files. Fails if neither backend has produced "
            "one yet."
        ),
    )
    parser.add_argument(
        "--timeout",
        type=int,
        default=900,
        help="Per-backend compile timeout in seconds (default: 900).",
    )
    parser.add_argument(
        "--project-root",
        type=Path,
        default=None,
        help="Override the FastLED repo root (default: auto-detect).",
    )
    args = parser.parse_args(argv)

    project_root = (
        args.project_root.resolve()
        if args.project_root is not None
        else Path(__file__).resolve().parent.parent
    )

    # The two backends overwrite the same .build/pio/<board>/build_info_*.json
    # file, so we must snapshot fbuild's output BEFORE running pio. The
    # --skip-build path only works when the user has already manually staged
    # both backends' build_info JSONs (or saved one elsewhere); we don't have
    # a way to recover a fresh fbuild snapshot from disk after pio has run.

    fbuild_info: dict
    pio_info: dict

    if args.skip_build:
        bi_path = _find_build_info(project_root, args.board, args.example, "fbuild")
        if bi_path is None: