virtualenv(1)
NAME
virtualenv - create virtual Python instances
SYNOPSIS
virtualenv [--version] [--help] [--verbose] [--quiet] [--clear]
[--no-site-packages] [destination-directory]
DESCRIPTION
This manual page documents briefly the virtualenv command.
This manual page was written for the Debian distribution because the
original program does not have a manual page.
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 overriden 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
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`-´). A summary of options is
included below.
- -h --help
- Show summary of options.
- --version
- Show version of 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. - --no-site-packages
- Don´t give access to the global site-packages modules to the
virtual environment.
SEE ALSO
The upstream documentation, stored in /usr/share/doc/virtualenv.
AUTHOR
This manual page was written by Jeff Licquia <licquia@debian.org> for
the Debian system (but may be used by others). Permission is granted to
copy, distribute and/or modify this document under the terms of the GNU
General Public License, Version 2 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 © 2007 Jeff Licquia