sourCEntral - mobile manpages

pdf

VIRTUALENV

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

pdf