salt.modules.virtualenv¶

Create virtualenv environments

salt.modules.virtualenv_mod.create(path, venv_bin=None, no_site_packages=None, system_site_packages=False, distribute=False, clear=False, python=None, extra_search_dir=None, never_download=None, prompt=None, pip=False, symlinks=None, upgrade=None, user=None, runas=None, saltenv='base')¶

Create a virtualenv

path

The path to create the virtualenv

venv_bin : None (default 'virtualenv')

The name (and optionally path) of the virtualenv command. This can also be set globally in the minion config file as virtualenv.venv_bin.

no_site_packages : None

Passthrough argument given to virtualenv if True. Deprecated since salt>=0.17.0. Use system_site_packages=False instead.

system_site_packages : False

Passthrough argument given to virtualenv or pyvenv

distribute : False

Passthrough argument given to virtualenv

pip : False

Install pip after creating a virtual environment, implies distribute=True

clear : False

Passthrough argument given to virtualenv or pyvenv

python : None (default)

Passthrough argument given to virtualenv

extra_search_dir : None (default)

Passthrough argument given to virtualenv

never_download : None (default)

Passthrough argument given to virtualenv if True

prompt : None (default)

Passthrough argument given to virtualenv if not None

symlinks : None

Passthrough argument given to pyvenv if True

upgrade : None

Passthrough argument given to pyvenv if True

user : None

Set ownership for the virtualenv

runas : None

Set ownership for the virtualenv

Note

The runas argument is deprecated as of Hydrogen. user should be used instead.

CLI Example:

salt '*' virtualenv.create /path/to/new/virtualenv

salt.modules.virtualenv_mod.get_site_packages(venv)¶

Returns the path to the site-packages directory inside a virtualenv

CLI Example:

salt '*' virtualenv.get_site_packages /path/to/my/venv