Function build_meson_setup_cmd

ci/meson/meson_setup_execute.py:459–545

Build the ``meson setup [--reconfigure] ...`` command list. When the venv ships a zccache (>= 1.11.13) that supports the ``meson configure`` wrapper (zackees/zccache#649) plus ``--input-file`` (zackees/zccache#655, closes zackees/zccache#654), route the invocation through that wrapp

(
    *,
    native_file_path: Path,
    build_dir: Path,
    build_mode: str,
    enable_examples: bool,
    enable_unit_tests: bool,
    reconfigure: bool,
    source_hashes: Optional["SourceHashes"] = None,
)

def build_meson_setup_cmd(
    *,
    native_file_path: Path,
    build_dir: Path,
    build_mode: str,
    enable_examples: bool,
    enable_unit_tests: bool,
    reconfigure: bool,
    source_hashes: Optional["SourceHashes"] = None,
) -> list[str]:
    """Build the ``meson setup [--reconfigure] ...`` command list.

    When the venv ships a zccache (>= 1.11.13) that supports the
    ``meson configure`` wrapper (zackees/zccache#649) plus ``--input-file``
    (zackees/zccache#655, closes zackees/zccache#654), route the
    invocation through that wrapper AND extend the cache key with a
    sidecar file containing FastLED's source/test/example hashes. The
    sidecar lets the wrapper correctly invalidate the cached configure
    tree when those globs change — so the reconfigure path also benefits
    from cache restoration instead of having to bypass the wrapper.

    When the wrapper is 1.11.14+ (zackees/zccache#660), pass ``--no-walk``
    plus an explicit ``--input-file`` for each of FastLED's known
    meson.build paths (see ``FASTLED_MESON_BUILD_FILES``). This skips
    the wrapper's recursive ``--source-dir`` walk entirely — that walk
    was dominated by ``.venv/`` traversal (~100k Python files, ~5s on
    cold-with-cache) and is pure overhead given we already enumerate
    the input set.

    When ``source_hashes`` is unavailable (caller didn't supply, or
    sidecar write failed), the reconfigure path falls back to a direct
    ``meson setup --reconfigure`` invocation. The non-reconfigure path
    still uses the wrapper without the sidecar (the wrapper hashes
    meson.build either way, which is stable for non-source-trigger
    configures).
    """
    meson_exe = get_meson_executable()
    meson_args: list[str] = [
        "--native-file",
        str(native_file_path),
        f"-Dbuild_mode={build_mode}",
        f"-Denable_examples={str(enable_examples).lower()}",
        f"-Denable_unit_tests={str(enable_unit_tests).lower()}",
    ]

    capability = _get_zccache_meson_configure_path()
    sidecar: Optional[Path] = None
    if capability is not None and source_hashes is not None:
        sidecar = _write_zccache_input_sidecar(
            build_dir=build_dir,
            build_mode=build_mode,
            source_hashes=source_hashes,
        )

    # Wrapper path: requires zccache+wrapper. The sidecar is OPTIONAL —
    # without it, the wrapper still works but only invalidates on
    # meson.build changes, so we keep the old reconfigure-bypass guard
    # to avoid stale-tree hits on source-trigger reconfigures.