If you’re using Python 2.7, you can launch the tests using the built-in unittest runner:
$ python -m unittest discover
If you’re using Python 2.5 or 2.6, you’ll need to install unittest2, and use the provided runner:
$ pip install unittest2
$ unit2 discover
Or you can run the tests on all supported Python versions using tox, which will take care of everything:
$ pip install tox
$ tox
Running functional tests requires Vagrant to launch virtual machines, against which all the tests will be run.
If Vagrant is not installed, the functional tests will be skipped automatically.
If Vagrant is installed, the default is to run the tests on all available base boxes. You can specify which base boxes should be used by setting the FABTOOLS_TEST_BOXES environment variable:
$ FABTOOLS_TEST_BOXES='ubuntu_10_04 ubuntu_12_04' tox -e py27
You can also use this to manually disable functional tests:
$ FABTOOLS_TEST_BOXES='' tox