Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung | |||
| modul:m450:learningunits:lu03:pytest [2024/11/19 10:05] – [Resultate mit Fliesskommazahlen] msuter | modul:m450:learningunits:lu03:pytest [2026/11/17 07:56] (aktuell) – Fehler bei pytest.approx korrigiert, Testsuche, Ausführen, Lernziele, Kontrollfragen, Kompetenz-Tags admin | ||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| ====== LU03b - PyTest ====== | ====== LU03b - PyTest ====== | ||
| - | + | <WRAP center round info 80%> | |
| - | <WRAP center round info 60%> | + | **Auf einen Blick**\\ |
| - | PyTest ist ein Test-Framework | + | [[https:// |
| - | Es eignet sich vor allem, um die Schnittstellen einzelner Funktionen zu testen. | + | Ein Test ist eine gewöhnliche Funktion, deren Name mit '' |
| + | PyTest findet alle Tests selbständig, | ||
| </ | </ | ||
| - | ===== Einstieg | + | ===== Lernziele |
| - | Die Nutzung von PyTest in unserer IDE PyCharm ist relativ einfach. | + | Sie können |
| + | * PyTest in einem Projekt installieren, | ||
| + | * Testdateien und Testfunktionen so benennen, dass PyTest sie findet, | ||
| + | * Unit Tests mit '' | ||
| + | * Fliesskommazahlen mit '' | ||
| - | ==== Paket " | + | ===== Installation ===== |
| - | Zuerst musst du das Paket '' | + | PyTest wird im Virtual Environment |
| - | Gehe in den Tab '' | + | |
| - | Achte auf die Anzeige '' | + | |
| - | < | + | |
| - | (venv) PS C: | + | |
| - | </ | + | |
| - | Falls diese Anzeige fehlt, musst du die virtuelle Umgebung zuerst aktivieren. | + | |
| - | Gib dazu unter Windows den Befehl '' | + | |
| - | Nun kannst du pytest installieren. | + | Öffnen Sie in PyCharm den Tab **Terminal** und prüfen Sie, ob am Anfang der Zeile '' |
| - | < | + | Falls nicht, aktivieren Sie die virtuelle Umgebung: |
| - | (venv) | + | |
| - | </ | + | |
| - | Ich empfehle dir, die Pakete immer im Virtual Environment zu installieren. | + | ^ Betriebssystem |
| - | Dadurch gibt es weniger Probleme mit der Kompatiblität verschiedener Projekte. | + | | Windows (PowerShell) | '' |
| + | | macOS / Linux | '' | ||
| - | ==== Modul für Testfälle ==== | + | Danach installieren Sie PyTest: |
| - | Nachdem pytest installiert ist, erstellst du ein neues Modul (Python File) für deine Tests. | + | < |
| - | Als Dateinamen ergänze ich den Namen des zu testenden Moduls (z.B. main.py) um '' | + | (.venv) PS C:\BZZ\Python\MyProject> |
| - | + | ||
| - | ==== Unit Tests ==== | + | |
| - | + | ||
| - | Die einzelnen Unit Tests werden als Funktionen in Python programmiert. | + | |
| - | Zum Beispiel: | + | |
| - | + | ||
| - | < | + | |
| - | def test_normal(): | + | |
| - | result = factorial(7) | + | |
| - | assert result == 5040 | + | |
| </ | </ | ||
| - | * Der Funktionsname für den Test muss mit '' | + | <WRAP center round tip 80%> |
| - | * Wir rufen die zu testende Funktion (im Beispiel '' | + | Je nach Projekt heisst der Ordner |
| - | * Der Befehl '' | + | </ |
| - | === Assert | + | ===== Wie findet PyTest die Tests? ===== |
| - | Der Befehl '' | + | PyTest durchsucht den Projektordner nach Tests. Dabei gelten diese Regeln: |
| - | Falls die Bedingung erfüllt ist, wird nichts gemacht. | + | |
| - | Sonst wird eine '' | + | |
| - | Wir könnten das gleiche Resultat auch mit '' | + | |
| - | ^ assert | + | ^ Was ^ Regel ^ Beispiel |
| - | | <code python> | + | | Testdatei |
| - | if result == 5040: | + | | Testfunktion |
| - | | + | | Testklasse (optional) | Name beginnt mit '' |
| - | else: | + | |
| - | raise AssertionError | + | <WRAP center round important 80%> |
| - | </code> | | + | Heisst eine Funktion '' |
| + | </WRAP> | ||
| - | ===== Beispiel ===== | + | In den GitHub-Classroom-Aufträgen dieses Moduls liegen die Tests meistens in '' |
| - | Anhand dieses einfachen Beispiels siehst du, wie eine Python-Funktion getestet werden kann. | + | |
| + | ===== Ein erster Unit Test ===== | ||
| ==== factorial.py ==== | ==== factorial.py ==== | ||
| - | Dieses Modul enthält eine Funktion um die Fakultät einer Zahl zu berechnen. | + | Dieses Modul berechnet |
| <code python> | <code python> | ||
| Zeile 75: | Zeile 60: | ||
| ==== test_factorial.py ==== | ==== test_factorial.py ==== | ||
| - | Dieses Modul enhält meine Unit Tests. | ||
| <code python> | <code python> | ||
| from factorial import factorial | from factorial import factorial | ||
| Zeile 83: | Zeile 67: | ||
| result = factorial(7) | result = factorial(7) | ||
| assert result == 5040 | assert result == 5040 | ||
| - | | + | |
| def test_zero(): | def test_zero(): | ||
| result = factorial(0) | result = factorial(0) | ||
| - | assert result == 1 | + | assert result == 1 |
| </ | </ | ||
| - | ===== Resultate mit Fliesskommazahlen ===== | + | * Die Testdatei importiert die Funktion, die getestet wird. |
| - | Bei Berechnungen | + | * Jeder Test ruft die Funktion |
| - | Daher würde der Befehl '' | + | * Pro Testfall |
| - | Um diesem Problem zu begegnen, gibt es die Funktion [[https:// | + | ===== Tests ausführen ===== |
| - | Diese Funktion | + | ^ Wo ^ Wie ^ |
| - | Beim Aufruf der Funktion muss zwingend das erwartete Resultat mitgegeben werden. | + | | Terminal |
| - | Zusätzlich kennt die Funktion 3 optionale Argumente: | + | | Einzelne Datei | '' |
| - | | + | | Einzelner Test | '' |
| - | * '' | + | | PyCharm |
| - | | + | |
| + | Wie Sie das Ergebnis lesen, erfahren Sie in [[.: | ||
| + | |||
| + | ===== assert ===== | ||
| + | '' | ||
| + | |||
| + | ^ assert ^ gleichwertig mit if / else ^ | ||
| + | | <code python> | ||
| + | if result == 5040: | ||
| + | pass | ||
| + | else: | ||
| + | raise AssertionError | ||
| + | </ | ||
| + | |||
| + | Mit '' | ||
| + | <code python> | ||
| + | assert result == 5040 # gleich | ||
| + | assert result != 0 # ungleich | ||
| + | assert result > 0 # grösser | ||
| + | assert ' | ||
| + | assert result is None # ist None | ||
| + | assert isinstance(result, | ||
| + | </ | ||
| + | |||
| + | ===== Fliesskommazahlen vergleichen ===== | ||
| + | Computer speichern Fliesskommazahlen nur ungefähr. Deshalb ergibt zum Beispiel '' | ||
| + | Ein Vergleich mit '' | ||
| + | |||
| + | Die Funktion [[https:// | ||
| + | |||
| + | ^ Argument | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | Ein Wert gilt als gleich, wenn er **eine** der beiden Toleranzen einhält. | ||
| ==== Beispiel ==== | ==== Beispiel ==== | ||
| - | In diesem Beispiel | + | Wir testen eine Funktion, welche die Mehrwertsteuer (8.1 %) berechnet. |
| - | Wir haben ein Total von CHF 1575.50 | + | |
| <code python> | <code python> | ||
| import pytest | import pytest | ||
| + | from vat import calculate_vat | ||
| + | |||
| - | def calculate_vat(amount): | ||
| - | | ||
| - | |||
| def test_calculate_vat(): | def test_calculate_vat(): | ||
| - | | + | |
| - | vat = calculate_vat(total) | + | assert vat == pytest.approx(127.6155) |
| - | pytest.approx(127.6155) == vat | + | |
| - | | + | |
| + | def test_calculate_vat_rappen(): | ||
| + | vat = calculate_vat(1575.50) | ||
| + | | ||
| </ | </ | ||
| - | Da ich hier keine Angaben für relative | + | * Im ersten Test gilt die relative |
| - | ===== Tutorials ===== | + | * Im zweiten Test genügt es, wenn das Resultat auf den Rappen genau stimmt. |
| - | * [[https:// | + | |
| - | * [[https:// | + | |
| + | <WRAP center round important 80%> | ||
| + | Vergessen Sie das '' | ||
| + | </ | ||
| + | |||
| + | ===== Kontrollfragen ===== | ||
| + | - Sie haben die Datei '' | ||
| + | - Mit welchem Befehl führen Sie nur den Test '' | ||
| + | - Warum schreiben wir für jeden Testfall eine eigene Testfunktion? | ||
| + | - Warum schlägt '' | ||
| + | |||
| + | ===== Weiterführende Links ===== | ||
| + | * [[https:// | ||
| + | * [[https:// | ||
| ---- | ---- | ||
| - | {{tag> | + | {{tag> |
| [[https:// | [[https:// | ||
| + | |||