Einen Unit-Test strukturieren: Arrange, Act, Assert

Ziel

Tests schreiben, deren Fehlermeldung der Leserin oder dem Leser sagt, welches Szenario fehlgeschlagen ist und welches Verhalten erwartet wurde, ohne den Testkörper zu öffnen.

Voraussetzungen

Ein Test-Runner (pytest oder unittest) sowie Code, dessen Einheiten sich ohne globalen Zustand konstruieren lassen.

Schritte

1. Den Test nach dem Szenario und dem erwarteten Ergebnis benennen: test_stale_if_match_is_rejected_with_412.
2. Arrange: genau den Zustand aufbauen, den das Szenario benötigt. Explizite Fixtures oder Builder gegenüber grossen gemeinsam genutzten Setups bevorzugen; pytest-Fixtures deklarieren, was jeder Test verwendet.
3. Act: eine Funktion oder einen Endpunkt einmal aufrufen.
4. Assert: das beobachtbare Ergebnis prüfen und, wo relevant, dass sich sonst nichts geändert hat. Eine logische Prüfung pro Test verwenden; mehrere assert-Anweisungen zu demselben Ergebnis sind unproblematisch.
5. Testdaten minimal und aussagekräftig halten; magische Zahlen erhalten einen Namen.
6. Den Test deterministisch gestalten: feste Uhren, mit einem Seed versehener Zufall, kein Netzwerk.

Erwartetes Ergebnis

Ein fehlschlagender Test benennt das Szenario in seinem Titel und die Abweichung in seiner Meldung; eine Leserin oder ein Leser kann den Code korrigieren, ohne den Test zurückzuentwickeln.

Grenzen und Prüfbasis

Das Muster gilt für Unit-Tests und die meisten Integrationstests; explorative oder eigenschaftsbasierte Tests folgen anderen Formen. Übermässig isolierte Einheiten können bestehen, während die Zusammensetzung fehlschlägt; die Struktur ergänzt also Tests auf höherer Ebene, ersetzt sie aber nicht.