django-test-plus

Useful additions to Django's default TestCase from REVSYS

If you would like to get started testing your Django apps or improve how your team is testing we offer TestStart to help your team dramatically improve your productivity.

Support

• Python 3.11, 3.12, 3.13, 3.14, and 3.15, including the free-threaded

• Django 4.2 LTS, 5.1, 5.2 LTS, 6.0, and 6.1.

Installation

$ pip install django-test-plus

Usage

Have your tests inherit from test_plus.test.TestCase rather than the normal django.test.TestCase:

from test_plus.test import TestCase
class MyViewTests(TestCase):
    ...

That is enough to get rolling. Here is a taste of what you get — reversing URLs, checking status codes, and inspecting context without the boilerplate:

class MyViewTests(TestCase):
def test_the_view(self):
        # GET a named URL, with args or kwargs if it needs them
        self.get('my-url-name')
        self.response_200()
# The last response and its context are stored for you
        self.assertInContext('some-key')
        self.assertResponseContains('<p>Hello, World!</p>')
# POST data, then check the redirect
        self.post('my-form-view', data={'name': 'Test'})
        self.response_302()
def test_auth(self):
        user = self.make_user('u1')
self.assertLoginRequired('my-protected-view')
with self.login(user):
            self.get_check_200('my-protected-view')
def test_query_count(self):
        # 200 OK in under 50 queries, in one line
        self.assertGoodView('my-url-name')

You are encouraged to create your own sub-class for your project so you can add project-specific helper methods:

# myproject/test.py
from test_plus.test import TestCase as PlusTestCase
class TestCase(PlusTestCase):
    pass

There is a pytest fixture too — ask for tp and you get the same helpers:

def test_url_reverse(tp):
    assert tp.reverse('api') == '/api/'

Documentation

**Full documentation, including the complete method reference, is available at django-test-plus.readthedocs.org.**

• Usage —

• Methods —

• Authentication helpers —

• Ensuring low query counts —

• Testing class-based views
• Disable logging

Development

To work on django-test-plus itself, clone this repository and run the following command:

$ pip install -e .
$ pip install -e .[test]

To run all tests:

$ nox

NOTE: You will also need to ensure that the test_project directory, located at the root of this repo, is in your virtualenv's path.

Keep in touch!

If you have a question about this project, please open a GitHub issue. If you love us and want to keep track of our goings-on, here's where you can find us online: