KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Excepties testen met assertRaises

Gebruik `unittest.TestCase.assertRaises` met een aanroepbaar object of in een `with`-blok om te controleren of een bewerking de verwachte exceptie opwerpt.

Versie: 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.

In Python 3.12 is assertRaises een methode van unittest.TestCase. Geef een exceptieklasse door, geen instantie, of een tuple van klassen als meerdere typen zijn toegestaan. Een subklasse van een verwachte klasse komt ook overeen. Een overeenkomende exceptie wordt opgevangen en de assertie slaagt. Zonder exceptie faalt de assertie. Een niet-overeenkomende exceptie wordt doorgegeven en doorgaans als testfout gemeld.

Gebruik voor de vorm met een aanroepbaar object self.assertRaises(ValueError, parse_port, "0"). Geef parse_port zelf door en geef de positionele en benoemde argumenten afzonderlijk op. Geef niet het resultaat van parse_port("0") door: die aanroep zou plaatsvinden voordat de assertie de exceptie kan opvangen.

Schrijf voor de vorm met een contextmanager with self.assertRaises(ValueError) as cm: en zet alleen de bewerking die de exceptie moet opwerpen in het blok. Als een andere bewerking hetzelfde type opwerpt, kan de assertie om de verkeerde reden slagen. Na het blok bevat cm.exception de opgevangen instantie. In deze vorm geeft het optionele msg= een melding voor een mislukte assertie, geen patroon voor de exceptietekst. Gebruik assertRaisesRegex om de tekst met een reguliere expressie te controleren.

setUp() bereidt de testgegevens voor vóór elke testmethode, niet vóór elk subTest()-blok. assertEqual controleert resultaten voor geldige invoer en kan ook de tekst van de opgevangen exceptie vergelijken. subTest(invalid=invalid) labelt elke iteratie met de waarde die in het rapport verschijnt als de subtest faalt.

Voorbeelden

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)")

Resultaat

OK (2 tests)

Het voorbeeld controleert geldige poorten, vangt de exceptie voor `"0"` op en vergelijkt de tekst ervan. Daarna controleert het in gelabelde subtests of `"0"` en `"65536"` worden geweigerd. De aangepaste samenvatting telt de twee testmethoden, niet de subtestiteraties.

Gerelateerde lessen

  • Python · Les 37 · Gevorderd · Versie: 5
  • Python · Les 34 · Gemiddeld · Versie: 3

Bronnen