Virtualenv Support (paver.virtual)¶
Paver makes it easy to set up virtualenv environments for development and deployment. Virtualenv gives you a place to install Python packages and keep them separate from your main system’s Python installation.
Using virtualenv with tasks¶
You may specify which virtual environment should particular task use. Do this
with @virtualenv
decorator:
from paver.easy import task
from paver.virtual import virtualenv
@task
@virtualenv(dir="virtualenv")
def t1():
import some_module_existing_only_in_virtualenv
paver.virtual Tasks¶
Tasks for managing virtualenv environments.
-
paver.virtual.
bootstrap
()¶ Creates a virtualenv bootstrap script. The script will create a bootstrap script that populates a virtualenv in the current directory. The environment will have paver, the packages of your choosing and will run the paver command of your choice.
This task looks in the virtualenv options for:
- script_name
- name of the generated script
- packages_to_install
- packages to install with pip/easy_install. The version of paver that you are using is included automatically. This should be a list of strings.
- paver_command_line
- run this paver command line after installation (just the command line arguments, not the paver command itself).
- dest_dir
- the destination directory for the virtual environment (defaults to ‘.’)
- no_site_packages
- don’t give access to the global site-packages dir to the virtual environment (default; deprecated)
- system_site_packages
- give access to the global site-packages dir to the virtual environment
- unzip_setuptools
- unzip Setuptools when installing it (defaults to False)
- distribute
- use Distribute instead of Setuptools. Set environment variable VIRTUALENV_DISTRIBUTE to make it the default.
- index_url
- base URL of Python Package Index
- trusted_host
- specify whether the given index_url is a trusted host to avoid deprecated warnings
- no_index
- ignore package index (only looking at find_links URL(s) instead)
- find_links
- additional URL(s) to search for packages. This should be a list of strings.
- prefer_easy_install
- prefer easy_install to pip for package installation if both are installed (defaults to False)
-
paver.virtual.
virtualenv
(dir)¶ Run decorated task in specified virtual environment.