Running Unit Tests

Tests can be run be run using via py.test, via the nose front-end script, or the Python setup.py script:

py.test

python run_tests.py

python setup.py test

There's also a tox.ini file with several configurations:

tox

Setting up Optional Databases

The test suite will attempt to run a subset of tests against various database backends, including Postgresql and MySQL. It uses the database URLs in the [db] section of setup.cfg to locate a URL for particular backend types. If the URL cannot be loaded, either because the requisite DBAPI is not present, or if the target database is found to be not accessible, the test is skipped.

To run tests for these backends, replace URLs with working ones inside the setup.cfg file. Setting a URL here requires that the corresponding DBAPI is installed as well as that the target database is running. A connection to the database should provide access to a blank schema, where tables will be created and dropped. It is critical that this schema have no tables in it already.

For Postgresql, it is also necessary that the target database contain a user-accessible schema called "test_schema".