salt.modules.virtualenv¶

Create virtualenv environments.

salt.modules.virtualenv_mod.create(path, venv_bin=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, use_vt=False, 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.

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

use_vt : False

Use VT terminal emulation (see ouptut while installing)

New in version 2015.5.0.

saltenv : 'base'

Specify a different environment. The default environment is base.

New in version 2014.1.0.

Note

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

CLI Example:

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

salt.modules.virtualenv_mod.get_resource_content(venv, package_or_requirement, resource_name)¶

Returns the content of a resource of a package or a distribution inside a virtualenv

New in version 2015.5.0.

venv

Path to the virtualenv.

package_or_requirement

Name of the package where the resource resides in.

resource_name

Name of the resource of which the content is to be returned.

CLI Example:

salt '*' virtualenv.get_resource_content /path/to/my/venv my_package my/resource.xml

salt.modules.virtualenv_mod.get_resource_path(venv, package_or_requirement, resource_name)¶

Returns the path to a resource of a package or a distribution inside a virtualenv

New in version 2015.5.0.

venv

Path to the virtualenv.

package_or_requirement

Name of the package where the resource resides in.

resource_name

Name of the resource of which the path is to be returned.

CLI Example:

salt '*' virtualenv.get_resource_path /path/to/my/venv my_package my/resource.xml

salt.modules.virtualenv_mod.get_site_packages(venv)¶

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

venv

Path to the virtualenv.

CLI Example:

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