CKTIS / Python
Тестване на изключения с assertRaises
Използвай `unittest.TestCase.assertRaises` с извикваем обект или в блок `with`, за да провериш дали дадена операция поражда очакваното изключение.
Версия: Python 3.12
Синтаксис
self.assertRaises(exception, callable, *args, **kwds)
with self.assertRaises(exception, msg=None) as cm:
operation()
# After a matching exception, inspect cm.exception.В Python 3.12 assertRaises е метод на unittest.TestCase. Подай клас на изключение, а не негова инстанция, или кортеж от класове, ако са допустими няколко типа. Подклас на очакван клас също съвпада. Съвпадащото изключение се прихваща и проверката минава. Ако не възникне изключение, проверката се проваля. Несъвпадащото изключение се разпространява и обикновено се отчита като грешка при теста.
Във формата с извикваем обект напиши self.assertRaises(ValueError, parse_port, "0"). Подай самата функция parse_port, а позиционните и именуваните ѝ аргументи посочи отделно. Не подавай резултата от parse_port("0"): това извикване би се изпълнило, преди проверката да може да прихване изключението.
Във формата с контекстен мениджър напиши with self.assertRaises(ValueError) as cm: и постави в блока само операцията, която трябва да предизвика изключението. Ако друга операция предизвика изключение от същия тип, проверката може да мине по погрешна причина. След блока cm.exception съдържа прихванатата инстанция. Незадължителният msg= в тази форма задава съобщение при неуспешна проверка, а не шаблон за текста на изключението. За проверка на текста с регулярен израз използвай assertRaisesRegex.
setUp() подготвя данните преди всеки тестов метод, а не преди всеки блок subTest(). assertEqual проверява резултатите за валидни входни данни и може да сравни и текста на прихванатото изключение. subTest(invalid=invalid) обозначава всяка итерация със стойността, която ще се появи в отчета при неуспешен подтест.
Примери
import io
import unittest
def parse_port(text):
port = int(text)
if not 1 <= port <= 65535:
raise ValueError("port must be between 1 and 65535")
return port
class PortTests(unittest.TestCase):
def setUp(self):
self.default_port = "80"
self.highest_port = "65535"
def test_context_form(self):
self.assertEqual(parse_port(self.default_port), 80)
self.assertEqual(parse_port(self.highest_port), 65535)
with self.assertRaises(ValueError) as cm:
parse_port("0")
self.assertEqual(str(cm.exception), "port must be between 1 and 65535")
def test_callable_form(self):
for invalid, valid, expected in (("0", "1", 1), ("65536", self.highest_port, 65535)):
with self.subTest(invalid=invalid):
self.assertEqual(parse_port(valid), expected)
self.assertRaises(ValueError, parse_port, invalid)
if __name__ == "__main__":
log = io.StringIO()
suite = unittest.defaultTestLoader.loadTestsFromTestCase(PortTests)
result = unittest.TextTestRunner(stream=log).run(suite)
if not result.wasSuccessful():
raise SystemExit(log.getvalue())
print(f"OK ({result.testsRun} tests)")
Резултат
OK (2 tests)
Примерът проверява валидни портове, прихваща изключението за `"0"` и сравнява текста му. После в обозначени подтестове проверява дали `"0"` и `"65536"` се отхвърлят. Персонализираното обобщение брои двата тестови метода, а не итерациите на подтестовете.
Свързани уроци
- Python · Урок 37 · Напреднало · Версия: 5
- Python · Урок 34 · Средно · Версия: 3
Източници
- unittest — Unit testing framework: TestCase.assertRaises (Python 3.12)
- unittest — Unit testing framework: TestCase.assertRaisesRegex (Python 3.12)
- unittest — Unit testing framework: TestCase.setUp (Python 3.12)
- unittest — Unit testing framework: TestCase.assertEqual (Python 3.12)
- unittest — Unit testing framework: TestCase.subTest (Python 3.12)
- unittest — Unit testing framework: TextTestRunner (Python 3.12)