virtualenvwrapper / docs / en / projects.rst

Project Management

A :term:`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 :ref:`command-mkproject` is run instead of :ref:`command-mkvirtualenv`. To bind an existing project directory to a virtualenv, use :ref:`command-setvirtualenvproject`.

Using Templates

A new project directory can be created empty, or populated using one or more :term:`template` plugins. Templates should be specified as arguments to :ref:`command-mkproject`. Multiple values can be provided to apply more than one template. For example, to check out a Mercurial repository from on a project on bitbucket and create a new Django site, combine the :ref:`templates-bitbucket` and :ref:`templates-django` templates.

$ mkproject -t bitbucket -t django my_site