Представьте, что вы написали какую-либо программу, а теперь хотите проверить, правильно ли она работает. Что вы для этого сделаете? Скорее всего, вы запустите её несколько раз с различными входными данными, и убедитесь в правильности выдаваемого ответа. А теперь вы что-то поменяли и снова хотите проверить корректность программы. Запускать ещё несколько раз? А если потом снова что-то поменяется? Нельзя ли как-то автоматизировать это дело? Оказывается, можно. В Python встроен модуль unittest, который поддерживает автоматизацию тестов, использование общего кода для настройки и завершения тестов, объединение тестов в группы, а также позволяет отделять тесты от фреймворка для вывода информации. Для автоматизации тестов, unittest поддерживает некоторые важные коцепции:
Модуль unittest предоставляет богатый набор инструментов для написания и запуска тестов. Однако достаточно лишь некоторых из них, чтобы удовлетворить потребности большинства пользователей. Вот короткий скрипт для тестирования трех методов строк: import unittest class TestStringMethods(unittest.TestCase): def test_upper(self): self.assertEqual('foo'.upper(), 'FOO') def test_isupper(self): self.assertTrue('FOO'.isupper()) self.assertFalse('Foo'.isupper()) def test_split(self): s = 'hello world' self.assertEqual(s.split(), ['hello', 'world']) # Проверим, что s.split не работает, если разделитель - не строка with self.assertRaises(TypeError): s.split(2) if __name__ == '__main__': unittest.main() Тестовый случай создаётся путём наследования от unittest.TestCase. 3 отдельных теста определяются с помощью методов, имя которых начинается на test. Это соглашение говорит исполнителю тестов о том, какие методы являются тестами. Суть каждого теста - вызов assertEqual() для проверки ожидаемого результата;assertTrue() или assertFalse() для проверки условия; assertRaises() для проверки, что метод порождает исключение. Эти методы используются вместо обычного assert для того, чтобы исполнитель тестов смог взять все результаты и оформить отчёт. Методы setUp() и tearDown() (которые в данном простом случае не нужны) позволяют определять инструкции, выполняемые перед и после каждого теста, соответственно. Последние 2 строки показывают простой способ запуска тестов. unittest.main() предоставляет интерфейс командной строки для тестирования программы. Будучи запущенным из командной строки, этот скрипт выводит отчёт, подобный этому: ... ---------------------------------------------------------------------- Ran 3 tests in 0.000s OK Интерфейс командной строкиunittest может быть использован из командной строки для запуска модулей с тестами, классов или даже отдельных методов: python -m unittest test_module1 test_module2 python -m unittest test_module.TestClass python -m unittest test_module.TestClass.test_method Можно также указывать путь к файлу: python -m unittest tests/test_something.py С помощью флага -v можно получить более детальный отчёт: python -m unittest -v test_module Для нашего примера подробный отчёт будет таким: test_isupper (__main__.TestStringMethods) ... ok test_split (__main__.TestStringMethods) ... ok test_upper (__main__.TestStringMethods) ... ok ---------------------------------------------------------------------- Ran 3 tests in 0.001s OK -b (--buffer) - вывод программы при провале теста будет показан, а не скрыт, как обычно. -c (--catch) - Ctrl+C во время выполнения теста ожидает завершения текущего теста и затем сообщает результаты на данный момент. Второе нажатие Ctrl+C вызывает обычное исключение KeyboardInterrupt. -f (--failfast) - выход после первого же неудачного теста. --locals (начиная с Python 3.5) - показывать локальные переменные для провалившихся тестов. Обнаружение тестовunittest поддерживает простое обнаружение тестов. Для совместимости с обнаружением тестов, все файлы тестов должны быть модулями или пакетами, импортируемыми из директории верхнего уровня проекта (см. подробнее о правилах наименования модулей ). Обнаружение тестов реализовано в TestLoader.discover(), но может быть использовано из командной строки:
cd project_directory
python -m unittest discover
-v (--verbose) - подробный вывод. -s (--start-directory) directory_name - директория начала обнаружения тестов (текущая по умолчанию). -p (--pattern) pattern - шаблон названия файлов с тестами (по умолчанию test*.py). -t (--top-level-directory) directory_name - директория верхнего уровня проекта (по умолчанию равна start-directory). Организация тестового кодаБазовые блоки тестирования это тестовые случаи - простые случаи, которые должны быть проверены на корректность. Тестовый случай создаётся путём наследования от unittest.TestCase. Тестирующий код должен быть самостоятельным, то есть никак не зависеть от других тестов. Простейший подкласс TestCase может просто реализовывать тестовый метод (метод, начинающийся с test). Вымышленный пример: import unittest class DefaultWidgetSizeTestCase(unittest.TestCase): def test_default_widget_size(self): widget = Widget('The widget') self.assertEqual(widget.size(), (50, 50)) Заметьте, что для того, чтобы проверить что-то, мы используем один из assert\*() методов. Тестов может быть много, и часть кода настройки может повторяться. К счастью, мы можем определить код настройки путём реализации метода setUp(), который будет запускаться перед каждым тестом: import unittest class SimpleWidgetTestCase(unittest.TestCase): def setUp(self): self.widget = Widget('The widget') def test_default_widget_size(self): self.assertEqual(self.widget.size(), (50,50), 'incorrect default size') def test_widget_resize(self): self.widget.resize(100,150) self.assertEqual(self.widget.size(), (100,150), 'wrong size after resize') Мы также можем определить метод tearDown(), который будет запускаться после каждого теста: import unittest class SimpleWidgetTestCase(unittest.TestCase): def setUp(self): self.widget = Widget('The widget') def tearDown(self): self.widget.dispose() Можно разместить все тесты в том же файле, что и сама программа (таком как widgets.py), но размещение тестов в отдельном файле (таком как test_widget.py) имеет много преимуществ:
| |
|
| |
| Просмотров: 493 | |
| Всего комментариев: 0 | |