Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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