pytest-django 2.5

A Django plugin for py.test.

pytest-django is a plugin for pytest that provides a set of useful tools for testing Django applications and projects.

• Authors: Ben Firshman, Andreas Pelme and contributors

• Licence: BSD

• Compatibility: Django 1.3-1.6, python 2.5-2.7 and 3.2-3.3 or PyPy, pytest >= 2.3.4

• Project URL: https://github.com/pelme/pytest_django

• Documentation: http://pytest-django.rtfd.org/

Quick Start

1. pip install pytest-django

2. Make sure DJANGO_SETTINGS_MODULE is defined and and run tests with the py.test command.

3. (Optionally) If you put your tests under a tests directory (the standard Django application layout), and your files are not named test_FOO.py, see the FAQ

Documentation

Documentation is available on Read the Docs.

Why would I use this instead of Django’s manage.py test command?

Running the test suite with pytest offers some features that are not present in Djangos standard test mechanism:

• Less boilerplate: no need to import unittest, create a subclass with methods. Just write tests as regular functions.

• Manage test dependencies with fixtures

• Database re-use: no need to re-create the test database for every test run.

• Run tests in multiple processes for increased speed

• There are a lot of other nice plugins available for pytest.

• Easy switching: Existing unittest-style tests will still work without any modifications.

See the pytest documentation for more information on pytest.

Contributing

Read the contributing page from the documentation.

To run the project’s tests:

make test

To build the project’s docs:

make docs

Bugs? Feature suggestions?

Report issues and feature requests at the github issue tracker.