Модульные тесты¶

Django поставляется с собственным набором тестов в каталоге tests кодовой базы. Наша политика заключается в том, чтобы все тесты всегда проходили.

Мы ценим любой и всякий вклад в тестовый пакет!

Все тесты Django используют инфраструктуру тестирования, поставляемую вместе с Django для тестирования приложений. См. Написание и выполнение тестов для объяснения того, как писать новые тесты.

Contrib-приложения¶

Тесты для приложений contrib можно найти в каталоге tests/, обычно в каталоге <app_name>_tests. Например, тесты для contrib.auth находятся в tests/auth_tests.

Советы по написанию тестов¶

Изолирующая регистрация модели¶

Чтобы избежать загрязнения глобального apps реестра и предотвратить ненужное создание таблиц, модели, определенные в методе тестирования, должны быть привязаны к временному Apps экземпляру:

from django.apps.registry import Apps
from django.db import models
from django.test import SimpleTestCase

class TestModelDefinition(SimpleTestCase):
    def test_model_definition(self):
        test_apps = Apps(['app_label'])

        class TestModel(models.Model):
            class Meta:
                apps = test_apps
        ...

django.test.utils.isolate_apps(*app_labels, attr_name=None, kwarg_name=None)¶

Поскольку этот шаблон включает в себя много шаблонов, Django предоставляет декоратор isolate_apps(). Он используется следующим образом:

from django.db import models
from django.test import SimpleTestCase
from django.test.utils import isolate_apps

class TestModelDefinition(SimpleTestCase):
    @isolate_apps('app_label')
    def test_model_definition(self):
        class TestModel(models.Model):
            pass
        ...

Установка app_label

Модели, определенные в методе тестирования без явного app_label, автоматически присваивается метка приложения, в котором находится их тестовый класс.

Для того чтобы убедиться, что модели, определенные в контексте экземпляров isolate_apps(), установлены правильно, необходимо передать в качестве аргументов набор целевых app_label:

tests/app_label/tests.py¶

from django.db import models
from django.test import SimpleTestCase
from django.test.utils import isolate_apps

class TestModelDefinition(SimpleTestCase):
    @isolate_apps('app_label', 'other_app_label')
    def test_model_definition(self):
        # This model automatically receives app_label='app_label'
        class TestModel(models.Model):
            pass

        class OtherAppModel(models.Model):
            class Meta:
                app_label = 'other_app_label'
        ...

Декоратор также может быть применен к классам:

from django.db import models
from django.test import SimpleTestCase
from django.test.utils import isolate_apps

@isolate_apps('app_label')
class TestModelDefinition(SimpleTestCase):
    def test_model_definition(self):
        class TestModel(models.Model):
            pass
        ...

Временный экземпляр Apps, используемый для изоляции регистрации модели, может быть получен как атрибут при использовании в качестве декоратора класса с помощью параметра attr_name:

from django.db import models
from django.test import SimpleTestCase
from django.test.utils import isolate_apps

@isolate_apps('app_label', attr_name='apps')
class TestModelDefinition(SimpleTestCase):
    def test_model_definition(self):
        class TestModel(models.Model):
            pass
        self.assertIs(self.apps.get_model('app_label', 'TestModel'), TestModel)

Или в качестве аргумента метода проверки при использовании в качестве декоратора метода с помощью параметра kwarg_name:

from django.db import models
from django.test import SimpleTestCase
from django.test.utils import isolate_apps

class TestModelDefinition(SimpleTestCase):
    @isolate_apps('app_label', kwarg_name='apps')
    def test_model_definition(self, apps):
        class TestModel(models.Model):
            pass
        self.assertIs(apps.get_model('app_label', 'TestModel'), TestModel)

Стиль кодирования

Представление исправлений

Вернуться на верх

Модульные тесты¶

Запуск модульных тестов¶

Быстрый старт¶

Запуск тестов с использованием `tox`¶

Тестирование других версий Python и бэкендов баз данных¶

Выполнение тестов JavaScript¶

Запуск тестов с использованием `django-docker-box`¶

Использование другого модуля `settings`¶

Выполнение только некоторых тестов¶

Запуск тестов Selenium¶

Выполнение всех тестов¶

Покрытие кода¶

Contrib-приложения¶

Устранение неполадок¶

Набор тестов зависает или показывает сбои на ветке `main`¶

Много ошибок при тестировании с `UnicodeEncodeError`¶

Тесты, которые не работают только в комбинации¶

Просмотр SQL-запросов, выполняемых во время тестирования¶

Просмотр полной трассировки неудачного теста¶

Советы по написанию тестов¶

Изолирующая регистрация модели¶

Django 4.0

Содержание

Дополнительно

Вы здесь:

Модульные тесты¶

Запуск модульных тестов¶

Быстрый старт¶

Запуск тестов с использованием tox¶

Тестирование других версий Python и бэкендов баз данных¶

Выполнение тестов JavaScript¶

Запуск тестов с использованием django-docker-box¶

Использование другого модуля settings¶

Выполнение только некоторых тестов¶

Запуск тестов Selenium¶

Выполнение всех тестов¶

Покрытие кода¶

Contrib-приложения¶

Устранение неполадок¶

Набор тестов зависает или показывает сбои на ветке main¶

Много ошибок при тестировании с UnicodeEncodeError¶

Тесты, которые не работают только в комбинации¶

Просмотр SQL-запросов, выполняемых во время тестирования¶

Просмотр полной трассировки неудачного теста¶

Советы по написанию тестов¶

Изолирующая регистрация модели¶

Django 4.0

Содержание

Дополнительно

Вы здесь:

Запуск тестов с использованием `tox`¶

Запуск тестов с использованием `django-docker-box`¶

Использование другого модуля `settings`¶

Набор тестов зависает или показывает сбои на ветке `main`¶

Много ошибок при тестировании с `UnicodeEncodeError`¶