Skip to main content

Nice pytest plugin to help you with Django pluggable application testing.

Project description

release lic coverage


Nice pytest plugin to help you with Django pluggable application testing.

This exposes some useful tools for Django applications developers to facilitate tests authoring, including:

  • Settings overriding

  • Template tags testing

  • User creation

  • Request object creation

  • Management command calls

  • Mailing

  • Migrations

  • Messages

  • DB queries audit

  • Live server & client UI testing

  • etc.

Suitable for testing apps for Django 1.8+.

How to use

Let’s say you have classical tests placing (inside application directory):

|__ myapp
|  |__
|  |__ tests
|  |  |__
|  |  |__  <- Configure djangoapp here.

Add the following lines into to configure djangoapp and start using it:

from pytest_djangoapp import configure_djangoapp_plugin

pytest_plugins = configure_djangoapp_plugin()

Fixtures usage examples can be found in the documentation and the source code.

Testing an entire project

Despite the fact that djangoapp is primarily aimed to reusable Django applications testing one can use it also to test a project (a set of apps). For that, pass a dotted settings module path into settings argument:

pytest_plugins = configure_djangoapp_plugin(
    migrate=False,  # If you do not want to apply migrations.

What about pytest-django

pytest-djangoapp does not depend on pytest-django.

There are design decisions in pytest-django that might make it uncomfortable to work with.

  1. It uses setuptools entrypoints feature for pytest plugin discovery. It’s not a problem by itself, but all kinds of bootstrapping with side effects made by pytest-django just on startup, make the plugin a poor choice for cases of system-wide (i.e. not venv) installations.

  2. Philosophy that next to no unit test should require DB access may be quite annoying.

  3. Some fixtures (e.g. django_assert_num_queries) usability arouse questions.

Despite that pytest-django is nice, of course.

pytest-djangoapp fixtures allow the use of Django without marking all relevant tests as needing a database, as is required by pytest-django which provides the django_db mark and db fixtures.

If you have pytest-django already installed, it can be disabled for projects using pytest-djangoapp by adding the following lines into pytest.ini:

# pytest.ini
addopts = -p no:django


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-djangoapp-1.2.0.tar.gz (32.4 kB view hashes)

Uploaded source

Built Distribution

pytest_djangoapp-1.2.0-py3-none-any.whl (32.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page