Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Python

Preverjanje izjem z assertRaises

Z `unittest.TestCase.assertRaises` preveri, ali operacija sproži pričakovano izjemo, tako da podaš klicljiv objekt ali uporabiš blok `with`.

Različica: 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.

V Pythonu 3.12 je assertRaises metoda razreda unittest.TestCase. Podaj razred izjeme, ne primerka, ali nabor razredov (tuple), če je sprejemljivih več tipov. Ustreza tudi podrazred pričakovanega razreda. Ujemajoča se izjema se prestreže in preverjanje uspe. Če se ne sproži nobena izjema, preverjanje ne uspe. Izjema, ki se ne ujema, se širi naprej in je običajno prikazana kot napaka pri testu.

V obliki s klicljivim objektom napiši self.assertRaises(ValueError, parse_port, "0"). Podaj samo funkcijo parse_port, njene položajne in poimenovane argumente pa navedi ločeno. Ne podaj rezultata parse_port("0"): ta klic bi se izvedel, preden bi lahko preverjanje prestreglo izjemo.

V obliki z upravljalnikom konteksta napiši with self.assertRaises(ValueError) as cm: in v blok postavi samo operacijo, ki naj sproži izjemo. Če drugo dejanje sproži isti tip izjeme, lahko preverjanje uspe iz napačnega razloga. Po bloku cm.exception vsebuje prestreženi primerek. Izbirni msg= v tej obliki določi sporočilo ob neuspelem preverjanju, ne vzorca za besedilo izjeme. Za preverjanje besedila z regularnim izrazom uporabi assertRaisesRegex.

setUp() pripravi podatke pred vsako testno metodo, ne pred vsakim blokom subTest(). assertEqual preveri rezultate za veljavne vhode in lahko primerja tudi besedilo prestrežene izjeme. subTest(invalid=invalid) vsako ponovitev označi z vrednostjo, ki se prikaže v poročilu, če podtest ne uspe.

Primeri

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)

Primer preveri veljavna vrata, prestreže izjemo za `"0"` in primerja njeno besedilo. Nato v označenih podtestih preveri, ali sta vrednosti `"0"` in `"65536"` zavrnjeni. Prilagojeni povzetek šteje dve testni metodi, ne ponovitev podtestov.

Povezane lekcije

  • Python · Lekcija 37 · Napredna · Različica: 5
  • Python · Lekcija 34 · Srednja · Različica: 3

Viri