Tests ===== Running tests ------------- 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 Unit tests ---------- Running unit tests requires the `mock `_ library. Functional tests ---------------- 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