Ein Test, der dieselbe Frage jedes Mal stellt
Ein Unit-Test ist ein kleines Programm, das eine einzelne Funktion mit einer festen Eingabe aufruft und das Ergebnis prüft. Es läuft in Sekunden und sagt sofort, ob die Funktion noch stimmt.
Eine Buchhaltung rechnet Nettopreise in Bruttopreise um. Wer die Funktion ändert, will nach jeder Änderung wissen, ob noch alles richtig ist. Von Hand wäre das jedes Mal Rechnen.
Am Ende dieser Lektion
Notiz
Ich kann einen Unit-Test mit Assertions schreiben und ausführen.
Schlüsselwörter
| Begriff | Was er bedeutet | Beispiel |
|---|---|---|
| Unit-Test | ein Test für eine einzelne Funktion | |
| Assertion | eine Behauptung, die wahr sein muss | assert x == 3 |
| erwarteter Wert | das Ergebnis, das Sie von Hand ausgerechnet haben | |
| Testlauf | ein Durchgang, der alle Tests startet und zählt | |
| Ausnahme | ein Fehler, den ein Programm mit raise auslöst | ValueError |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Ein Test hat drei Schritte: Arrange, Act, Assert
Jeder Test folgt demselben Muster. Arrange heißt vorbereiten: Sie legen die Eingabe fest. Act heißt ausführen: Sie rufen die Funktion auf. Assert heißt behaupten: Sie prüfen das Ergebnis gegen den erwarteten Wert.
Der erwartete Wert steht im Test fest drin. Sie rechnen ihn selbst aus, bevor Sie die Funktion fragen.
Drei Schritte in einem Skript
def brutto(netto_cent):
return netto_cent * 119 // 100
# Arrange: die Eingabe festlegen
netto = 1000
# Act: die Funktion aufrufen
ergebnis = brutto(netto)
# Assert: das Ergebnis prüfen
assert ergebnis == 1190, "Erwartet wurde 1190"
print("Test bestanden")
# Ändern Sie 1190 in 1200 und starten Sie noch einmal.
Ein häufiger Fehler
Warnung
Viele schreiben als erwarteten Wert denselben Ausdruck wie in der Funktion, zum Beispiel netto * 119 // 100. Dann stimmen Test und Funktion immer überein, auch wenn beide falsch sind. Rechnen Sie den Wert selbst aus und schreiben Sie die Zahl hin.
Das Modul unittest sammelt und zählt Tests
Python bringt das Modul unittest mit. Ein Test ist dort eine Methode, deren Name mit test_ beginnt, in einer Klasse, die von unittest.TestCase erbt.
Mit self.assertEqual(a, b) behaupten Sie, dass a gleich b ist. Mit python3 -m unittest startet der Testlauf. In den Aufgaben dieses Kits schreiben Sie dagegen einfache Funktionen mit einem assert. Beide Wege prüfen dasselbe.
Funktion und Tests im Lab anlegen
Sie legen im Lab zwei Dateien an: mwst.py mit der Funktion brutto und test_mwst.py mit drei Tests. Die Funktion rechnet Cent netto in Cent brutto um, mit 19 Prozent Umsatzsteuer, und lehnt negative Preise ab.
Der Testlauf schreibt viele Zeilen. Wir lesen nur die letzte mit tail -n 1: OK heißt, alles bestanden.
Den Ordner anlegen
mkdir -p ~/testlaborHier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Hineingehen
cd ~/testlaborHier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Die Funktion schreiben
printf 'def brutto(netto_cent):\n if netto_cent < 0:\n raise ValueError("Der Preis darf nicht negativ sein")\n return netto_cent * 119 // 100\n' > mwst.pyHier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Die drei Tests schreiben
printf 'import unittest\nfrom mwst import brutto\n\nclass TestBrutto(unittest.TestCase):\n def test_hundert_cent(self):\n self.assertEqual(brutto(100), 119)\n\n def test_null(self):\n self.assertEqual(brutto(0), 0)\n\n def test_negativ(self):\n with self.assertRaises(ValueError):\n brutto(-1)\n' > test_mwst.pyHier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Den Testlauf starten, letzte Zeile
python3 -m unittest test_mwst 2>&1 | tail -n 1Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Ein Test muss auch rot werden können
Ein Test, der nie fehlschlägt, könnte auch nichts prüfen. Bauen Sie deshalb absichtlich einen Fehler ein: Der Satz 119 wird zu 11.
Danach läuft der Test noch einmal. Die Meldung sagt, was erwartet wurde und was herauskam.
Den Fehler einbauen
sed -i.bak 's/119/11/' mwst.pyHier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Der Testlauf, letzte Zeile
python3 -m unittest test_mwst 2>&1 | tail -n 1Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Die Meldung des Fehlers zeigen
python3 -m unittest test_mwst 2>&1 | grep AssertionErrorHier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Den Fehler wieder ausbauen
sed -i.bak 's/ 11 / 119 /' mwst.pyHier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Noch einmal laufen lassen
python3 -m unittest test_mwst 2>&1 | tail -n 1Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Ein Überblick: die wichtigsten Assertions in unittest
| Methode | Sie behaupten | Beispiel |
|---|---|---|
| assertEqual(a, b) | a ist gleich b | self.assertEqual(brutto(100), 119) |
| assertTrue(x) | x ist wahr | self.assertTrue(ist_gerade(4)) |
| assertIn(a, liste) | a steckt in der Liste | self.assertIn("a", "Haus") |
| assertRaises(Fehler) | Der Aufruf löst diese Ausnahme aus | with self.assertRaises(ValueError): |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.