Running Unit Tests

Unit tests are located in the tests directory.

To test both the pure Python and C extension module based implementations, run the command:

tox

By default tests are run for Python 2.7, 3.4-3.7 and PyPy, with and without the C extensions.

py27-without-extensions
py34-without-extensions
py35-without-extensions
py36-without-extensions
py37-without-extensions

py27-with-extensions
py34-with-extensions
py35-with-extensions
py36-with-extensions
py37-with-extensions

pypy-without-extensions

If wishing to run tests for a specific Python combination you can run tox with the -e option.

tox -e py37-with-extensions

If adding more tests and you need to add a test which is Python 2 or Python 3 specific, then end the name of the Python code file as _py2.py or _py3.py appropriately.

For further options refer to the documentation for tox.

Coverage

Coverage is collected and sent to Coveralls when running the tests automatically in Travis CI. To collect and view coverage results locally, here’s the sequence of commands:

export COVERAGE_CMD="coverage run -m"
export COVERAGE_DEP=coverage
tox
coverage combine
coverage html --ignore-errors

At this point there’s a directly called htmlcov with the formatted results.