unittest.md

1> **Источник:** https://python-all.ru/3.15/library/unittest.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `unittest` – фреймворк для модульного тестирования89**Исходный код:** [Lib/unittest/\_\_init\_\_.py](https://python-all.ru/src/3.15/Lib/unittest/__init__.py)1011---1213(Если вы уже знакомы с основными понятиями тестирования, можете перейти к [списку методов assert](https://python-all.ru/3.15/library/unittest.html#assert-methods).)1415Фреймворк модульного тестирования `unittest` изначально был вдохновлён JUnit и имеет схожий подход с основными фреймворками модульного тестирования на других языках. Он поддерживает автоматизацию тестов, совместное использование кода подготовки и завершения тестов, объединение тестов в коллекции и независимость тестов от системы отчётов.1617Для этого `unittest` поддерживает несколько важных концепций в объектно-ориентированном стиле:1819**тестовая фикстура**2021*Тестовая фикстура* представляет собой подготовку, необходимую для выполнения одного или нескольких тестов, а также все связанные действия по очистке. Это может включать, например, создание временных или прокси-баз данных, каталогов или запуск серверного процесса.2223**тестовый случай**2425*Тестовый случай* – это отдельная единица тестирования. Он проверяет определённую реакцию на конкретный набор входных данных. `unittest` предоставляет базовый класс [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), который можно использовать для создания новых тестовых случаев.2627**набор тестов**2829*Набор тестов* – это совокупность тестовых случаев, наборов тестов или и того, и другого. Он используется для объединения тестов, которые должны выполняться вместе.3031**исполнитель тестов**3233*Исполнитель тестов* – это компонент, который управляет выполнением тестов и предоставляет результат пользователю. Исполнитель может использовать графический интерфейс, текстовый интерфейс или возвращать специальное значение, указывающее на результаты выполнения тестов.3435> **См. также**36>37> **Модуль [`doctest`](https://python-all.ru/3.15/library/doctest.html#module-doctest)**38>39> Ещё один модуль поддержки тестирования с совершенно другим подходом.40>41> **[Простое тестирование в Smalltalk: с шаблонами](https://python-all.ru/3.15/library/unittest.html)**42>43> Оригинальная статья Кента Бека о фреймворках тестирования, в которых используется тот же шаблон, что и в `unittest`.44>45> **[pytest](https://python-all.ru/3.15/library/unittest.html)**46>47> Сторонний фреймворк модульного тестирования с более лёгким синтаксисом для написания тестов. Например, `assert func(10) == 42`.48>49> **[Таксономия инструментов тестирования Python](https://python-all.ru/3.15/library/unittest.html)**50>51> Обширный список инструментов тестирования Python, включая фреймворки функционального тестирования и библиотеки имитационных объектов (mock).52>53> **[Список рассылки по тестированию в Python](https://python-all.ru/3.15/library/unittest.html)**54>55> Группа по интересам для обсуждения тестирования и инструментов тестирования в Python.56>57> Скрипт `Tools/unittestgui/unittestgui.py` в дистрибутиве исходных кодов Python – это графический инструмент для обнаружения и выполнения тестов. Он в значительной степени предназначен для упрощения работы с тестированием для новичков в модульном тестировании. Для производственных сред рекомендуется, чтобы тесты запускались системой непрерывной интеграции, такой как [Buildbot](https://python-all.ru/3.15/library/unittest.html), [Jenkins](https://python-all.ru/3.15/library/unittest.html), [GitHub Actions](https://python-all.ru/3.15/library/unittest.html) или [AppVeyor](https://python-all.ru/3.15/library/unittest.html).5859## Простой пример6061Модуль `unittest` предоставляет богатый набор инструментов для создания и запуска тестов. В этом разделе показано, что небольшого подмножества этих инструментов достаточно для удовлетворения потребностей большинства пользователей.6263Вот короткий скрипт для тестирования трёх строковых методов:6465```python66import unittest6768class TestStringMethods(unittest.TestCase):6970    def test_upper(self):71        self.assertEqual('foo'.upper(), 'FOO')7273    def test_isupper(self):74        self.assertTrue('FOO'.isupper())75        self.assertFalse('Foo'.isupper())7677    def test_split(self):78        s = 'hello world'79        self.assertEqual(s.split(), ['hello', 'world'])80        # проверить, что s.split завершается ошибкой, если разделитель не строка81        with self.assertRaises(TypeError):82            s.split(2)8384if __name__ == '__main__':85    unittest.main()86```8788Тестовый случай создаётся путём создания подкласса [`unittest.TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase). Три отдельных теста определяются методами, имена которых начинаются с букв `test`. Это соглашение об именах сообщает исполнителю тестов, какие методы являются тестами.8990Суть каждого теста – вызов [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual) для проверки ожидаемого результата; [`assertTrue()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertTrue) или [`assertFalse()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertFalse) для проверки условия; или [`assertRaises()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertRaises) для проверки того, что возбуждается определённое исключение. Эти методы используются вместо оператора [`assert`](https://python-all.ru/3.15/reference/simple_stmts.html#assert), чтобы исполнитель тестов мог накапливать все результаты тестов и формировать отчёт.9192Методы [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) и [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown) позволяют определить инструкции, которые будут выполняться до и после каждого метода теста. Они подробнее рассматриваются в разделе [Организация тестового кода](https://python-all.ru/3.15/library/unittest.html#organizing-tests).9394В последнем блоке показан простой способ запуска тестов. [`unittest.main()`](https://python-all.ru/3.15/library/unittest.html#unittest.main) предоставляет интерфейс командной строки для тестового скрипта. При запуске из командной строки приведённый выше скрипт выдаёт вывод, который выглядит так:9596```python97...98----------------------------------------------------------------------99Ran 3 tests in 0.000s100101OK102```103104Передача флага `-v` вашему тестовому скрипту укажет [`unittest.main()`](https://python-all.ru/3.15/library/unittest.html#unittest.main) включить более высокий уровень подробности и выдать следующий вывод:105106```python107test_isupper (__main__.TestStringMethods.test_isupper) ... ok108test_split (__main__.TestStringMethods.test_split) ... ok109test_upper (__main__.TestStringMethods.test_upper) ... ok110111----------------------------------------------------------------------112Ran 3 tests in 0.001s113114OK115```116117Представленные выше примеры демонстрируют наиболее часто используемые возможности `unittest`, которых достаточно для многих повседневных задач тестирования. Оставшаяся часть документации рассматривает полный набор функций с самого начала.118119Изменено в версии 3.11: Возврат значения из тестового метода (кроме значения по умолчанию `None`) теперь считается устаревшим.120121## Интерфейс командной строки122123Модуль unittest можно использовать из командной строки для запуска тестов из модулей, классов или даже отдельных тестовых методов:124125```python126python -m unittest test_module1 test_module2127python -m unittest test_module.TestClass128python -m unittest test_module.TestClass.test_method129```130131Можно передать список с любой комбинацией имён модулей, а также полных имён классов или методов.132133Тестовые модули также можно указывать по пути к файлу:134135```python136python -m unittest tests/test_something.py137```138139Это позволяет использовать автодополнение имён файлов в оболочке для указания тестового модуля. Указанный файл по-прежнему должен быть импортируем как модуль. Путь преобразуется в имя модуля путём удаления ‘.py’ и замены разделителей пути на ‘.’. Если требуется выполнить тестовый файл, который не импортируется как модуль, следует запускать файл напрямую.140141Можно запускать тесты с большей детализацией (повышенной подробностью), передав флаг -v:142143```python144python -m unittest -v test_module145```146147При запуске без аргументов запускается [автоматическое обнаружение тестов](https://python-all.ru/3.15/library/unittest.html#unittest-test-discovery):148149```python150python -m unittest151```152153Чтобы получить список всех параметров командной строки:154155```python156python -m unittest -h157```158159Изменено в версии 3.2: В более ранних версиях можно было запускать только отдельные тестовые методы, а не модули или классы.160161Добавлено в версии 3.14: Вывод по умолчанию раскрашивается, и это можно [настроить с помощью переменных окружения](https://python-all.ru/3.15/using/cmdline.html#using-on-controlling-color).162163### Параметры командной строки164165**unittest** поддерживает следующие параметры командной строки:166167#### `-b, --buffer`168169Потоки стандартного вывода и стандартной ошибки буферизируются во время выполнения теста. Вывод при успешном тесте отбрасывается. При ошибке или провале теста вывод выводится обычным образом и добавляется к сообщениям о неудаче.170171#### `-c, --catch`172173`Control`-`C` во время выполнения теста ожидает завершения текущего теста и затем выводит все результаты на данный момент. Повторное нажатие `Control`-`C` вызывает обычное исключение [`KeyboardInterrupt`](https://python-all.ru/3.15/library/exceptions.html#KeyboardInterrupt).174175См. раздел [Обработка сигналов](https://python-all.ru/3.15/library/unittest.html#signal-handling) с описанием функций, предоставляющих эту возможность.176177#### `-f, --failfast`178179Остановить выполнение теста при первой же ошибке или неудаче.180181#### `-k`182183Запускать только те тестовые методы и классы, которые соответствуют шаблону или подстроке. Этот параметр можно использовать несколько раз; в этом случае включаются все тесты, соответствующие любому из заданных шаблонов.184185Шаблоны, содержащие символ подстановки (`*`), сопоставляются с именем теста с помощью [`fnmatch.fnmatchcase()`](https://python-all.ru/3.15/library/fnmatch.html#fnmatch.fnmatchcase); в противном случае используется простое сопоставление подстрок с учётом регистра.186187Шаблоны сопоставляются с полным именем тестового метода, импортированным загрузчиком тестов.188189Например, `-k foo` соответствует `foo_tests.SomeTest.test_something`, `bar_tests.SomeTest.test_foo`, но не `bar_tests.FooTest.test_something`.190191#### `--locals`192193Показывать локальные переменные в трассировках.194195#### `--durations N`196197Показывать N самых медленных тестов (N=0 – все).198199Добавлено в версии 3.2: Были добавлены параметры командной строки `-b`, `-c` и `-f`.200201Добавлено в версии 3.5: Параметр командной строки `--locals`.202203Добавлено в версии 3.7: Параметр командной строки `-k`.204205Добавлено в версии 3.12: Параметр командной строки `--durations`.206207Командная строка также может использоваться для автоматического обнаружения тестов, для запуска всех тестов в проекте или только их части.208209## Обнаружение тестов210211Добавлено в версии 3.2.212213Unittest поддерживает простое обнаружение тестов. Чтобы быть совместимыми с обнаружением тестов, все тестовые файлы должны быть [модулями](https://python-all.ru/3.15/tutorial/modules.html#tut-modules) или [пакетами](https://python-all.ru/3.15/tutorial/modules.html#tut-packages), импортируемыми из корневого каталога проекта (это означает, что их имена файлов должны быть допустимыми [идентификаторами](https://python-all.ru/3.15/reference/lexical_analysis.html#identifiers)).214215Обнаружение тестов реализовано в [`TestLoader.discover()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader.discover), но также может использоваться из командной строки. Основное использование командной строки:216217```python218cd project_directory219python -m unittest discover220```221222> **Примечание**223>224> В качестве сокращения, `python -m unittest` эквивалентно `python -m unittest discover`. Если требуется передать аргументы для обнаружения тестов, необходимо явно указать подкоманду `discover`.225226Подкоманда `discover` имеет следующие опции:227228#### `-v, --verbose`229230Подробный вывод231232#### `-s, --start-directory directory`233234Каталог для начала обнаружения (по умолчанию `.`)235236#### `-p, --pattern pattern`237238Шаблон для сопоставления тестовых файлов (по умолчанию `test*.py`)239240#### `-t, --top-level-directory directory`241242Корневой каталог проекта (по умолчанию – каталог начала поиска)243244Параметры [`-s`](https://python-all.ru/3.15/library/unittest.html#cmdoption-unittest-discover-s), [`-p`](https://python-all.ru/3.15/library/unittest.html#cmdoption-unittest-discover-p) и [`-t`](https://python-all.ru/3.15/library/unittest.html#cmdoption-unittest-discover-t) можно передавать в качестве позиционных аргументов в указанном порядке. Следующие две командные строки эквивалентны:245246```python247python -m unittest discover -s project_directory -p "*_test.py"248python -m unittest discover project_directory "*_test.py"249```250251Помимо пути, в качестве начального каталога можно передать имя пакета, например `myproject.subpackage.test`. Указанное имя пакета будет импортировано, и его расположение в файловой системе будет использоваться в качестве начального каталога.252253> **Внимание**254>255> Обнаружение тестов загружает тесты путем их импорта. Как только обнаружение тестов найдет все тестовые файлы в указанном начальном каталоге, оно преобразует пути в имена пакетов для импорта. Например, `foo/bar/baz.py` будет импортирован как `foo.bar.baz`.256>257> Если пакет установлен глобально, и предпринимается попытка обнаружения тестов в другой копии пакета, то импорт *может* произойти из неправильного места. Если это произойдет, обнаружение тестов выдаст предупреждение и завершится.258>259> Если указать начальный каталог как имя пакета, а не путь к каталогу, то discover считает, что местоположение, из которого он импортирует, и есть то, которое вы имели в виду, поэтому предупреждение не появится.260261Тестовые модули и пакеты могут настраивать загрузку и обнаружение тестов с помощью [протокола load\_tests](https://python-all.ru/3.15/library/unittest.html#id1).262263Изменено в версии 3.4: Обнаружение тестов поддерживает [пакеты с пространством имен](https://python-all.ru/3.15/glossary.html#term-namespace-package).264265Изменено в версии 3.11: Обнаружение тестов прекратило поддержку [пакетов с пространством имен](https://python-all.ru/3.15/glossary.html#term-namespace-package). Она была нарушена начиная с Python 3.7. Начальный каталог и его подкаталоги, содержащие тесты, должны быть обычными пакетами, имеющими файл `__init__.py`.266267Если начальный каталог является точечным именем пакета, родительские пакеты могут быть пакетами с пространством имен.268269Изменено в версии 3.14: Обнаружение тестов снова поддерживает [пакет с пространством имен](https://python-all.ru/3.15/glossary.html#term-namespace-package) в качестве начального каталога. Чтобы избежать сканирования каталогов, не связанных с Python, тесты не ищутся в подкаталогах, не содержащих `__init__.py`.270271## Организация тестового кода272273Основными строительными блоками модульного тестирования являются *тестовые случаи* – отдельные сценарии, которые необходимо настроить и проверить на корректность. В `unittest` тестовые случаи представлены экземплярами [`unittest.TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase). Чтобы создать собственные тестовые случаи, необходимо написать подклассы [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) или использовать [`FunctionTestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.FunctionTestCase).274275Тестовый код экземпляра [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) должен быть полностью самодостаточным, чтобы его можно было запускать как изолированно, так и в произвольной комбинации с любым количеством других тестовых случаев.276277Простейший подкласс [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) просто реализует тестовый метод (т.е. метод, имя которого начинается с `test`) для выполнения определенного тестового кода:278279```python280import unittest281282class DefaultWidgetSizeTestCase(unittest.TestCase):283    def test_default_widget_size(self):284        widget = Widget('The widget')285        self.assertEqual(widget.size(), (50, 50))286```287288Обратите внимание, что для проверки чего-либо используются [методы assert\*](https://python-all.ru/3.15/library/unittest.html#assert-methods), предоставляемые базовым классом [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase). Если тест не пройден, будет возбуждено исключение с пояснительным сообщением, и `unittest` определит тестовый случай как *сбой*. Любые другие исключения будут расцениваться как *ошибки*.289290Тестов может быть много, и их подготовка может быть повторяющейся. К счастью, можно вынести код подготовки в метод с именем [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp), который тестовый фреймворк будет автоматически вызывать для каждого запускаемого теста:291292```python293import unittest294295class WidgetTestCase(unittest.TestCase):296    def setUp(self):297        self.widget = Widget('The widget')298299    def test_default_widget_size(self):300        self.assertEqual(self.widget.size(), (50,50),301                         'incorrect default size')302303    def test_widget_resize(self):304        self.widget.resize(100,150)305        self.assertEqual(self.widget.size(), (100,150),306                         'wrong size after resize')307```308309> **Примечание**310>311> Порядок выполнения различных тестов определяется сортировкой имен тестовых методов в соответствии со встроенным порядком строк.312313Если метод [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) возбуждает исключение во время выполнения теста, фреймворк посчитает, что тест завершился ошибкой, и тестовый метод не будет выполнен.314315Аналогично, можно предоставить метод [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown), который выполняет очистку после выполнения тестового метода:316317```python318import unittest319320class WidgetTestCase(unittest.TestCase):321    def setUp(self):322        self.widget = Widget('The widget')323324    def tearDown(self):325        self.widget.dispose()326```327328Если [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) успешно выполнен, [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown) будет выполнен, независимо от того, завершился тестовый метод успешно или нет.329330Такое рабочее окружение для тестового кода называется *тестовой фикстурой*. Новый экземпляр TestCase создаётся как уникальная тестовая фикстура, используемая для выполнения каждого отдельного тестового метода. Таким образом, [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp), [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown) и `TestCase.__init__()` будут вызываться один раз для каждого теста.331332Рекомендуется группировать тесты с помощью реализаций TestCase в соответствии с тестируемыми возможностями. `unittest` предоставляет для этого механизм: *набор тестов*, представленный классом [`TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite) из модуля `unittest`. В большинстве случаев вызов [`unittest.main()`](https://python-all.ru/3.15/library/unittest.html#unittest.main) сделает всё правильно: соберёт все тестовые случаи модуля и выполнит их.333334Однако, если требуется настроить сборку набора тестов, это можно сделать самостоятельно:335336```python337def suite():338    suite = unittest.TestSuite()339    suite.addTest(WidgetTestCase('test_default_widget_size'))340    suite.addTest(WidgetTestCase('test_widget_resize'))341    return suite342343if __name__ == '__main__':344    runner = unittest.TextTestRunner()345    runner.run(suite())346```347348Определения тестовых случаев и наборов тестов можно размещать в тех же модулях, что и тестируемый код (например, `widget.py`), но есть несколько преимуществ в размещении тестового кода в отдельном модуле, например, `test_widget.py`:349350- Тестовый модуль можно запускать автономно из командной строки.351- Тестовый код проще отделить от поставляемого кода.352- Меньше соблазна изменять тестовый код, чтобы подогнать его под тестируемый код, без веской причины.353- Тестовый код должен изменяться гораздо реже, чем тестируемый код.354- Тестируемый код проще поддаётся рефакторингу.355- Тесты для модулей, написанных на C, всё равно должны быть в отдельных модулях – так почему бы не придерживаться этого подхода?356- Если стратегия тестирования меняется, нет необходимости изменять исходный код.357358## Повторное использование старого тестового кода359360Некоторые пользователи могут иметь существующий тестовый код, который они хотели бы запускать из `unittest`, не преобразовывая каждую старую тестовую функцию в подкласс [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase).361362По этой причине `unittest` предоставляет класс [`FunctionTestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.FunctionTestCase). Этот подкласс [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) можно использовать для обёртывания существующей тестовой функции. Также можно предоставить функции настройки (set-up) и завершения (tear-down).363364Рассмотрим следующую тестовую функцию:365366```python367def testSomething():368    something = makeSomething()369    assert something.name is not None370    # ...371```372373можно создать эквивалентный экземпляр тестового случая следующим образом, с опциональными методами настройки и завершения:374375```python376testcase = unittest.FunctionTestCase(testSomething,377                                     setUp=makeSomethingDB,378                                     tearDown=deleteSomethingDB)379```380381> **Примечание**382>383> Хотя [`FunctionTestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.FunctionTestCase) можно использовать для быстрого преобразования существующей тестовой базы в систему на основе `unittest`, этот подход не рекомендуется. Затрата времени на создание правильных подклассов [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) значительно упростит будущий рефакторинг тестов.384385В некоторых случаях существующие тесты могли быть написаны с использованием модуля [`doctest`](https://python-all.ru/3.15/library/doctest.html#module-doctest). В этом случае `doctest` предоставляет класс [`DocTestSuite`](https://python-all.ru/3.15/library/doctest.html#doctest.DocTestSuite), который может автоматически создавать экземпляры [`unittest.TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite) из существующих тестов на основе `doctest`.386387## Пропуск тестов и ожидаемые сбои388389Добавлено в версии 3.1.390391Unittest поддерживает пропуск отдельных тестовых методов и даже целых классов тестов. Кроме того, он поддерживает пометку теста как «ожидаемый сбой» – тест, который сломан и завершится неудачей, но не должен засчитываться как сбой в [`TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult).392393Пропуск теста – это просто использование [`skip()`](https://python-all.ru/3.15/library/unittest.html#unittest.skip) [декоратора](https://python-all.ru/3.15/glossary.html#term-decorator) или одного из его условных вариантов, вызов [`TestCase.skipTest()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.skipTest) внутри [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) или тестового метода, или непосредственное возбуждение [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest).394395Базовый пропуск выглядит так:396397```python398class MyTestCase(unittest.TestCase):399400    @unittest.skip("demonstrating skipping")401    def test_nothing(self):402        self.fail("shouldn't happen")403404    @unittest.skipIf(mylib.__version__ < (1, 3),405                     "not supported in this library version")406    def test_format(self):407        # Тесты, которые работают только для определённой версии библиотеки.408        pass409410    @unittest.skipUnless(sys.platform.startswith("win"), "requires Windows")411    def test_windows_support(self):412        # код тестирования для Windows413        pass414415    def test_maybe_skipped(self):416        if not external_resource_available():417            self.skipTest("external resource not available")418        # тестовый код, зависящий от внешнего ресурса419        pass420```421422Это вывод приведённого выше примера в подробном режиме:423424```python425test_format (__main__.MyTestCase.test_format) ... skipped 'not supported in this library version'426test_nothing (__main__.MyTestCase.test_nothing) ... skipped 'demonstrating skipping'427test_maybe_skipped (__main__.MyTestCase.test_maybe_skipped) ... skipped 'external resource not available'428test_windows_support (__main__.MyTestCase.test_windows_support) ... skipped 'requires Windows'429430----------------------------------------------------------------------431Ran 4 tests in 0.005s432433OK (skipped=4)434```435436Классы можно пропускать так же, как методы:437438```python439@unittest.skip("showing class skipping")440class MySkippedTestCase(unittest.TestCase):441    def test_not_run(self):442        pass443```444445[`TestCase.setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) также может пропустить тест. Это полезно, когда ресурс, который необходимо настроить, недоступен.446447Для ожидаемых сбоев используется декоратор [`expectedFailure()`](https://python-all.ru/3.15/library/unittest.html#unittest.expectedFailure).448449```python450class ExpectedFailureTestCase(unittest.TestCase):451    @unittest.expectedFailure452    def test_fail(self):453        self.assertEqual(1, 0, "broken")454```455456Легко создать собственные декораторы пропуска, создав декоратор, который вызывает [`skip()`](https://python-all.ru/3.15/library/unittest.html#unittest.skip) для теста, когда нужно его пропустить. Этот декоратор пропускает тест, если только переданный объект не имеет определённого атрибута:457458```python459def skipUnlessHasattr(obj, attr):460    if hasattr(obj, attr):461        return lambda func: func462    return unittest.skip("{!r} doesn't have {!r}".format(obj, attr))463```464465Следующие декораторы и исключение реализуют пропуск тестов и ожидаемые сбои:466467#### `@unittest.skip(reason)`468469Безусловно пропускает декорированный тест. Параметр *reason* должен описывать причину пропуска теста.470471#### `@unittest.skipIf(condition, reason)`472473Пропустить декорированный тест, если *condition* истинно.474475#### `@unittest.skipUnless(condition, reason)`476477Пропустить декорированный тест, если *condition* не истинно.478479#### `@unittest.expectedFailure`480481Помечает тест как ожидаемый сбой или ошибку. Если тест завершается ошибкой или сбоем в самой тестовой функции (а не в одном из методов *тестовой фикстуры*), то он будет считаться успешным. Если тест проходит, он будет считаться неудачным.482483#### `exception unittest.SkipTest(reason)`484485Это исключение возбуждается для пропуска теста.486487Обычно можно использовать [`TestCase.skipTest()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.skipTest) или один из декораторов пропуска, вместо того чтобы возбуждать его напрямую.488489Пропущенные тесты не будут выполнять [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) или [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown). Пропущенные классы не будут выполнять [`setUpClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUpClass) или [`tearDownClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDownClass). Пропущенные модули не будут выполнять [`setUpModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.setUpModule) или [`tearDownModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.tearDownModule).490491## Различение итераций теста с помощью подтестов492493Добавлено в версии 3.4.494495Когда между тестами есть очень небольшие различия, например некоторые параметры, unittest позволяет различать их внутри тела тестового метода с помощью контекстного менеджера [`subTest()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.subTest).496497Например, следующий тест:498499```python500class NumbersTest(unittest.TestCase):501502    def test_even(self):503        """504        Проверить, что все числа от 0 до 5 чётные.505        """506        for i in range(0, 6):507            with self.subTest(i=i):508                self.assertEqual(i % 2, 0)509```510511выдаст следующий результат:512513```python514======================================================================515FAIL: test_even (__main__.NumbersTest.test_even) (i=1)516Test that numbers between 0 and 5 are all even.517----------------------------------------------------------------------518Traceback (most recent call last):519  File "subtests.py", line 11, in test_even520    self.assertEqual(i % 2, 0)521    ^^^^^^^^^^^^^^^^^^^^^^^^^^522AssertionError: 1 != 0523524======================================================================525FAIL: test_even (__main__.NumbersTest.test_even) (i=3)526Test that numbers between 0 and 5 are all even.527----------------------------------------------------------------------528Traceback (most recent call last):529  File "subtests.py", line 11, in test_even530    self.assertEqual(i % 2, 0)531    ^^^^^^^^^^^^^^^^^^^^^^^^^^532AssertionError: 1 != 0533534======================================================================535FAIL: test_even (__main__.NumbersTest.test_even) (i=5)536Test that numbers between 0 and 5 are all even.537----------------------------------------------------------------------538Traceback (most recent call last):539  File "subtests.py", line 11, in test_even540    self.assertEqual(i % 2, 0)541    ^^^^^^^^^^^^^^^^^^^^^^^^^^542AssertionError: 1 != 0543```544545Без использования подтеста выполнение остановилось бы после первого сбоя, и ошибку было бы труднее диагностировать, поскольку значение `i` не отображалось бы:546547```python548======================================================================549FAIL: test_even (__main__.NumbersTest.test_even)550----------------------------------------------------------------------551Traceback (most recent call last):552  File "subtests.py", line 32, in test_even553    self.assertEqual(i % 2, 0)554AssertionError: 1 != 0555```556557## Классы и функции558559В этом разделе подробно описывается API `unittest`.560561### Тестовые примеры562563#### `class unittest.TestCase(methodName='runTest')`564565Экземпляры класса `TestCase` представляют собой логические тестовые единицы в среде `unittest`. Этот класс предназначен для использования в качестве базового класса, при этом конкретные тесты реализуются в конкретных подклассах. Класс реализует интерфейс, необходимый тестовому исполнителю для управления тестами, а также методы, которые тестовый код может использовать для проверки и сообщения о различных видах сбоев.566567Каждый экземпляр `TestCase` выполняет один базовый метод: метод с именем *methodName*. В большинстве случаев использования `TestCase` не требуется ни изменять *methodName*, ни переопределять метод по умолчанию `runTest()`.568569Изменено в версии 3.2: `TestCase` можно успешно создать без указания *methodName*. Это упрощает эксперименты с `TestCase` в интерактивном интерпретаторе.570571Экземпляры `TestCase` предоставляют три группы методов: одна группа используется для выполнения теста, другая – реализацией теста для проверки условий и сообщения о сбоях, и несколько запросных методов, позволяющих собирать информацию о самом тесте.572573Методы первой группы (выполнение теста):574575#### `setUp()`576577Метод, вызываемый для подготовки тестовой фикстуры. Он вызывается непосредственно перед вызовом тестового метода; за исключением [`AssertionError`](https://python-all.ru/3.15/library/exceptions.html#AssertionError) или [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest), любое исключение, возбуждённое этим методом, будет считаться ошибкой, а не сбоем теста. Реализация по умолчанию ничего не делает.578579#### `tearDown()`580581Метод, вызываемый сразу после вызова тестового метода и записи результата. Он вызывается, даже если тестовый метод возбудил исключение, поэтому реализация в подклассах должна быть особенно осторожна при проверке внутреннего состояния. Любое исключение, кроме [`AssertionError`](https://python-all.ru/3.15/library/exceptions.html#AssertionError) или [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest), возбуждённое этим методом, будет считаться дополнительной ошибкой, а не сбоем теста (таким образом увеличивая общее количество сообщённых ошибок). Этот метод будет вызван только если [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) выполнится успешно, независимо от результата тестового метода. Реализация по умолчанию ничего не делает.582583#### `setUpClass()`584585Метод класса, вызываемый перед выполнением тестов в отдельном классе. `setUpClass` вызывается с классом в качестве единственного аргумента и должен быть декорирован как [`classmethod()`](https://python-all.ru/3.15/library/functions.html#classmethod):586587```python588@classmethod589def setUpClass(cls):590    ...591```592593См. [Фикстуры классов и модулей](https://python-all.ru/3.15/library/unittest.html#class-and-module-fixtures) для получения дополнительных сведений.594595Добавлено в версии 3.2.596597#### `tearDownClass()`598599Метод класса, вызываемый после выполнения тестов в отдельном классе. `tearDownClass` вызывается с классом в качестве единственного аргумента и должен быть декорирован как [`classmethod()`](https://python-all.ru/3.15/library/functions.html#classmethod):600601```python602@classmethod603def tearDownClass(cls):604    ...605```606607См. [Фикстуры классов и модулей](https://python-all.ru/3.15/library/unittest.html#class-and-module-fixtures) для получения дополнительных сведений.608609Добавлено в версии 3.2.610611#### `run(result=None)`612613Запускает тест, собирая результат в объект [`TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult), переданный как *result*. Если *result* опущен или равен `None`, создаётся временный объект результата (путем вызова метода [`defaultTestResult()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.defaultTestResult)), который и используется. Объект результата возвращается вызывающему коду `run()`.614615Того же эффекта можно добиться простым вызовом экземпляра `TestCase`.616617Изменено в версии 3.3: Предыдущие версии `run` не возвращали результат. Также не возвращал результат вызов экземпляра.618619#### `skipTest(reason)`620621Вызов этого метода внутри тестового метода или [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) пропускает текущий тест. Подробнее см. [Пропуск тестов и ожидаемые сбои](https://python-all.ru/3.15/library/unittest.html#unittest-skipping).622623Добавлено в версии 3.1.624625#### `subTest(msg=None, **params)`626627Возвращает менеджер контекста, который выполняет вложенный блок кода как подтест. *msg* и *params* – необязательные произвольные значения, отображаемые при сбое подтеста, что позволяет однозначно их идентифицировать.628629Тестовый пример может содержать любое количество объявлений подтестов, и они могут быть произвольно вложены.630631Подробнее см. [Различение итераций тестов с помощью подтестов](https://python-all.ru/3.15/library/unittest.html#subtests).632633Добавлено в версии 3.4.634635#### `debug()`636637Запускает тест без сбора результата. Это позволяет исключениям, возникшим в тесте, распространяться до вызывающего кода, и может использоваться для поддержки запуска тестов под отладчиком.638639Класс `TestCase` предоставляет несколько методов assert для проверки и сообщения об ошибках. В следующей таблице перечислены наиболее часто используемые методы (см. таблицы ниже для получения дополнительных методов assert):640641| Метод | Проверяет, что | Новое в |642| --- | --- | --- |643| [`assertEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual) | `a == b` |  |644| [`assertNotEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotEqual) | `a != b` |  |645| [`assertTrue(x)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertTrue) | `bool(x) is True` |  |646| [`assertFalse(x)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertFalse) | `bool(x) is False` |  |647| [`assertIs(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIs) | `a is b` | 3.1 |648| [`assertIsNot(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIsNot) | `a is not b` | 3.1 |649| [`assertIsNone(x)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIsNone) | `x is None` | 3.1 |650| [`assertIsNotNone(x)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIsNotNone) | `x is not None` | 3.1 |651| [`assertIn(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIn) | `a in b` | 3.1 |652| [`assertNotIn(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotIn) | `a not in b` | 3.1 |653| [`assertIsInstance(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIsInstance) | `isinstance(a, b)` | 3.2 |654| [`assertNotIsInstance(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotIsInstance) | `not isinstance(a, b)` | 3.2 |655| [`assertIsSubclass(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIsSubclass) | `issubclass(a, b)` | 3.14 |656| [`assertNotIsSubclass(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotIsSubclass) | `not issubclass(a, b)` | 3.14 |657658Все методы assert принимают аргумент *msg*, который, если указан, используется как сообщение об ошибке в случае сбоя (см. также [`longMessage`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.longMessage)). Обратите внимание, что ключевой аргумент *msg* может быть передан методам [`assertRaises()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertRaises), [`assertRaisesRegex()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertRaisesRegex), [`assertWarns()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertWarns), [`assertWarnsRegex()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertWarnsRegex) только когда они используются как менеджер контекста.659660#### `assertEqual(first, second, msg=None)`661662Проверяет, что *first* и *second* равны. Если значения не равны, тест завершится с ошибкой.663664Кроме того, если *first* и *second* относятся к одному и тому же типу и это list, tuple, dict, set, frozenset, str или любой тип, зарегистрированный подклассом с помощью [`addTypeEqualityFunc()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.addTypeEqualityFunc), то будет вызвана типовая функция сравнения для формирования более информативного сообщения об ошибке по умолчанию (см. также [список типовых методов](https://python-all.ru/3.15/library/unittest.html#type-specific-methods)).665666Изменено в версии 3.1: Добавлен автоматический вызов типовой функции сравнения.667668Изменено в версии 3.2: [`assertMultiLineEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertMultiLineEqual) добавлен в качестве типовой функции сравнения по умолчанию для сравнения строк.669670#### `assertNotEqual(first, second, msg=None)`671672Проверяет, что *first* и *second* не равны. Если значения равны, тест завершится с ошибкой.673674#### `assertTrue(expr, msg=None)`675676#### `assertFalse(expr, msg=None)`677678Проверяет, что *expr* истинно (или ложно).679680Обратите внимание, что это эквивалентно `bool(expr) is True`, а не `expr is True` (для последнего используйте `assertIs(expr, True)`). Этот метод также следует избегать, если доступны более специфические методы (например, `assertEqual(a, b)` вместо `assertTrue(a == b)`), потому что они предоставляют более информативное сообщение об ошибке в случае сбоя.681682#### `assertIs(first, second, msg=None)`683684#### `assertIsNot(first, second, msg=None)`685686Проверяет, что *first* и *second* являются (или не являются) одним и тем же объектом.687688Добавлено в версии 3.1.689690#### `assertIsNone(expr, msg=None)`691692#### `assertIsNotNone(expr, msg=None)`693694Проверяет, что *expr* является (или не является) `None`.695696Добавлено в версии 3.1.697698#### `assertIn(member, container, msg=None)`699700#### `assertNotIn(member, container, msg=None)`701702Проверяет, что *member* находится (или не находится) в *container*.703704Добавлено в версии 3.1.705706#### `assertIsInstance(obj, cls, msg=None)`707708#### `assertNotIsInstance(obj, cls, msg=None)`709710Проверяет, что *obj* является (или не является) экземпляром *cls* (который может быть классом или кортежем классов, как поддерживается [`isinstance()`](https://python-all.ru/3.15/library/functions.html#isinstance)). Для проверки точного типа используйте [`assertIs(type(obj), cls)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIs).711712Добавлено в версии 3.2.713714#### `assertIsSubclass(cls, superclass, msg=None)`715716#### `assertNotIsSubclass(cls, superclass, msg=None)`717718Проверяет, что *cls* является (или не является) подклассом *superclass* (который может быть классом или кортежем классов, как поддерживается [`issubclass()`](https://python-all.ru/3.15/library/functions.html#issubclass)). Для проверки точного типа используйте [`assertIs(cls, superclass)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertIs).719720Добавлено в версии 3.14.721722Также можно проверить возникновение исключений, предупреждений и сообщений журнала с помощью следующих методов:723724| Метод | Проверяет, что | Новое в |725| --- | --- | --- |726| [`assertRaises(exc, fun, *args, **kwds)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertRaises) | `fun(*args, **kwds)` возбуждает *exc* |  |727| [`assertRaisesRegex(exc, r, fun, *args, **kwds)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertRaisesRegex) | `fun(*args, **kwds)` возбуждает *exc* и сообщение соответствует регулярному выражению *r* | 3.1 |728| [`assertWarns(warn, fun, *args, **kwds)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertWarns) | `fun(*args, **kwds)` возбуждает *warn* | 3.2 |729| [`assertWarnsRegex(warn, r, fun, *args, **kwds)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertWarnsRegex) | `fun(*args, **kwds)` возбуждает *warn* и сообщение соответствует регулярному выражению *r* | 3.2 |730| [`assertLogs(logger, level)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertLogs) | Блок `with` пишет в журнал *logger* с минимальным уровнем *level* | 3.4 |731| [`assertNoLogs(logger, level)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNoLogs) | Блок `with` не пишет в журнал*logger* с минимальным *level* | 3.10 |732733#### `assertRaises(exception, callable, *args, **kwds)`734735#### `assertRaises(exception, *, msg=None)`736737Проверяет, что исключение возбуждается, когда *callable* вызывается с любыми позиционными или именованными аргументами, которые также передаются в `assertRaises()`. Тест проходит, если возбуждается *исключение*, считается ошибкой, если возбуждается другое исключение, или не проходит, если исключение не возбуждается. Чтобы перехватить любое из группы исключений, можно передать кортеж, содержащий классы исключений, как *исключение*.738739Если переданы только аргументы *исключение* и, возможно, *msg*, возвращается менеджер контекста, чтобы проверяемый код можно было написать встроенно, а не в виде функции:740741```python742with self.assertRaises(SomeException):743    do_something()744```745746При использовании в качестве менеджера контекста `assertRaises()` принимает дополнительный ключевой аргумент *msg*.747748Менеджер контекста сохраняет перехваченный объект исключения в своём атрибуте `exception`. Это может быть полезно, если нужно выполнить дополнительные проверки возникшего исключения:749750```python751with self.assertRaises(SomeException) as cm:752    do_something()753754the_exception = cm.exception755self.assertEqual(the_exception.error_code, 3)756```757758Изменено в версии 3.1: Добавлена возможность использовать `assertRaises()` в качестве менеджера контекста.759760Изменено в версии 3.2: Добавлен атрибут `exception`.761762Изменено в версии 3.3: добавлен ключевой аргумент *msg* при использовании в качестве менеджера контекста.763764#### `assertRaisesRegex(exception, regex, callable, *args, **kwds)`765766#### `assertRaisesRegex(exception, regex, *, msg=None)`767768Как [`assertRaises()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertRaises), но также проверяет, что *regex* соответствует строковому представлению возбуждённого исключения. *regex* может быть объектом регулярного выражения или строкой, содержащей регулярное выражение, подходящее для использования [`re.search()`](https://python-all.ru/3.15/library/re.html#re.search). Примеры:769770```python771self.assertRaisesRegex(ValueError, "invalid literal for.*XYZ'$",772                       int, 'XYZ')773```774775или:776777```python778with self.assertRaisesRegex(ValueError, 'literal'):779   int('XYZ')780```781782Добавлено в версии 3.1: Добавлено под именем `assertRaisesRegexp`.783784Изменено в версии 3.2: переименовано в `assertRaisesRegex()`.785786Изменено в версии 3.3: добавлен ключевой аргумент *msg* при использовании в качестве менеджера контекста.787788#### `assertWarns(warning, callable, *args, **kwds)`789790#### `assertWarns(warning, *, msg=None)`791792Проверяет, что предупреждение вызывается, когда *вызываемый объект* вызывается с любыми позиционными или ключевыми аргументами, которые также передаются в `assertWarns()`. Тест проходит, если *предупреждение* вызывается, и не проходит в противном случае. Любое исключение считается ошибкой. Чтобы перехватить любое из группы предупреждений, можно передать кортеж, содержащий классы предупреждений, в качестве *предупреждения*.793794Если указаны только *предупреждение* и, возможно, *msg*, возвращается менеджер контекста, позволяющий писать тестируемый код inline, а не в виде функции:795796```python797with self.assertWarns(SomeWarning):798    do_something()799```800801При использовании в качестве менеджера контекста `assertWarns()` принимает дополнительный ключевой аргумент *msg*.802803Менеджер контекста сохраняет перехваченный объект предупреждения в своём атрибуте `warning`, а также исходную строку, вызвавшую предупреждения, в атрибутах `filename` и `lineno`. Это может быть полезно, если требуется выполнить дополнительные проверки перехваченного предупреждения:804805```python806with self.assertWarns(SomeWarning) as cm:807    do_something()808809self.assertIn('myfile.py', cm.filename)810self.assertEqual(320, cm.lineno)811```812813Менеджеры контекста можно вкладывать друг в друга, чтобы проверять, что выдаётся несколько разных предупреждений:814815```python816with (self.assertWarns(SomeWarning),817      self.assertWarns(OtherWarning)):818    do_something()819```820821Этот метод работает независимо от фильтров предупреждений, установленных на момент его вызова.822823Добавлено в версии 3.2.824825Изменено в версии 3.3: добавлен ключевой аргумент *msg* при использовании в качестве менеджера контекста.826827Изменено в версии 3.15: Предупреждения, не соответствующие указанной категории, больше не подавляются. Теперь поддерживаются вложенные менеджеры контекста.828829#### `assertWarnsRegex(warning, regex, callable, *args, **kwds)`830831#### `assertWarnsRegex(warning, regex, *, msg=None)`832833Как и [`assertWarns()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertWarns), но также проверяет, что *регулярное выражение* соответствует сообщению вызванного предупреждения. *Регулярное выражение* может быть объектом регулярного выражения или строкой, содержащей регулярное выражение, пригодное для использования [`re.search()`](https://python-all.ru/3.15/library/re.html#re.search). Пример:834835```python836self.assertWarnsRegex(DeprecationWarning,837                      r'legacy_function\(\) is deprecated',838                      legacy_function, 'XYZ')839```840841или:842843```python844with self.assertWarnsRegex(RuntimeWarning, 'unsafe frobnicating'):845    frobnicate('/etc/passwd')846```847848Менеджеры контекста можно вкладывать друг в друга, чтобы проверять, что выдаётся несколько разных предупреждений:849850```python851with (self.assertWarns(SomeWarning, regex1),852      self.assertWarns(OtherWarning, regex2)):853    do_something()854```855856Добавлено в версии 3.2.857858Изменено в версии 3.3: добавлен ключевой аргумент *msg* при использовании в качестве менеджера контекста.859860Изменено в версии 3.15: Предупреждения, не соответствующие указанной категории или регулярному выражению, больше не подавляются. Теперь поддерживаются вложенные менеджеры контекста.861862#### `assertLogs(logger=None, level=None, formatter=None)`863864Менеджер контекста для проверки того, что хотя бы одно сообщение зарегистрировано в *логгере* или одном из его потомков, с уровнем не ниже указанного *уровня*.865866Если указан, *логгер* должен быть объектом [`logging.Logger`](https://python-all.ru/3.15/library/logging.html#logging.Logger) или [`str`](https://python-all.ru/3.15/library/stdtypes.html#str), задающим имя логгера. По умолчанию используется корневой логгер, который перехватывает все сообщения, не заблокированные непропагандирующим дочерним логгером.867868Если указан, *уровень* должен быть числовым уровнем логирования или его строковым эквивалентом (например, `"ERROR"` или [`logging.ERROR`](https://python-all.ru/3.15/library/logging.html#logging.ERROR)). По умолчанию [`logging.INFO`](https://python-all.ru/3.15/library/logging.html#logging.INFO).869870Если указан, *formatter* должен быть объектом [`logging.Formatter`](https://python-all.ru/3.15/library/logging.html#logging.Formatter). По умолчанию используется форматтер со строкой форматирования `"%(levelname)s:%(name)s:%(message)s"`871872Тест проходит, если хотя бы одно сообщение, отправленное внутри блока `with`, соответствует условиям *логгера* и *уровня*, в противном случае тест не проходит.873874Объект, возвращаемый менеджером контекста, представляет собой вспомогательный объект для записи, который отслеживает соответствующие сообщения журнала. Он имеет два атрибута:875876#### `records`877878Список объектов [`logging.LogRecord`](https://python-all.ru/3.15/library/logging.html#logging.LogRecord) соответствующих сообщений журнала.879880#### `output`881882Список объектов [`str`](https://python-all.ru/3.15/library/stdtypes.html#str) с отформатированным выводом соответствующих сообщений.883884Пример:885886```python887with self.assertLogs('foo', level='INFO') as cm:888    logging.getLogger('foo').info('first message')889    logging.getLogger('foo.bar').error('second message')890self.assertEqual(cm.output, ['INFO:foo:first message',891                             'ERROR:foo.bar:second message'])892```893894Добавлено в версии 3.4.895896Изменено в версии 3.15: Теперь принимает *formatter* для управления форматированием сообщений.897898#### `assertNoLogs(logger=None, level=None)`899900Менеджер контекста для проверки того, что на *логгере* или одном из его потомков не зарегистрировано ни одного сообщения с уровнем не ниже указанного *уровня*.901902Если указан, *логгер* должен быть объектом [`logging.Logger`](https://python-all.ru/3.15/library/logging.html#logging.Logger) или [`str`](https://python-all.ru/3.15/library/stdtypes.html#str), задающим имя логгера. По умолчанию используется корневой логгер, который перехватывает все сообщения.903904Если указан, *уровень* должен быть числовым уровнем логирования или его строковым эквивалентом (например, `"ERROR"` или [`logging.ERROR`](https://python-all.ru/3.15/library/logging.html#logging.ERROR)). По умолчанию [`logging.INFO`](https://python-all.ru/3.15/library/logging.html#logging.INFO).905906В отличие от [`assertLogs()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertLogs), менеджер контекста ничего не возвращает.907908Добавлено в версии 3.10.909910Существуют также другие методы для выполнения более специфических проверок, например:911912| Метод | Проверяет, что | Новое в |913| --- | --- | --- |914| [`assertAlmostEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertAlmostEqual) | `round(a-b, 7) == 0` |  |915| [`assertNotAlmostEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotAlmostEqual) | `round(a-b, 7) != 0` |  |916| [`assertGreater(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertGreater) | `a > b` | 3.1 |917| [`assertGreaterEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertGreaterEqual) | `a >= b` | 3.1 |918| [`assertLess(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertLess) | `a < b` | 3.1 |919| [`assertLessEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertLessEqual) | `a <= b` | 3.1 |920| [`assertRegex(s, r)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertRegex) | `r.search(s)` | 3.1 |921| [`assertNotRegex(s, r)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotRegex) | `not r.search(s)` | 3.2 |922| [`assertCountEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertCountEqual) | *a* содержит те же элементы, что и *b*, независимо от их порядка. | 3.2 |923| [`assertStartsWith(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertStartsWith) | `a.startswith(b)` | 3.14 |924| [`assertNotStartsWith(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotStartsWith) | `not a.startswith(b)` | 3.14 |925| [`assertEndsWith(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEndsWith) | `a.endswith(b)` | 3.14 |926| [`assertNotEndsWith(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotEndsWith) | `not a.endswith(b)` | 3.14 |927| [`assertHasAttr(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertHasAttr) | `hasattr(a, b)` | 3.14 |928| [`assertNotHasAttr(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertNotHasAttr) | `not hasattr(a, b)` | 3.14 |929930#### `assertAlmostEqual(first, second, places=7, msg=None, delta=None)`931932#### `assertNotAlmostEqual(first, second, places=7, msg=None, delta=None)`933934Проверяет, что *first* и *second* приблизительно равны (или не равны), вычисляя разность, округляя до заданного числа десятичных знаков *places* (по умолчанию 7) и сравнивая с нулём. Обратите внимание, что эти методы округляют значения до заданного числа *десятичных знаков* (т.е. как функция [`round()`](https://python-all.ru/3.15/library/functions.html#round)), а не до *значащих цифр*.935936Если указан *delta* вместо *places*, то разность между *first* и *second* должна быть меньше или равна (или больше) *delta*.937938Одновременная передача *delta* и *places* вызывает [`TypeError`](https://python-all.ru/3.15/library/exceptions.html#TypeError).939940Изменено в версии 3.2: `assertAlmostEqual()` теперь автоматически считает приблизительно равными объекты, которые сравниваются как равные. `assertNotAlmostEqual()` теперь автоматически завершается ошибкой, если объекты сравниваются как равные. Добавлен именованный аргумент *delta*.941942#### `assertGreater(first, second, msg=None)`943944#### `assertGreaterEqual(first, second, msg=None)`945946#### `assertLess(first, second, msg=None)`947948#### `assertLessEqual(first, second, msg=None)`949950Проверяет, что *first* соответственно \>, \>=, \< или \<= по отношению к *second* в зависимости от имени метода. Если это не так, тест завершается ошибкой:951952```python953>>> self.assertGreaterEqual(3, 4)954AssertionError: "3" unexpectedly not greater than or equal to "4"955```956957Добавлено в версии 3.1.958959#### `assertRegex(text, regex, msg=None)`960961#### `assertNotRegex(text, regex, msg=None)`962963Проверяет, что поиск по *regex* совпадает (или не совпадает) с *text*. В случае неудачи сообщение об ошибке будет содержать шаблон и *text* (или шаблон и ту часть *text*, которая неожиданно совпала). *regex* может быть объектом регулярного выражения или строкой, содержащей регулярное выражение, подходящее для использования с [`re.search()`](https://python-all.ru/3.15/library/re.html#re.search).964965Добавлено в версии 3.1: Добавлено под именем `assertRegexpMatches`.966967Изменено в версии 3.2: Метод `assertRegexpMatches()` был переименован в `assertRegex()`.968969Добавлено в версии 3.2: `assertNotRegex()`.970971#### `assertCountEqual(first, second, msg=None)`972973Проверяет, что последовательность *first* содержит те же элементы, что и *second*, независимо от их порядка. Если нет, генерируется сообщение об ошибке с перечислением различий между последовательностями.974975Дублирующиеся элементы *не* игнорируются при сравнении *first* и *second*. Проверяется, что каждый элемент встречается одинаковое количество раз в обеих последовательностях. Эквивалентно: `assertEqual(Counter(list(first)), Counter(list(second)))` но также работает с последовательностями нехешируемых объектов.976977Добавлено в версии 3.2.978979#### `assertStartsWith(s, prefix, msg=None)`980981#### `assertNotStartsWith(s, prefix, msg=None)`982983Проверяет, что строка Unicode или байтовая строка *s* начинается (или не начинается) с *prefix*. *prefix* также может быть кортежем строк для проверки.984985Добавлено в версии 3.14.986987#### `assertEndsWith(s, suffix, msg=None)`988989#### `assertNotEndsWith(s, suffix, msg=None)`990991Проверяет, что строка Unicode или байтовая строка *s* заканчивается (или не заканчивается) на *suffix*. *suffix* также может быть кортежем строк для проверки.992993Добавлено в версии 3.14.994995#### `assertHasAttr(obj, name, msg=None)`996997#### `assertNotHasAttr(obj, name, msg=None)`998999Проверяет, что объект *obj* имеет (или не имеет) атрибут *name*.10001001Добавлено в версии 3.14.10021003Метод [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual) направляет проверку равенства для объектов одного типа к различным методам, специфичным для типа. Эти методы уже реализованы для большинства встроенных типов, но также можно зарегистрировать новые методы с помощью [`addTypeEqualityFunc()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.addTypeEqualityFunc):10041005#### `addTypeEqualityFunc(typeobj, function)`10061007Регистрирует метод, специфичный для типа, вызываемый с помощью [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual) для проверки, равны ли два объекта одного и того же *typeobj* (не подклассы). *function* должен принимать два позиционных аргумента и третий именованный аргумент msg=None, как и `assertEqual()`. Он должен вызывать [`self.failureException(msg)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.failureException) при обнаружении неравенства между первыми двумя параметрами – возможно, предоставляя полезную информацию и подробно объясняя неравенства в сообщении об ошибке.10081009Добавлено в версии 3.1.10101011Список типовых методов, автоматически используемых [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual), приведён в следующей таблице. Обратите внимание, что обычно нет необходимости вызывать эти методы напрямую.10121013| Метод | Используется для сравнения | Новое в |1014| --- | --- | --- |1015| [`assertMultiLineEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertMultiLineEqual) | строки | 3.1 |1016| [`assertSequenceEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertSequenceEqual) | последовательности | 3.1 |1017| [`assertListEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertListEqual) | списки | 3.1 |1018| [`assertTupleEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertTupleEqual) | кортежи | 3.1 |1019| [`assertSetEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertSetEqual) | множества или неизменяемые множества | 3.1 |1020| [`assertDictEqual(a, b)`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertDictEqual) | словари | 3.1 |10211022#### `assertMultiLineEqual(first, second, msg=None)`10231024Проверяет, что многострочная строка *first* равна строке *second*. Если они не равны, в сообщение об ошибке включается diff двух строк с подсветкой различий. Этот метод используется по умолчанию при сравнении строк с помощью [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual).10251026Добавлено в версии 3.1.10271028#### `assertSequenceEqual(first, second, msg=None, seq_type=None)`10291030Проверяет, что две последовательности равны. Если передан *seq\_type*, то *first* и *second* должны быть экземплярами *seq\_type*, иначе будет вызвана ошибка. Если последовательности различаются, формируется сообщение об ошибке, показывающее разницу между ними.10311032Этот метод не вызывается напрямую методом [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual), но используется для реализации [`assertListEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertListEqual) и [`assertTupleEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertTupleEqual).10331034Добавлено в версии 3.1.10351036#### `assertListEqual(first, second, msg=None)`10371038#### `assertTupleEqual(first, second, msg=None)`10391040Проверяет, что два списка или кортежа равны. Если нет, формируется сообщение об ошибке, показывающее только различия между ними. Ошибка также возникает, если один из параметров имеет неверный тип. Эти методы используются по умолчанию при сравнении списков или кортежей с помощью [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual).10411042Добавлено в версии 3.1.10431044#### `assertSetEqual(first, second, msg=None)`10451046Проверяет, что два множества равны. Если нет, формируется сообщение об ошибке, перечисляющее различия между множествами. Этот метод используется по умолчанию при сравнении множеств или неизменяемых множеств с помощью [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual).10471048Завершается ошибкой, если *first* или *second* не имеет метода [`difference()`](https://python-all.ru/3.15/library/stdtypes.html#frozenset.difference).10491050Добавлено в версии 3.1.10511052#### `assertDictEqual(first, second, msg=None)`10531054Проверяет, что два словаря равны. Если нет, формируется сообщение об ошибке, показывающее различия в словарях. Этот метод будет использоваться по умолчанию для сравнения словарей в вызовах [`assertEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertEqual).10551056Добавлено в версии 3.1.10571058Наконец, `TestCase` предоставляет следующие методы и атрибуты:10591060#### `fail(msg=None)`10611062Безусловно сигнализирует о сбое теста, используя *msg* или `None` в качестве сообщения об ошибке.10631064#### `failureException`10651066Этот атрибут класса задаёт исключение, которое вызывается тестовым методом. Если тестовому фреймворку требуется использовать специализированное исключение, возможно, для передачи дополнительной информации, он должен создать подкласс этого исключения, чтобы «честно играть» с фреймворком. Начальное значение этого атрибута – [`AssertionError`](https://python-all.ru/3.15/library/exceptions.html#AssertionError).10671068#### `longMessage`10691070Этот атрибут класса определяет, что происходит, когда пользовательское сообщение об ошибке передаётся в качестве аргумента msg в вызов assertXYY, который завершается сбоем. Значение по умолчанию – `True`. В этом случае пользовательское сообщение добавляется в конец стандартного сообщения об ошибке. Если установлено `False`, пользовательское сообщение заменяет стандартное.10711072Настройку класса можно переопределить в отдельных тестовых методах, присвоив атрибуту экземпляра self.longMessage значение `True` или `False` перед вызовом assert-методов.10731074Настройка класса сбрасывается перед каждым вызовом теста.10751076Добавлено в версии 3.1.10771078#### `maxDiff`10791080Этот атрибут управляет максимальной длиной вывода различий, выводимых методами утверждения, которые сообщают о различиях при неудаче. По умолчанию – 80\*8 символов. Методы утверждения, на которые влияет этот атрибут: [`assertSequenceEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertSequenceEqual) (включая все методы сравнения последовательностей, которые делегируют ему), [`assertDictEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertDictEqual) и [`assertMultiLineEqual()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.assertMultiLineEqual).10811082Установка `maxDiff` в `None` означает, что максимальная длина различий не ограничена.10831084Добавлено в версии 3.2.10851086Тестовые фреймворки могут использовать следующие методы для сбора информации о тесте:10871088#### `countTestCases()`10891090Возвращает количество тестов, представленных этим тестовым объектом. Для экземпляров `TestCase` это всегда будет `1`.10911092#### `defaultTestResult()`10931094Возвращает экземпляр класса результата теста, который следует использовать для данного класса тестового случая (если ни один другой экземпляр результата не был передан методу [`run()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.run)).10951096Для экземпляров `TestCase` это всегда будет экземпляр [`TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult); подклассы `TestCase` должны при необходимости переопределять это.10971098#### `id()`10991100Возвращает строку, идентифицирующую конкретный тестовый случай. Обычно это полное имя тестового метода, включая имя модуля и класса.11011102#### `shortDescription()`11031104Возвращает описание теста или `None`, если описание не было предоставлено. Реализация по умолчанию этого метода возвращает первую строку докстринга тестового метода, если он доступен, или `None`.11051106Изменено в версии 3.1: В 3.1 это было изменено, чтобы добавлять имя теста в краткое описание даже при наличии докстринга. Это вызвало проблемы совместимости с расширениями unittest, и добавление имени теста было перенесено в [`TextTestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TextTestResult) в Python 3.2.11071108#### `addCleanup(function, /, *args, **kwargs)`11091110Добавляет функцию, которая будет вызвана после [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown) для очистки ресурсов, использованных во время теста. Функции вызываются в порядке, обратном порядку их добавления (LIFO). Они вызываются с теми позиционными и именованными аргументами, которые были переданы в `addCleanup()` при их добавлении.11111112Если [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp) завершается неудачей, то есть [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown) не вызывается, любые добавленные функции очистки всё равно будут вызваны.11131114Добавлено в версии 3.1.11151116#### `enterContext(cm)`11171118Входит в предоставленный [менеджер контекста](https://python-all.ru/3.15/glossary.html#term-context-manager). В случае успеха также добавляет его метод [`__exit__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__exit__) как функцию очистки с помощью [`addCleanup()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.addCleanup) и возвращает результат метода [`__enter__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__enter__).11191120Добавлено в версии 3.12.11211122#### `doCleanups()`11231124Этот метод вызывается безусловно после [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown) или после [`setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp), если `setUp()` вызывает исключение.11251126Он отвечает за вызов всех функций очистки, добавленных с помощью [`addCleanup()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.addCleanup). Если необходимо, чтобы функции очистки вызывались *до* [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown), то можно вызвать `doCleanups()` самостоятельно.11271128`doCleanups()` извлекает методы из стека функций очистки по одному, поэтому его можно вызывать в любой момент.11291130Добавлено в версии 3.1.11311132#### `classmethod addClassCleanup(function, /, *args, **kwargs)`11331134Добавляет функцию, которая будет вызвана после [`tearDownClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDownClass) для очистки ресурсов, использованных во время тестового класса. Функции вызываются в обратном порядке по сравнению с порядком их добавления (LIFO). Они вызываются с теми аргументами и именованными аргументами, которые были переданы в `addClassCleanup()` при их добавлении.11351136Если [`setUpClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUpClass) завершается ошибкой, то есть [`tearDownClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDownClass) не вызывается, то все добавленные функции очистки всё равно будут вызваны.11371138Добавлено в версии 3.8.11391140#### `classmethod enterClassContext(cm)`11411142Входит в предоставленный [менеджер контекста](https://python-all.ru/3.15/glossary.html#term-context-manager). В случае успеха также добавляет его метод [`__exit__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__exit__) как функцию очистки с помощью [`addClassCleanup()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.addClassCleanup) и возвращает результат метода [`__enter__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__enter__).11431144Добавлено в версии 3.12.11451146#### `classmethod doClassCleanups()`11471148Этот метод вызывается безусловно после [`tearDownClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDownClass) или после [`setUpClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUpClass), если `setUpClass()` вызывает исключение.11491150Он отвечает за вызов всех функций очистки, добавленных с помощью [`addClassCleanup()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.addClassCleanup). Если нужно, чтобы функции очистки вызывались *до* [`tearDownClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDownClass), то можно вызвать `doClassCleanups()` самостоятельно.11511152`doClassCleanups()` извлекает методы из стека функций очистки по одному, поэтому его можно вызывать в любой момент.11531154Добавлено в версии 3.8.11551156#### `class unittest.IsolatedAsyncioTestCase(methodName='runTest')`11571158Этот класс предоставляет API, похожий на [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), и также принимает корутины в качестве тестовых функций.11591160Добавлено в версии 3.8.11611162#### `loop_factory`11631164Значение *loop\_factory*, переданное в [`asyncio.Runner`](https://python-all.ru/3.15/library/asyncio-runner.html#asyncio.Runner). Переопределите его в подклассах с помощью [`asyncio.EventLoop`](https://python-all.ru/3.15/library/asyncio-eventloop.html#asyncio.EventLoop), чтобы не использовать систему политик asyncio.11651166Добавлено в версии 3.13.11671168#### `async asyncSetUp()`11691170Метод вызывается для подготовки тестового окружения. Он вызывается после [`TestCase.setUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUp), непосредственно перед вызовом тестового метода; любое исключение, возбуждённое этим методом, за исключением [`AssertionError`](https://python-all.ru/3.15/library/exceptions.html#AssertionError) или [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest), считается ошибкой, а не неудачей теста. Реализация по умолчанию ничего не делает.11711172#### `async asyncTearDown()`11731174Метод, вызываемый сразу после вызова тестового метода и записи результата. Вызывается перед [`tearDown()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDown). Вызывается даже если тестовый метод возбудил исключение, поэтому реализация в подклассах должна быть особенно осторожна при проверке внутреннего состояния. Любое исключение, возбуждённое этим методом, за исключением [`AssertionError`](https://python-all.ru/3.15/library/exceptions.html#AssertionError) или [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest), считается дополнительной ошибкой, а не неудачей теста (таким образом, увеличивая общее количество сообщённых ошибок). Этот метод вызывается только в случае успеха [`asyncSetUp()`](https://python-all.ru/3.15/library/unittest.html#unittest.IsolatedAsyncioTestCase.asyncSetUp), независимо от результата тестового метода. Реализация по умолчанию ничего не делает.11751176#### `addAsyncCleanup(function, /, *args, **kwargs)`11771178Этот метод принимает корутину, которая может использоваться как функция очистки.11791180#### `async enterAsyncContext(cm)`11811182Входит в предоставленный [асинхронный менеджер контекста](https://python-all.ru/3.15/glossary.html#term-asynchronous-context-manager). В случае успеха также добавляет его метод [`__aexit__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__aexit__) как функцию очистки с помощью [`addAsyncCleanup()`](https://python-all.ru/3.15/library/unittest.html#unittest.IsolatedAsyncioTestCase.addAsyncCleanup) и возвращает результат метода [`__aenter__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__aenter__).11831184Добавлено в версии 3.12.11851186#### `run(result=None)`11871188Настраивает новый цикл событий для выполнения теста, собирая результат в объект [`TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult), переданный как *result*. Если *result* опущен или равен `None`, создаётся временный объект результата (вызовом метода [`defaultTestResult()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.defaultTestResult)) и используется. Объект результата возвращается вызывающему `run()`. В конце теста все задачи в цикле событий отменяются.11891190Пример, иллюстрирующий порядок:11911192```python1193from unittest import IsolatedAsyncioTestCase11941195events = []11961197class Test(IsolatedAsyncioTestCase):11981199    def setUp(self):1200        events.append("setUp")12011202    async def asyncSetUp(self):1203        self._async_connection = await AsyncConnection()1204        events.append("asyncSetUp")12051206    async def test_response(self):1207        events.append("test_response")1208        response = await self._async_connection.get("https://example.com")1209        self.assertEqual(response.status_code, 200)1210        self.addAsyncCleanup(self.on_cleanup)12111212    def tearDown(self):1213        events.append("tearDown")12141215    async def asyncTearDown(self):1216        await self._async_connection.close()1217        events.append("asyncTearDown")12181219    async def on_cleanup(self):1220        events.append("cleanup")12211222if __name__ == "__main__":1223    unittest.main()1224```12251226После запуска теста `events` будет содержать `["setUp", "asyncSetUp", "test_response", "asyncTearDown", "tearDown", "cleanup"]`.12271228#### `class unittest.FunctionTestCase(testFunc, setUp=None, tearDown=None, description=None)`12291230Этот класс реализует ту часть интерфейса [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), которая позволяет исполнителю тестов управлять тестом, но не предоставляет методов, которые тестовый код может использовать для проверки и сообщения об ошибках. Это используется для создания тестовых примеров с использованием устаревшего тестового кода, что позволяет интегрировать его в тестовую среду на основе `unittest`.12311232### Группировка тестов12331234#### `class unittest.TestSuite(tests=())`12351236Этот класс представляет собой агрегацию отдельных тестовых примеров и тестовых наборов. Класс предоставляет интерфейс, необходимый исполнителю тестов, чтобы его можно было запускать как любой другой тестовый пример. Запуск экземпляра `TestSuite` равносилен итерации по набору с запуском каждого теста по отдельности.12371238Если задан *tests*, он должен быть итерабельным объектом, содержащим отдельные тестовые примеры или другие тестовые наборы, которые будут использоваться для первоначального построения набора. Дополнительные методы предоставляются для добавления тестовых примеров и наборов в коллекцию позже.12391240Объекты `TestSuite` ведут себя во многом как объекты [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), за исключением того, что они не реализуют фактический тест. Вместо этого они используются для объединения тестов в группы, которые должны запускаться вместе. Некоторые дополнительные методы доступны для добавления тестов в экземпляры `TestSuite`:12411242#### `addTest(test)`12431244Добавляет [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) или `TestSuite` в набор.12451246#### `addTests(tests)`12471248Добавляет все тесты из итерабельного объекта, содержащего экземпляры [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) и `TestSuite`, в этот тестовый набор.12491250Это эквивалентно итерации по *tests* с вызовом [`addTest()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite.addTest) для каждого элемента.12511252`TestSuite` разделяет следующие методы с [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase):12531254#### `run(result)`12551256Запускает тесты, связанные с этим набором, собирая результат в объект результата теста, переданный как *result*. Обратите внимание, что, в отличие от [`TestCase.run()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.run), `TestSuite.run()` требует, чтобы объект результата был передан.12571258#### `debug()`12591260Запускает тесты, связанные с этим набором, без сбора результата. Это позволяет исключениям, возбуждённым тестом, распространяться до вызывающего кода и может использоваться для поддержки запуска тестов под отладчиком.12611262#### `countTestCases()`12631264Возвращает количество тестов, представленных этим тестовым объектом, включая все отдельные тесты и поднаборы.12651266#### `__iter__()`12671268Тесты, сгруппированные с помощью `TestSuite`, всегда доступны через итерацию. Подклассы могут лениво предоставлять тесты, переопределяя `__iter__()`. Обратите внимание, что этот метод может вызываться несколько раз для одного набора (например, при подсчёте тестов или сравнении на равенство), поэтому тесты, возвращаемые повторными итерациями до [`TestSuite.run()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite.run), должны быть одинаковыми для каждого вызова итерации. После `TestSuite.run()` вызывающий код не должен полагаться на тесты, возвращаемые этим методом, если только вызывающий код не использует подкласс, который переопределяет `TestSuite._removeTestAtIndex()` для сохранения ссылок на тесты.12691270Изменено в версии 3.2: В более ранних версиях `TestSuite` обращался к тестам напрямую, а не через итерацию, поэтому переопределения `__iter__()` было недостаточно для предоставления тестов.12711272Изменено в версии 3.4: В более ранних версиях `TestSuite` хранил ссылки на каждый [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) после [`TestSuite.run()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite.run). Подклассы могут восстановить такое поведение, переопределив `TestSuite._removeTestAtIndex()`.12731274При типичном использовании объекта `TestSuite` метод [`run()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite.run) вызывается с помощью `TestRunner`, а не через тестовую оболочку конечного пользователя.12751276### Загрузка и запуск тестов12771278#### `class unittest.TestLoader`12791280Класс `TestLoader` используется для создания тестовых наборов из классов и модулей. Обычно нет необходимости создавать экземпляр этого класса; модуль `unittest` предоставляет экземпляр, который можно использовать совместно как [`unittest.defaultTestLoader`](https://python-all.ru/3.15/library/unittest.html#unittest.defaultTestLoader). Однако использование подкласса или экземпляра позволяет настраивать некоторые конфигурируемые свойства.12811282Объекты `TestLoader` имеют следующие атрибуты:12831284#### `errors`12851286Список нефатальных ошибок, возникших при загрузке тестов. Не сбрасывается загрузчиком ни в какой момент. Фатальные ошибки сигнализируются соответствующим методом, который генерирует исключение для вызывающего кода. Нефатальные ошибки также указываются синтетическим тестом, который при выполнении вызовет исходную ошибку.12871288Добавлено в версии 3.5.12891290Объекты `TestLoader` имеют следующие методы:12911292#### `loadTestsFromTestCase(testCaseClass)`12931294Возвращает набор всех тестов, содержащихся в `testCaseClass`, производном от [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase).12951296Экземпляр тестового случая создаётся для каждого метода, именованного [`getTestCaseNames()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader.getTestCaseNames). По умолчанию это имена методов, начинающиеся с `test`. Если `getTestCaseNames()` не возвращает ни одного метода, но метод `runTest()` реализован, то вместо этого создаётся один тестовый случай для этого метода.12971298#### `loadTestsFromModule(module, *, pattern=None)`12991300Возвращает набор всех тестовых случаев, содержащихся в данном модуле. Этот метод ищет в *module* классы, производные от [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), и создаёт экземпляр класса для каждого тестового метода, определённого для этого класса.13011302> **Примечание**1303>1304> Хотя использование иерархии классов, производных от [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), может быть удобным для совместного использования фикстур и вспомогательных функций, определение тестовых методов в базовых классах, которые не предназначены для прямого создания экземпляров, плохо сочетается с этим методом. Однако это может быть полезно, когда фикстуры различаются и определены в подклассах.13051306Если модуль предоставляет функцию `load_tests`, она будет вызвана для загрузки тестов. Это позволяет модулям настраивать загрузку тестов. Это называется [протокол load\_tests](https://python-all.ru/3.15/library/unittest.html#id1). Аргумент *pattern* передаётся как третий аргумент в `load_tests`.13071308Изменено в версии 3.2: Добавлена поддержка `load_tests`.13091310Изменено в версии 3.5: Добавлена поддержка аргумента, передаваемого только по ключу, *pattern*.13111312Изменено в версии 3.12: Незадокументированный и неофициальный параметр *use\_load\_tests* был удалён.13131314#### `loadTestsFromName(name, module=None)`13151316Возвращает набор всех тестовых случаев по заданному строковому спецификатору.13171318Спецификатор *name* – это «точечное имя», которое может указывать на модуль, класс тестового случая, тестовый метод внутри класса тестового случая, экземпляр [`TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite) или вызываемый объект, возвращающий экземпляр [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) или `TestSuite`. Эти проверки применяются в указанном порядке; то есть метод в возможном классе тестового случая будет распознан как «тестовый метод внутри класса тестового случая», а не как «вызываемый объект».13191320Например, если у вас есть модуль `SampleTests`, содержащий класс `SampleTestCase`, производный от [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), с тремя тестовыми методами (`test_one()`, `test_two()` и `test_three()`), спецификатор `'SampleTests.SampleTestCase'` заставит этот метод вернуть набор, который выполнит все три тестовых метода. Использование спецификатора `'SampleTests.SampleTestCase.test_two'` приведёт к возврату тестового набора, который выполнит только тестовый метод `test_two()`. Спецификатор может ссылаться на модули и пакеты, которые не были импортированы; они будут импортированы как побочный эффект.13211322Метод опционально разрешает *name* относительно заданного *module*.13231324Изменено в версии 3.5: Если при обходе *name* возникает [`ImportError`](https://python-all.ru/3.15/library/exceptions.html#ImportError) или [`AttributeError`](https://python-all.ru/3.15/library/exceptions.html#AttributeError), то будет возвращён синтетический тест, который при выполнении вызывает эту ошибку. Эти ошибки включаются в ошибки, накопленные self.errors.13251326#### `loadTestsFromNames(names, module=None)`13271328Аналогичен [`loadTestsFromName()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader.loadTestsFromName), но принимает последовательность имён, а не одно имя. Возвращаемое значение – тестовый набор, который включает все тесты, определённые для каждого имени.13291330#### `getTestCaseNames(testCaseClass)`13311332Возвращает отсортированную последовательность имён методов, найденных в *testCaseClass*; это должен быть подкласс [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase).13331334#### `discover(start_dir, pattern='test*.py', top_level_dir=None)`13351336Находит все тестовые модули, рекурсивно обходя подкаталоги, начиная с указанного каталога, и возвращает объект TestSuite, содержащий их. Будут загружены только тестовые файлы, соответствующие *pattern*. (Используется сопоставление с образцом в стиле shell.) Будут загружены только имена модулей, которые можно импортировать (т.е. являются допустимыми идентификаторами Python).13371338Все тестовые модули должны быть импортируемы из корневого каталога проекта. Если начальный каталог не является корневым, то *top\_level\_dir* необходимо указать отдельно.13391340Если импорт модуля завершается неудачей, например из-за синтаксической ошибки, это записывается как одна ошибка, и поиск продолжается. Если неудача импорта связана с возникновением [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest), это будет записано как пропуск, а не как ошибка.13411342Если найден пакет (каталог, содержащий файл с именем `__init__.py`), в пакете проверяется наличие функции `load_tests`. Если она существует, она вызывается с помощью `package.load_tests(loader, tests, pattern)`. Поиск тестов гарантирует, что пакет проверяется на наличие тестов только один раз за вызов, даже если сама функция load\_tests вызывает `loader.discover`.13431344Если `load_tests` существует, то поиск *не* рекурсирует в пакет, `load_tests` отвечает за загрузку всех тестов в пакете.13451346Шаблон намеренно не хранится как атрибут загрузчика, чтобы пакеты могли продолжать поиск самостоятельно.13471348*top\_level\_dir* хранится внутренне и используется по умолчанию для любых вложенных вызовов `discover()`. То есть, если `load_tests` пакета вызывает `loader.discover()`, ему не нужно передавать этот аргумент.13491350*start\_dir* может быть как точечным именем модуля, так и каталогом.13511352Добавлено в версии 3.2.13531354Изменено в версии 3.4: Модули, вызывающие [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest) при импорте, записываются как пропуски, а не ошибки.13551356*start\_dir* может быть [пакетом пространства имён](https://python-all.ru/3.15/glossary.html#term-namespace-package).13571358Пути сортируются перед импортом, чтобы порядок выполнения оставался одинаковым, даже если порядок в файловой системе не зависит от имени файла.13591360Изменено в версии 3.5: Найденные пакеты теперь проверяются на наличие `load_tests` независимо от того, соответствует ли их путь *pattern*, поскольку имя пакета не может соответствовать шаблону по умолчанию.13611362Изменено в версии 3.11: *start\_dir* не может быть [пакетом пространства имён](https://python-all.ru/3.15/glossary.html#term-namespace-package). Это было сломано начиная с Python 3.7, и Python 3.11 официально удаляет эту возможность.13631364Изменено в версии 3.13: *top\_level\_dir* сохраняется только на время вызова *discover*.13651366Изменено в версии 3.14: *start\_dir* снова может быть [пакетом пространства имён](https://python-all.ru/3.15/glossary.html#term-namespace-package).13671368Следующие атрибуты `TestLoader` можно настроить либо через наследование, либо через присваивание экземпляру:13691370#### `testMethodPrefix`13711372Строка, задающая префикс имён методов, которые будут интерпретироваться как тестовые методы. Значение по умолчанию – `'test'`.13731374Это влияет на [`getTestCaseNames()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader.getTestCaseNames) и все методы `loadTestsFrom*`.13751376#### `sortTestMethodsUsing`13771378Функция, используемая для сравнения имён методов при их сортировке в [`getTestCaseNames()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader.getTestCaseNames) и во всех методах `loadTestsFrom*`.13791380#### `suiteClass`13811382Вызываемый объект, который создаёт тестовый набор из списка тестов. Никакие методы результирующего объекта не требуются. Значение по умолчанию – класс [`TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite).13831384Это влияет на все методы `loadTestsFrom*`.13851386#### `testNamePatterns`13871388Список шаблонов имён тестов в стиле оболочки Unix (символы подстановки), которым должны соответствовать тестовые методы для включения в наборы тестов (см. опцию `-k`).13891390Если этот атрибут не равен `None` (по умолчанию), все тестовые методы, которые должны быть включены в тестовые наборы, должны соответствовать одному из шаблонов в этом списке. Обратите внимание, что сопоставление всегда выполняется с помощью [`fnmatch.fnmatchcase()`](https://python-all.ru/3.15/library/fnmatch.html#fnmatch.fnmatchcase), поэтому, в отличие от шаблонов, переданных опции `-k`, простые шаблоны подстрок придётся преобразовать с использованием подстановочных знаков `*`.13911392Это влияет на все методы `loadTestsFrom*`.13931394Добавлено в версии 3.7.13951396#### `class unittest.TestResult`13971398Этот класс используется для сбора информации о том, какие тесты прошли успешно, а какие завершились неудачей.13991400Объект `TestResult` хранит результаты набора тестов. Классы [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) и [`TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite) обеспечивают правильную запись результатов; авторам тестов не нужно беспокоиться о записи результатов тестов.14011402Тестовые фреймворки, построенные на базе `unittest`, могут нуждаться в доступе к объекту `TestResult`, созданному при запуске набора тестов для целей отчетности; для этого метод `TestRunner.run()` возвращает экземпляр `TestResult`.14031404Экземпляры `TestResult` имеют следующие атрибуты, которые будут интересны при проверке результатов запуска набора тестов:14051406#### `errors`14071408Список, содержащий 2-кортежи экземпляров [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) и строк с форматированными трассировками. Каждый кортеж представляет тест, вызвавший неожиданное исключение.14091410#### `failures`14111412Список, содержащий 2-кортежи экземпляров [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) и строк с форматированными трассировками. Каждый кортеж представляет тест, в котором сбой был явно обозначен с помощью методов [assert\*](https://python-all.ru/3.15/library/unittest.html#assert-methods).14131414#### `skipped`14151416Список, содержащий 2-кортежи экземпляров [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) и строк с причиной пропуска теста.14171418Добавлено в версии 3.1.14191420#### `expectedFailures`14211422Список, содержащий 2-кортежи экземпляров [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) и строк с форматированными трассировками. Каждый кортеж представляет ожидаемый сбой или ошибку тестового случая.14231424#### `unexpectedSuccesses`14251426Список, содержащий экземпляры [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), которые были помечены как ожидаемые сбои, но завершились успешно.14271428#### `collectedDurations`14291430Список, содержащий 2-кортежи имен тестовых случаев и чисел с плавающей точкой, представляющих затраченное время каждого запущенного теста.14311432Добавлено в версии 3.12.14331434#### `shouldStop`14351436Устанавливается в `True`, когда выполнение тестов должно быть остановлено с помощью [`stop()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.stop).14371438#### `testsRun`14391440Общее количество запущенных на данный момент тестов.14411442#### `buffer`14431444Если установлено в true, `sys.stdout` и `sys.stderr` будут буферизироваться между вызовами [`startTest()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.startTest) и [`stopTest()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.stopTest). Собранный вывод будет передаваться на реальные `sys.stdout` и `sys.stderr` только в случае сбоя или ошибки теста. Любой вывод также прикрепляется к сообщению о сбое/ошибке.14451446Добавлено в версии 3.2.14471448#### `failfast`14491450Если установлено в true, [`stop()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.stop) будет вызван при первой ошибке или сбое, останавливая выполнение теста.14511452Добавлено в версии 3.2.14531454#### `tb_locals`14551456Если установлено в true, то локальные переменные будут отображаться в трассировках.14571458Добавлено в версии 3.5.14591460#### `wasSuccessful()`14611462Возвращает `True`, если все запущенные на данный момент тесты пройдены, в противном случае возвращает `False`.14631464Изменено в версии 3.4: Возвращает `False`, если были какие-либо [`unexpectedSuccesses`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.unexpectedSuccesses) от тестов, помеченных декоратором [`expectedFailure()`](https://python-all.ru/3.15/library/unittest.html#unittest.expectedFailure).14651466#### `stop()`14671468Этот метод может быть вызван, чтобы указать, что выполняемый набор тестов должен быть прерван установкой атрибута [`shouldStop`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.shouldStop) в `True`. Объекты `TestRunner` должны учитывать этот флаг и возвращаться без запуска дополнительных тестов.14691470Например, эта возможность используется классом [`TextTestRunner`](https://python-all.ru/3.15/library/unittest.html#unittest.TextTestRunner) для остановки тестового фреймворка, когда пользователь подает сигнал прерывания с клавиатуры. Интерактивные инструменты, предоставляющие реализации `TestRunner`, могут использовать это аналогичным образом.14711472Следующие методы класса `TestResult` используются для поддержки внутренних структур данных и могут быть расширены в подклассах для поддержки дополнительных требований к отчетности. Это особенно полезно при создании инструментов, поддерживающих интерактивную отчетность во время выполнения тестов.14731474#### `startTest(test)`14751476Вызывается перед запуском тестового сценария *test*.14771478#### `stopTest(test)`14791480Вызывается после выполнения тестового сценария *test*, независимо от результата.14811482#### `startTestRun()`14831484Вызывается один раз перед выполнением любых тестов.14851486Добавлено в версии 3.1.14871488#### `stopTestRun()`14891490Вызывается один раз после выполнения всех тестов.14911492Добавлено в версии 3.1.14931494#### `addError(test, err)`14951496Вызывается, когда тестовый сценарий *test* порождает неожиданное исключение. *err* – кортеж вида, возвращаемого [`sys.exc_info()`](https://python-all.ru/3.15/library/sys.html#sys.exc_info): `(type, value, traceback)`.14971498Реализация по умолчанию добавляет кортеж `(test, formatted_err)` к атрибуту [`errors`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.errors) экземпляра, где *formatted\_err* – форматированная трассировка, полученная из *err*.14991500#### `addFailure(test, err)`15011502Вызывается, когда тестовый сценарий *test* сигнализирует о сбое. *err* – кортеж вида, возвращаемого [`sys.exc_info()`](https://python-all.ru/3.15/library/sys.html#sys.exc_info): `(type, value, traceback)`.15031504Реализация по умолчанию добавляет кортеж `(test, formatted_err)` к атрибуту [`failures`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.failures) экземпляра, где *formatted\_err* – форматированная трассировка, полученная из *err*.15051506#### `addSuccess(test)`15071508Вызывается, когда тестовый сценарий *test* завершается успешно.15091510Реализация по умолчанию ничего не делает.15111512#### `addSkip(test, reason)`15131514Вызывается, когда тестовый сценарий *test* пропускается. *reason* – причина, которую тест указал для пропуска.15151516Реализация по умолчанию добавляет кортеж `(test, reason)` к атрибуту [`skipped`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.skipped) экземпляра.15171518#### `addExpectedFailure(test, err)`15191520Вызывается, когда тестовый сценарий *test* завершается неудачей или ошибкой, но был помечен декоратором [`expectedFailure()`](https://python-all.ru/3.15/library/unittest.html#unittest.expectedFailure).15211522Реализация по умолчанию добавляет кортеж `(test, formatted_err)` к атрибуту [`expectedFailures`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.expectedFailures) экземпляра, где *formatted\_err* – форматированная трассировка, полученная из *err*.15231524#### `addUnexpectedSuccess(test)`15251526Вызывается, когда тестовый сценарий *test* был помечен декоратором [`expectedFailure()`](https://python-all.ru/3.15/library/unittest.html#unittest.expectedFailure), но завершился успешно.15271528Реализация по умолчанию добавляет тест к атрибуту [`unexpectedSuccesses`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.unexpectedSuccesses) экземпляра.15291530#### `addSubTest(test, subtest, outcome)`15311532Вызывается, когда завершается подтест. *test* – тестовый сценарий, соответствующий тестовому методу. *subtest* – пользовательский экземпляр [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), описывающий подтест.15331534Если *outcome* равен [`None`](https://python-all.ru/3.15/library/constants.html#None), подтест завершился успешно. В противном случае он завершился исключением, где *outcome* – кортеж вида, возвращаемого [`sys.exc_info()`](https://python-all.ru/3.15/library/sys.html#sys.exc_info): `(type, value, traceback)`.15351536Реализация по умолчанию ничего не делает, если результат – успех, и записывает сбои подтестов как обычные сбои.15371538Добавлено в версии 3.4.15391540#### `addDuration(test, elapsed)`15411542Вызывается после завершения тестового сценария. *elapsed* – время, выраженное в секундах, включающее выполнение функций очистки.15431544Добавлено в версии 3.12.15451546#### `class unittest.TextTestResult(stream, descriptions, verbosity, *, durations=None)`15471548Конкретная реализация [`TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult), используемая [`TextTestRunner`](https://python-all.ru/3.15/library/unittest.html#unittest.TextTestRunner). Подклассы должны принимать `**kwargs`, чтобы обеспечить совместимость при изменении интерфейса.15491550Добавлено в версии 3.2.15511552Изменено в версии 3.12: Добавлен именованный параметр *durations*.15531554#### `unittest.defaultTestLoader`15551556Экземпляр класса [`TestLoader`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader), предназначенный для совместного использования. Если настройка `TestLoader` не требуется, можно использовать этот экземпляр вместо повторного создания новых.15571558#### `class unittest.TextTestRunner(stream=None, descriptions=True, verbosity=1, failfast=False, buffer=False, resultclass=None, warnings=None, *, tb_locals=False, durations=None)`15591560Базовая реализация запуска тестов, которая выводит результаты в поток данных. Если *stream* равен `None` (значение по умолчанию), в качестве выходного потока данных используется [`sys.stderr`](https://python-all.ru/3.15/library/sys.html#sys.stderr). Этот класс имеет несколько настраиваемых параметров, но в целом очень прост. Графические приложения, запускающие наборы тестов, должны предоставлять альтернативные реализации. Такие реализации должны принимать `**kwargs`, поскольку интерфейс для создания запускаторов меняется при добавлении новых возможностей в unittest.15611562По умолчанию этот запускатор показывает [`DeprecationWarning`](https://python-all.ru/3.15/library/exceptions.html#DeprecationWarning), [`PendingDeprecationWarning`](https://python-all.ru/3.15/library/exceptions.html#PendingDeprecationWarning), [`ResourceWarning`](https://python-all.ru/3.15/library/exceptions.html#ResourceWarning) и [`ImportWarning`](https://python-all.ru/3.15/library/exceptions.html#ImportWarning), даже если они [игнорируются по умолчанию](https://python-all.ru/3.15/library/warnings.html#warning-ignored). Это поведение можно переопределить с помощью опций Python `-Wd` или `-Wa` (см. [Управление предупреждениями](https://python-all.ru/3.15/using/cmdline.html#using-on-warnings)), оставив *warnings* равным `None`.15631564Изменено в версии 3.2: Добавлен параметр *warnings*.15651566Изменено в версии 3.2: Поток по умолчанию устанавливается на [`sys.stderr`](https://python-all.ru/3.15/library/sys.html#sys.stderr) в момент создания экземпляра, а не при импорте.15671568Изменено в версии 3.5: Добавлен параметр *tb\_locals*.15691570Изменено в версии 3.12: Добавлен параметр *durations*.15711572#### `_makeResult()`15731574Этот метод возвращает экземпляр `TestResult`, используемый [`run()`](https://python-all.ru/3.15/library/unittest.html#unittest.TextTestRunner.run). Он не предназначен для прямого вызова, но может быть переопределён в подклассах для предоставления собственного `TestResult`.15751576`_makeResult()` создаёт экземпляр класса или вызываемого объекта, переданного в конструктор `TextTestRunner` как аргумент `resultclass`. По умолчанию используется [`TextTestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TextTestResult), если `resultclass` не предоставлен. Класс результата создаётся со следующими аргументами:15771578```python1579stream, descriptions, verbosity1580```15811582#### `run(test)`15831584Этот метод является основным публичным интерфейсом `TextTestRunner`. Он принимает экземпляр [`TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite) или [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase). [`TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult) создаётся вызовом [`_makeResult()`](https://python-all.ru/3.15/library/unittest.html#unittest.TextTestRunner._makeResult), после чего тест(ы) выполняются, а результаты выводятся в stdout.15851586#### `unittest.main(module='__main__', defaultTest=None, argv=None, testRunner=None, testLoader=unittest.defaultTestLoader, exit=True, verbosity=1, failfast=None, catchbreak=None, buffer=None, warnings=None)`15871588Программа командной строки, которая загружает набор тестов из *module* и запускает их; это в первую очередь для удобного выполнения тестовых модулей. Простейший способ использования этой функции – добавить следующую строку в конец тестового скрипта:15891590```python1591if __name__ == '__main__':1592    unittest.main()1593```15941595Можно запускать тесты с более подробной информацией, передав аргумент verbosity:15961597```python1598if __name__ == '__main__':1599    unittest.main(verbosity=2)1600```16011602Аргумент *defaultTest* может быть либо именем одного теста, либо итерируемым объектом с именами тестов для запуска, если имена тестов не указаны через *argv*. Если он не задан или равен `None`, а имена тестов не переданы через *argv*, выполняются все тесты, найденные в *module*.16031604Аргумент *argv* может быть списком параметров, переданных программе, где первый элемент – имя программы. Если он не задан или равен `None`, используются значения [`sys.argv`](https://python-all.ru/3.15/library/sys.html#sys.argv).16051606Аргумент *testRunner* может быть либо классом запускатора тестов, либо уже созданным экземпляром такого класса. По умолчанию `main` вызывает [`sys.exit()`](https://python-all.ru/3.15/library/sys.html#sys.exit) с кодом возврата, указывающим на успех (0) или неудачу (1) выполненных тестов. Код возврата 5 означает, что тесты не выполнялись или были пропущены.16071608Аргумент *testLoader* должен быть экземпляром [`TestLoader`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader) и по умолчанию равен [`defaultTestLoader`](https://python-all.ru/3.15/library/unittest.html#unittest.defaultTestLoader).16091610`main` поддерживает использование из интерактивного интерпретатора при передаче аргумента `exit=False`. При этом результат выводится в стандартный вывод без вызова [`sys.exit()`](https://python-all.ru/3.15/library/sys.html#sys.exit):16111612```python1613>>> from unittest import main1614>>> main(module='test_module', exit=False)1615```16161617Параметры *failfast*, *catchbreak* и *buffer* имеют тот же эффект, что и одноимённые [параметры командной строки](https://python-all.ru/3.15/library/unittest.html#command-line-options).16181619Аргумент *warnings* задаёт [фильтр предупреждений](https://python-all.ru/3.15/library/warnings.html#warning-filter), который следует использовать при выполнении тестов. Если он не указан, он останется `None` при передаче опции `-W` в **python** (см. [Управление предупреждениями](https://python-all.ru/3.15/using/cmdline.html#using-on-warnings)), в противном случае будет установлен в `'default'`.16201621Вызов `main` возвращает объект с атрибутом `result`, содержащим результат выполнения тестов в виде [`unittest.TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult).16221623Изменено в версии 3.1: Добавлен параметр *exit*.16241625Изменено в версии 3.2: Добавлены параметры *verbosity*, *failfast*, *catchbreak*, *buffer* и *warnings*.16261627Изменено в версии 3.4: Параметр *defaultTest* был изменён: теперь он также принимает итерируемый объект с именами тестов.16281629#### Протокол load\_tests16301631Добавлено в версии 3.2.16321633Модули или пакеты могут настраивать загрузку тестов из себя во время обычного запуска тестов или их обнаружения, реализуя функцию с именем `load_tests`.16341635Если тестовый модуль определяет `load_tests`, то он будет вызван функцией [`TestLoader.loadTestsFromModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader.loadTestsFromModule) со следующими аргументами:16361637```python1638load_tests(loader, standard_tests, pattern)1639```16401641где *pattern* передаётся напрямую из `loadTestsFromModule`. По умолчанию он равен `None`.16421643Она должна возвращать объект [`TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite).16441645*loader* – это экземпляр [`TestLoader`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader), выполняющий загрузку. *standard\_tests* – это тесты, которые будут загружены по умолчанию из модуля. Часто тестовые модули хотят только добавить или удалить тесты из стандартного набора. Третий аргумент используется при загрузке пакетов в рамках обнаружения тестов.16461647Типичная функция `load_tests`, загружающая тесты из определённого набора классов [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase), может выглядеть так:16481649```python1650test_cases = (TestCase1, TestCase2, TestCase3)16511652def load_tests(loader, tests, pattern):1653    suite = TestSuite()1654    for test_class in test_cases:1655        tests = loader.loadTestsFromTestCase(test_class)1656        suite.addTests(tests)1657    return suite1658```16591660Если обнаружение запускается в каталоге, содержащем пакет, либо из командной строки, либо вызовом [`TestLoader.discover()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestLoader.discover), то у пакета `__init__.py` проверяется наличие `load_tests`. Если такой функции нет, обнаружение рекурсивно обходит пакет, как если бы это был просто ещё один каталог. В противном случае обнаружение тестов пакета передаётся функции `load_tests`, которая вызывается со следующими аргументами:16611662```python1663load_tests(loader, standard_tests, pattern)1664```16651666Она должна возвращать объект [`TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite), представляющий все тесты из пакета. (`standard_tests` будет содержать только тесты, собранные из `__init__.py`.)16671668Поскольку шаблон передаётся в `load_tests`, пакет может продолжить (и, возможно, изменить) обнаружение тестов. Функция `load_tests`, которая ничего не делает, для тестового пакета может выглядеть так:16691670```python1671def load_tests(loader, standard_tests, pattern):1672    # корневой каталог, кэшированный на экземпляре загрузчика1673    this_dir = os.path.dirname(__file__)1674    package_tests = loader.discover(start_dir=this_dir, pattern=pattern)1675    standard_tests.addTests(package_tests)1676    return standard_tests1677```16781679Изменено в версии 3.5: Обнаружение больше не проверяет имена пакетов на соответствие *pattern* из-за невозможности соответствия имён пакетов шаблону по умолчанию.16801681## Фикстуры классов и модулей16821683Фикстуры на уровне класса и модуля реализованы в [`TestSuite`](https://python-all.ru/3.15/library/unittest.html#unittest.TestSuite). Когда набор тестов встречает тест из нового класса, вызывается [`tearDownClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.tearDownClass) предыдущего класса (если он есть), а затем [`setUpClass()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase.setUpClass) нового класса.16841685Аналогично, если тест из другого модуля, отличного от предыдущего, то запускается `tearDownModule` предыдущего модуля, а затем `setUpModule` нового модуля.16861687После выполнения всех тестов запускаются финальные `tearDownClass` и `tearDownModule`.16881689Обратите внимание, что общие фикстуры плохо совместимы с такими возможностями, как параллельное выполнение тестов, и нарушают изоляцию тестов. Их следует использовать с осторожностью.16901691Упорядочивание тестов по умолчанию, создаваемое загрузчиками тестов unittest, группирует все тесты из одних и тех же модулей и классов вместе. Это приводит к тому, что `setUpClass` / `setUpModule` (и т.д.) вызываются ровно один раз на класс и модуль. Если изменить порядок случайным образом, так что тесты из разных модулей и классов будут соседствовать друг с другом, то эти общие фикстуры могут вызываться несколько раз за один прогон тестов.16921693Общие фикстуры не предназначены для работы с наборами тестов, имеющими нестандартный порядок. `BaseTestSuite` всё ещё существует для фреймворков, которые не хотят поддерживать общие фикстуры.16941695Если во время выполнения одной из общих фикстур возникает исключение, тест помечается как ошибочный. Поскольку нет соответствующего экземпляра теста, создаётся объект `_ErrorHolder` (имеющий тот же интерфейс, что и [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase)) для представления ошибки. Если вы просто используете стандартный исполнитель тестов unittest, эта деталь не имеет значения, но если вы разработчик фреймворка, это может быть актуально.16961697### setUpClass и tearDownClass16981699Они должны быть реализованы как методы класса:17001701```python1702import unittest17031704class Test(unittest.TestCase):1705    @classmethod1706    def setUpClass(cls):1707        cls._connection = createExpensiveConnectionObject()17081709    @classmethod1710    def tearDownClass(cls):1711        cls._connection.destroy()1712```17131714Если нужно, чтобы `setUpClass` и `tearDownClass` базовых классов вызывались, необходимо вызвать их самостоятельно. Реализации в [`TestCase`](https://python-all.ru/3.15/library/unittest.html#unittest.TestCase) пусты.17151716Если во время выполнения `setUpClass` возникает исключение, тесты в классе не запускаются, и `tearDownClass` не выполняется. Пропущенные классы не будут выполнять `setUpClass` или `tearDownClass`. Если исключением является [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest), то класс будет помечен как пропущенный, а не как ошибочный.17171718### setUpModule и tearDownModule17191720Они должны быть реализованы как функции:17211722```python1723def setUpModule():1724    createConnection()17251726def tearDownModule():1727    closeConnection()1728```17291730Если в `setUpModule` возникает исключение, то ни один тест в модуле не будет запущен, и `tearDownModule` не будет выполнен. Если исключением является [`SkipTest`](https://python-all.ru/3.15/library/unittest.html#unittest.SkipTest), то модуль будет помечен как пропущенный, а не как ошибочный.17311732Чтобы добавить код очистки, который должен выполняться даже в случае исключения, используйте `addModuleCleanup`:17331734#### `unittest.addModuleCleanup(function, /, *args, **kwargs)`17351736Добавляет функцию, которая будет вызвана после [`tearDownModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.tearDownModule) для очистки ресурсов, использованных во время тестового класса. Функции вызываются в обратном порядке по сравнению с порядком их добавления (LIFO). Они вызываются с теми аргументами и именованными аргументами, которые были переданы в `addModuleCleanup()` при их добавлении.17371738Если [`setUpModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.setUpModule) завершается ошибкой, то есть [`tearDownModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.tearDownModule) не вызывается, то все добавленные функции очистки всё равно будут вызваны.17391740Добавлено в версии 3.8.17411742#### `unittest.enterModuleContext(cm)`17431744Входит в предоставленный [менеджер контекста](https://python-all.ru/3.15/glossary.html#term-context-manager). В случае успеха также добавляет его метод [`__exit__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__exit__) как функцию очистки с помощью [`addModuleCleanup()`](https://python-all.ru/3.15/library/unittest.html#unittest.addModuleCleanup) и возвращает результат метода [`__enter__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__enter__).17451746Добавлено в версии 3.12.17471748#### `unittest.doModuleCleanups()`17491750Эта функция вызывается безусловно после [`tearDownModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.tearDownModule) или после [`setUpModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.setUpModule), если `setUpModule()` вызывает исключение.17511752Он отвечает за вызов всех функций очистки, добавленных с помощью [`addModuleCleanup()`](https://python-all.ru/3.15/library/unittest.html#unittest.addModuleCleanup). Если нужно, чтобы функции очистки вызывались *до* [`tearDownModule()`](https://python-all.ru/3.15/library/unittest.html#unittest.tearDownModule), то можно вызвать `doModuleCleanups()` самостоятельно.17531754`doModuleCleanups()` извлекает методы из стека функций очистки по одному, поэтому его можно вызывать в любой момент.17551756Добавлено в версии 3.8.17571758## Обработка сигналов17591760Добавлено в версии 3.2.17611762Параметр командной строки [`-c/--catch`](https://python-all.ru/3.15/library/unittest.html#cmdoption-unittest-c) для unittest вместе с параметром `catchbreak` для [`unittest.main()`](https://python-all.ru/3.15/library/unittest.html#unittest.main) обеспечивают более удобную обработку control-C во время выполнения тестов. Когда поведение catch-break включено, control-C позволяет завершить текущий тест, после чего выполнение тестов завершается и выводятся все результаты на данный момент. Повторное нажатие control-C вызовет исключение [`KeyboardInterrupt`](https://python-all.ru/3.15/library/exceptions.html#KeyboardInterrupt) обычным образом.17631764Обработчик сигнала control-c старается оставаться совместимым с кодом или тестами, которые устанавливают собственный обработчик [`signal.SIGINT`](https://python-all.ru/3.15/library/signal.html#signal.SIGINT). Если обработчик `unittest` вызывается, но *не является* установленным обработчиком `signal.SIGINT`, то есть был заменён тестируемой системой и делегирован, то он вызывает стандартный обработчик. Обычно это ожидаемое поведение для кода, который заменяет установленный обработчик и делегирует ему. Для отдельных тестов, где требуется `unittest` отключить обработку control-c, можно использовать декоратор [`removeHandler()`](https://python-all.ru/3.15/library/unittest.html#unittest.removeHandler).17651766Существует несколько вспомогательных функций для разработчиков фреймворков, позволяющих включить обработку control-c в тестовых фреймворках.17671768#### `unittest.installHandler()`17691770Устанавливает обработчик control-c. Когда получен сигнал [`signal.SIGINT`](https://python-all.ru/3.15/library/signal.html#signal.SIGINT) (обычно в ответ на нажатие пользователем control-c), у всех зарегистрированных результатов вызывается [`stop()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.stop).17711772#### `unittest.registerResult(result)`17731774Регистрирует объект [`TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult) для обработки control-c. При регистрации результата сохраняется слабая ссылка на него, поэтому это не препятствует сборке мусора объекта результата.17751776Регистрация объекта [`TestResult`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult) не имеет побочных эффектов, если обработка control-c не включена, поэтому тестовые фреймворки могут безусловно регистрировать все создаваемые ими результаты, независимо от того, включена обработка или нет.17771778#### `unittest.removeResult(result)`17791780Удаляет зарегистрированный результат. После удаления результата [`stop()`](https://python-all.ru/3.15/library/unittest.html#unittest.TestResult.stop) больше не будет вызываться для этого объекта результата в ответ на control-c.17811782#### `unittest.removeHandler(function=None)`17831784При вызове без аргументов эта функция удаляет обработчик control-c, если он был установлен. Эту функцию также можно использовать как тестовый декоратор для временного удаления обработчика на время выполнения теста:17851786```python1787@unittest.removeHandler1788def test_signal_handling(self):1789    ...1790```1791