coman 0.1a1

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 lockfiles. 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 is expected to work fully on Linux and macOS if a recent version of mamba is already available on your system. Otherwise you can currently only install (coman install) and activate (coman shell) environments. In other words: you can use CoMan on a production system without any external dependencies.

CoMan manages:

• environment.yml:
  • add/remove dependencies with version constraints
• conda-{platform}.lock:
  • (multi-platform) lock files for reproducable environments
• {envs_dir}/{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/mamba are installed (the conda base environment) if you want to be able to edit your environment.yml and lock files.
conda activate base
pipx install -e --python python coman

Latest development version

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

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 conflicts between coman and the command you run)
cm run -- python --version

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