CKTIS / Python
Podtesty v unittest: rovnosť a očakávané výnimky
Overte viacero vstupov v jednej testovacej metóde, identifikujte neúspešné podtesty a odlíšte kontrolu rovnosti od kontroly očakávanej výnimky.
Verzia: Python 3.12
Syntax
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 Pythone 3.12 vracia unittest.TestCase.subTest správcu kontextu. Pomocou with self.subTest("popis", value=value): vymedzíte jeden podtest, napríklad jednu iteráciu cyklu. Voliteľná správa msg a pomenované argumenty **params identifikujú podtest v hlásení o zlyhaní; testovanej funkcii sa neodovzdávajú.
Bez režimu failfast neúspešná asercia ukončí aktuálny blok with, ale testovacia metóda za ním pokračuje a môže vykonať ďalšie podtesty. Podtesty nie sú samostatné testovacie metódy a nespúšťajú setUp() ani tearDown() osobitne. V režime failfast nepredpokladajte, že sa vykonajú ďalšie podtesty.
self.assertEqual(actual, expected) overuje rovnosť hodnôt (==), nie identitu objektov (is). Ak sa hodnoty nerovnajú, asercia zlyhá. Umiestnite ju dovnútra podtestu, aby hlásenie identifikovalo vstup, ktorý viedol k neočakávanému výsledku.
Vo forme s volateľným objektom self.assertRaises(ExpectedError, func, *args, **kwargs) zavolá func s uvedenými argumentmi. Odovzdajte func, nie func(...). Asercia uspeje, ak sa vyvolá očakávaná výnimka alebo jej podtrieda, zlyhá, ak sa nevyvolá žiadna výnimka, a inú výnimku nechá šíriť ďalej. Prípadne použite with self.assertRaises(ExpectedError): a zavolajte funkciu vnútri bloku.
Prí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ýsledok
Invalid input rejected tests=1, failures=1, errors=0
Očakávaná hodnota `13` pre `"12"` je zámerne nesprávna. Podtest pre `"-3"` prejde a prípad `"bad"` vypíše správu až po zachytení očakávanej výnimky `ValueError`. Súhrn uvádza jednu testovaciu metódu, jedno zlyhanie a žiadnu chybu. Ak počty zodpovedajú týmto hodnotám, skript sa skončí s návratovým kódom `0`.
Súvisiace lekcie
- Python · Lekcia 37 · Pokročilá · Verzia: 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