mirror of
https://github.com/BOSWatch/BW3-Core.git
synced 2026-01-07 01:00:58 +01:00
add _gen/ readme
This commit is contained in:
parent
a648ff2c3e
commit
7182e40b7b
40
_gen/readme.md
Normal file
40
_gen/readme.md
Normal file
|
|
@ -0,0 +1,40 @@
|
|||
## 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"
|
||||
Loading…
Reference in a new issue