CKTIS / Python
Testování výjimek pomocí assertRaises
Pomocí `unittest.TestCase.assertRaises` ověř, že operace vyvolá očekávanou výjimku, a to předáním volatelného objektu nebo v bloku `with`.
Verze: Python 3.12
Syntaxe
self.assertRaises(exception, callable, *args, **kwds)
with self.assertRaises(exception, msg=None) as cm:
operation()
# After a matching exception, inspect cm.exception.V Pythonu 3.12 je assertRaises metoda třídy unittest.TestCase. Předej třídu výjimky, ne její instanci, nebo n-tici tříd, pokud připouštíš více typů. Vyhovuje i podtřída očekávané třídy. Odpovídající výjimka se zachytí a aserce projde. Pokud se žádná výjimka nevyvolá, aserce selže. Neodpovídající výjimka se šíří dál a obvykle se vykáže jako chyba testu.
Ve variantě s volatelným objektem napiš self.assertRaises(ValueError, parse_port, "0"). Předej samotnou funkci parse_port a její poziční a pojmenované argumenty uveď zvlášť. Nepředávej výsledek parse_port("0"): funkce by se zavolala dřív, než by aserce mohla výjimku zachytit.
Ve variantě se správcem kontextu napiš with self.assertRaises(ValueError) as cm: a do bloku vlož jen operaci, která má výjimku vyvolat. Kdyby stejný typ vyvolala jiná operace, aserce by mohla projít ze špatného důvodu. Po bloku obsahuje cm.exception zachycenou instanci. Volitelné msg= v této variantě určuje zprávu při selhání aserce, nikoli vzor pro text výjimky. K ověření textu regulárním výrazem použij assertRaisesRegex.
setUp() připraví data před každou testovací metodou, ne před každým blokem subTest(). assertEqual kontroluje výsledky pro platné vstupy a může porovnat také text zachycené výjimky. subTest(invalid=invalid) označí každou iteraci hodnotou, která se objeví ve výpisu, pokud dílčí test selže.
Příklady
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)")
Výsledek
OK (2 tests)
Příklad ověřuje platné porty, zachytí výjimku pro `"0"` a porovná její text. Poté v označených dílčích testech ověří, že jsou hodnoty `"0"` a `"65536"` odmítnuty. Vlastní souhrn počítá dvě testovací metody, nikoli iterace dílčích testů.
Související lekce
- Python · Lekce 37 · Pokročilá · Verze: 5
- Python · Lekce 34 · Středně pokročilá · Verze: 3
Zdroje
- 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)