Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A colorful Django Test Runner.

Project Description

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.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-rainbowtests-0.6.0.tar.gz (6.3 kB) Copy SHA256 Checksum SHA256 Source Dec 21, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting