Function locate_binary

python/src/cmdop/_locate.py:69–108

Return an absolute path to a runnable ``cmdop-core`` binary. Raises :class:`FileNotFoundError` if neither the override nor a baked binary is present, or if the host platform/arch has no prebuilt binary.

()

def locate_binary() -> str:
    """Return an absolute path to a runnable ``cmdop-core`` binary.

    Raises :class:`FileNotFoundError` if neither the override nor a baked binary
    is present, or if the host platform/arch has no prebuilt binary.
    """
    override = os.environ.get("CMDOP_CORE_BINARY")
    if override:
        if not os.path.exists(override):
            raise FileNotFoundError(
                f"CMDOP_CORE_BINARY points at a missing file: {override}"
            )
        _make_executable(override)
        return override

    slug = _host_slug()
    if slug is None:
        raise FileNotFoundError(
            f"cmdop-core has no prebuilt binary for {sys.platform}/"
            f"{platform.machine().lower()}. Set CMDOP_CORE_BINARY to a "
            "`go build -o /path/cmdop-core ./cmd/cmdop-core` output."
        )

    name = _binary_name()
    try:
        resource = files("cmdop._bin").joinpath(name)
        with as_file(resource) as p:
            path = str(p)
        if not os.path.exists(path):
            raise FileNotFoundError(path)
    except (FileNotFoundError, ModuleNotFoundError, OSError) as exc:
        raise FileNotFoundError(
            f"cmdop-core binary not found ({name}). The 5 baked binaries ship "
            "in the wheel under cmdop/_bin/; reinstall cmdop, or set "
            "CMDOP_CORE_BINARY to a `go build -o /path/cmdop-core "
            "./cmd/cmdop-core` output."
        ) from exc

    _make_executable(path)
    return path