LU09.A00: PyTests finden
Erstelle ein JSON-Array mit allen Unittests in einem Python-Projekt.
Aufgabe
Das Skript durchsucht ein Projekt nach Dateien, die Unittests enthalten.
Die Dateinamen müssen test_ oder _test enthalten.
Zum Beispiel:
- test_main.py
- main_test.py
Innerhalb dieser Dateien sucht das Skript nach Funktionen, deren Bezeichner mit test_ beginnt.
Die Bezeichner dieser Funktionen werden in eine Liste geschrieben.
Schlussendlich wird diese Liste sortiert und als JSON-Array ausgegeben.
Beispiel
[
"test_figure_init_empty",
"test_figure_add_shape",
"test_figure_add_shape_multiple",
"test_figure_take_shape",
"test_figure_remove_shape_by_title",
"test_figure_remove_shape_by_index",
"test_figure_total_area_scale1",
"test_figure_total_area_scale3",
"test_figureshape_init_empty",
"test_figureshape_set_figure",
"test_figureshape_set_shape",
"test_main"
]
Wieso Python und Bash?
Grundsätzlich könnte man die Aufgabe ausschliesslich mit Python lösen oder als reines Bash-Skript schreiben. Jede Sprache hat jedoch ihre Vorteile, die wir hier ausnutzen wollen:
- Dateien durchsuchen: Hier spielt Bash seine Stärke aus
- Arbeiten mit Collections: Dies lässt sich leichter in Python umsetzen.
Umsetzung
Vorbereitung
Siehe https://wiki.bzz.ch/modul/m122/learningunits/lu08/linux_python#virtual_environment
- Klone das Repository im WSL in einen neuen Ordner.
- Erstelle das virtual Environment.
- Führe das Bash-Skript setup.sh aus. Dieses erstellt einen Ordner und Dateien für die Tests.
==== Teilschritte ====
In den folgenden Aufgaben werden Sie zunächst einzelne Teilschritte umsetzen und testen.
Zum Schluss schreiben Sie die main-Funktion um alle Teilfunktionen zu verbinden.
===== Hinweise=====
Das Python-Skript kann nicht unter Windows ausgeführt werden, da wir Bash-Befehle nutzen.
Um auf das Windows-Laufwerk C zuzugreifen, verwendest du im WSL den Pfad /mnt/c.
==== Aufruf des Skripts ====
- Öffne das Windows Subsystem for Linux (WSL).
- Wechsel in den Ordner, in dem Ihr Projekt gespeichert ist. Zum Beispiel: cd „/mnt/c/BZZ/Python/m122-lu08-a02-listtest-ghwalin“
- Starte das Python Skript mit python3 main.py ORDNER_PFAD. Ersetze ORDNER_PFAD durch den Pfad zum gewünschten Projekt.
==== Unittests aufrufen ====
Um einen bestimmten Unittest durchzuführen, wird dieser im Terminal mit dem Befehl pytest aufgerufen.
<code bash>
pytest MODULE::FUNCTION
</code>
* Ersetze MODULE durch den Dateinamen mit den Unittests, z.B. main_test.py
* Ersetze FUNCTION durch den Namen der Test-Funktion, z.B. test_find_test_modules
* Gibst du nur den Modulnamen an, werden alle Tests in dieser Datei durchgeführt.
<code bash>
pytest main_test.py::test_find_test_modules
pytest main_test.py
</code>