ansible/rst/modules/pip.rst
2012-08-13 15:39:00 -04:00

34 lines
2.1 KiB
ReStructuredText

.. _pip:
pip
```
.. versionadded:: 0.7
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' |
+--------------------+----------+---------+----------------------------------------------------------------------------+
Please note that `virtualenv <http://www.virtualenv.org/>`_ must be installed on
the remote host if the `virtualenv` parameter is specified.
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