Skip to main content

A colorful Django Test Runner.

Project description

Current Release License

This is a custom test runner for Django that gives you really colorful test output.

How do I use this?

Install the latest release with:

pip install django-rainbowtests

New in 0.5.0: Add a settings for RAINBOWTESTS_HIGHLIGHT_PATH. While running your tests, any lines in your tracebacks that match this path will be highlighted, making them easier to find and read. If you omit this setting, the default is to use the path to your django installation (which probably ends up highlighting more than you need or want).:

RAINBOWTESTS_HIGHLIGHT_PATH = '/path/to/my/project/'

New in 0.6.0 If the test output is too verbose and you just want a colorful version of the standard Django test output, set RAINBOWTESTS_SHOW_MESSAGES to False:


Django > 1.6: Set your test runner to the RainbowDiscoverRunner:

TEST_RUNNER = 'rainbowtests.test.runner.RainbowDiscoverRunner'

Django < 1.5: Set your test runner to the RainbowTestSuiteRunner. This was removed in django 1.8, so using this test runner on newer projects will fail:

TEST_RUNNER = 'rainbowtests.test.simple.RainbowTestSuiteRunner'

Then run your tests!

Python/Django Compatibility

This code should work with Django 1.4 - 1.8, Python 2.7 and Python 3.4. If you find otherwise, please open an Issue.


As of version 0.3.0, there is (experimental) support for coverage, and 0.4.0 cleaned it up by introducing a new test runner:


TEST_RUNNER = ‘rainbowtests.test.runner.RainbowDiscoverCoverageRunner’

and run your tests as normal (python test <whatever>), and if you have coverage installed, you should see a report when your tests complete. You could also use coverage html and open htmlcov/index.html for a more fancy coverage report. Make sure you have a .coveragerc file, though!


This code is distributed under the terms of the MIT license. See the LICENSE file.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-rainbowtests, version 0.6.0
Filename, size File type Python version Upload date Hashes
Filename, size django-rainbowtests-0.6.0.tar.gz (6.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page