CKTIS / Python
Dílčí testy v unittest: rovnost a očekávané výjimky
Ověřte více vstupů v jedné testovací metodě, rozpoznejte neúspěšné dílčí testy a odlište kontrolu rovnosti od kontroly očekávané výjimky.
Verze: Python 3.12
Syntaxe
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)V Pythonu 3.12 vrací unittest.TestCase.subTest správce kontextu. Pomocí with self.subTest("popis", value=value): vymezíte jeden dílčí test, například jednu iteraci cyklu. Volitelná zpráva msg a pojmenované argumenty **params identifikují dílčí test v hlášení o selhání; testované funkci se nepředávají.
Bez režimu failfast neúspěšná aserce ukončí aktuální blok with, ale testovací metoda za ním pokračuje a může spustit další dílčí testy. Dílčí testy nejsou samostatné testovací metody a nespouštějí setUp() ani tearDown() zvlášť. V režimu failfast nepředpokládejte, že se následující dílčí testy provedou.
self.assertEqual(actual, expected) ověřuje rovnost hodnot (==), nikoli totožnost objektů (is). Pokud se hodnoty nerovnají, aserce selže. Umístěte ji do dílčího testu, aby hlášení označilo vstup, který vedl k neočekávanému výsledku.
Ve formě s volatelným objektem self.assertRaises(ExpectedError, func, *args, **kwargs) zavolá func s předanými argumenty. Předejte func, nikoli func(...). Aserce uspěje při vyvolání očekávané výjimky nebo její podtřídy, selže, pokud se žádná výjimka nevyvolá, a neodpovídající výjimku nechá šířit dál. Případně použijte with self.assertRaises(ExpectedError): a zavolejte funkci uvnitř bloku.
Příklady
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)
Výsledek
Invalid input rejected tests=1, failures=1, errors=0
Očekávaná hodnota `13` pro `"12"` je záměrně chybná. Dílčí test pro `"-3"` projde a případ `"bad"` vypíše zprávu až po zachycení očekávané výjimky `ValueError`. Souhrn uvádí jednu testovací metodu, jedno selhání a žádnou chybu. Pokud počty odpovídají těmto hodnotám, skript skončí s návratovým kódem `0`.
Související lekce
- Python · Lekce 37 · Pokročilá · Verze: 5
Zdroje
- 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