About

fabtools includes useful functions to help you write your Fabric files.

fabtools makes it easier to manage system users, packages, databases, etc.

fabtools includes a number of low-level actions, as well as a higher level interface called fabtools.require.

Using fabtools.require allows you to use a more declarative style, similar to Chef or Puppet.

Installing

To install the latest release from PyPI

$ pip install fabtools

To install the latest development version from GitHub

$ pip install git+git://github.com/ronnix/fabtools.git

Example

Here is an example fabfile.py using fabtools

fromfabric.apiimport*fromfabtoolsimportrequireimportfabtools@taskdefsetup():
# Require some Debian/Ubuntu packagesrequire.deb.packages([
'imagemagick',
'libxml2-dev',
])
# Require a Python packagewithfabtools.python.virtualenv('/home/myuser/env'):
require.python.package('pyramid')
# Require an email serverrequire.postfix.server('example.com')
# Require a PostgreSQL serverrequire.postgres.server()
require.postgres.user('myuser', 's3cr3tp4ssw0rd')
require.postgres.database('myappsdb', 'myuser')
# Require a supervisor process for our apprequire.supervisor.process('myapp',
command='/home/myuser/env/bin/gunicorn_paster /home/myuser/env/myapp/production.ini',
directory='/home/myuser/env/myapp',
user='myuser'
)
# Require an nginx server proxying to our apprequire.nginx.proxied_site('example.com',
docroot='/home/myuser/env/myapp/myapp/public',
proxy_url='http://127.0.0.1:8888'
)
# Setup a daily cron taskfabtools.cron.add_daily('maintenance', 'myuser', 'my_script.py')

Supported targets

fabtools currently supports the following target operating systems:

• full support:
  • Debian family:
    • Debian 6 (squeeze), 7 (wheezy), 8 (jessie)
    • Ubuntu 10.04 (lucid), 12.04 (precise), 14.04 (trusty)
• partial support:
  • RedHat family:
    • RHEL 5/6
    • CentOS 5/6
    • Scientific Linux 5/6
    • Fedora
  • Arch Linux, Manjaro Linux
  • Gentoo
  • SmartOS (Joyent)

Contributions to help improve existing support and extend it to other Unix/Linux distributions are welcome!