coman 0.1a5

Simpler Conda dependency management

CoMan: Conda Manager

A simple CLI for Conda dependency management. CoMan gives you simple commands to manage dependencies in your environment.yml and properly uses lock files. Moreover, it manages unique Conda environments per project directory. CoMan mimicks the workflow of Poetry (or any other modern dependency manager), but then for Conda.

Warning: CoMan is work in progress and may not work in every scenario.

CoMan manages:

• environment.yml:
  • add/remove dependencies with version constraints
• conda-{platform}.lock:
  • (multi-platform) lock files for reproducable environments
• requirements.txt:
  • (optional) pinned pip dependencies from environment.yml
• {CONDA_ROOT}/envs/{basename}-{hash}:
  • unique environments for your project in your default environments directory

Installation

There is currently no CoMan conda recipe. CoMan is designed to work independently of Conda, so that it can install and run Conda environments on any system (with Micromamba).

pip install -U coman

# pipx (recommended)
# make sure that pipx uses the python environment in which conda is installed (the conda base environment) if you have those installed
conda activate base
pipx install -e --python python coman

Latest development version

pip install --user --upgrade git+https://github.com/wietsedv/coman.git

Development

git clone [e-mail]:wietsedv/coman.git
cd coman && pip install -e .

Quick start

cd projects/MyProject

# "cm" is short for "coman"; use the command you prefer

# show system and environment status
cm info

# create environment.yml and lock file
cm init

# install the environment
cm install

# add "requests" dependency to environment.yml, the lock file(s) and your installed environment
cm add requests

# show the installed packages
cm show

# run a command (use -- to avoid argument conflicts)
cm run -- python --version
cm python -- --version  # available for bash and python
coman-python --version  # available for bash and python

# activate your environment in your current shell (at least works with bash and zsh)
cm shell