Role Name

=========

This role installs virtualenv and virtualenvwrapper, sets up environment variables for virtualenvwrapper, and creates a Python virtual environment.

Requirements

You need to have Python installed where the virtualenv_python variable points. You will almost always need Pip and Python "-dev" packages. The python role handles these requirements.

Role Variables

Specify the path to Python for creating a virtual environment:

virtualenv_python: /usr/bin/python3

Set up WORKON_HOME and PROJECT_HOME in the user's home directory under ~ansible_user/workon_dir and ~ansible_user/project_dir respectively. By default, these will be in the $HOME directory of the ansible_user.

virtualenv_workon_dir: pyves
virtualenv_project_dir: pyves

Create a project using mkvirtualenv with the virtualenv_python only if virtualenv_project variable is specified.

virtualenv_project: myproject

Dependencies

rm-software.python

Example Playbook

- hosts: servers
  - import_role:
      name: virtualenv
    vars:
      virtualenv_python: /usr/bin/python3.6
      virtualenv_project: myproject