mache.jigsaw.build_jigsawpy_package

mache.jigsaw.build_jigsawpy_package(*, python_version: str, jigsaw_python_path: str, repo_root: str, log_filename: str, quiet: bool, backend: str = 'auto', pixi_exe: str | None = None, conda_exe: str | None = None) → JigsawBuildResult[source]

Build a local conda package for jigsawpy.

The function ensures the jigsaw-python source is available, computes a cache key, reuses cached output when valid, and otherwise runs rattler-build using the resolved backend.

Parameters:

  • python_version (str) – Python major/minor version used to select the variant matrix.

  • jigsaw_python_path (str) – Path to jigsaw-python relative to repo_root.

  • repo_root (str) – Root directory containing the source tree.

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

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

  • backend ({"auto", "pixi", "conda"}, optional) – Backend used to run rattler-build.

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

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

Returns:

JigsawBuildResult – Build metadata including channel URI, cache key, cache hit flag, and resolved jigsawpy version.

Raises:

  • ValueError – If python_version or platform-specific build configuration is unsupported.

  • RuntimeError – If source acquisition, metadata extraction, or build validation fails.