mache.jigsaw.install_jigsawpy_package

mache.jigsaw.install_jigsawpy_package(*, channel_uri: str, log_filename: str, quiet: bool, jigsaw_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) → str[source]

Install jigsawpy from a local conda channel.

Parameters:

  • channel_uri (str) – URI for a local conda channel containing the built jigsawpy package.

  • log_filename (str) – Log file path passed through to shell command execution.

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

  • jigsaw_version (str, optional) – Version of jigsawpy to install. When provided, installation is pinned to this built version.

  • backend ({"auto", "pixi", "conda"}, optional) – Installation backend. "auto" infers backend from environment.

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

  • pixi_manifest (str, optional) – Pixi manifest path used with backend "pixi".

  • pixi_feature (str, optional) – Explicit pixi feature to target when using backend "pixi".

  • 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 backend resolves to "conda".

  • conda_prefix (str, optional) – Conda prefix used when backend resolves to "conda".

Returns:

str – Resolved backend used for installation, either "pixi" or "conda".

Raises:

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

  • RuntimeError – If backend auto-detection fails.