====== LU03e - Klassen und Fehlerfälle testen ======
**Auf einen Blick**\\
Gute Tests prüfen nicht nur den Normalfall. Sie prüfen auch Grenzwerte, Spezialfälle und ungültige Eingaben.
Bei ungültigen Eingaben soll das Programm meistens eine **Exception** auslösen. Mit ''pytest.raises'' testen Sie, ob das passiert.
Klassen testen Sie, indem Sie ein Objekt erzeugen, eine Methode aufrufen und danach den Zustand des Objekts prüfen.
===== Lernziele =====
Sie können
* für eine Funktion Normalfälle, Grenzwerte, Spezialfälle und ungültige Eingaben bestimmen,
* mit ''pytest.raises'' prüfen, ob eine bestimmte Exception ausgelöst wird,
* Methoden einer Klasse nach dem Muster Arrange – Act – Assert testen.
===== Welche Testfälle braucht es? =====
Für jede Funktion überlegen Sie sich Testfälle in diesen vier Gruppen. Beispiel: ''minmax(numbers)'' liefert die kleinste und die grösste Zahl einer Liste.
^ Gruppe ^ Frage ^ Beispiel ''minmax'' ^
| **Normalfall** (positiver Test) | Funktioniert der typische Fall? | ''[3, 1, 2]'' → ''(1, 3)'' |
| **Grenzwerte** | Was passiert am Rand des gültigen Bereichs? | Liste mit genau einem Element ''[5]'' → ''(5, 5)'' |
| **Spezialfälle** | Gibt es Werte, die anders behandelt werden könnten? | nur negative Zahlen, gleiche Zahlen, Fliesskommazahlen |
| **Ungültige Eingaben** (negativer Test) | Reagiert die Funktion richtig auf Fehler? | leere Liste ''[]'' → ''ValueError'' |
Bei ungültigen Eingaben unterscheiden wir wie in [[modul:m450:learningunits:lu01:grundlagen|LU01a]]:
* **formal falsch:** falscher Datentyp oder falsches Format, zum Beispiel ''%%'abc'%%'' statt einer Zahl,
* **formal korrekt, aber logisch ungültig:** richtiger Datentyp, aber unzulässiger Wert, zum Beispiel ein negativer Betrag.
Systematische Verfahren, um solche Testfälle zu finden (Äquivalenzklassen, Grenzwertanalyse), vertiefen Sie in [[modul:m450:learningunits:lu05:start|LU05]] und [[modul:m450:learningunits:lu06:start|LU06]].
===== Exceptions testen mit pytest.raises =====
Löst eine Funktion bei ungültigen Eingaben eine Exception aus, ist das ihr **korrektes** Verhalten. Der Test muss also bestehen, wenn die Exception kommt, und fehlschlagen, wenn sie ausbleibt.
import pytest
from minmax import minmax
def test_minmax_empty():
with pytest.raises(ValueError):
minmax([])
* Der Code im ''with''-Block muss die angegebene Exception auslösen. Sonst schlägt der Test fehl mit ''DID NOT RAISE''.
* Eine **andere** Exception, zum Beispiel ein ''TypeError'', lässt den Test ebenfalls fehlschlagen.
* Schreiben Sie nur die eine Zeile in den ''with''-Block, welche die Exception auslösen soll.
Mit ''match'' prüfen Sie zusätzlich den Text der Fehlermeldung:
def test_withdraw_too_much():
account = BankAccount('Anna', 100.0)
with pytest.raises(ValueError, match='ungenügend'):
account.withdraw(100.01)
===== Klassen testen =====
==== bank_account.py ====
class BankAccount:
def __init__(self, owner, balance=0.0):
self.owner = owner
self._balance = balance
@property
def balance(self):
return self._balance
def deposit(self, amount):
if amount <= 0:
raise ValueError('Betrag muss grösser als 0 sein')
self._balance += amount
def withdraw(self, amount):
if amount <= 0:
raise ValueError('Betrag muss grösser als 0 sein')
if amount > self._balance:
raise ValueError('Kontostand ungenügend')
self._balance -= amount
==== test_bank_account.py ====
Jeder Test erzeugt ein **eigenes** Objekt. So beeinflussen sich die Tests nicht gegenseitig (Prinzip //Independent//, siehe [[.:unittest|LU03a]]).
import pytest
from bank_account import BankAccount
def test_new_account_is_empty():
account = BankAccount('Anna')
assert account.balance == 0.0
def test_deposit():
# Arrange
account = BankAccount('Anna', 100.0)
# Act
account.deposit(50.0)
# Assert
assert account.balance == 150.0
def test_withdraw_whole_balance():
account = BankAccount('Anna', 100.0)
account.withdraw(100.0)
assert account.balance == 0.0
def test_deposit_negative_amount():
account = BankAccount('Anna', 100.0)
with pytest.raises(ValueError):
account.deposit(-20.0)
assert account.balance == 100.0
def test_withdraw_too_much():
account = BankAccount('Anna', 100.0)
with pytest.raises(ValueError, match='ungenügend'):
account.withdraw(100.01)
assert account.balance == 100.0
* ''test_withdraw_whole_balance'' prüft den **Grenzwert**: Den ganzen Kontostand abzuheben ist erlaubt.
* ''test_withdraw_too_much'' prüft den Wert **knapp daneben**: Ein Rappen mehr ist nicht erlaubt.
* Nach einer Exception prüfen die Tests zusätzlich, dass der Kontostand **unverändert** ist. Eine fehlgeschlagene Buchung darf das Konto nicht verändern.
Wiederholt sich das Arrange in vielen Tests, können Sie es in eine Fixture auslagern. Das lernen Sie in [[modul:m450:learningunits:lu04:fixture|LU04a]].
===== Kontrollfragen =====
- Nennen Sie für die Funktion ''average(numbers)'' je einen Testfall für Normalfall, Grenzwert, Spezialfall und ungültige Eingabe.
- Wann schlägt ein Test mit ''pytest.raises(ValueError)'' fehl?
- Warum prüft ''test_deposit_negative_amount'' nach der Exception noch den Kontostand?
- Weshalb erzeugt jeder Test ein eigenes ''BankAccount''-Objekt, statt eines für alle Tests zu verwenden?
----
{{tag>M450-LU03 M450-C1I}}
[[https://creativecommons.org/licenses/by-nc-sa/4.0/|{{https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png}}]] Marcel Suter