Тестирование в Python [unittest]. Часть 4. Пропуск тестов

Автор: | 15.09.2017

В рамках четвертой части цикла “Тестирование в Python [unittest]” изучим вопрос пропуска тестов. Будет рассмотрен условный и безусловный пропуск тестов, а также пропуск всех тестов внутри класса.

  1. Подготовка
  2. Пропуск отдельных тестов в классе
    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)

<<< Тестирование в Python [unittest]. Часть 3

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *