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!

Django command for quickly re-running tests when ever a file changes.

Project Description


Provides the ‘autotest’ command which enhances django’s built in test feature with the auto reload feature used in django’s runserver command.


Install via pip or your python egg layer of choice:

pip install django-autotest-command

Then add to your django

INSTALLED_APPS = ( … ‘autotest’, )

No other apps are required except for django core.


Run like a usual django test:

./ autotest [app_name[.tests.TestCaseName[.test_name]]]

This testing tool will launch the test suite, setup the database and then run the test suite as usual. When finished it will wait for a file to change in your project before re-running the tests.

When re-running it will by default only test the previous failures on the next run through. If all tests passed, then it will run all tests.

After failures are detected, they are all listed by number. You can select one or more tests to target by typing the numbers seperated by commas and hitting enter. Targeting allows you to focus on one bug at a time.

When finished with your test targeting press enter at the prompt to reset.


Coverage reports can be generated by install the coverage module >=4.0.0 and will pick up on any .coveragerc file in your project. A new report will only run when all items are being tested. Partial coverage reports are not yet supported.

Base Test Classes

autotest.base contains useful base classes which can help you write tests for django. The functionality includes getObj for getting objects of a certain type. assertGet/Post for making requests with status checking and forum error checking. As well as client and user management functions.


See this test command in action here:


Please come help this project by using the code, writing tests and leting the project authors know you appreciate their code:

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


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-autotest-command-1.5.5.tar.gz (24.5 kB) Copy SHA256 Checksum SHA256 Source Feb 6, 2017

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