WaterButler

master Build Status:

develop Build Status:

Compatibility

WaterButler is compatible with Python 3.6.

Documentation

Documentation available at https://waterbutler.readthedocs.io/en/latest/

Setting up

In order to run WaterButler, you must create a Python 3.6-based virtualenv for it.

For MacOSX, you can install the latest version of Python3 using:

brew install python3

For Ubuntu users:

apt-get install python3.6

After completing the installation of Python 3.6, you must create a virtual environment. This can be done with the following commands:

pip install virtualenv
pip install virtualenvwrapper
mkvirtualenv --python=python3.6 waterbutler

pip install setuptools=37.0.0
pip install invoke==0.13.0

invoke install
invoke server

The above code will get the virtualenv up and running for the first time. After the initial setup, you can run waterbutler by running:

workon waterbutler
invoke server

Some tasks also require a running celery worker. You will need to install rabbitmq and run a server: