mache.jigsaw.detect_install_backend

mache.jigsaw.detect_install_backend(*, backend: str = 'auto') → str[source]

Resolve the jigsaw installation backend.

Parameters:

backend ({"auto", "pixi", "conda"}, optional) – Explicit backend selection. When set to "auto", backend is inferred from environment variables.

Returns:

str – Resolved backend name, either "pixi" or "conda".

Raises:

ValueError – If backend is not one of "auto", "pixi", or "conda".
RuntimeError – If backend="auto" and no supported environment variables are detected.

Notes

Auto-detection currently prefers pixi when either PIXI_PROJECT_MANIFEST or PIXI_PROJECT_ROOT is set; otherwise it falls back to conda when CONDA_PREFIX is set.