ba01455d52
Ziel: eine VF_n-Kette soll aus einem Stapel Eingabedaten gebaut werden koennen - ohne Dialog, ohne Konsolenfrage. Fahrplan und Begruendungen in doc/TODO-plan-vf-interactive.md. Alle Aenderungen sind No-Ops, solange *ssg-gui-aus* und *vfl-headless* nil sind. Produktion (Lisp/vf_linienzug.lsp, Lisp/vf_core.lsp): - vfl-journal-reset im Dispatcher VOR die Modus-cond gezogen. Bisher nur im Modus-1-Zweig: ein frischer Modus-2-Lauf erbte das Journal des Vorlaufs und schrieb es in die XDATA, ein spaeterer Doppelklick spielte fremde Eingaben vor. - Lokale Variable "member" in vf-linienzug-modus2 umbenannt. Sie verdeckte im selben Scope das Builtin member, das weiter unten gebraucht wird - jedes Kletterer-Segment waere in "bad function" gelaufen. - Neu vfl-meldung: sammelt den Text nach *vfl-meldungen* + dbgmsg und zeigt ihn nur bei erlaubter GUI modal, sonst per princ. Die 12 Bau-Pfad-alerts darauf umgestellt; ein Alert blockierte sonst jeden Batch-Lauf, und sein Text ist die einzige Auskunft, WELCHE Sektion abgewiesen wurde. Die reinen Interaktiv-Alerts (fehlendes DCL, "nicht editierbar", "kein Journal") bleiben alert. - Neu *vfl-headless* (+ vfl-headless-p/-abbruch/-notausgang/-ort, Diagnose *vfl-headless-fehler*, optionaler Antwort-Hook *vfl-headless-antwort-fn*): eine erschoepfte Replay-Queue ist damit ein harter Abbruch MIT Fundstelle (Art der Eingabe, Glied- und Eingabe-Nummer) statt eines stillen Rueckfalls auf Live-Eingabe. Eingebaut in vfl-in-value, vfl-in-value-p, vfl-in-selection und vfl-in-abstand. - vfl-journal-reset loescht Meldungen und Diagnose mit (gehoeren zum Lauf); vfl-view-refresh ueberspringt headless _PLAN/_ZOOM. Testfall HundM05 (5 echte Ketten aus data/polylines.dxf): - tests/testdata/hundm05.json neu erzeugt aus den XDATA-Journalen der VF_n-Bloecke (lib/vf_journal_export.py) - flach, weil ssg-load-json zeilenweise liest. Die drei kopierten Ketten bekommen ihren echten Einfuegepunkt, nicht das veraltete HOEHE_VON-Attribut. - tests/test_hundm05.lsp arbeitet jetzt per Journal-Replay statt mit Eingabe-Mocks: ein echtes Journal fuehrt die geerbte Fahrtrichtung nicht mit (vfl-in-abstand journalisiert hz nur beim ersten Segment), ein Mock kann sie also nicht kennen. Schaltet *vfl-headless* ein und schreibt prompts, headless_fehler und meldungen ins Ergebnis-JSON. - Kettenschleife fangt je Kette: ein Fehler NACH dem Bau nimmt nicht mehr die restlichen Ketten mit. - entprev gibt es in AutoLISP nicht (nur entnext/entlast) - die Suche nach dem fertigen Block laeuft vorwaerts ab dem Zeichnungsstand vor dem Bau. Dieselbe Falle in tests/test_mubea.lsp mitbehoben; sie schlug dort nie zu, weil entlast immer sofort traf. Absicherung ohne CAD: - tests/test_vf_headless_statisch.py: eingechecktes Inventar aller alert/get*/ssget/new_dialog-Fundstellen je Funktion (ein neues getreal in einer Bau-Funktion faellt auf, auch wenn sein Zweig im Test nie erreicht wird), Praesenz des Riegels in allen vier Wrappern, Diagnose-Reset und die Reset-Reihenfolge im Dispatcher. Dazu ein Waechter gegen erfundene AutoLISP-Funktionen (entprev u.a.) - diese Fehlerklasse kostet sonst jedes Mal einen CAD-Lauf. - tests/test_hundm05.py prueft zusaetzlich prompts == 0, keine Headless-Abbrueche und keine Bau-Meldungen. tests/alltests.json: hundm05-Zeile laedt VarioFoerderer (nicht KreiselInsert) und bleibt bis zu einem gruenen CAD-Lauf abgeschaltet. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
517 lines
20 KiB
Markdown
517 lines
20 KiB
Markdown
# Tests - SSG_LIB Testarchitektur
|
|
|
|
## Uebersicht
|
|
|
|
Die Tests folgen einer **zweistufigen Architektur**:
|
|
|
|
1. **LISP-Testrunner** (`.lsp`) — laufen in BricsCAD, erzeugen Ergebnisdateien
|
|
2. **Python-Validierung** (`.py`) — pruefen die Ergebnisse mit pytest + ezdxf
|
|
|
|
```
|
|
tests/alltests.json
|
|
|
|
|
v
|
|
BricsCAD Kommandozeile
|
|
| |
|
|
| SSG_RUN_ALL_TESTS |
|
|
| (fuehrt je Eintrag aus |
|
|
| alltests.json den passenden |
|
|
| TEST_<NAME> aus) |
|
|
| | |
|
|
v v |
|
|
tests/output/ |
|
|
<name>_results.json (immer) |
|
|
<name>_tests.dxf/.dwg (gemaess save)|
|
|
|
|
|
bin\run_tests.bat --check
|
|
|
|
|
pytest -v
|
|
|
|
|
test_<name>.py je Modul
|
|
```
|
|
|
|
## LISP-Unit-Tests fuer reine Standardfunktionen (`--lisp`)
|
|
|
|
Neben den zeichnungsbasierten Integrationstests gibt es **Unit-Tests fuer einfache
|
|
LISP-Standardfunktionen** — reine Funktionen ohne Zeichnungsdatenbank, Auswahlsaetze,
|
|
Dialoge oder Blockdateien (String-/Zahl-/Vektor-/Alist-Helfer). Sie funktionieren
|
|
analog zu den Python-Unittests: jeder Testfall vergleicht einen Funktionsaufruf gegen
|
|
ein erwartetes Ergebnis.
|
|
|
|
- **Testrunner**: `tests/test_unit.lsp` — Befehl `TEST_UNIT`, Mini-Framework mit
|
|
`tu-eq` (exakt), `tu-eqf` (Fliesskomma-Toleranz), `tu-true`, `tu-nil`.
|
|
- **Startskript**: `tests/test_unit.scr` — laedt SSG_LIB + die Tests, ruft `TEST_UNIT`
|
|
auf und beendet BricsCAD (pfadunabhaengig ueber `DXFMAKRO`).
|
|
- **Ergebnis**: Konsole (PASS/FAIL je Test) und `tests/output/unit_results.txt`
|
|
(letzte Zeile `RESULT: OK` / `RESULT: FAIL`).
|
|
|
|
Ausfuehrung ueber die Kommandozeile (startet BricsCAD headless):
|
|
|
|
```cmd
|
|
bin\run_tests.bat --lisp
|
|
```
|
|
|
|
`run_tests.bat --lisp` loescht das alte Ergebnis, startet BricsCAD mit `test_unit.scr`,
|
|
gibt danach `unit_results.txt` aus und liefert Exit-Code 1, wenn ein Test fehlschlaegt
|
|
oder kein Report erzeugt wurde.
|
|
|
|
Direkt in BricsCAD (SSG_LIB geladen):
|
|
|
|
```lisp
|
|
(load (strcat (getenv "DXFMAKRO") "/tests/test_unit.lsp"))
|
|
TEST_UNIT
|
|
```
|
|
|
|
Getestete Module: `ssg_core`, `ssg_lang`, `ssg_id`, `vf_core`, `export`,
|
|
`Gefaellestrecke`, `OmniModulInsert`, `KreiselInsert`.
|
|
|
|
## Zeichnungsbasierte Integrationstests
|
|
|
|
**Jedes Testmodul laeuft in einer eigenen, neuen Zeichnung** (statt die aktuelle zu
|
|
leeren/wiederzuverwenden). `SSG_RUN_ALL_TESTS` fragt beim Start interaktiv nach
|
|
dem gewuenschten Modus:
|
|
|
|
- **Kontroll-Modus (Default, Enter/Nein)**: Zeichnung wird gespeichert, per
|
|
`_.ZOOM _Extents` auf den Inhalt gezoomt und bleibt als eigener Tab offen —
|
|
der naechste Test startet in einer weiteren neuen Zeichnung. Am Ende des Laufs
|
|
sind alle Testzeichnungen gleichzeitig offen und direkt sichtbar. Sinnvoll,
|
|
wenn neue/geaenderte Testfaelle visuell geprueft werden sollen.
|
|
`c:EXPORTCSV`/`c:EXPORTSIVAS` laufen **nicht** automatisch mit — CSV/Sivas-
|
|
Export danach bei Bedarf manuell ueber `TEST_EXPORT_ALL`
|
|
(`tests/test_export_all.lsp`, Menuepunkt "Export CSV/Sivas ALL"), das alle
|
|
vorhandenen DXF/DWG-Dateien aus `tests/output/` einliest und je Datei
|
|
`<basis>_export.csv`/`<basis>_sivas.csv` erzeugt.
|
|
- **Automatik-Modus (Ja)**: Zeichnung wird gespeichert, direkt per
|
|
`c:EXPORTCSV`/`c:EXPORTSIVAS` exportiert (`<name>_tests_export.csv`/
|
|
`<name>_tests_sivas.csv`) und danach sofort wieder geschlossen. Kompletter
|
|
Lauf ohne manuellen Zusatzschritt, aber ohne gleichzeitige visuelle Kontrolle
|
|
aller Zeichnungen am Ende. Sinnvoll fuer reine CI-artige Validierung.
|
|
|
|
## alltests.json — Testregistry
|
|
|
|
Die Datei `tests/alltests.json` ist die zentrale Registry aller Test-Module.
|
|
`SSG_RUN_ALL_TESTS` liest sie beim Start — die Testliste ist **nicht** hartcodiert in `test_run_all.lsp`.
|
|
|
|
```json
|
|
[
|
|
{ "name": "kreisel", "save": "dxf", "module": "KreiselInsert" },
|
|
{ "name": "foerderer", "save": "dwg", "module": "VarioFoerderer" },
|
|
{ "name": "linienzug", "save": "dwg", "module": "VarioFoerderer" },
|
|
{ "name": "vfl_schema", "module": "VarioFoerderer" },
|
|
{ "name": "omniflo", "save": "dxf", "module": "OmniModulInsert" },
|
|
{ "name": "omniflo_strecke", "save": "dxf", "module": "OmniModulInsert" },
|
|
{ "name": "gefaellestrecke", "save": "dwg", "module": "Gefaellestrecke" },
|
|
{ "name": "mubea", "save": "dxf", "module": "KreiselInsert" },
|
|
{ "name": "hundm05", "save": "dxf", "module": "VarioFoerderer", "disabled": true }
|
|
]
|
|
```
|
|
|
|
Felder pro Eintrag:
|
|
|
|
| Feld | Typ | Bedeutung |
|
|
| --- | --- | --- |
|
|
| `name` | String | Basisname des Testmoduls (Pflicht) |
|
|
| `save` | `"dxf"` / `"dwg"` / `null` | Ob und als welches Format die Zeichnung gespeichert wird |
|
|
| `module` | String | LISP-Feature-Modul, das vor dem Test per `ssg-ensure` geladen wird |
|
|
| `disabled` | `true` | (optional) Schaltet den Eintrag ab: `SSG_RUN_ALL_TESTS` ueberspringt ihn komplett (kein Bauen/Speichern/Export) und gibt nur einen Hinweis auf der Konsole aus. Zum Reaktivieren das Feld entfernen. |
|
|
|
|
**JSON-Export laeuft immer** — unabhaengig vom `save`-Feld. Die Datei `<name>_results.json`
|
|
wird in `tests/output/` geschrieben, sobald der Test abgeschlossen ist.
|
|
|
|
**GUI-Aus waehrend des Laufs:** `SSG_RUN_ALL_TESTS` (und der Einzeltest `TEST_LINIENZUG`)
|
|
rufen `(ssg-gui-aus)` (ssg_core.lsp) auf, damit keine DCL-/Wizard-Dialoge den automatischen
|
|
Lauf blockieren; danach wird `(ssg-gui-an)` wieder gesetzt. Bei abgeschalteter GUI fallen die
|
|
Eingaben auf den Konsolen-/Mock-/Replay-Pfad zurueck. Interaktiver Betrieb (`FOERDERANLAGE`
|
|
etc.) ist davon unberuehrt (GUI standardmaessig an).
|
|
|
|
**Wann welches `save` verwenden:**
|
|
|
|
- `"dxf"` — wenn ein Python-Test (ezdxf) die Geometrie der Zeichnung pruefen soll
|
|
- `"dwg"` — wenn die Zeichnung zur manuellen Kontrolle oder als DWG-Referenz erhalten bleiben soll
|
|
- `null` (oder Feld weglassen) — wenn nur der JSON-Export benoetigt wird
|
|
|
|
## Ablauf fuer den Anwender
|
|
|
|
1. **BricsCAD starten** (ueber `bin\start_briscad.bat`) und die LISP-Testrunner ausfuehren (siehe Abschnitt "LISP-Tests in BricsCAD ausfuehren"). Die Testrunner erzeugen Bloecke in der Zeichnung und speichern Ergebnisse nach `tests/output/`.
|
|
|
|
2. **Optische Kontrolle** in BricsCAD — pruefen ob die erzeugten Bloecke korrekt aussehen (Positionen, Drehungen, Beschriftungen). Jede Testzeichnung bleibt als eigener Tab offen (auf den Inhalt gezoomt) und kann direkt visuell inspiziert werden.
|
|
|
|
3. **Kommandozeile**: Ergebnisse validieren:
|
|
- `bin\run_tests.bat --check` — pytest prueft die Ergebnisse aus `output/` gegen Testdefinitionen und Referenzdaten (optional: einzelnes Modul, z.B. `--check test_kreisel.py`)
|
|
- `bin\run_tests.bat --diff_references` — vergleicht die CSVs in `output/` gegen `reference/` und oeffnet bei Unterschieden das Diff-Tool (meld); optional eine einzelne Datei, z.B. `--diff_references kreisel_tests_export.csv`
|
|
- Referenz aktualisieren (nach geprueftem Lauf): die betreffende(n) Datei(en) aus `output/` manuell nach `reference/` kopieren (es gibt keinen eigenen Schalter dafuer)
|
|
|
|
## Verzeichnisstruktur
|
|
|
|
```
|
|
tests/
|
|
conftest.py # Gemeinsame pytest-Fixtures (Pfade, JSON/DXF-Laden)
|
|
create_testbase.py # Erzeugt Basis-DXF (optional, wird nicht mehr benoetigt)
|
|
requirements.txt # Python-Abhaengigkeiten (ezdxf, pytest)
|
|
test_run_all.lsp # Fuehrt alle Tests aus: C:SSG_RUN_ALL_TESTS
|
|
test_kreisel.lsp # LISP-Testrunner: C:TEST_KREISEL
|
|
test_kreisel.py # pytest-Validierung der Kreisel-Ergebnisse
|
|
test_foerderer.lsp # LISP-Testrunner: C:TEST_FOERDERER
|
|
test_omniflo.lsp # LISP-Testrunner: C:TEST_OMNIFLO
|
|
test_omniflo.py # pytest-Validierung der Omniflo-Ergebnisse
|
|
test_omniflo_strecke.lsp # LISP-Testrunner: C:TEST_OMNIFLO_STRECKE (Streckenzug)
|
|
test_omniflo_strecke.py # pytest-Validierung des Omniflo-Streckenzugs
|
|
test_export_all.lsp # LISP-Testrunner: C:TEST_EXPORT_ALL (manuell, nicht in alltests.json)
|
|
test_foerderer.py # pytest-Validierung Foerderer (Status/Mathematik/CSV/Sivas)
|
|
test_gefaellestrecke.py # pytest-Validierung Gefaellestrecke
|
|
test_mubea.py # pytest-Validierung Mubea-Gesamtmodell
|
|
test_hundm05.py # pytest-Validierung HundM05 (5 Linienzuege)
|
|
test_vf_journal_grammatik.py # pytest ohne CAD: Journal-Dekoder aus
|
|
# lib/vf_journal_export.py gegen handgebaute
|
|
# Journale (Linie-VF, gewinkelter Erstkoerper)
|
|
test_vf_headless_statisch.py # pytest ohne CAD: statischer Waechter, dass
|
|
# im VF-Bau-Pfad kein alert/get*/ssget neu
|
|
# auftaucht und der Headless-Riegel an allen
|
|
# vfl-in-*-Wrappern sitzt
|
|
test_unit.lsp / .scr # LISP-Unit-Tests: C:TEST_UNIT (ueber --lisp)
|
|
testdata/
|
|
kreisel_tests.json # Testfall-Definitionen fuer Kreisel
|
|
omniflo_tests.json # Testfall-Definitionen fuer Omniflo
|
|
omniflo_strecke_tests.json # Streckenzug: 4 Geraden + 2 Boegen + 1 Weiche (7 Elemente)
|
|
foerderer_tests.json / mubea.json / hundm05.json / ...
|
|
output/ # Ergebnisse aus BricsCAD (nicht in Git)
|
|
<name>_results.json # JSON-Ergebnisse pro Testmodul (immer)
|
|
<name>_tests.dxf/.dwg # Zeichnung pro Testmodul (gemaess save in alltests.json)
|
|
export_all_results.json # nur nach manuellem TEST_EXPORT_ALL-Lauf
|
|
<basis>_export.csv # EXPORTCSV je Quelldatei, nur nach TEST_EXPORT_ALL
|
|
<basis>_sivas.csv # EXPORTSIVAS je Quelldatei, nur nach TEST_EXPORT_ALL
|
|
reference/ # Abgenommene Referenzdaten (in Git): *_results.json,
|
|
... # *_tests_export.csv / *_tests_sivas.csv, export_raw.json
|
|
```
|
|
|
|
## Workflow
|
|
|
|
### 1. LISP-Tests in BricsCAD ausfuehren
|
|
|
|
BricsCAD starten (ueber `bin\start_briscad.bat`) und Module laden:
|
|
|
|
```lisp
|
|
(load (strcat (getenv "DXFMAKRO") "/Lisp/ssg_load.lsp"))
|
|
```
|
|
|
|
Dann alle Tests auf einmal ausfuehren:
|
|
|
|
```lisp
|
|
;; Alle Tests ausfuehren (empfohlen)
|
|
(load (strcat (getenv "DXFMAKRO") "/tests/test_run_all.lsp"))
|
|
SSG_RUN_ALL_TESTS
|
|
```
|
|
|
|
`SSG_RUN_ALL_TESTS` liest die Testliste aus `tests/alltests.json` und fuehrt fuer jedes Modul aus:
|
|
|
|
1. Zeichnung leeren (ERASE ALL + PURGE x5) — saubere Basis fuer jeden Test
|
|
2. `test_<name>.lsp` laden und `TEST_<NAME>` ausfuehren
|
|
3. JSON-Export aufrufen: `<name>:export-results` — **immer**, unabhaengig von `save`
|
|
4. Zeichnung speichern — nur wenn `"save"` in `alltests.json` gesetzt ist (`"dxf"` oder `"dwg"`)
|
|
5. Bei Fehler: weiter mit naechstem Test (`vl-catch-all-apply`)
|
|
|
|
**Einzeltest** (z.B. nur Kreisel pruefen):
|
|
|
|
```lisp
|
|
;; Test-Datei laden und Befehl ausfuehren
|
|
(load (strcat (getenv "DXFMAKRO") "/tests/test_kreisel.lsp"))
|
|
TEST_KREISEL
|
|
;; JSON-Export manuell aufrufen:
|
|
(kreisel:export-results (strcat (getenv "DXFMAKRO") "/tests/output"))
|
|
```
|
|
|
|
**Unterschied SSG_RUN_ALL_TESTS vs. Einzeltest:**
|
|
|
|
| | SSG_RUN_ALL_TESTS | Einzeltest |
|
|
| --- | --- | --- |
|
|
| Testliste | aus `alltests.json` | manuell gewaehlter Test |
|
|
| Zeichnung leeren | automatisch vor jedem Test | nein (Zeichnung bleibt) |
|
|
| JSON-Export | automatisch nach jedem Test | manuell aufrufen |
|
|
| DXF/DWG speichern | gemaess `save` in `alltests.json` | manuell (SAVEAS / DXFOUT) |
|
|
| Fehlerisolation | ja (Fehler unterbricht nicht weitere Tests) | nein |
|
|
|
|
### 2. Python-Validierung ausfuehren
|
|
|
|
```cmd
|
|
bin\run_tests.bat --check
|
|
```
|
|
|
|
Oder fuer ein einzelnes Testmodul:
|
|
|
|
```cmd
|
|
bin\run_tests.bat --check test_kreisel.py
|
|
```
|
|
|
|
Die Python-Tests pruefen:
|
|
- **Attribut-Werte** gegen die Testdefinitionen (JSON)
|
|
- **DXF-Geometrie** mit ezdxf (Bloecke, Positionen, Radien)
|
|
- **Referenz-Vergleich** gegen abgenommene Referenz-DXF
|
|
- **CSV-Export** ueber `lib/export_csv.py` (Omniflo: Spalten, Merkmale, Sum-Zeile, Datentypen)
|
|
|
|
Tests, deren Eingabedaten fehlen (z.B. kein BricsCAD-Lauf), werden automatisch uebersprungen (`pytest.skip`).
|
|
|
|
### 3. Referenz erstellen/aktualisieren
|
|
|
|
Nach einem erfolgreichen, geprueften Testlauf die betreffende(n) Ergebnisdatei(en)
|
|
manuell aus `output/` nach `reference/` kopieren (nur bei bestandenen Tests). Es gibt
|
|
keinen eigenen Batch-Schalter dafuer.
|
|
|
|
```cmd
|
|
copy tests\output\<datei> tests\reference\<datei>
|
|
```
|
|
|
|
Zum Vergleich der aktuellen CSVs gegen die Referenz (mit Diff-Tool meld):
|
|
|
|
```cmd
|
|
bin\run_tests.bat --diff_references
|
|
```
|
|
|
|
## Neuen Test erstellen
|
|
|
|
### Schritt 1: Testdaten definieren (JSON)
|
|
|
|
Neue Testfaelle in `testdata/<modul>_tests.json` eintragen. Das Format ist ein **flaches JSON-Array** (kompatibel mit `omni:load-json`).
|
|
|
|
**Kreisel-Beispiel** (`kreisel_tests.json`):
|
|
|
|
```json
|
|
[
|
|
{
|
|
"id": "KR_Insert_Neu",
|
|
"function": "insert",
|
|
"x": 5000, "y": 5000, "z": 2000,
|
|
"abstand": 5000,
|
|
"rotation": 0.0,
|
|
"typ": "STANDARD",
|
|
"expect_block_prefix": "KREISEL_",
|
|
"expect_hoehe": "2000",
|
|
"expect_kreiselart": "STANDARD"
|
|
}
|
|
]
|
|
```
|
|
|
|
Felder:
|
|
- `id` — Eindeutiger Name des Testfalls
|
|
- `function` — `"insert"` oder `"connect"`
|
|
- Eingabeparameter (`x`, `y`, `z`, `abstand`, `rotation`, `typ` fuer Insert; `start_x/y/z`, `end_x/y/z`, `typ` fuer Connect)
|
|
- `expect_*` — Erwartete Ergebniswerte (fuer Python-Validierung)
|
|
|
|
**Omniflo-Beispiel** (`omniflo_tests.json`):
|
|
|
|
```json
|
|
[
|
|
{
|
|
"sivasnr": "834372001",
|
|
"type": "bogen",
|
|
"description": "Bogen 90 Grad R200",
|
|
"hoehe": 2000,
|
|
"drehung": 0
|
|
}
|
|
]
|
|
```
|
|
|
|
**Foerderer-Beispiel** (`foerderer_tests.json`):
|
|
|
|
```json
|
|
[
|
|
{ "y_abstand": 800 },
|
|
{
|
|
"test_id": "VF_Auf_2000_Rechts",
|
|
"richtung": "Auf",
|
|
"deltaL": 7000,
|
|
"deltaH": 2000,
|
|
"seite": "rechts",
|
|
"winkel": 27,
|
|
"gf_verteilung": "vorne"
|
|
}
|
|
]
|
|
```
|
|
|
|
Felder:
|
|
|
|
- `test_id` — Eindeutiger Name des Testfalls
|
|
- `richtung` — `"Auf"` oder `"Ab"`
|
|
- `deltaL`, `deltaH` — Horizontal-/Hoehendistanz in mm
|
|
- `seite` *(optional, Default `"links"`)* — `"links"` oder `"rechts"`, steuert AS-/ES-Seite (`SEITE_AS`/`SEITE_ES`-Attribut)
|
|
- `winkel` *(optional)* — erzwingt einen bestimmten Kandidatenwinkel statt des automatisch gewaehlten kleinsten gueltigen Winkels; muss ein gueltiger Wert aus der `bogen_winkel`-Kandidatenliste sein, sonst wird der Testfall `NICHT_GEBAUT`
|
|
- `gf_verteilung` *(optional, Default `"gleichmaessig"`)* — `"gleichmaessig"` (50/50 auf Einlauf/Auslauf), `"vorne"` (alles am Einlauf) oder `"hinten"` (alles am Auslauf)
|
|
|
|
### Schritt 2: LISP-Testrunner erweitern (falls neues Modul)
|
|
|
|
Fuer ein neues Modul eine neue `.lsp`-Datei erstellen nach dem Muster:
|
|
|
|
```lisp
|
|
;; test_<modul>.lsp
|
|
;; Konvention: Basisname <modul> bestimmt Befehl, DXF und Export-Funktion
|
|
|
|
;; Export-Funktion (wird von test_run_all.lsp aufgerufen)
|
|
(defun <modul>:export-results (tests-out-dir / out-json f first)
|
|
(if (null *<modul>-test-results*)
|
|
(princ "\n Keine <modul>-Ergebnisse vorhanden.")
|
|
(progn
|
|
(vl-mkdir tests-out-dir)
|
|
(setq out-json (strcat tests-out-dir "/<modul>_results.json"))
|
|
;; ... JSON-Array schreiben ...
|
|
)
|
|
)
|
|
)
|
|
|
|
(defun c:TEST_<MODUL> (/ ...)
|
|
(ssg-start "TEST_<MODUL>" '(("OSMODE") ("ATTREQ") ("ATTDIA")))
|
|
(setvar "OSMODE" 0)
|
|
(setvar "ATTREQ" 0)
|
|
(setvar "ATTDIA" 0)
|
|
|
|
;; 1. Testdaten laden
|
|
(setq testfaelle (omni:load-json
|
|
(strcat (getenv "DXFMAKRO") "/tests/testdata/<modul>_tests.json")))
|
|
|
|
;; 2. Testfaelle ausfuehren, Ergebnisse sammeln
|
|
(foreach eintrag testfaelle
|
|
;; ... Script-Funktion aufrufen, Ergebnis pruefen ...
|
|
)
|
|
|
|
;; 3. Ergebnisse in globaler Variable speichern
|
|
(setq *<modul>-test-results* (reverse results-list))
|
|
|
|
(ssg-end)
|
|
)
|
|
```
|
|
|
|
Dann den Basisnamen in `tests/alltests.json` eintragen:
|
|
|
|
```json
|
|
{ "name": "<modul>", "save": "dxf" }
|
|
```
|
|
|
|
`"save"` waehlen je nach Bedarf (`"dxf"`, `"dwg"` oder `null`).
|
|
`test_run_all.lsp` leitet alle Namen aus dem `"name"`-Feld ab — **nichts** in `test_run_all.lsp` aendern.
|
|
|
|
### Namenskonventionen (werden von test_run_all.lsp automatisch abgeleitet)
|
|
|
|
Aus dem Basisnamen `<name>` in `alltests.json` entstehen durch Konvention:
|
|
|
|
| Element | Schema | Beispiel fuer `"name": "kreisel"` |
|
|
| --- | --- | --- |
|
|
| LISP-Datei | `tests/test_<name>.lsp` | `tests/test_kreisel.lsp` |
|
|
| BricsCAD-Befehl | `TEST_<NAME>` (Grossbuchstaben) | `TEST_KREISEL` |
|
|
| Export-Funktion | `<name>:export-results` | `kreisel:export-results` |
|
|
| JSON-Ergebnis | `output/<name>_results.json` | `output/kreisel_results.json` |
|
|
| DXF/DWG-Datei | `output/<name>_tests.dxf/.dwg` | `output/kreisel_tests.dxf` |
|
|
|
|
Die Export-Funktion **muss** exakt so heissen: `<name>:export-results` (Namespace-Notation mit Doppelpunkt).
|
|
Sie nimmt genau einen Parameter entgegen: den Pfad zum Output-Verzeichnis.
|
|
|
|
Wichtig:
|
|
|
|
- `omni:load-json` erwartet ein **flaches JSON-Array** mit flachen Objekten (kein Nesting)
|
|
- `omni:val` liest Werte aus den geladenen Eintraegen
|
|
- Script-Funktionen (z.B. `kreisel-insert-script`) muessen **ohne User-Interaktion** funktionieren
|
|
|
|
### Schritt 3: Python-Validierung erstellen
|
|
|
|
Neue `test_<modul>.py` erstellen:
|
|
|
|
```python
|
|
import pytest
|
|
|
|
class TestModulAttributes:
|
|
"""Prueft Attribute gegen Testdefinitionen."""
|
|
|
|
def test_all_executed(self, <modul>_results):
|
|
"""Alle Testfaelle muessen ausgefuehrt worden sein."""
|
|
# ...
|
|
|
|
def test_attribute_values(self, <modul>_testdata, <modul>_results):
|
|
"""Attributwerte muessen mit Erwartungen uebereinstimmen."""
|
|
# ...
|
|
|
|
class TestModulGeometry:
|
|
"""Prueft DXF-Geometrie mit ezdxf."""
|
|
|
|
def test_blocks_exist(self, <modul>_dxf):
|
|
"""Bloecke muessen im Modelspace vorhanden sein."""
|
|
# ...
|
|
|
|
class TestModulReference:
|
|
"""Vergleicht gegen Referenz."""
|
|
|
|
def test_matches_reference(self, <modul>_dxf, <modul>_ref_dxf):
|
|
# ...
|
|
```
|
|
|
|
### Schritt 4: Fixtures in conftest.py ergaenzen
|
|
|
|
Neue Fixtures fuer Testdaten, Ergebnisse und DXF in `conftest.py` hinzufuegen:
|
|
|
|
```python
|
|
@pytest.fixture
|
|
def <modul>_testdata():
|
|
path = os.path.join(_testdata_dir(), "<modul>_tests.json")
|
|
return _load_json(path)
|
|
|
|
@pytest.fixture
|
|
def <modul>_results():
|
|
path = os.path.join(_output_dir(), "<modul>_results.json")
|
|
if not os.path.exists(path):
|
|
pytest.skip("<modul>_results.json nicht vorhanden")
|
|
return _load_json(path)
|
|
|
|
@pytest.fixture
|
|
def <modul>_dxf():
|
|
path = os.path.join(_output_dir(), "<modul>_tests.dxf")
|
|
if not os.path.exists(path):
|
|
pytest.skip("<modul>_tests.dxf nicht vorhanden")
|
|
return ezdxf.readfile(path)
|
|
|
|
@pytest.fixture
|
|
def <modul>_ref_dxf():
|
|
path = os.path.join(_reference_dir(), "<modul>_ref.dxf")
|
|
if not os.path.exists(path):
|
|
pytest.skip("Referenz nicht vorhanden")
|
|
return ezdxf.readfile(path)
|
|
```
|
|
|
|
## Testklassen
|
|
|
|
### test_kreisel.py
|
|
|
|
| Klasse | Prueft |
|
|
|---|---|
|
|
| `TestKreiselAttributes` | Attribute (KREISELART, HOEHE), Block-Prefixe, Status |
|
|
| `TestKreiselGeometry` | DXF-Bloecke, Positionen, Kreis-Radien (400mm) |
|
|
| `TestKreiselReference` | Block-Anzahl und -Typen gegen Referenz-DXF |
|
|
|
|
### test_omniflo.py
|
|
|
|
| Klasse | Prueft |
|
|
|---|---|
|
|
| `TestOmnifloExportUnit` | Mock-Export ueber `lib/export_csv.py`: Merkmale, Datentypen, Sum-Zeile, Vollstaendigkeit (ohne BricsCAD) |
|
|
| `TestOmnifloResults` | omniflo_results.json aus BricsCAD: Testfaelle vollstaendig, Status OK, Hoehe |
|
|
| `TestOmnifloReferenceCSV` | CSV-Export aus `lib/export_csv.py` gegen abgenommene Referenz-CSV |
|
|
|
|
### test_omniflo_strecke.py
|
|
|
|
Streckenzug **4 Geraden -> 180-Grad-Kurve (4x 45-Grad-Bogen) -> 4 Geraden**.
|
|
Die Geometrie wird ohne BricsCAD direkt aus `omniflo_strecke_tests.json` geprueft.
|
|
|
|
| Klasse | Prueft |
|
|
|---|---|
|
|
| `TestStreckeStruktur` | 4+4+4 = 12 Elemente, Reihenfolge der Gruppen, Typen |
|
|
| `TestStreckeKatalog` | Bogen-SivasNummern existieren in `omniflo_boegen.json` (Radius/Winkel) |
|
|
| `TestStreckeGeometrie` | Lueckenlose Verkettung, Kurvensumme 180 Grad, gemeinsamer Bogen-Mittelpunkt |
|
|
| `TestStreckeResults` | omniflo_strecke_results.json aus BricsCAD: Elemente vollstaendig, Status OK |
|
|
|
|
## Umgebungsvariablen
|
|
|
|
Werden von `bin\setenv.bat` gesetzt. Fuer Tests relevant:
|
|
|
|
| Variable | Beschreibung |
|
|
|---|---|
|
|
| `DXFMAKRO` | Projektwurzel |
|
|
| `DXFM_TESTS` | tests/-Verzeichnis |
|
|
| `DXFM_TESTDATA` | testdata/-Verzeichnis |
|
|
| `DXFM_TESTOUT` | output/-Verzeichnis |
|
|
| `DXFM_TESTREF` | reference/-Verzeichnis |
|
|
| `DXFM_OMNIFLO` | Pfad zu Omniflo-DXF-Dateien |
|