3.2
5.0
6.1
Версия документации: 3.1

Юнит тесты¶

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

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

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

Приложения contrib¶

Tests for contrib apps can be found in the tests/ directory, typically under <app_name>_tests. For example, tests for contrib.auth are located in tests/auth_tests.

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

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

To avoid polluting the global apps registry and prevent unnecessary table creation, models defined in a test method should be bound to a temporary Apps instance:

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)¶

Since this pattern involves a lot of boilerplate, Django provides the isolate_apps() decorator. It’s used like this:

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'
        ...

The decorator can also be applied to classes:

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
        ...

The temporary Apps instance used to isolate model registration can be retrieved as an attribute when used as a class decorator by using the attr_name parameter:

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)

Or as an argument on the test method when used as a method decorator by using the kwarg_name parameter:

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)

Стиль кодинга

Submitting patches

Юнит тесты¶

Выполнение модульных тестов¶

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

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

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

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

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

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

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

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

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

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

Приложения contrib¶

Поиск неисправностей¶

Test suite hangs or shows failures on `master` branch¶

Множество неудачных тестов с `UnicodeEncodeError`¶

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

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

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

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

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

Дополнительная информация

Содержание

Просмотр

Вы находитесь здесь:

Получить помощь

Юнит тесты¶

Выполнение модульных тестов¶

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

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

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

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

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

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

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

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

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

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

Приложения contrib¶

Поиск неисправностей¶

Test suite hangs or shows failures on master branch¶

Множество неудачных тестов с UnicodeEncodeError¶

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

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

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

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

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

Дополнительная информация

Содержание

Просмотр

Вы находитесь здесь:

Получить помощь

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

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

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

Test suite hangs or shows failures on `master` branch¶

Множество неудачных тестов с `UnicodeEncodeError`¶