====== 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