====== LU03a - Unit Tests ======
**Auf einen Blick**\\
Ein **Unit Test** (Komponententest) prüft eine kleine Codeeinheit, meist eine Funktion oder eine Methode, **isoliert** vom Rest des Programms.
Er ist selbst ein kleines Programm: Er ruft die Einheit mit festgelegten Daten auf und vergleicht das Ergebnis automatisch mit dem erwarteten Wert.
===== Lernziele =====
Sie können
* erklären, was ein Unit Test ist und was ihn von einem Integrationstest unterscheidet,
* die Vorteile automatisierter gegenüber manueller Tests nennen,
* einen Unit Test nach dem Muster Arrange – Act – Assert aufbauen,
* die FIRST-Prinzipien erklären und an einem Test überprüfen.
===== Was ist eine «Unit»? =====
Eine Unit ist der kleinste Baustein, den man sinnvoll für sich allein testen kann. In Python ist das meistens
* eine **Funktion**, zum Beispiel ''factorial(number)'',
* oder eine **Methode** einer Klasse, zum Beispiel ''account.deposit(amount)''.
Ein Unit Test kennt die Schnittstelle der Unit: Name, Parameter, Rückgabewert und mögliche Exceptions. Was im Innern passiert, spielt für das Ergebnis keine Rolle.
===== Manuell oder automatisiert? =====
In [[modul:m450:learningunits:lu01:testfall|LU01]] haben Sie Testfälle von Hand durchgeführt und das IST ins Testprotokoll eingetragen. Ein Unit Test macht dasselbe, nur durch ein Programm:
^ ^ Manueller Test ^ Automatisierter Unit Test ^
^ Durchführung | Eine Person gibt Daten ein und schaut | Ein Testprogramm ruft den Code auf |
^ SOLL/IST-Vergleich | Von Auge | Mit ''assert'' im Testcode |
^ Dauer | Minuten bis Stunden | Sekunden, auch für Hunderte von Tests |
^ Wiederholung | Aufwändig, wird oft weggelassen | Nach jeder Änderung, ohne Mehraufwand |
^ Geeignet für | Benutzeroberfläche, Bedienbarkeit, Abnahme | Berechnungen, Logik, Fehlerbehandlung |
Der grösste Vorteil ist der **Regressionstest**: Wer Code ändert, startet die ganze Testsuite neu und merkt sofort, ob die Änderung etwas kaputt gemacht hat.
===== Unit Test und Integrationstest =====
^ ^ Unit Test ^ Integrationstest ^
^ Prüft | eine einzelne Funktion oder Methode | das Zusammenspiel mehrerer Units |
^ Abhängigkeiten | werden ersetzt (Stub, Mock) | sind echt (Datenbank, Datei, andere Klassen) |
^ Findet typischerweise | Rechenfehler, falsche Bedingungen | falsche Schnittstellen, vertauschte Parameter |
^ Geschwindigkeit | sehr schnell | langsamer |
^ Im Modul | LU03, LU04 | [[modul:m450:learningunits:lu15:start|LU15]] |
Unit Tests bilden die breite Basis der Testpyramide: Es gibt viele davon, sie sind billig und schnell. Weiter oben folgen weniger, dafür aufwändigere Tests (siehe auch [[modul:m450:learningunits:lu01:teststufen|LU01e - Teststufen]]).
{{:modul:m450:learningunits:lu03:testpyramide.png?600|Testpyramide}}
==== Isolation ====
Ruft die getestete Funktion etwas auf, das wir nicht kontrollieren, ist der Test nicht mehr isoliert. Typische Beispiele:
* Benutzereingaben mit ''input()''
* Dateien, Datenbanken, Netzwerk
* Zufallszahlen oder die aktuelle Uhrzeit
Solche Abhängigkeiten ersetzen wir im Test durch Platzhalter. Wie das mit PyTest geht, sehen Sie in [[.:inputoutput|LU03c]], [[modul:m450:learningunits:lu04:monkeypatch|LU04b]] und [[modul:m450:learningunits:lu11:mock|LU11b]].
===== Aufbau: Arrange – Act – Assert =====
Jeder Unit Test hat drei Teile:
* **Arrange:** Alles vorbereiten, was der Test braucht: Objekte erzeugen, Testdaten festlegen.
* **Act:** Die zu testende Funktion oder Methode genau **einmal** aufrufen.
* **Assert:** Das Ergebnis mit dem SOLL vergleichen.
def test_deposit():
# Arrange
account = BankAccount('Anna', 100.0)
# Act
account.deposit(50.0)
# Assert
assert account.balance == 150.0
In der Sprache von Behaviour Driven Development ([[modul:m450:learningunits:lu16:start|LU16]]) heissen die drei Teile **Given – When – Then**.
===== Die FIRST-Prinzipien =====
Gute Unit Tests erfüllen fünf Eigenschaften:
^ Prinzip ^ Bedeutung ^ Verstoss, Beispiel ^
| **F**ast | Die ganze Testsuite läuft in Sekunden. Man startet sie deshalb oft. | Ein Test lädt jedes Mal eine grosse Datei aus dem Internet. |
| **I**ndependent | Jeder Test läuft für sich allein und in beliebiger Reihenfolge. | Test B funktioniert nur, wenn Test A vorher ein Konto angelegt hat. |
| **R**epeatable | Gleiche Ausgangslage, gleiches Ergebnis, auf jedem Computer. | Das Ergebnis hängt vom heutigen Datum oder von Zufallszahlen ab. |
| **S**elf-validating | Der Test meldet selbst «bestanden» oder «fehlgeschlagen». | Der Test gibt Werte mit ''print()'' aus, die man von Auge prüfen muss. |
| **T**imely / **T**horough | Tests entstehen rechtzeitig, idealerweise vor dem Code (TDD), und decken nicht nur den Normalfall ab. | Es gibt nur einen Test mit gültigen Werten. |
**Thorough** heisst: Normalfälle, Grenzwerte, Spezialfälle (leere Liste, 0, sehr grosse Zahl) und ungültige Eingaben testen. Hohe Codeabdeckung allein genügt nicht (siehe [[modul:m450:learningunits:lu02:coverage|LU02c]]).
===== Kontrollfragen =====
- Was ist der Unterschied zwischen einem Unit Test und einem Integrationstest? Nennen Sie je ein Beispiel.
- Warum lohnt sich das Automatisieren besonders für Regressionstests?
- Eine Funktion liest den Preis eines Artikels aus einer Datenbank und berechnet den Rabatt. Was müssen Sie tun, damit der Test der Rabattberechnung isoliert ist?
- Welches FIRST-Prinzip verletzt ein Test, der nur am Vormittag besteht?
- Markieren Sie in einem Ihrer Tests aus LU03.A01 die Teile Arrange, Act und Assert.
----
{{tag>M450-LU03 M450-C2B}}
[[https://creativecommons.org/licenses/by-nc-sa/4.0/|{{https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png}}]] Marcel Suter