pixi-to-conda-lock 0.1.0

pixi-to-conda-lock converts a pixi.lock file to a conda-lock.yml file.

pixi-to-conda-lock 🔄🔒

pixi-to-conda-lock is a Python utility designed to bridge the gap between the lightning-fast pixi lock and the traditionally slow generation of conda-lock files. By converting your fast-generated pixi.lock file into a fully functional conda-lock.yml, you can enjoy rapid lock file creation without sacrificing the reproducibility of your conda environments. 🚀

[ToC] 📚

• :star2: Features
• :books: Usage
• :hammer_and_wrench: Installation
• :bulb: Examples
  • Basic Conversion
  • Specifying a Repodata Directory
  • Enable Verbose Logging
• :page_facing_up: How It Works
• :heart: Support and Contributions

---

:star2: Features

• Speed Boost: Generate a conda-lock.yml file quickly by leveraging the performance of pixi lock.
• Accurate Conversion: Uses repodata to extract detailed package metadata from your pixi.lock file.
• Multi-Manager Support: Handles both conda and PyPI packages, ensuring comprehensive environment reproduction.
• Fully Tested: Comprehensive tests ensure robust and reliable behavior.
• Typed & Readable: Written in Python with full type annotations for clarity and maintainability.

---

:books: Usage

Transform your fast-generated pixi.lock file into a reproducible conda lock file with a single command:

pixi-to-conda-lock --help

This will display the help message:

usage: pixi-to-conda-lock [-h] [--output OUTPUT] [--repodata-dir REPODATA_DIR]
                          [--verbose]
                          pixi_lock

Convert pixi.lock to conda-lock.yml

positional arguments:
  pixi_lock             Path to pixi.lock file

options:
  -h, --help            show this help message and exit
  --output, -o OUTPUT   Output conda-lock.yml file path
  --repodata-dir REPODATA_DIR
                        Path to repodata cache directory
  --verbose, -v         Enable verbose logging

---

:hammer_and_wrench: Installation

Install pixi-to-conda-lock via PyPI:

pip install pixi-to-conda-lock

Or clone the repository and install locally:

git clone https://github.com/basnijholt/pixi-to-conda-lock.git
cd pixi-to-conda-lock
pip install .

---

:bulb: Examples

Basic Conversion

Convert your pixi.lock file to a conda-lock.yml:

pixi-to-conda-lock /path/to/pixi.lock

Specifying a Repodata Directory

If you have a custom repodata cache directory:

pixi-to-conda-lock /path/to/pixi.lock --repodata-dir /custom/path/to/repodata

Enable Verbose Logging

To see detailed logs during the conversion process:

pixi-to-conda-lock /path/to/pixi.lock --verbose

---

:page_facing_up: How It Works

1. Fast pixi.lock Parsing: Reads the fast-generated pixi.lock file, which is created quickly compared to generating a conda lock file directly.
2. Repodata Loading: Retrieves detailed package metadata from repodata files (either automatically discovered or from a user-specified directory).
3. Package Processing: Processes both conda and PyPI packages. For conda packages, if repodata information isn’t available, the tool falls back on URL parsing.
4. Generating conda-lock.yml: Combines the gathered information to generate a fully reproducible conda-lock.yml file that mirrors your original environment.

This approach ensures you get the speed benefits of pixi lock without compromising on the quality and reproducibility of your conda environments.

---

:heart: Support and Contributions

Contributions, bug reports, and feature suggestions are welcome! Please open an issue or submit a pull request on the GitHub repository.

Happy converting! 🔄🔒