BW3-Core/_gen/readme.md

40 lines
1.5 KiB
Markdown
Raw Normal View History

2018-01-04 23:36:39 +01:00
## Generatoren
Im Verzeichniss _gen befinden sich Windows Batch-Scripte um bestimmt Aufgaben zu
vereinfachen und automatisieren.
### cloc.bat
CLoC steht für Count Lines of Code
Dieses Tool erstellt einen kurzen Report über die Anzahl der Dateien, Codezeilen,
Kommentare und Leerzeilen sortiert nach jeweiliger Programmiersprache
### doxygen.bat
Doxygen ist ein Dokumentationswerkzeug zum automatischen dokumentieren von Quellcode.
Nach dem ausführen wird der gesamte Quellcode geparst und eine HTML Dokumentation
im Verzeichnis "_docu/html/" angelegt.
Die Konfigurations Datei für Doxygen findet sich unter "_config/doxygen.ini"
### pytest.bat
pytest ist ein Python Testframework
Damit ist es möglich, automatisierte Tests laufen zu lassen.
Nach dem Start kann man mit einem Druck auf [ENTER] direkt alle bekannten Tests
laufen lassen, oder durch die Eingabe eines spezifischen Tests auch nur diesen
ausführen. Die Tests werden dabei in zufälliger Reihenfolge abgearbeitet um auch
Fehler durch Abhängigkeiten voneinander zu erfassen.
Die Testfälle befinden sich im Unterordner "test"
Einzeltests werden durch Eingabe des Namens ohne "test_" und ".py" aufgerufen.
Zum Beispiel "decoder" statt "test_decoder.py"
Zusätzlich werden alle Quellcode Dateien mittels eines PEP8 Parsers auf die Einhaltung
der Code-Sytel Vorgaben von Python hin untersucht und etwaige Fehler ausgegeben.
Vom Testverlauf wird ein Logfile erstellt welches in "log/test.log" befindet.
Die Konfigurationsdatei für pytest findet sich unter "_config/pytest.ini"