mkdjangovirtualenv 0.0.2

A django-specific enhancement to virtualenvwrapper's mkvirtualenv function to setup the settings and pythonpath variables, auto-install requirements, set the project path, and install git modules if possible.

Performs the command mkvirtualenv ENV_NAME, but also:

• sets the directory to jump to when the virtualenv is activated

• sets the PYTHONPATH and DJANGO_SETTINGS_MODULE in the postactivate hook

• auto-installs dependencies if there is a requirements.txt file

• auto-inits git submodules if there are any

This is intended to save environment setup busywork after pulling down a django project from github.

This does not run django-admin.py startproject, instead it is for configuring the environment for an existing django project. If you are looking for a way to create an empty django project with virtualenvwrapper, check out the [virtualenvwrapper.django template plugin for virtualenvwrapper](http://www.doughellmann.com/projects/virtualenvwrapper.django/).

Usage

source mkdjangovirtualenv [–settings DJANGO_SETTINGS_MODULE] ENV_NAME [PROJECT_DIRECTORY]

Options

--settings DJANGO_SETTINGS_MODULE

Provide a python import path for the settings file. Defaults to project.settings

ENV_NAME

The name for the virtualenv

PROJECT_DIRECTORY

Provide a path to the root of the project. May be a relative path, defaults the current working directory.

Installation

Include mkdjangovirtualenv.sh in a startup script so you can use its mkdjangovirtualenv function directly.

Or, you can install from pypi, which will place the mkdjangovirtualenv script in a bin directory so it can be used on your path (and as a result, it will most likely require sudo):

sudo pip install mkdjangovirtualenv