Skip to content

Latest commit

 

History

History
57 lines (35 loc) · 1.25 KB

README.md

File metadata and controls

57 lines (35 loc) · 1.25 KB

venvrc

Bash-based Python-venv convenience wrapper.

Demo

Install

Copy venvrc file to ~/.venvrc, and add the following line to your ~/.bashrc file:

# source .venvrc on startup
. ~/.venvrc

Restart your shell and venv will be available as a command.

Configuration

When creating virtual environments, venvrc scans for the VENV_INSTALL environment variable - if it's set, all the packages specified in it, separated by whitespace, are installed/upgraded on virtual environment creation.

For example, to upgrade pip and wheel packages on each venv creation, add the following line to your ~/.bashrc:

VENV_INSTALL="pip wheel"

Usage

venv c[reate] [ENVIRONMENT]
venv r[emove] [ENVIRONMENT]
venv a[ctivate] [ENVIRONMENT]
venv d[eactivate]
venv l[ist]

  • If [ENVIRONMENT] is not specified, the current directory's name is taken as environment name

  • If venv activate is called for an environment that doesn't exist, it will be automatically created

NOTE

Since commands contain no common prefix, they can be specified through the prefix, i.e. venv c is equivalent to venv cre, which is equivalent to venv create