KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Subtests in unittest: gelijkheid en verwachte uitzonderingen

Controleer meerdere invoerwaarden in één testmethode, herken mislukte subtests en onderscheid een gelijkheidscontrole van een controle op een verwachte uitzondering.

Versie: Python 3.12

Syntax

with self.subTest("case label", value=value):
    self.assertEqual(actual, expected)

with self.subTest(value=value):
    self.assertRaises(ExpectedError, func, *args, **kwargs)

with self.assertRaises(ExpectedError):
    func(*args, **kwargs)

In Python 3.12 geeft unittest.TestCase.subTest een contextmanager terug. Gebruik with self.subTest("label", value=value): om een blok als subtest af te bakenen, bijvoorbeeld voor één lusiteratie. Het optionele bericht msg en de sleutelwoordargumenten **params identificeren de subtest in het verslag als die mislukt; ze worden niet doorgegeven aan de geteste functie.

Zonder failfast breekt een mislukte assertie het huidige with-blok af, maar de testmethode gaat na het blok verder en kan volgende subtests uitvoeren. Subtests zijn geen afzonderlijke testmethoden en voeren setUp() en tearDown() niet apart uit. Ga er met failfast niet van uit dat volgende subtests worden uitgevoerd.

self.assertEqual(actual, expected) controleert waardegelijkheid (==), niet objectidentiteit (is). Als de waarden ongelijk zijn, mislukt de assertie. Plaats deze in de subtest, zodat het verslag aangeeft welke invoer het onverwachte resultaat opleverde.

In de vorm met een aanroepbaar object roept self.assertRaises(ExpectedError, func, *args, **kwargs) de functie func aan met de opgegeven argumenten. Geef func door, niet func(...). De assertie slaagt bij de verwachte uitzondering of een subklasse daarvan, mislukt als er geen uitzondering optreedt en laat een niet-passende uitzondering door. Je kunt ook with self.assertRaises(ExpectedError): gebruiken en de functie binnen het blok aanroepen.

Voorbeelden

import unittest


class ParseTests(unittest.TestCase):
    def test_parse(self):
        for text, expected in [("12", 13), ("-3", -3)]:
            with self.subTest("valid integer", text=text):
                self.assertEqual(int(text), expected)

        with self.subTest("invalid integer", text="bad"):
            self.assertRaises(ValueError, int, "bad")
            print("Invalid input rejected")


if __name__ == "__main__":
    result = ParseTests("test_parse").run()
    tests, failures, errors = result.testsRun, len(result.failures), len(result.errors)
    print(f"tests={tests}, failures={failures}, errors={errors}")
    # The demonstration succeeds only if it records the deliberate failure.
    if (tests, failures, errors) != (1, 1, 0):
        raise SystemExit(1)

Resultaat

Invalid input rejected
tests=1, failures=1, errors=0

De verwachte waarde `13` voor `"12"` is opzettelijk onjuist. De subtest voor `"-3"` slaagt, en het geval `"bad"` schrijft zijn bericht pas nadat de verwachte `ValueError` is opgevangen. De samenvatting telt één testmethode, één mislukte controle en nul fouten. Het script eindigt met afsluitstatus `0` als de aantallen overeenkomen met deze waarden.

Gerelateerde lessen

  • Python · Les 37 · Gevorderd · Versie: 5

Bronnen