Skip to content

anfema/anfema-django-testutils

Repository files navigation

anfema-django-testutils

The main intention of the anfema_django_testutils app is to provide a Django test runner which considers snapshot tests as well as code coverage and human-readable html test reports. Moreover, the test result Precondition Failure has been added.

This package integrates snapshottest as well as coverage.

Links

Prerequisites

anfema_django_testutils is officially supported on:

  • Python >= 3.9
  • Django >= 3.2

Installation

$ pip install anfema-django-testutils

Setting up

Update your Django settings.py to use the anfema_django_testutils test runner:

# settings.py

INSTALLED_APPS = [
    ...
    "mathfilters",
    "anfema_django_testutils",
]

TEST_RUNNER = "anfema_django_testutils.runner.TestRunner"

For further information see the anfema_django_testutils documentation.

Usage

For writing test cases use the anfema_django_testutils.testcases.TestCase rather than the django.test.TestCase:

# app/tests.py

from anfema_django_testutils.testcases import TestCase


class CustomTest(TestCase):
    ...

Create documentation

To generate the anfema_django_testutils documentation from the local sources, run in a terminal:

$ pip install tox
$ tox -e docs -- docs/build

Run tests

To execute the anfema_django_testutils tests, run in a terminal:

$ pip install tox
$ tox

License

Licensed under the MIT-clause license; see LICENSE for details.