mache.jigsaw.deploy_jigsawpy

mache.jigsaw.deploy_jigsawpy(*, jigsaw_python_path: str = 'jigsaw-python', repo_root: str = '.', log_filename: str | None = None, quiet: bool = False, python_version: str | None = None, backend: str = 'auto', pixi_exe: str | None = None, pixi_manifest: str | None = None, pixi_feature: str | None = None, pixi_local: bool = False, conda_exe: str | None = None, conda_prefix: str | None = None) → JigsawBuildResult[source]

Build and install jigsawpy in one call.

This convenience wrapper first builds a local conda package for jigsawpy (including the bundled JIGSAW dependency) and then installs that package into either a pixi or conda environment. The resolved backend is used for both the build and install stages.

Parameters:

  • jigsaw_python_path (str) – Path to the jigsaw-python source relative to repo_root. Defaults to "jigsaw-python".

  • repo_root (str) – Root directory containing the target source tree. Defaults to ".".

  • log_filename (str, optional) – Log file path passed through to shell command execution. If None, logs are discarded (written to os.devnull).

  • quiet (bool) – If True, suppress command echo to stdout and log only. Defaults to False.

  • python_version (str, optional) – Python major/minor version used to select the build variant (for example "3.14"). If omitted, the version is inferred from the active Python interpreter.

  • backend ({"auto", "pixi", "conda"}, optional) – Backend used for both build and install stages. "auto" infers backend from environment variables.

  • pixi_exe (str, optional) – Path to the pixi executable when backend resolves to "pixi".

  • pixi_manifest (str, optional) – Pixi manifest path used when installing with backend "pixi". If omitted, PIXI_PROJECT_MANIFEST is used.

  • pixi_feature (str, optional) – Explicit pixi feature to target when installing with backend "pixi". If omitted, a matching active pixi environment name is used when possible.

  • pixi_local (bool, optional) – If True and backend resolves to "pixi", install into a local copied manifest under .mache_cache/jigsaw/pixi-local instead of mutating the source manifest directly.

  • conda_exe (str, optional) – Conda executable used when installing with backend "conda".

  • conda_prefix (str, optional) – Target conda prefix used when backend is "conda". If omitted, CONDA_PREFIX is used.

Returns:

JigsawBuildResult – Metadata describing the produced local package channel and cache status.

Raises:

  • ValueError – If backend-specific required arguments are missing or invalid.

  • RuntimeError – If source discovery, backend detection, or build/install steps fail.