Project description

----

Fabric is a Python (2.5-2.7) library and command-line tool forstreamlining the use of SSH for application deployment or systemsadministration tasks.

It provides a basic suite of operations for executing local or remote shellcommands (normally or via ``sudo``) and uploading/downloading files, as well asauxiliary functionality such as prompting the running user for input, oraborting execution.

Typical use involves creating a Python module containing one or more functions,then executing them via the ``fab`` command-line tool. Below is a small butcomplete "fabfile" containing a single task:

.. code-block:: python

from fabric.api import run

def host_type(): run('uname -s')

If you save the above as ``fabfile.py`` (the default module that``fab`` loads), you can run the tasks defined in it on one or moreservers, like so::

In addition to use via the ``fab`` tool, Fabric's components may be importedinto other Python code, providing a Pythonic interface to the SSH protocolsuite at a higher level than that provided by e.g. the ``Paramiko`` library(which Fabric itself uses.)