Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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