HTTPS clone URL
Subversion checkout URL
Simple, Pythonic remote execution and deployment. Please file tickets at http://code.fabfile.org instead of sending pull requests!
0.9 0.9.0-docs 0.9.1-docs 0.9.2-docs 0.9.3-docs 0.9.4-docs 0.9.5-docs 1.0 1.0.0-docs 1.0.1-docs 7-prompt-detection 8-skip-bad-hosts 68-fabfile-generation 79-get-host-prefix 88-local-default-capture 172-default-kwarg-cleanup 217-file-like-objects-get-put 224-parallel-tests 245-lcd 256-sys-path-problems 262-pip-dev-install 279-nuke-recursive-kwarg 281-optional-line-prefix 295-get-relative-remotepath 305-hostname-whitespace bash-completion flexible-task-declarations hudsontest invoke_shell master put-get-overhaul
Nothing to show
Fetching latest commit...
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Fabric is a Python (2.5 or higher) library and command-line tool for streamlining the use of SSH for application deployment or systems administration tasks. It provides a basic suite of operations for executing local or remote shell commands (normally or via ``sudo``) and uploading/downloading files, as well as auxiliary functionality such as prompting the running user for input, or aborting 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 but complete "fabfile" containing a single task:: from fabric.api import run def host_type(): run('uname -s') Once a task is defined, it may be run on one or more servers, like so:: $ fab -H localhost,linuxbox host_type [localhost] run: uname -s [localhost] out: Darwin [linuxbox] run: uname -s [linuxbox] out: Linux Done. Disconnecting from localhost... done. Disconnecting from linuxbox... done. In addition to use via the ``fab`` tool, Fabric's components may be imported into other Python code, providing a Pythonic interface to the SSH protocol suite at a higher level than that provided by e.g. Paramiko (which Fabric itself leverages.)