diff --git a/rst/modules.rst b/rst/modules.rst index 9569e45f8c5..8ae6aaf9fa1 100644 --- a/rst/modules.rst +++ b/rst/modules.rst @@ -518,6 +518,38 @@ from /usr/bin/ansible:: .. postgresql_db: + +.. _pip: + +pip +``` + +Manages Python library dependencies. + ++--------------------+----------+---------+----------------------------------------------------------------------------+ +| parameter | required | default | comments | ++====================+==========+=========+============================================================================+ +| name | no | | The name of a Python library to install | ++--------------------+----------+---------+----------------------------------------------------------------------------+ +| version | no | | The version number to install of the Python library specified in the | +| | | | 'name' parameter | ++--------------------+----------+---------+----------------------------------------------------------------------------+ +| requirements | no | | The path to a pip requirements file | ++--------------------+----------+---------+----------------------------------------------------------------------------+ +| virtualenv | no | | An optional path to a virtualenv directory to install into | ++--------------------+----------+---------+----------------------------------------------------------------------------+ +| state | no | present | 'present', 'absent' or 'latest' | ++--------------------+----------+---------+----------------------------------------------------------------------------+ + +Examples:: + + pip name=flask + pip name=flask version=0.8 + pip name=flask virtualenv=/srv/webapps/my_app/venv + pip requirements=/srv/webapps/my_app/src/requirements.txt + pip requirements=/srv/webapps/my_app/src/requirements.txt virtualenv=/srv/webapps/my_app/venv + + postgresql_db `````````````