bigchaindb/docs/source/running-unit-tests.md

Running Unit Tests

Once you've installed BigchainDB Server, you may want to run all the unit tests. This section explains how.

First of all, if you installed BigchainDB Server using pip (i.e. by getting the package from PyPI), then you didn't install the tests. Before you can run all the unit tests, you must install BigchainDB from source.

To run all the unit tests, first make sure you have RethinkDB running:

$ rethinkdb

then in another terminal, do:

$ python setup.py test

(Aside: How does the above command work? The documentation for pytest-runner explains. We use pytest to write all unit tests.)

Using docker-compose to Run the Tests

You can also use docker-compose to run the unit tests. (You don't have to start RethinkDB first: docker-compose does that on its own, when it reads the docker-compose.yml file.)

First, build the images (~once), using:

$ docker-compose build

then run the unit tests using:

$ docker-compose run --rm bigchaindb py.test -v