Project Management¶
A project directory is associated with a virtualenv, but usually contains the source code under active development rather than the installed components needed to support the development. For example, the project directory may contain the source code checked out from a version control system, temporary artifacts created by testing, experimental files not committed to version control, etc.
A project directory is created and bound to a virtualenv when mkproject is run instead of mkvirtualenv. To bind an existing project directory to a virtualenv, use setvirtualenvproject.
Using Templates¶
A new project directory can be created empty, or populated using one or more template plugins. Templates should be specified as arguments to mkproject. Multiple values can be provided to apply more than one template. For example, to check out a Mercurial repository from a project on BitBucket and create a new Django site, combine the bitbucket and django templates.
$ mkproject -t bitbucket -t django my_site
Project Hook Files¶
The project directory can include additional hook files for the postactivate and predeactivate hooks. Placing hook scripts in the project hook directory, .virtualenvwrapper, allows them to be checked into version control and shared more easily.
When the postactivate hook runs, it looks for .virtualenvwrapper/postactivate within the project directory and if it is found it sources the file.
When the predeactivate hook runs, it looks for .virtualenvwrapper/predeactivate within the project directory and if it is found it sources the file.