Function _fbuild_supports_subcommand

ci/util/fbuild_runner.py:178–209

Return whether the active fbuild executable exposes ``subcommand``. Probes with `` --help`` rather than `` help ``: the latter parses ``help`` as the subcommand name and `` `` as a positional arg, which fails clap arg validation (e

(subcommand: str)

def _fbuild_supports_subcommand(subcommand: str) -> bool:
    """Return whether the active fbuild executable exposes ``subcommand``.

    Probes with ``<fbuild> <subcommand> --help`` rather than ``<fbuild> help
    <subcommand>``: the latter parses ``help`` as the subcommand name and
    ``<subcommand>`` as a positional arg, which fails clap arg validation
    (exit 2) on any subcommand with required args like ``--board``. With
    ``--help`` clap intercepts and prints help with exit 0 regardless of
    other required args. The old probe silently disabled compile-many on
    every CI run and forced the legacy serial fallback path.
    """
    import subprocess

    fbuild_exe = get_fbuild_executable()
    if fbuild_exe is None:
        return False
    try:
        proc = subprocess.run(
            [fbuild_exe, subcommand, "--help"],
            capture_output=True,
            text=True,
            timeout=15,
            check=False,
        )
    except KeyboardInterrupt as ki:
        from ci.util.global_interrupt_handler import handle_keyboard_interrupt

        handle_keyboard_interrupt(ki)
        raise
    except (FileNotFoundError, subprocess.SubprocessError, OSError):
        return False
    return proc.returncode == 0


@lru_cache(maxsize=1)