KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

`unittest.TestCase.setUp`: elke test voorbereiden

Geef elke test nieuwe gegevens met `setUp()`. Controleer vervolgens waarden met `assertEqual()` en een verwachte uitzondering met `assertRaises()`.

Versie: Python 3.12

Syntax

import unittest

class ExampleTests(unittest.TestCase):
    def setUp(self):
        self.items = [10, 20]

unittest.TestCase.setUp is een instantiemethode die unittest automatisch aanroept vlak voordat het een testmethode uitvoert. Definieer setUp(self) in een subklasse van unittest.TestCase en bewaar de testgegevens, onderdeel van de testfixture, in attributen van self. De standaardimplementatie doet niets.

unittest maakt voor elke testmethode een afzonderlijke TestCase-instantie. Maak in setUp() een nieuwe lijst in plaats van een wijzigbare lijst als klasseattribuut te delen. In het voorbeeld wijzigt test_pop zijn lijst, terwijl test_remove_missing met een nieuwe lijst [10, 20] begint. setUpClass() is een klassenmethode voor gedeelde voorbereiding op klasseniveau, niet voor de initialisatie van elke test afzonderlijk.

De drie aanroepen van assertEqual(werkelijk, verwacht) controleren gelijkheid van waarden, niet de identiteit van objecten: ze controleren het teruggegeven element, de lijst na pop() en de lijst na de mislukte verwijderpoging. Het blok with self.assertRaises(ValueError): bevat alleen de poging om de ontbrekende waarde te verwijderen. Zonder uitzondering faalt de assertie; een andere uitzondering wordt niet onderschept. Als alternatief kun je de aan te roepen methode met haar argument meegeven: self.assertRaises(ValueError, self.items.remove, 99).

Als setUp() een uitzondering opwerpt, worden noch de testmethode noch tearDown() uitgevoerd. AssertionError telt als een mislukte test, unittest.SkipTest als een overgeslagen test en de meeste andere uitzonderingen als fouten. Opruimfuncties die al met addCleanup() zijn geregistreerd, worden wel uitgevoerd als unittest tijdens de voorbereiding een mislukking, een fout of een overgeslagen test registreert. Als setUp() een KeyboardInterrupt niet opvangt, wordt die uitzondering in Python 3.12 echter vanuit TestCase.run() doorgegeven voordat doCleanups() wordt aangeroepen. Als de voorbereiding lukt, draait tearDown() ook als de test mislukt.

Voorbeelden

import unittest


class ListTests(unittest.TestCase):
    def setUp(self):
        self.items = [10, 20]

    def test_pop(self):
        removed = self.items.pop()
        self.assertEqual(removed, 20)
        self.assertEqual(self.items, [10])

    def test_remove_missing(self):
        with self.assertRaises(ValueError):
            self.items.remove(99)
        self.assertEqual(self.items, [10, 20])


if __name__ == "__main__":
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(ListTests)
    result = unittest.TestResult()
    suite.run(result)
    print(f"Tests run: {result.testsRun}")
    print(f"Successful: {result.wasSuccessful()}")
    raise SystemExit(0 if result.wasSuccessful() else 1)

Resultaat

Tests run: 2
Successful: True

Voer `python list_tests.py` uit met Python 3.12. De verwachte uitvoer laat zien dat er twee tests zijn uitgevoerd en dat de testsuite is geslaagd; het script toont geen verstreken tijd.

Gerelateerde lessen

  • Python · Les 34 · Gemiddeld · Versie: 3

Bronnen