viv/README.md

Viv

viv isn't venv

Setup

Start by cloning the repo and symlinking the script for access to the CLI. By default it will symlink ./src/viv/viv.py to ~/bin/viv. You can set PREFIX to symlink to a different location.

git clone git@github.com:daylinmorgan/viv.git ~/.viv
cd ~/.viv
make install # or PREFIX=~/.local/bin make install

Place this directory on the python path in your rc file.

export PYTHONPATH="$PYTHONPATH:$HOME/.viv/src"

Then in any python script with external dependencies you can add this line.

__import__("viv").activate("click")

Usage

To temove all viv venvs:

viv remove $(viv list -q)

TODO

• add doc strings to src/viv/viv.py
• use config file (probably ini or json / could also allow toml for python>=3.11)
• enable a garbage collection based on time or file existence (configurable)
• unit tests

Alternatives

• pipx
• pip-run