pytest-django Documentation — pytest-django documentation (original) (raw)

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

Quick Start

$ pip install pytest-django

Make sure DJANGO_SETTINGS_MODULE is defined (seeConfiguring Django settings) and make your tests discoverable (see My tests are not being found. Why?):

Example using pytest.ini or tox.ini

-- FILE: pytest.ini (or tox.ini)

[pytest] DJANGO_SETTINGS_MODULE = test.settings

-- recommended but optional:

python_files = tests.py test_*.py *_tests.py

Example using pyproject.toml

-- Example FILE: pyproject.toml

[tool.pytest.ini_options] DJANGO_SETTINGS_MODULE = "test.settings"

-- recommended but optional:

python_files = ["test_*.py", "_test.py", "testing/python/.py"]

Run your tests with pytest: