CKTIS / Python
Podtesti v unittest: enakost in pričakovane izjeme
Preveri več vhodov v eni testni metodi, prepoznaj neuspele podteste in razlikuj preverjanje enakosti od preverjanja pričakovane izjeme.
Različica: Python 3.12
Sintaksa
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 metoda unittest.TestCase.subTest vrne upravljalnik konteksta. Z with self.subTest("oznaka", value=value): označiš blok kot en podtest, na primer za eno ponovitev zanke. Neobvezno sporočilo msg in poimenovani argumenti **params označijo podtest v poročilu o neuspehu; testirani funkciji se ne posredujejo.
Brez načina failfast neuspelo preverjanje prekine trenutni blok with, vendar se testna metoda nadaljuje za blokom in lahko izvede naslednje podteste. Podtesti niso ločene testne metode in ne izvajajo setUp() ali tearDown() ločeno. V načinu failfast ne predvidevaj, da se bodo poznejši podtesti izvedli.
self.assertEqual(actual, expected) preveri enakost vrednosti (==), ne identitete objektov (is). Če vrednosti nista enaki, preverjanje ne uspe. Postavi ga v podtest, da bo poročilo označilo vhod, ki je dal nepričakovan rezultat.
V obliki s klicljivim objektom self.assertRaises(ExpectedError, func, *args, **kwargs) pokliče func z navedenimi argumenti. Posreduj func, ne func(...). Preverjanje uspe, če se sproži pričakovana izjema ali njen podrazred, ne uspe, če se ne sproži nobena izjema, in neusklajeno izjemo prepusti nadaljnji obravnavi. Lahko pa uporabiš with self.assertRaises(ExpectedError): in funkcijo pokličeš znotraj bloka.
Primeri
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)
Rezultat
Invalid input rejected tests=1, failures=1, errors=0
Pričakovana vrednost `13` za `"12"` je namenoma napačna. Podtest za `"-3"` uspe, primer `"bad"` pa izpiše sporočilo šele po tem, ko je prestrežena pričakovana izjema `ValueError`. Povzetek šteje eno testno metodo, eno neuspešno preverjanje in nič napak. Če se števila ujemajo s temi vrednostmi, se skript konča z izhodno kodo `0`.
Povezane lekcije
- Python · Lekcija 37 · Napredna · Različica: 5
Viri
- 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