How to test

Cinemagoer has a test suite based on pytest. The simplest way to run the tests is to run the following command in the top level directory of the project:


You can execute a specific test module:

pytest tests/

Or execute test functions that match a given keyword:

pytest -k cover


A Makefile is provided for easier invocation of jobs. The following targets are defined (among others, run “make” to see the full list):


Run tests quickly with the default Python.


Check style with flake8.


Generate Sphinx HTML documentation, including API docs.


Check code coverage quickly with the default Python.


Clean everything.


Multiple test environments can be tested using tox:


This will test all the environments listed in the tox.ini file. If you want to run all tests for a specific environment, for example python 3.4, supply it as an argument to tox:

tox -e py34

You can supply commands that will be executed in the given environment. For example, to run the test function that have the string “cover” in them using pypy3, execute:

tox -e pypy3 -- pytest -k cover

Or to get a Python prompt under Python 3.5 (with Cinemagoer and all dependencies already installed), execute:

tox -e py35 -- python

S3 dataset

The tests will use the HTTP access system by default. If you would also like to test the database generated from the S3 dataset, define the CINEMAGOER_S3_URI environment variable:

CINEMAGOER_S3_URI='postgres://imdb@localhost/imdb' pytest

This will run the tests for both HTTP and S3 access systems.