Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung | |||
| modul:m450:learningunits:lu04:monkeypatch [2024/11/12 07:30] – msuter | modul:m450:learningunits:lu04:monkeypatch [2026/11/17 08:03] (aktuell) – Klassenbeispiel korrigiert (Patch wirkt jetzt tatsächlich), Fehlerfall simulieren, Stolperfalle Import, Lernziele, Kontrollfragen, Fusszeile und Kompetenz-Tags admin | ||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| ====== LU04b - Funktionen und Klassen simulieren ====== | ====== LU04b - Funktionen und Klassen simulieren ====== | ||
| - | <WRAP center round tip 60%> | + | <WRAP center round info 80%> |
| - | Mit '' | + | **Auf einen Blick**\\ |
| - | Dadurch können einzelne Programmteile | + | Die getestete Funktion ruft oft andere Funktionen oder Klassen auf, zum Beispiel für den Zugriff auf eine Datenbank. |
| + | Mit '' | ||
| + | So testen wir die Funktion **isoliert**: schnell, wiederholbar und unabhängig von Datenbank, Netzwerk oder unfertigem Code. | ||
| </ | </ | ||
| - | Ein Unittest soll eine einzelne Funktion oder sogar nur Teile einer Funktion testen. | + | ===== Lernziele ===== |
| - | Die zu testende Funktion wird aber in der Regel Objekte verarbeiten und weitere Funktionen/ | + | Sie können |
| - | Funktionen und Klassen werden bei Unittests simuliert (oder " | + | * erklären, warum Abhängigkeiten |
| + | * eine Funktion mit '' | ||
| + | * eine Klasse durch eine simulierte Klasse ersetzen, | ||
| + | * Fehlerzustände wie einen Verbindungsabbruch gezielt simulieren. | ||
| - | ==== Isolation der Testobjekte | + | ===== Warum simulieren? ===== |
| - | Mocking hilft, sich nur auf die zu testende | + | ^ Grund ^ Erklärung |
| - | + | | **Isolation** | |
| - | ==== Vermeidung externer Abhängigkeiten ==== | + | | **Keine externen Systeme** |
| - | In vielen Anwendungen greifen Funktionen und Klassen auf externe Ressourcen zu, wie Datenbanken, | + | | **Kontrolle** |
| - | + | | **Geschwindigkeit** | |
| - | ==== Kontrolle über Rückgabewerte und Fehlerzustände ==== | + | | **Frühes Testen** |
| - | Mocks ermöglichen es, gezielt verschiedene Rückgabewerte oder Fehler | + | |
| - | + | ||
| - | ==== Verbesserte Performance ==== | + | |
| - | Da Mocks die tatsächlichen Ausführungen komplexer Funktionen oder Klassen ersetzen, laufen Tests oft schneller und benötigen weniger Ressourcen. Besonders bei großen Test-Suites führt dies zu einer deutlichen Zeitersparnis. | + | |
| - | + | ||
| - | Insgesamt macht Mocking Unittests flexibler, effizienter und zuverlässiger, | + | |
| + | Solche Platzhalter heissen je nach Verwendung **Stub** (liefert feste Werte, siehe [[modul: | ||
| ===== Funktionen simulieren ===== | ===== Funktionen simulieren ===== | ||
| - | Nehmen wir einmal an, wir möchten eine Funktion '' | + | Die Funktion '' |
| - | Diese Funktion ruft eine andere Funktion | + | |
| - | Für unsere Unittests der Funktion '' | + | |
| <code python> | <code python> | ||
| Zeile 33: | Zeile 31: | ||
| def get_data_from_database(): | def get_data_from_database(): | ||
| - | | + | # Hier stünde |
| - | Diese Funktion würde normalerweise eine Datenbank abfragen und Daten zurückgeben. | + | raise NotImplementedError('Diese Funktion greift normalerweise auf eine Datenbank zu.') |
| - | Wir simulieren diese Funktion im Test. | + | |
| - | """ | + | |
| - | | + | |
| - | raise NotImplementedError("Diese Funktion greift normalerweise auf eine Datenbank zu.") | + | |
| def process_data(): | def process_data(): | ||
| - | """ | ||
| - | Diese Funktion ruft Daten von der Datenbank ab und verarbeitet sie. | ||
| - | """ | ||
| data = get_data_from_database() | data = get_data_from_database() | ||
| - | # Verarbeiten wir die Daten (hier nur ein einfaches Beispiel) | ||
| return [item * 2 for item in data] | return [item * 2 for item in data] | ||
| </ | </ | ||
| <code python> | <code python> | ||
| + | # test_my_module.py | ||
| import pytest | import pytest | ||
| from my_module import process_data | from my_module import process_data | ||
| - | # Fixture zum Simulieren der Datenbankabfrage-Funktion | + | |
| @pytest.fixture | @pytest.fixture | ||
| def mock_get_data_from_database(monkeypatch): | def mock_get_data_from_database(monkeypatch): | ||
| - | """ | ||
| - | Simuliert die Funktion `get_data_from_database`, | ||
| - | """ | ||
| def mock_data(): | def mock_data(): | ||
| - | return [1, 2, 3] # Beispielhafte Testdaten, die anstelle echter Daten zurückgegeben werden | + | return [1, 2, 3] |
| + | |||
| + | monkeypatch.setattr(' | ||
| - | # Ersetzen der echten Funktion durch die simulierte Version | ||
| - | monkeypatch.setattr(" | ||
| def test_process_data(mock_get_data_from_database): | def test_process_data(mock_get_data_from_database): | ||
| - | """ | ||
| - | Testet die Funktion `process_data`, | ||
| - | """ | ||
| result = process_data() | result = process_data() | ||
| - | assert result == [2, 4, 6], "Die Daten sollten verdoppelt werden." | + | assert result == [2, 4, 6], 'Die Daten sollten verdoppelt werden.' |
| </ | </ | ||
| - | Mit der Zeile '' | + | * '' |
| - | dass anstelle von '' | + | * Ruft '' |
| + | * Nach dem Test stellt PyTest die Originalfunktion automatisch wieder her. | ||
| + | |||
| + | <WRAP center round important 80%> | ||
| + | **Stolperfalle: | ||
| + | </ | ||
| ===== Klassen simulieren ===== | ===== Klassen simulieren ===== | ||
| - | Auch ganze Klassen mit ihren Attributen | + | Die Funktion '' |
| - | Einerseits lässt sich dadurch eine Funktion testen, bevor die Klasse überhaupt realisiert wurde. | + | |
| - | Andererseits isolieren wir die zu testende Funktion von allfälligen Fehlern in der Umsetzung der Klasse. | + | |
| <code python> | <code python> | ||
| Zeile 85: | Zeile 74: | ||
| class DatabaseClient: | class DatabaseClient: | ||
| - | """ | ||
| - | Klasse zum Verbinden mit einer Datenbank und Abrufen von Daten. | ||
| - | """ | ||
| def fetch_data(self): | def fetch_data(self): | ||
| - | # In einer echten Anwendung | + | # In einer echten Anwendung |
| - | raise NotImplementedError("Verbindung zur echten Datenbank.") | + | raise NotImplementedError('Verbindung zur echten Datenbank.') |
| - | def get_processed_data(db_client): | + | |
| - | | + | def get_processed_data(): |
| - | Funktion, die Daten vom DatabaseClient | + | |
| - | """ | + | |
| data = db_client.fetch_data() | data = db_client.fetch_data() | ||
| - | # Beispielhafte Verarbeitung: | ||
| return [item + 1 for item in data] | return [item + 1 for item in data] | ||
| - | |||
| </ | </ | ||
| + | |||
| + | Im Test ersetzen wir die ganze Klasse '' | ||
| <code python> | <code python> | ||
| # test_database_module.py | # test_database_module.py | ||
| - | |||
| import pytest | import pytest | ||
| from database_module import get_processed_data | from database_module import get_processed_data | ||
| - | # Fixture zum Simulieren der Klasse DatabaseClient | + | |
| + | class MockDatabaseClient: | ||
| + | def fetch_data(self): | ||
| + | return [10, 20, 30] | ||
| + | |||
| @pytest.fixture | @pytest.fixture | ||
| def mock_db_client(monkeypatch): | def mock_db_client(monkeypatch): | ||
| - | | + | |
| - | Simuliert die DatabaseClient-Klasse, um feste Testdaten zurückzugeben. | + | |
| - | """ | + | |
| - | # Simulierte Klasse | + | |
| - | class MockDatabaseClient: | + | |
| - | def fetch_data(self): | + | |
| - | return [10, 20, 30] # Beispielhafte Testdaten | + | |
| - | # Ersetzen der echten DatabaseClient-Klasse durch die simulierte Version | ||
| - | monkeypatch.setattr(" | ||
| - | | ||
| - | # Instanz der simulierten Klasse zurückgeben | ||
| - | return MockDatabaseClient() | ||
| def test_get_processed_data(mock_db_client): | def test_get_processed_data(mock_db_client): | ||
| - | | + | result = get_processed_data() |
| - | Testet die Funktion `get_processed_data`, | + | assert result == [11, 21, 31], 'Die Daten sollten um 1 erhöht werden.' |
| - | """ | + | |
| - | | + | |
| - | assert result == [11, 21, 31], "Die Daten sollten um 1 erhöht werden." | + | |
| </ | </ | ||
| - | ==== Erläuterung | + | Weil '' |
| - | ** Fixture mock_db_client: ** | + | |
| + | <WRAP center round tip 80%> | ||
| + | Erhält eine Funktion das Objekt als **Parameter**, | ||
| + | </ | ||
| + | |||
| + | ===== Fehler simulieren ===== | ||
| + | Wie reagiert das Programm, wenn die Datenbank nicht erreichbar ist? In der Realität lässt sich das schlecht testen, mit '' | ||
| + | |||
| + | <code python> | ||
| + | import pytest | ||
| + | import database_module | ||
| + | from database_module import get_processed_data | ||
| + | |||
| + | |||
| + | def test_db_error(monkeypatch): | ||
| + | def broken_fetch(self): | ||
| + | raise ConnectionError(' | ||
| + | |||
| + | monkeypatch.setattr(database_module.DatabaseClient, | ||
| + | with pytest.raises(ConnectionError): | ||
| + | get_processed_data() | ||
| + | </ | ||
| + | |||
| + | ===== Weitere Möglichkeiten von monkeypatch ===== | ||
| + | ^ Methode | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | ===== Kontrollfragen ===== | ||
| + | - Nennen Sie drei Gründe, weshalb man in Unit Tests eine Datenbankabfrage simuliert. | ||
| + | - Was passiert nach dem Test mit der Funktion, die Sie mit '' | ||
| + | - Das Modul '' | ||
| + | - Wie testen Sie, dass Ihr Programm bei einem Netzwerkfehler eine verständliche Meldung ausgibt? | ||
| - | Diese Fixture erstellt eine simulierte Version der '' | + | ===== Weiterführende Links ===== |
| - | Mit '' | + | * [[https:// |
| - | ** Test test_get_processed_data: ** | + | ---- |
| + | {{tag> | ||
| + | [[https:// | ||
| - | Der Test nutzt die Fixture '' | ||
| - | Da '' | ||