Testing Brownie

Brownie uses the attest framework for testing in combination with tox. This allows us to easily create unit tests, to test our documentation and to run all tests using various configurations defined through their test environments.

Usually you just want to run all tests with the default python version, in order to do that simply execute:

$ make test

Before you commit you should run those tests again all supported python versions, so you have to execute:

$ make test-all

Sometimes you may want to run tests only in a specific test environment, in order to do that you need to use tox directly:

$ tox -e <testenv>

<testenv> has to be a test environment or a comma-separated list of test environments.

Selectively Running Tests

If you are developing a specific feature you rarely care about the tests for all the modules you are currently not working on. In this case you can select the module you want to test by calling tox and passing the name of the module:

$ tox -- <module>

<module> can be any module in brownie.tests which has a attest.Tests collection under the attribute tests. If you want to run the tests in multiple modules you can do that by passing each name as an argument to tox.

Test Environments

At the moment the following test environments are available:

docs
Tests that the documentation builds to HTML without any warnings and that all links are working.
py25, pypy
Runs all unit tests on Python 2.5
py26, py27
Runs all unit tests on Python 2.6 or 2.7 respectively as well as doctests and examples in the documentation.
py31
Runs all unit tests on Python 3.1.