NAME
virtualenv - create virtual Python instances
SYNOPSIS
virtualenv [--version] [--help] [--verbose] [--quiet] [--clear]
[--no-site-packages] [destination-directory]
DESCRIPTION
virtualenv creates virtual Python executables, each of which can have
its own set of installed modules. Programs that require different
versions of modules or sets of modules that may be incompatible with
others to be installed on the same system without conflicts.
The result is a directory containing its own Python executables (in
DIR/bin/pythonVER and DIR/bin/python) and its own module directory
containing the standard library as installed by the system. Additional
modules may be installed via setuptools, as invoked from the binary
directory (DIR/bin/easy_install). The system's site-packages
directories will be available, but can be overridden with
locally-installed modules.
In addition, a shell script called "activate" will be installed in the
bin directory. If sourced, this will cause normal invokations of the
Python executable to use the virtual environment.
By running the virtualenv command explicitly under the desired Python
interpreter, the user can control which version of Python is created in
the virtual environment.
OPTIONS
-h, --help
Show summary of options.
--version
Show the version of the program.
-v, --verbose
Be more verbose.
-q, --quiet
Be less verbose; suppress unimportant output.
--clear
Clear out a previously-created virtual Python instance in this
location before creating a new one.
-p PYTHON_EXE,--python=PYTHON_EXE
The Python interpreter to use to create the new environment.
--no-site-packages
Don't give access to the global site-packages modules to the
virtual environment.
--unzip-setuptools
Unzip Setuptools or Distribute when installing it.
--relocatable
Make an EXISTING virtualenv environment relocatable.
--distribute
Ignored. Distribute is used by default. See --setuptools to use
Setuptools instead of Distribute.
--setuptools Use Setuptools instead of Distribute. Set environ variable
VIRTUALENV_USE_SETUPTOOLS to make it the default.
AUTHORS
This manual page was originally written by Jeff Licquia <licquia@debian.org>, later rewritten by Carl Chenet <chaica@ohmytux.com>.
LICENSE
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, version 2 or any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.
COPYRIGHT
Copyright (C) 2007 Jeff Licquia
12/02/2009