virtualenv.md

Virtualenv

note: anaconda python does not work with virtualenv/virutalenvwrapper. use conda instead.

$ type -a python
python is ~/anaconda/bin/python
python is /usr/bin/python

$ type -a python3
python3 is /usr/local/bin/python3

config file

add to ~/.zshrc file:

export WORKON_HOME=$HOME/.virtualenvs         # virtualenvs location
export PROJECT_HOME=$HOME/Envs                # project working directories location
export VIRTUALENVWRAPPER_PYTHON=              # full path of interpreter to use
export VIRTUALENV_PYTHON=                     # overrides interpreter above
export VIRTUALENVWRAPPER_VIRTUALENV=          # full path of virtualenv binary to use
source /usr/local/bin/virtualenvwrapper.sh

or specify VIRTUALENV_PYTHON with python directory before mkproject/mkvirtualenv

example

$ export VIRTUALENV_PYTHON=/usr/local/bin/python3

$ mkproject py3

$ python -V
Python 3.3.4
(py2)

mkvirtualenv/mkproject

creates an environment inside ~/.virtualenvs

$ mkvirtualenv venv

# or
$ mkvirtualenv --python=/usr/local/bin/python3 venv

creates an environment inside ~/.virtualenvs and a project directory inside ~/Envs

$ mkproject py33

install ipython

$ pip install "ipython[all]"

workon

shows current environments

$ workon
py33
venv

deactivate

switches out of current environment

$ deactivate

rmvirtualenv

removes project/environment

$ rmvirtualenv py33

allvirtualenv

update pip for all virtualenvs

$ allvirtualenv pip install -U pip

mktmpenv

creates temporary environment in WORKON_HOME directory. deleted when deactivated.

mktmpenv

requirements

after installing modules, create requirements.txt

$ pip install Flask requests
$ pip freeze > requirements.txt
$ cat requirements.txt
Flask==0.8
requests==0.11.1

# use requirements.txt modules for new virtualenv
$ pip install -r requirements.txt

postmkvirtualenv is run when a new environment is created, letting you automatically install commonly-used tools.