Per-User Customization

The global scripts applied to all environments should be placed in thedirectory named by VIRTUALENVWRAPPER_HOOK_DIR, which by default will be equalto . The local scripts should beplaced in the directory of the virtualenv.

As a Django developer, you likely want DJANGO_SETTINGS_MODULE to be set, andif you work on multiple projects, you want it to be specific to the projectyou are currently working on. Wouldn’t it be nice if it was set based on theactive virtualenv? You can achieve this with Per-User Customization as follows.

If your is set to ~/.virtualenvs:

Edit the file so it contains the following (for a default Django setup):

Create a new virtualenv, and you should see DJANGO_SETTINGS_MODULE in your env!

get_env_details

$VIRTUALENVWRAPPER_HOOK_DIR/get_env_details is run when workon is run with noarguments and a list of the virtual environments is printed. The hookis run once for each environment, after the name is printed, and canprint additional information about that environment.

initialize

Global/Local:	global
Argument(s):	None
Sourced/Run:	sourced

$VIRTUALENVWRAPPER_HOOK_DIR/initialize is sourced when virtualenvwrapper.shis loaded into your environment. Use it to adjust global settingswhen virtualenvwrapper is enabled.

premkvirtualenv

Global/Local:	global
Argument(s):	name of new environment
Sourced/Run:	run

postmkvirtualenv

Global/Local:	global
Argument(s):	none
Sourced/Run:	sourced

$VIRTUALENVWRAPPER_HOOK_DIR/postmkvirtualenv is sourced after the new environmentis created and activated. If the -a <project_path> flag was used,the link to the project directory is set up before this script is sourced.

$VIRTUALENVWRAPPER_HOOK_DIR/precpvirtualenv is run as an external program afterthe source environment is duplicated and made relocatable, but beforethe hook is run or the current environment isswitched to point to the new env. The current working directory forthe script is $WORKON_HOME and the names of the source and newenvironments are passed as arguments to the script.

postcpvirtualenv

Global/Local:	global
Argument(s):	none
Sourced/Run:	sourced

$VIRTUALENVWRAPPER_HOOK_DIR/postcpvirtualenv is sourced after the new environmentis created and activated.

preactivate

Global/Local:	global, local
Argument(s):	environment name
Sourced/Run:	run

The global $VIRTUALENVWRAPPER_HOOK_DIR/preactivate script is run before the newenvironment is enabled. The environment name is passed as the firstargument.

The local $VIRTUAL_ENV/bin/preactivate hook is run before the newenvironment is enabled. The environment name is passed as the firstargument.

postactivate

Global/Local:	global, local
Argument(s):	none
Sourced/Run:	sourced

The global $VIRTUALENVWRAPPER_HOOK_DIR/postactivate script is sourced after thenew environment is enabled. $VIRTUAL_ENV refers to the newenvironment at the time the script runs.

This example script adds a space between the virtual environment nameand your old PS1 by making use of _OLD_VIRTUAL_PS1.

This example script for the PyMOTW environment changes the currentworking directory and the PATH variable to refer to the source treecontaining the PyMOTW source.

predeactivate

The local script is sourced before thecurrent environment is deactivated, and can be used to disable orclear settings in your environment. $VIRTUAL_ENV refers to the oldenvironment at the time the script runs.

The global $VIRTUALENVWRAPPER_HOOK_DIR/predeactivate script is sourced before thecurrent environment is deactivated. $VIRTUAL_ENV refers to theold environment at the time the script runs.

Global/Local:	local, global
Argument(s):	none
Sourced/Run:	sourced

The $VIRTUAL_ENV/bin/postdeactivate script is sourced after thecurrent environment is deactivated, and can be used to disable orclear settings in your environment. The path to the environment justdeactivated is available in $VIRTUALENVWRAPPER_LAST_VIRTUALENV.

prermvirtualenv

Global/Local:	global
Argument(s):	environment name
Sourced/Run:	run

The $VIRTUALENVWRAPPER_HOOK_DIR/prermvirtualenv script is run as an externalprogram before the environment is removed. The full path to theenvironment directory is passed as an argument to the script.

postrmvirtualenv

Global/Local:	global
Argument(s):	environment name
Sourced/Run:	run

The $VIRTUALENVWRAPPER_HOOK_DIR/postrmvirtualenv script is run as an externalprogram after the environment is removed. The full path to theenvironment directory is passed as an argument to the script.

premkproject

$WORKON_HOME/premkproject is run as an external program after thevirtual environment is created and after the current environment isswitched to point to the new env, but before the new project directoryis created. The current working directory for the script is$PROJECT_HOME and the name of the new project is passed as anargument to the script.

postmkproject

Global/Local:	global
Argument(s):	none
Sourced/Run:	sourced