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:

$ py.test -v

If the above command doesn't work (e.g. maybe you are running in a conda virtual environment), try:

$ python -m pytest -v

(We write our unit tests using the pytest framework.)

You can also run all unit tests via setup.py, using:

$  python setup.py test

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