django-test-plus

Useful additions to Django's default TestCase from REVSYS

Rationale

Let's face it, writing tests isn't always fun. Part of the reason for that is all of the boilerplate you end up writing. django-test-plus is an attempt to cut down on some of that when writing Django tests. We guarantee it will increase the time before you get carpal tunnel by at least 3 weeks!

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.10, 3.11, 3.12, 3.13, and 3.14, including the 3.14 free-threaded build (3.14t).
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 — including pytest fixtures and testing DRF views
Methods — requests, status code assertions, response and context helpers, make_user
Authentication helpers — assertLoginRequired and the login() context
Ensuring low query counts — assertNumQueriesLessThan and assertGoodView
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:

Metadata

Release files for django-test-plus 2.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-test-plus 2.6.1
File	Size	Uploaded
django_test_plus-2.6.1.tar.gz	17.2 kB	Jul 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-test-plus 2.6.1
File	Interpreter	ABI	Platform	Reset
django_test_plus-2.6.1-py3-none-any.whl 15.3 kB Jul 31, 2026	Python 3	none	any	Details

Total release size: 32.5 kB

Release files / django_test_plus-2.6.1.tar.gz

Download URL	django_test_plus-2.6.1.tar.gz
Size	17.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`42f62e92b702bdc522228f28fbbbb9ea2d25177ba4b7bb0baf61e1b327d9fcc9`
BLAKE2b-256 checksum How to use checksums	`55e863679285169b479f496758b91970e4cf95283a1c8b4d715959b157d7a08e`
Upload date	Jul 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / django_test_plus-2.6.1-py3-none-any.whl

Download URL	django_test_plus-2.6.1-py3-none-any.whl
Size	15.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`681fecf522a9b56b9c20a0f53c509535d73ea945100a216c5edc8d398d775967`
BLAKE2b-256 checksum How to use checksums	`7f9d4b996a9319a4413cef5e4d2693e021c8598348d64b384e21452e1bd8d26f`
Upload date	Jul 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`