CKTIS / Python
Подтестове в unittest: равенство и очаквани изключения
Проверявайте няколко входни стойности в един тестов метод, разпознавайте неуспешните подтестове и различавайте проверката за равенство от проверката за изключение.
Версия: Python 3.12
Синтаксис
with self.subTest("case label", value=value):
self.assertEqual(actual, expected)
with self.subTest(value=value):
self.assertRaises(ExpectedError, func, *args, **kwargs)
with self.assertRaises(ExpectedError):
func(*args, **kwargs)В Python 3.12 unittest.TestCase.subTest връща контекстен мениджър. Използвайте with self.subTest("етикет", value=value):, за да обособите блок като един подтест, например за една итерация на цикъл. Незадължителното съобщение msg и именуваните аргументи **params обозначават подтеста в отчета за неуспех; те не се предават на проверяваната функция.
Без failfast неуспешната проверка прекъсва текущия блок with, но тестовият метод продължава след него и може да изпълни следващите подтестове. Подтестовете не са отделни тестови методи и не изпълняват setUp() и tearDown() поотделно. При включен failfast не разчитайте, че следващите подтестове ще се изпълнят.
self.assertEqual(actual, expected) проверява равенство на стойностите (==), а не идентичност на обектите (is). Ако стойностите не са равни, проверката е неуспешна. Поставете я в подтеста, за да показва отчетът кой вход е довел до неочаквания резултат.
Във формата с извикваем обект self.assertRaises(ExpectedError, func, *args, **kwargs) извиква func с подадените аргументи. Подайте func, а не func(...). Проверката е успешна, ако се породи очакваното изключение или изключение от негов подклас, неуспешна е, ако няма изключение, и не прихваща несъответстващо изключение. Друг вариант е with self.assertRaises(ExpectedError): с извикване на функцията вътре в блока.
Примери
import unittest
class ParseTests(unittest.TestCase):
def test_parse(self):
for text, expected in [("12", 13), ("-3", -3)]:
with self.subTest("valid integer", text=text):
self.assertEqual(int(text), expected)
with self.subTest("invalid integer", text="bad"):
self.assertRaises(ValueError, int, "bad")
print("Invalid input rejected")
if __name__ == "__main__":
result = ParseTests("test_parse").run()
tests, failures, errors = result.testsRun, len(result.failures), len(result.errors)
print(f"tests={tests}, failures={failures}, errors={errors}")
# The demonstration succeeds only if it records the deliberate failure.
if (tests, failures, errors) != (1, 1, 0):
raise SystemExit(1)
Резултат
Invalid input rejected tests=1, failures=1, errors=0
Очакваната стойност `13` за `"12"` е умишлено неправилна. Подтестът за `"-3"` е успешен, а случаят `"bad"` отпечатва съобщението едва след прихващане на очакваното изключение `ValueError`. Обобщението отчита един тестов метод, една неуспешна проверка и нула грешки. Скриптът завършва с код `0`, ако отчетените бройки съвпадат с тези стойности.
Свързани уроци
- Python · Урок 37 · Напреднало · Версия: 5
Източници
- Python 3.12 unittest — TestCase.subTest
- Python 3.12 unittest — Distinguishing test iterations using subtests
- Python 3.12 unittest — TestCase.assertEqual
- Python 3.12 unittest — TestCase.assertRaises
- Python 3.12 unittest — TestCase.run
- Python 3.12 unittest — TestResult.addSubTest
- Python 3.12 unittest — failfast command-line option