CKTIS / Python
Testovanie výnimiek pomocou assertRaises
Pomocou `unittest.TestCase.assertRaises` over, či operácia vyvolá očakávanú výnimku, a to odovzdaním volateľného objektu alebo v bloku `with`.
Verzia: Python 3.12
Syntax
self.assertRaises(exception, callable, *args, **kwds)
with self.assertRaises(exception, msg=None) as cm:
operation()
# After a matching exception, inspect cm.exception.V Pythone 3.12 je assertRaises metóda triedy unittest.TestCase. Odovzdaj triedu výnimky, nie jej inštanciu, alebo n-ticu tried, ak pripúšťaš viac typov. Vyhovuje aj podtrieda očakávanej triedy. Zodpovedajúca výnimka sa zachytí a asercia prejde. Ak sa nevyvolá žiadna výnimka, asercia zlyhá. Nezodpovedajúca výnimka sa šíri ďalej a zvyčajne sa nahlási ako chyba testu.
Vo variante s volateľným objektom napíš self.assertRaises(ValueError, parse_port, "0"). Odovzdaj samotnú funkciu parse_port a jej pozičné a pomenované argumenty uveď samostatne. Neodovzdávaj výsledok parse_port("0"): funkcia by sa zavolala skôr, než by asercia mohla výnimku zachytiť.
Vo variante so správcom kontextu napíš with self.assertRaises(ValueError) as cm: a do bloku vlož len operáciu, ktorá má vyvolať výnimku. Ak rovnaký typ vyvolá iná operácia, asercia môže prejsť z nesprávneho dôvodu. Po bloku obsahuje cm.exception zachytenú inštanciu. Voliteľné msg= v tomto variante nastavuje správu pri zlyhaní asercie, nie vzor pre text výnimky. Na overenie textu regulárnym výrazom použi assertRaisesRegex.
setUp() pripraví údaje pred každou testovacou metódou, nie pred každým blokom subTest(). assertEqual kontroluje výsledky pre platné vstupy a môže porovnať aj text zachytenej výnimky. subTest(invalid=invalid) označí každú iteráciu hodnotou, ktorá sa zobrazí vo výpise, ak čiastkový test zlyhá.
Prí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ýsledok
OK (2 tests)
Príklad overuje platné porty, zachytí výnimku pre `"0"` a porovná jej text. Potom v označených čiastkových testoch overí, že hodnoty `"0"` a `"65536"` sú odmietnuté. Vlastný súhrn počíta dve testovacie metódy, nie iterácie čiastkových testov.
Súvisiace lekcie
- Python · Lekcia 37 · Pokročilá · Verzia: 5
- Python · Lekcia 34 · Stredne pokročilá · Verzia: 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)