Simple Python Virtual Environment Management

venv-wrapper is a convenient wrapper around Python's venv module. It was inspired by the virtualenvwrapper project, and it aims to be simpler and more convenient to use.

A long-term goal of this project is to re-implement the venv module (and perhaps eventually the virtualenv module as well) in Rust to hopefully speed up virtualenv creation as well. Though, the main priority at this time is to add features to match the functionality of the virtualenvwrapper project.

Installation

Coming soon, to crates.io, the AUR, a PPA and homebrew!

Configuration

It's possible to configure venv-wrapper with either a configuration file, environment variables, or CLI flags.

• ~/.config/venv-wrapper/config.toml

  • All paths in the config file must be absolute. toml venvs_dir = "/home/username/.a-different-venvs-directory"

• VENVWRAPPER_VENVS_DIR=~/.a-different-venvs-directory venv ls

  • Paths do not need to be absolute with environment variables.

• venv -d ~/.a-different-venvs-directory venv ls

  • Paths do not need to be absolute with CLI flags.

Available Configuration Values

• venvs_dir: The directory in which to store all virtualenvs.

Shell Compatibility

Currently, only sh, bash and zsh have been tested and confirmed to work. However, fish support should be comming soon!

UTF-8

Any path to a virtualenv (including the virtualenv name itself) must be valid UTF-8 because paths and virtualenv names are printed to the terminal (and writing invalid UTF-8 to the terminal wouldn't really be all that useful).

Though, since emojis are valid UTF-8, feel free to use them in your virtualenv names! 🚀

Missing Features

In its current state, this project does not quite match the features of virtualenvwrapper. The missing features are as follows :

• Copy virtualenvs
• Tab completion of virtualenv names
• Customizable hooks
• A plugin system to create shareable extensions