CKTIS / Python
Testiranje iznimaka metodom assertRaises
S pomoću `unittest.TestCase.assertRaises` provjeri podiže li operacija očekivanu iznimku, bilo predajom pozivljivog objekta bilo u bloku `with`.
Verzija: Python 3.12
Sintaksa
self.assertRaises(exception, callable, *args, **kwds)
with self.assertRaises(exception, msg=None) as cm:
operation()
# After a matching exception, inspect cm.exception.U Pythonu 3.12 assertRaises je metoda klase unittest.TestCase. Predaj klasu iznimke, ne instancu, ili n-torku klasa ako je prihvatljivo više tipova. Odgovara i podklasa očekivane klase. Ako iznimka odgovara, metoda je hvata i provjera prolazi. Ako se ne podigne nijedna iznimka, provjera ne prolazi. Iznimka koja ne odgovara širi se dalje i obično se prijavljuje kao pogreška testa.
U obliku s pozivljivim objektom napiši self.assertRaises(ValueError, parse_port, "0"). Predaj samu funkciju parse_port, a njezine pozicijske i imenovane argumente navedi zasebno. Nemoj predati rezultat poziva parse_port("0"): taj bi se poziv izvršio prije nego što provjera može uhvatiti iznimku.
U obliku s upraviteljem konteksta napiši with self.assertRaises(ValueError) as cm: i u blok stavi samo operaciju koja treba podići iznimku. Ako neka druga operacija podigne isti tip iznimke, provjera može proći iz pogrešnog razloga. Nakon bloka cm.exception sadrži uhvaćenu instancu. Neobavezni msg= u tom obliku određuje poruku ako provjera ne prođe, a ne uzorak za tekst iznimke. Za provjeru teksta regularnim izrazom upotrijebi assertRaisesRegex.
setUp() priprema podatke prije svake testne metode, a ne prije svakog bloka subTest(). assertEqual provjerava rezultate za valjane ulaze i može usporediti tekst uhvaćene iznimke. subTest(invalid=invalid) označava svaku iteraciju vrijednošću koja će se prikazati u izvješću ako podtest ne prođe.
Primjeri
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)")
Rezultat
OK (2 tests)
Primjer provjerava valjane portove, hvata iznimku za `"0"` i uspoređuje njezin tekst. Zatim u označenim podtestovima provjerava odbacuju li se `"0"` i `"65536"`. Prilagođeni sažetak broji dvije testne metode, a ne iteracije podtestova.
Povezane lekcije
- Python · Lekcija 37 · Napredno · Verzija: 5
- Python · Lekcija 34 · Srednje · Verzija: 3
Izvori
- 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)