Тестирование в Python [unittest]. Часть 4. Пропуск тестов
Nuances of programmingПредыдушие части: Часть 1, Часть 2, Часть 3
Подготовка
В качестве тестируемого модуля будем использовать расширенный модуль calc.py из части 3.
Модуль calc.py
def add(a, b):
return a + b
def sub(a, b):
return a-b
def mul(a, b):
return a * b
def div(a, b):
return a / b
def sqrt(a):
return a**0.5
def pow(a, b):
return a**b
Также возьмем оттуда модуль с тестами.
Модуль calc_tests.py
import unittest
import calc
class CalcBasicTests(unittest.TestCase):
def test_add(self):
self.assertEqual(calc.add(1, 2), 3)
def test_sub(self):
self.assertEqual(calc.sub(4, 2), 2)
def test_mul(self):
self.assertEqual(calc.mul(2, 5), 10)
def test_div(self):
self.assertEqual(calc.div(8, 4), 2)
class CalcExTests(unittest.TestCase):
def test_sqrt(self):
self.assertEqual(calc.sqrt(4), 2)
def test_pow(self):
self.assertEqual(calc.pow(3, 3), 27)
И модуль для запуска тестов test_runner.py.
Модуль test_runner.py
import unittest import calc_tests calcTestSuite = unittest.TestSuite() calcTestSuite.addTest(unittest.makeSuite(calc_tests.CalcBasicTests)) calcTestSuite.addTest(unittest.makeSuite(calc_tests.CalcExTests)) runner = unittest.TextTestRunner(verbosity=2) runner.run(calcTestSuite)
Пропуск отдельных тестов в классе
Безусловный пропуск тестов
Для начала запустим модуль test_runner.py (о запуске тестов можно прочитать в третьей части цикла). Получим следующий результат:
test_add (calc_tests.CalcBasicTests) ... ok test_div (calc_tests.CalcBasicTests) ... ok test_mul (calc_tests.CalcBasicTests) ... ok test_sub (calc_tests.CalcBasicTests) ... ok test_pow (calc_tests.CalcExTests) ... ok test_sqrt (calc_tests.CalcExTests) ... ok ---------------------------------------------------------------------- Ran 6 tests in 0.002s OK
Исключим тест test_add из списка тестов. При попытке решить такую задачу, первое, что может прийти на ум – это удалить либо закомментировать данный тест. Но unittest предоставляет нам инструменты для удобного управление процессом пропуска тестов. Это может быть ещё полезно в том плане, что информацию о пропущенных тестах (их количестве) можно дополнительно получить через специальный API, предоставляемый классом TestResult. Для пропуска теста воспользуемся декоратором, который пишется перед тестом.
@unittest.skip(reason)
Модифицируем класс CalcBasicTests из модуля calc_tests.py:
class CalcBasicTests(unittest.TestCase):
@unittest.skip("Temporaly skip test_add")
def test_add(self):
self.assertEqual(calc.add(1, 2), 3)
def test_sub(self):
self.assertEqual(calc.sub(4, 2), 2)
def test_mul(self):
self.assertEqual(calc.mul(2, 5), 10)
def test_div(self):
self.assertEqual(calc.div(8, 4), 2)
И снова запустим test_runner.py.
test_add (calc_tests.CalcBasicTests) ... skipped 'Temporarily skipped' test_div (calc_tests.CalcBasicTests) ... ok test_mul (calc_tests.CalcBasicTests) ... ok test_sub (calc_tests.CalcBasicTests) ... ok test_pow (calc_tests.CalcExTests) ... ok test_sqrt (calc_tests.CalcExTests) ... ok ---------------------------------------------------------------------- Ran 6 tests in 0.003s OK (skipped=1)
Как видно из примера, был пропущен один тест – test_add.
Условный пропуск тестов
Для условного пропуска тестов применяются следующие декораторы:
@unittest.skipIf(condition, reason)
Тест будет пропущен, если условие (condition) истинно.
@unittest.skipUnless(condition, reason)
Тест будет пропущен если, условие (condition) не истинно.
Условный пропуск тестов можно использовать в ситуациях, когда те или иные тесты зависят от версии программы, например: в новой версии уже не поддерживается часть методов; или тесты могут быть платформозависимые, например: ряд тестов могут выполняться только под операционной системой MS Windows. Условие записывается в параметр condition, текстовое описание – в reason.
Пропуск классов
Для пропуска классов используется декоратор
@unittest.skip(reason)
который записывается перед объявлением класса. В результате все тесты из данного класса не будут выполнены. В рамках нашего примера с математическими действиями, для исключения из процесса тестирования методов sqrt и pow поместим декоратор skip перед объявлением класса CalcExTests.
Модуль calc_tests.py
import unittest
import calc
class CalcBasicTests(unittest.TestCase):
def test_add(self):
self.assertEqual(calc.add(1, 2), 3)
def test_sub(self):
self.assertEqual(calc.sub(4, 2), 2)
def test_mul(self):
self.assertEqual(calc.mul(2, 5), 10)
def test_div(self):
self.assertEqual(calc.div(8, 4), 2)
@unittest.skip("Skip CalcExTests")
class CalcExTests(unittest.TestCase):
def test_sqrt(self):
self.assertEqual(calc.sqrt(4), 2)
def test_pow(self):
self.assertEqual(calc.pow(3, 3), 27)
Результат будет следующим:
test_add (calc_tests.CalcBasicTests) ... ok test_div (calc_tests.CalcBasicTests) ... ok test_mul (calc_tests.CalcBasicTests) ... ok test_sub (calc_tests.CalcBasicTests) ... ok test_pow (calc_tests.CalcExTests) ... skipped 'Skip CalcExTests' test_sqrt (calc_tests.CalcExTests) ... skipped 'Skip CalcExTests' ---------------------------------------------------------------------- Ran 6 tests in 0.001s OK (skipped=2)