Author SHA1 Message Date
DanielandClaude Opus 5.5 e570d4524b Test-Audit sn_basis fortgesetzt: pruef_ergebnis.py fachlich geprüft (#76)
6 Testfälle nach Freigabe als geprüft markiert: test_pruef_ergebnis.py komplett
(Docstring-Anzahl korrigiert). Nebenbefund: die geprüften Properties
ist_verfahrens_db_aktion, erlaubte_persistierung und dateipfad werden derzeit nirgends
verwendet; PruefAktion schreibt "Datenbank" groß, Dateipruefer liefert "datenbank".

Testkatalog neu erzeugt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 09:34:49 +02:00
DanielandClaude Opus 5.5 693e453fc6 Test-Audit sn_basis fortgesetzt: print_layout.py fachlich geprüft (#76)
8 Testfälle nach Freigabe als geprüft markiert: test_print_layout.py komplett
(5 bestehende, 3 neue für create_single_page_layout). Nebenbefunde (direkter
qgis.PyQt-Import per importlib, removeGrid-Mock nach Name statt UUID, ungenutztes
width_limit_mm) bewusst ohne Issue: das Druckmodul wird ohnehin grundlegend überarbeitet.

Testkatalog neu erzeugt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 08:01:44 +02:00
DanielandClaude Opus 5.5 6966a67bd1 Test-Audit sn_basis fortgesetzt: os_wrapper.py fachlich geprüft (#76)
3 Testfälle nach Freigabe als geprüft markiert: test_os_wrapper.py komplett
(IsCaseSensitiveFsTests, alle drei Zweige abgedeckt, keine neuen Tests nötig).
Nebenbefund: Das Ziel „OS-Prüfung nur einmal, Plugin-Code ohne OS-Weichen“ ist nur
teilweise erfüllt (hasattr(os, "startfile") in Plan41, Wurzelpfad-Prüfung von Hand in
Dateipruefer/stilpruefer, ungenutzte Wrapper-Symbole). Dafür ist ein eigenes Issue
in Plugin_SN_Basis als Entwurf vorbereitet.

Testkatalog neu erzeugt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 07:49:12 +02:00
DanielandClaude Opus 5.5 1c4da60845 Regel: Testfälle nur auf ausdrückliche Aufforderung als geprüft markieren (#16)
Die Markierung per test_audit.py markieren bestätigt eine fachliche Abnahme durch einen
Menschen. Agenten sichten und ergänzen Tests und schlagen Markierungen vor, markieren aber
erst nach ausdrücklicher Freigabe. Aufgenommen in AGENTS.md (harte Regeln, Tests),
docs/leitfaden/06_tests.md Abschnitt 7 und Skill sn-tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 07:39:44 +02:00
DanielandClaude Opus 5.5 1435b157b5 Test-Audit sn_basis fortgesetzt: navigation.py fachlich geprüft (#76)
15 Testfälle fachlich geprüft und markiert: test_navigation.py komplett (12 bestehende,
3 neue für Standardpriorität, Reihenfolge bei gleicher Priorität und fehlende Toolbar).
Nebenbefund: remove_action entfernt die Action aus Menü, Toolbar und Liste, aber nicht aus
plugin_group und ruft kein deleteLater() auf – mögliches Überbleibsel beim Plugin-Reload,
analog zu #72. Nicht behoben (kein Umbau nebenbei).

Testkatalog neu erzeugt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 07:33:49 +02:00
DanielandClaude Opus 5.5 decd2a0002 Test-Audit sn_basis fortgesetzt: message_wrapper.py fachlich geprüft (#76)
5 Testfälle fachlich geprüft und markiert: test_message_wrapper.py komplett (inkl.
1 neuer Test für die Meldungsstufen von info/warning/error/success). Nebenbefund:
die Namens-Heuristik des Testkatalogs führte warning als referenziert, weil es in
test_pruefmanager/test_dockmanager nur per @patch ersetzt wird (bekannte, in
testkatalog.py dokumentierte Grenze).

Testkatalog neu erzeugt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 09:33:26 +02:00
DanielandClaude Opus 5.5 e747b2227b Test-Audit sn_basis fortgesetzt: ly_style_wrapper.py fachlich geprüft (#76)
5 Testfälle fachlich geprüft und markiert: test_ly_style_wrapper.py komplett (inkl.
1 neuer Test für die Pfadübergabe). Nebenbefunde: Debug-print() in apply_style als
Kommentar zu #79 vorbereitet; ungültige Layer in apply_style/apply_style_from_path
im Code mit Verweis auf #84 markiert. Nachtrag zum vorigen Audit-Commit: die dort
vorbereiteten Issues sind #84 (layer_is_valid/layer_is_usable) und #85 (Layerpruefer).

Testkatalog neu erzeugt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 09:23:55 +02:00
DanielandClaude Opus 5.5 3a872737a7 Test-Audit sn_basis fortgesetzt: ly_existence_wrapper.py fachlich geprüft (#76)
11 Testfälle fachlich geprüft und markiert: test_ly_existence_wrapper.py komplett
(inkl. 3 neuer Tests für layer_exists). Dabei gefunden und in Plugin_SN_Basis als
Issues vorbereitet (Absenden durch den Menschen): layer_is_valid/layer_is_usable
haben keinen Aufrufer, isValid() wird rund 20-mal direkt aufgerufen (nutzen oder
entfernen); Layerpruefer lässt ungültige Layer im Existenz-Schritt durch.

Testkatalog neu erzeugt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 09:08:48 +02:00
DanielandClaude Sonnet 5 94ab55923d Test-Audit sn_basis fortgesetzt: landkreise.py und LayerLoader.py fachlich geprüft (#76)
38 Testfälle fachlich geprüft und markiert: test_landkreise.py komplett (6, inkl.
4 neuer Tests) und test_layerloader.py komplett (32, inkl. 7 neuer Tests). Dabei
gefunden und in Plugin_SN_Basis als Issues vorbereitet (Absenden durch den
Menschen): #80 (REST-Link ohne Layer-Index lädt still Layer 0), #81 (unbekannter
Provider fällt still auf ogr zurück), #82 (Datenabruf und LayerLoader bauen aus
demselben REST-Link widersprüchliche URLs), #83 (filter_by_extent/filter_by_layer
reichen ungültige Layer still durch).

Testkatalog neu erzeugt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 15:26:25 +02:00
DanielandClaude Sonnet 5 a6dfbefbd4 Test-Audit sn_basis fortgesetzt: test_datenabruf, test_datenschreiber, test_dockmanager (#76)
48 weitere Testfälle in sn_basis fachlich geprüft und markiert (test_datenabruf.py: 24,
test_datenschreiber.py: 18, test_dockmanager.py: 6). Dabei zwei fragliche Codestellen
gefunden und als offene Punkte in STATUS.md festgehalten:
- Basis #77: Datenabruf._fetch_features() klassifiziert WMS-Zeilen immer als "ausserhalb",
  ohne dass je ein Layer geschrieben wird; der Kommentar "caller behandelt WMS separat"
  trifft nicht zu.
- Basis #78: Datenschreiber.schreibe_log() meldet Erfolg mit dem sachfremden Aktionscode
  "standarddatei_vorschlagen" (vermutlich Copy-Paste-Rest), aktuell folgenlos.

Testkatalog neu erzeugt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-21 14:49:28 +02:00
DanielandClaude Sonnet 5 159efc27a7 Testkatalog neu erzeugt für Basis #76
Docstring-Präzisierung von test_fehlender_layer_liefert_none übernommen.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-21 11:49:25 +02:00
DanielandClaude Sonnet 5 8f54251eaf Test-Audit: 19 sn_basis-Tests fachlich geprüft (test_base_dockwidget, test_datagrabber, test_dateipruefer)
CloseEventTests (test_base_dockwidget.py, 5 Tests), TestDataGrabber._aggregate_results-Tests
(test_datagrabber.py, 2 Tests) und alle bisher ungeprüften TestDateipruefer-Tests
(test_dateipruefer.py, 12 Testfälle inkl. der mit #70 ergänzten) als am 2026-09-21 fachlich
geprüft markiert.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-21 11:00:05 +02:00
DanielandClaude Sonnet 5 b20503d7b6 Testkatalog neu erzeugt für Basis #72
sn_basis: 329 Testfälle (zuvor 328), Navigation.remove_all()-Test aus #72 mit erfasst.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-21 10:45:06 +02:00
DanielandClaude Sonnet 5 049a5ffe1d Testkatalog neu erzeugt, Wissensbasis für Basis #70 nachgezogen
sn_basis steht laut Prüfstand jetzt bei 0 ungeklärten Funktionen. Fallstricke.md um den
Windows-Fallstrick "sqlite3-Verbindung aus with-Block schließt nicht, TemporaryDirectory-
Cleanup schlägt fehl" ergänzt (Fund aus Basis #70).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-21 08:50:32 +02:00
DanielandClaude Sonnet 5 cd11e409a3 Prüfstand: Statistik-Kacheln je Paket, beabsichtigt/ungeklärt-Indikator
Jedes Paket zeigt jetzt dieselben Kennzahl-Kacheln wie die Gesamtübersicht
(Testdateien, Testfälle, grün/rot/übersprungen, mit Docstring, geprüft,
ohne Testbezug) statt eines Fließtexts.

Ungetestete Funktionen werden per Docstring-Auswertung als "beabsichtigt"
(Vermerk "von Test abgesehen, weil …" oder "Test ausgesetzt, zunächst
Refactor") oder "ungeklärt" markiert - in Markdown als Anmerkung je
Funktion, im Prüfstand als Pille mit Tooltip (Begründung).

Der Abschnitt "Ungetestete Funktionen" ist im Prüfstand jetzt eine
ausklappbare Karte wie eine Testdatei, mit eigener Kennzahl-Übersicht
(Anzahl, ungeklärt, beabsichtigt) im Kopf - bewusst von den Filter-Chips
ausgenommen (.gapcard), da diese sich auf Testfall-Status beziehen, nicht
auf Quellcode-Funktionen.

Neue Funktion absichtlicher_verzicht() plus 6 neue Tests in
scripts/tests/test_testkatalog_quellfunktionen.py.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-18 13:26:01 +02:00
DanielandClaude Sonnet 5 cb29620f6e Testkatalog neu erzeugt für Basis #67
sn_basis: 317 Testfälle (32 Testdateien), Kategorie "vielleicht testen"
abgeschlossen. modulkarte.md an aktuelle Testdateizahl angepasst.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-18 13:07:20 +02:00
DanielandClaude Sonnet 5 3f985ce209 Testkatalog neu erzeugt, Wissensbasis für Basis #65 nachgezogen
sn_basis: 244 -> 249 Testfälle. fallstricke.md: _MockQDockWidget ohne
closeEvent(), zwei bestätigte Testkatalog-Fehlalarme (toter Code in
Pruefmanager._ask_use_or_replace_pufferlayer, Issue #60) sowie das Muster
Klasse.__new__(Klasse) für UI-Klassen, die im Mock nicht konstruierbar
sind. modulkarte.md an aktuelle Testdateizahl angepasst.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-18 11:20:37 +02:00
DanielandClaude Sonnet 5 b47f740c10 STATUS.md: Merge von Basis #63 und Verfahrensgebiet #53 nachgetragen
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-18 10:10:54 +02:00
DanielandClaude Sonnet 5 1359ba2761 Testkatalog neu erzeugt, Wissensbasis für Basis #63 nachgezogen
sn_basis: 96 -> 166 Testfälle (Datenabruf, Datenschreiber, LayerLoader,
excel_importer bekamen Tests). fallstricke.md: unvollständiger
_MockQgsProject (transformContext/addMapLayer fehlten). modulkarte.md und
STATUS.md an aktuellen Stand angepasst.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-18 09:50:45 +02:00
DanielandClaude Sonnet 5 906740eff6 Testkatalog: strukturelle Lückenanalyse (ungetestete Funktionen)
Ergänzt den Testkatalog um einen Abschnitt "Ungetestete Funktionen": Quellcode-Funktionen
und -Methoden, deren Name in keiner Testdatei des Pakets vorkommt (Namensabgleich per ast,
ohne Import). Keine Wiederaufnahme der in ADR 0009 verworfenen Zeilen-Coverage-in-Prozent,
sondern eine Lückenliste nach demselben Muster wie der bestehende Abschnitt für fehlende
Docstrings - entsprechend in ADR 0009 und docs/leitfaden/06_tests.md ergänzt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-18 07:37:40 +02:00
DanielandClaude Sonnet 5 e5e1b6e768 Testkatalog: neuer Test für Grenzpunkt-Stilanbringung (#53)
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 16:29:26 +02:00
DanielandClaude Sonnet 5 4d036516a1 Testkatalog: neuer Test für get_plugin_root()-Fix (Verfahrensgebiet #50)
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 16:12:17 +02:00
DanielandClaude Sonnet 5 4f87684224 Test-Audit: TestStilpruefer (sn_basis) fachlich geprüft
Alle 4 Tests gegen modules/stilpruefer.py geprüft - Docstrings passen
zur Implementierung, keine Diskrepanzen. Dabei entdeckt: der relative
Pfad-Zweig (sn_plan41/assets-Redirect) ist untestet und hängt von
get_plugin_root() ab, das laut #50 in Plugin_SN_Verfahrensgebiet einen
Junction-Auflösungsfehler hat. Test für diesen Zweig zurückgestellt,
bis der #50-Fix vorliegt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 15:51:40 +02:00
DanielandClaude Sonnet 5 a2467d3431 Test-Audit: TestSettingsLogic (sn_basis) fachlich geprüft
Alle 4 Tests gegen functions/settings_logic.py geprüft. Eine Docstring
war ungenau (Fallback-Verantwortung fälschlich load() zugeschrieben,
siehe vorheriger Commit) - jetzt korrigiert, alle vier bestätigt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 15:04:42 +02:00
DanielandClaude Sonnet 5 6b687c34d2 Testkatalog neu erzeugt: korrigierte Docstring test_settings_logic
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 15:01:29 +02:00
DanielandClaude Sonnet 5 fe55d5b914 Test-Audit: TestPruefmanager (sn_basis) fachlich geprüft
Alle 14 Tests gegen modules/Pruefmanager.py geprüft - Docstrings passen
zur Implementierung. Dabei entdeckt: _ask_use_or_replace_pufferlayer()
und _handle_verfahrensgebiet_layer_existiert() haben weder Tests noch
Aufrufer im gesamten Workspace; erstere referenziert ein nicht
existierendes self.pruefmanager (Absturz bei Aufruf) - dafür eigenes
Issue angelegt (Entwurf in entwuerfe/), analog zu #59.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 14:56:52 +02:00
DanielandClaude Sonnet 5 0f8f80a71d Test-Audit: TestLinkpruefer (sn_basis) fachlich geprüft
Alle 6 Tests (5 bestehende + neuer Testfall für leere Eingabe) gegen
modules/linkpruefer.py geprüft - Docstrings passen zur Implementierung,
keine Diskrepanzen gefunden.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 14:46:22 +02:00
DanielandClaude Sonnet 5 18bb17ac57 Test-Audit: TestLayerpruefer (sn_basis) fachlich geprüft
Alle 10 Tests gegen modules/layerpruefer.py geprüft - Docstrings passen
zur Implementierung, keine Diskrepanzen gefunden. Monkeypatch-Isolation
in setUp() (kein tearDown) bewusst unangetastet gelassen, da aktuell
keine andere Testdatei Layerpruefer verwendet.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 14:42:34 +02:00
DanielandClaude Sonnet 5 aa63f234e7 Test-Audit: TestGetLaenderkennung (sn_basis) fachlich geprüft
Alle 5 Tests gegen functions/laenderkennung.py geprüft - Docstrings
passen zur Implementierung, keine Diskrepanzen gefunden.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 14:38:42 +02:00
DanielandClaude Sonnet 5 3a07785a66 Test-Audit: TestDateipruefer (5 von 6) fachlich geprüft
leereingabe_erlaubt, leereingabe_nicht_erlaubt, temporaer_erlaubt,
datei_nicht_gefunden, datei_ok geprüft und bestätigt - Docstrings passen
zur Implementierung. test_standarddatei_vorschlagen bewusst ausgenommen,
solange die Design-Entscheidung zu Basis #59 (Standarddatei-Modus) offen
ist.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 14:35:44 +02:00
DanielandClaude Sonnet 5 78105fcd64 STATUS.md: offenen Punkt zur Standarddatei-Existenzprüfung ergänzt (Basis #59)
Fund aus dem Test-Audit (#16): Dateipruefer/Pruefmanager prüfen bei
standarddatei_vorschlagen nie file_exists(). Bearbeitung bewusst
zurückgestellt, bis geklärt ist, ob der Standarddatei-Modus überhaupt
gebraucht wird - separates Issue Basis #59, eigener Branch bei Bedarf.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 14:27:23 +02:00
DanielandClaude Sonnet 5 f2eb883162 Testkatalog neu erzeugt: TestFlurstueckAlkis-Korrekturen (#16)
Nach der Testabgleichung in Plugin_SN_Verfahrensgebiet (bugfix/16-
flurstueck-alkis-testabgleich): Docstrings jetzt in "Prueft, dass ..."-
Form, ein Test entfernt, Gruen/Rot-Zaehlung aktualisiert.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 12:12:03 +02:00
DanielandClaude Sonnet 5 4fb90fba31 Testkatalog neu erzeugt: restliche sn_basis-Docstrings
sn_basis steht jetzt bei 94 von 94 Testfällen mit Docstring (100 %),
Gegenstück zu Plugin_SN_Basis-Commit 23aab76 (Branch
feature/testdatagrabber-docstrings).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 15:06:33 +02:00
DanielandClaude Sonnet 5 accf1bf7e8 Test-Audit: TestDataGrabber (sn_basis) fachlich geprüft
Erster echter Audit-Durchgang mit scripts/test_audit.py: alle sechs
TestDataGrabber-Testfälle durchgesehen, mit Docstring versehen
(Plugin_SN_Basis, separater Branch/PR) und als geprüft markiert.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 13:18:13 +02:00
DanielandClaude Sonnet 5 ec400ae59e Test-Audit: Datei:Zeile und Quelltext-Ausgabe für bequemes Ansehen/Editieren
status zeigt je Treffer "<Datei>:<Zeile>" (in Editor-Terminals anklickbar)
und optional per --code den Testquelltext im Terminal. Der Prüfstand selbst
bleibt ohne Quelltext, um Diff-Lärm bei jeder Codeänderung zu vermeiden.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 12:45:12 +02:00
DanielandClaude Sonnet 5 5dfec4f934 STATUS.md: Test-Audit-Infrastruktur als offene Baustelle ergänzt
Ticket #16 ist mit dieser PR technisch umgesetzt (Skript + Datenformat +
Prüfstand); der eigentliche Audit-Durchgang durch die 346 Testfälle ist
ein separater nächster Schritt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 10:25:09 +02:00
DanielandClaude Sonnet 5 d9d2542a20 Test-Audit einführen: Prüfstatus je Testfall im Prüfstand sichtbar machen
Ticket #16. docs/status/testpruefungen.json hält je Testfall Datum und
Kurzprüfsumme der letzten fachlichen Prüfung fest; scripts/testkatalog.py
liest das und zeigt es als eigene Spalte/Pille (nie geprüft / geprüft am …
/ veraltet seit Änderung …), unabhängig vom Baseline-Status. Neues Skript
scripts/test_audit.py (status/markieren) pflegt die Datei; erste Tests für
scripts/ unter scripts/tests/.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 10:23:45 +02:00
24 changed files with 3302 additions and 2905 deletions
+6
View File
@@ -57,6 +57,12 @@ listet Tests ohne Docstring – Stand 15.09.2026 haben nur 114 von 346 Tests ein
Testdatei per Mermaid, Filter, Suche) – lokal im Browser öffnen, kein Server nötig; Mermaid lädt von
`cdnjs.cloudflare.com`, ohne Internetverbindung bleiben nur die Diagramme leer.
## Test-Audit (Prüfvermerke)
`python scripts/test_audit.py status <paket> --nur ungeprueft` zeigt offene Testfälle. **`markieren` nur auf
ausdrückliche Aufforderung** – die Markierung bedeutet „ein Mensch hat fachlich bestätigt". Ohne Freigabe:
sichten, Lücken ergänzen, mit `markieren … --trocken` die vorgeschlagenen Treffer zeigen und nachfragen.
Details: `docs/leitfaden/06_tests.md` Abschnitt 7.
## Testkonzept-Seiten
Für fachlich wichtige Abläufe liegt in `docs/tests/<ablauf>.md` eine Seite nach `docs/vorlagen/testkonzept.md`:
Mermaid-Diagramm des fachlichen Ablaufs, Tabelle Schritt → deckender Test → bewusst nicht getestet mit
+3
View File
@@ -45,6 +45,9 @@ Sie bleibt bewusst kurz: Details liegen in `docs/` und werden nur bei Bedarf gel
Danach `python scripts/testkatalog.py` neu erzeugen und mitcommitten.
- Tests werden nicht gelöscht, nicht mit `skip` stillgelegt und nicht in ihrer Erwartung angepasst, um grün zu werden –
außer das Verhalten wurde bewusst geändert und der Pull Request begründet es. Details: `docs/leitfaden/06_tests.md`.
- **Testfälle nur auf ausdrückliche Aufforderung als „geprüft" markieren** (`scripts/test_audit.py markieren`).
Die Markierung bestätigt, dass ein Mensch den Test fachlich abgenommen hat; ein Auftrag wie „Audit fortsetzen"
reicht dafür nicht. Agenten sichten, ergänzen Tests und schlagen die Markierung vor – markieren erst nach Freigabe.
### Code
-1
View File
@@ -19,7 +19,6 @@
| `tests/testkatalog.html` | generiert | dieselben Daten als lokal zu öffnendes Dashboard „Prüfstand“ (Baumdiagramm je Testdatei, Filter, Suche) – vom selben Lauf erzeugt |
| `tests/*.md` | lebend | Testkonzepte je Fachablauf, mit Mermaid; Vorlage in `vorlagen/` |
| `konzept/07_qgis_tests_plan.md` | Vorschlag | Stufenplan für Tests gegen echtes QGIS |
| `konzept/10_basemap_legende.md` | zur Freigabe | Basemap-Legende im Druck und Basemap-Stilvorlagen (Basis #88) |
| `konzept/09_alkis7_umstellung.md` | Prüfliste | ALKIS 6 ↔ 7 (GID 6.0/7.1), was in `sn_verfahrensgebiet` anzupassen ist |
| `konzept/08_repo_einrichten.md` | Prüfliste | Repo auf Gitea anlegen, `stable` und Branch-Schutz |
| `konzept/02_zusammenarbeit_ki_agenten.md` | stabil | Begründung und Aufbau der Zusammenarbeit |
+26 -37
View File
@@ -15,20 +15,19 @@ Legende: ⚠ = über 600 Zeilen, nie komplett laden, per `grep -n "def "` navigi
| `main.py` | 64 | `BasisPlugin`: baut `Navigation`, startet Verfahrensgebiet-Listener, ruft `initGui()` aller `sn_*`-Plugins nach, räumt beim Unload auf |
| `ui/navigation.py` | 127 | Menü und Toolbar „LNO Sachsen“; `add_action(text, callback, tooltip, priority)`, `finalize_menu_and_toolbar()`, `set_active_plugin()`. Enthält noch Debug-`print` und eine `TEST ACTION` |
| `ui/dockmanager.py` | 86 | `DockManager.show(dock)`: entfernt alle anderen `sn_dock_*`-Docks, zeigt das neue rechts an |
| `ui/base_dockwidget.py` | 172 | `BaseDockWidget`: Titel „LNO Sachsen \| <Untertitel>“, Tabs aus Klassenattribut `tabs`, jeder Tab in einem Scroll-Bereich (`setWidget`, #104), ruft `cleanup()` der Tabs beim Schließen, setzt Toolbar-Action zurück |
| `ui/base_dockwidget.py` | 126 | `BaseDockWidget`: Titel „LNO Sachsen \| <Untertitel>“, Tabs aus Klassenattribut `tabs`, ruft `cleanup()` der Tabs beim Schließen, setzt Toolbar-Action zurück |
| `ui/tabs/settings_tab.py` | 158 | Tab „Projekteigenschaften“: Benutzer- und Projektfelder → Projektvariablen (`SettingsLogic`) |
| `ui/tabs/print_tab.py` ⚠ | 730 | Tab „Druck“: Druckbereich, Maßstab, Format, Themen, Legende, Atlas, Basemap-Bereich; nutzt `print_logic` |
| `ui/widgets/basemap_bereich.py` | 503 | Einklappbarer Bereich „Basemap“ im Druck-Tab: Basemap hinzufügen und Thema wechseln (#100), Auswertebereich, Legende aktualisieren, Stilvorlagen inkl. Export/Import (#101) |
| `ui/tabs/print_tab.py` ⚠ | 709 | Tab „Druck“: Druckbereich, Maßstab, Format, Themen, Legende, Atlas; nutzt `print_logic` |
### functions/ – Wrapper-Schicht (Qt/QGIS/OS mit Mock-Fallback)
| Datei | Zeilen | Zweck |
|---|---:|---|
| `functions/__init__.py` | 50 | Re-Export vieler Wrapper (`from sn_basis.functions import QgsProject, info, ...`) |
| `functions/qt_wrapper.py` ⚠ | 873 | Qt-Symbole: PyQt6 primär, PyQt5-Fallback, sonst Mock. `QT_VERSION` (0/5/6), Enum-Aliase (`DockAreaRight`, …), `exec_dialog()` |
| `functions/qgiscore_wrapper.py` ⚠ | 1 474 | `qgis.core`-Symbole und Konstanten; ab Zeile ~255 Mock-Klassen; eigener Block für Vektorkacheln/Ausdrücke/Legende (#88); Helfer `network_head`, `get_layer_extent`, `create_buffer_layer`, `layer_exists_in_gpkg`, `polygon_zu_linie` |
| `functions/qgisui_wrapper.py` | 292 | `iface`-Zugriffe: Hauptfenster, Docks, Menüs, Toolbars, Layoutdesigner, Zoom auf Layer (`zoom_auf_layer`), aktiver Layer (`get_active_layer`); Mock-`iface` |
| `functions/dialog_wrapper.py` | 570 | Dialoge: `ask_yes_no`, `show_info_dialog`, `ask_text`, Überschreiben/Anhängen/Abbrechen, `ask_auswahl` (frei benannte Knöpfe), `ProgressDialog`/`create_progress_dialog`, `ask_mehrfachauswahl` (Liste mit Häkchen) |
| `functions/qt_wrapper.py` ⚠ | 796 | Qt-Symbole: PyQt6 primär, PyQt5-Fallback, sonst Mock. `QT_VERSION` (0/5/6), Enum-Aliase (`DockAreaRight`, …), `exec_dialog()` |
| `functions/qgiscore_wrapper.py` ⚠ | 1 122 | `qgis.core`-Symbole und Konstanten; ab Zeile ~255 Mock-Klassen; Helfer `network_head`, `get_layer_extent`, `create_buffer_layer`, `layer_exists_in_gpkg`, `polygon_zu_linie` |
| `functions/qgisui_wrapper.py` | 258 | `iface`-Zugriffe: Hauptfenster, Docks, Menüs, Toolbars, Layoutdesigner; Mock-`iface` |
| `functions/dialog_wrapper.py` | 393 | Dialoge: `ask_yes_no`, `show_info_dialog`, `ask_text`, Überschreiben/Anhängen/Abbrechen, `ProgressDialog`/`create_progress_dialog` |
| `functions/message_wrapper.py` | 85 | MessageBar: `info`, `warning`, `error`, `success`, `push_message` |
| `functions/variable_wrapper.py` | 120 | `get_variable(key, scope)`, `set_variable(...)` mit Präfix `sn_`; Mock-Speicher |
| `functions/settings_logic.py` | 50 | `SettingsLogic.VARIABLEN`: Liste der gespeicherten Projektvariablen, `load()/save()` |
@@ -56,26 +55,17 @@ Legende: ⚠ = über 600 Zeilen, nie komplett laden, per `grep -n "def "` navigi
| `modules/Datenabruf.py` ⚠ | 636 | `Datenabruf.datenabruf(...)`: WFS, ArcGIS REST, OGR laden; Raumfilter Verfahrensgebiet/Puffer/ohne |
| `modules/LayerLoader.py` | 422 | `create_layer(provider, link, thema)`, `apply_style`, `filter_by_extent`, `filter_by_layer`, `add_to_project` |
| `modules/Datenschreiber.py` | 448 | `schreibe_Daten(...)` in GeoPackage, `lade_Layer(...)` ins Projekt, `schreibe_log(...)` HTML-Protokoll |
| `modules/print_logic.py` ⚠ | 1 419 | `PrintLogic`, `AtlasConfig`, `RectangleCaptureTool`: Druckbereich, Maßstab, Atlas, Layoutaufruf |
| `modules/print_layout.py` ⚠ | 1 137 | `PrintLayout`: Layoutaufbau für § 38 / § 41 (Karte, Legende, Gitter, Schriftfeld) |
| `modules/print_kartenrand.py` | 284 | Kartenrand (Legenden, Quellenangabe, Kartenschild) überlappungsfrei anordnen: 1–3 Legendenspalten, Rand breiter, Seite ggf. höher (#93); Legenden-Mindestbreite 180 mm samt Listener für das Neuladen (#96) |
| `modules/print_layout_baufreigabe.py` | 419 | Layout „Anlage zur Baufreigabe“ (feste DIN A3/A4 quer) |
| `modules/basemap_legende.py` | 471 | Basemap-Legende (#88): Legendenkatalog laden, Styles → Einträge, Auswahl merken, Basemap-Layer erkennen, Auswertebereich; `BasemapLegende.aktualisiere(layout)` als Einstieg |
| `modules/basemap_kacheln.py` | 192 | Kacheln des Basemap-Layers kachelweise über `selectByGeometry` auswerten, Renderer-Styles lesen, Zoomstufen wie der QGIS-Renderer |
| `modules/basemap_legende_layout.py` | 471 | Legendensymbole aus Projektlayer-Styles zusammensetzen (weiße Flächen mit Legendenrand, #92), leere Hilfslayer, Legendenelement „Legende Basemap“ schreiben und platzieren |
| `modules/basemap_katalog.py` | 418 | Erzeugt/aktualisiert `data/basemap_legende.json` aus der basemap.de-Style-JSON (nur Standardbibliothek, eigenständig aufrufbar) |
| `modules/basemap_stilkorrektur.py` | 99 | Darstellungsfehler des Basemap-Layers korrigieren: Punktlinien mit Strichlänge 0 sichtbar machen (#90) |
| `modules/basemap_stilvorlagen.py` | 313 | Lokale Stilvorlagen des Basemap-Layers (QML + JSON im QGIS-Profil, mit Thema), Standard in `QSettings`; Export als ZIP, Import von ZIP oder QML, Themenprüfung beim Laden (#101) |
| `modules/basemap_themen.py` | 245 | Themen des Basemap-Layers (Farbe, Grau): Layer anlegen, an der Quell-URL erkennen, Thema wechseln, Prüfwert der Darstellung für ungespeicherte Änderungen (#100) |
| `modules/print_logic.py` ⚠ | 1 321 | `PrintLogic`, `AtlasConfig`, `RectangleCaptureTool`: Druckbereich, Maßstab, Atlas, Layoutaufruf |
| `modules/print_layout.py` ⚠ | 1 078 | `PrintLayout`: Layoutaufbau für § 38 / § 41 (Karte, Legende, Gitter, Schriftfeld) |
| `modules/print_layout_baufreigabe.py` | 403 | Layout „Anlage zur Baufreigabe“ (feste DIN A3/A4 quer) |
### Sonstiges
| Pfad | Zweck |
|---|---|
| `tests/` | 13 Testdateien, `unittest`, Mock-Modus; `run_tests.py` (farbiger Runner), `test_qgis.bat` (Coverage in OSGeo4W) |
| `tests/` | 32 Testdateien, `unittest`, Mock-Modus; `run_tests.py` (farbiger Runner), `test_qgis.bat` (Coverage in OSGeo4W) |
| `styles/` | QML-Stile (Verfahrensgebiet, LSG, Denkmalschutz, Flurstücksbeschriftung) |
| `data/landkreise.json` | Landkreise mit Kennzahl |
| `data/basemap_legende.json` | Legendenkatalog basemap.de: Style-ID → Legendeneintrag (190 Einträge), erzeugt mit `basemap_katalog.py`, fachlich nachbearbeitet |
| `assets/plan-qgis340ExitCrashFix.prompt.md` | KI-Planungsnotiz zum Exit-Crash (historisch) |
| `.gitea/workflows/release.yaml`, `.gitea/templates/metadata.template` | Release-Auslöser, Vorlage für `metadata.txt` |
@@ -84,28 +74,21 @@ Legende: ⚠ = über 600 Zeilen, nie komplett laden, per `grep -n "def "` navigi
| Datei | Zeilen | Zweck |
|---|---:|---|
| `main.py` | 80 | `Verfahrensgebiet`: registriert Action (Priorität 10), erzeugt `DockWidget` mit `Pruefmanager` und `DataGrabber` |
| `ui/dockwidget.py` | 60 | Tabs `WorkingTab`, `EigentuemerTab`, `PrintTab`, `SettingsTab`; injiziert Services per `set_services()` |
| `ui/tabs/working_tab.py` ⚠ | 820 | Tab „Bearbeitung“: Buttons und Handler für ALKIS/Shape laden, Gemarkungen, Flurstücke, Grenzpunkte, Beteiligung, Statistik; hält viel Ablauflogik |
| `ui/tabs/eigentuemer_tab.py` | 440 | Tab „Eigentümer“ (#56): Flurstückssuche, Eigentümersuche, Anzeige für den Eigentümer (Sitzung, „Anzeige leeren“, Lage des Fensters merken) und Korrekturen mit Pfadanzeige |
| `ui/eigentuemer_treffer.py` | 83 | Nicht modale Trefferliste der Eigentümersuche mit Mehrfachauswahl und „Daten anzeigen“ (#56) |
| `ui/eigentuemer_anzeige.py` | 112 | Anzeigefenster für den Eigentümer (nur Name, Anschrift, E-Mail; maskiertes HTML), immer mit Rahmen, nie Vollbild (#56) |
| `ui/eigentuemer_korrektur_dialog.py` | 79 | Korrekturdialog für den Bearbeiter (#56) |
| `ui/dockwidget.py` | 60 | Tabs `WorkingTab`, `PrintTab`, `SettingsTab`; injiziert Services per `set_services()` |
| `ui/tabs/working_tab.py` ⚠ | 873 | Tab „Bearbeitung“: Buttons und Handler für ALKIS/Shape laden, Gemarkungen, Flurstücke, Grenzpunkte, Beteiligung, Statistik; hält viel Ablauflogik |
| `functions/verfahrensgebiet_alkis.py` | 359 | WFS-Suche `BauRaumOderBodenordnungsrecht` per Verfahrensnummer/Landkreis, `LoadStatus` |
| `functions/verfahrensgebiet_alkis_komplett.py` ⚠ | 661 | Vollständiger Ladeablauf aus ALKIS: BROR → Gemarkungen → Flurstücke → Flächenvergleich → Detailprüfung |
| `functions/verfahrensgebiet_shape_komplett.py` ⚠ | 978 | Ladeablauf aus Shape/ZIP (Mehrfachauswahl, `FBSchl`-Klassifikation, Abgleich mit BROR) – siehe `docs/aus_shape_laden_technisch.md` im Repo |
| `functions/verfahrensgebiet_dialoge.py` | 344 | Dialoge: BROR-Kombinationen, Landkreis-Objekte, Landkreisauswahl; gemeinsame Auswahltabelle `baue_auswahltabelle` (auch für die Eigentümer-Trefferliste) |
| `functions/verfahrensgebiet_dialoge.py` | 300 | Dialoge: BROR-Kombinationen, Landkreis-Objekte, Landkreisauswahl |
| `functions/verfahrensgebiet_edit_service.py` | 359 | Verfahrensgebiet aus Flurstücksauswahl bilden, ergänzen, entfernen, ersetzen |
| `functions/gemarkung_alkis.py` | 229 | Gemarkungen aus vereinfachtem ALKIS-WFS |
| `functions/flurstueck_alkis.py` | 259 | Flurstücke je Gemarkung aus ALKIS-SF-WFS (BBOX, Batches) |
| `functions/flurstueck_suche.py` | 175 | Flurstückssuche im Layer „Flurstücke“ über das `flurstueckskennzeichen`; Gemarkungsname über Layer „Gemarkungen“ |
| `functions/eigentuemer_korrektur.py` | 128 | Korrekturen ermitteln und an `<Eigentümerdatei>_korrekturen.csv` anhängen; Pfad aus der Layerquelle; Qt-frei (#56) |
| `functions/eigentuemer_suche.py` | 225 | Eigentümersuche im CSV-Layer (Serienbriefexport): Layer erkennen, Name/Vorname suchen, gleiche Personen mit gleicher Anschrift zusammenfassen; Qt-frei |
| `functions/grenzpunkt_alkis.py` ⚠ | 1 674 | Grenzpunkte/`PunktortTA` gemarkungsweise, GML-Parsing, URL-sichere Batches |
| `functions/knickpunkt_pruefung.py` ⚠ | 810 | Knickpunktbasierte BROR-Prüfung, Ergebnislayer mit Kategorien |
| `functions/umringspruefung.py` | 312 | Umringsprüfung (Variante 1) |
| `functions/umringstatistik_grenzpunkte.py` | 374 | Statistik Grenzpunkte am Umring |
| `functions/beteiligung_pruefung.py` | 453 | Abgleich BI-Server-CSV mit ALKIS-Flurstücken |
| `tests/` | 18 Dateien | Mock-Modus, aktuell 157/201 grün (Baseline) |
| `tests/` | 12 Dateien | Mock-Modus, aktuell 157/201 grün (Baseline) |
| `docs/` | 3 Dateien | Ablaufdiagramme (Mermaid) für ALKIS- und Shape-Laden |
| `styles/` | 6 QML | BROR, Gemarkungen, Beteiligung, Verfahrensgebiet |
@@ -141,17 +124,23 @@ Dient als **minimales Muster** für ein neues Fachplugin (Skill `sn-neues-fachpl
| `Linkliste` | `linkliste.csv` → Gitea Action erzeugt XML/JSON/YAML |
| `Defaults` | Beispiel-Verfahrensdaten (JSON) und `styles/verfahrensgebiet.qml`; nicht vom Code referenziert |
## Workspace-Skripte (dieses Repository, `scripts/`)
| Pfad | Zweck |
|---|---|
| `scripts/test_audit.py` | Prüf-Audit: zeigt (`status`) und markiert (`markieren`) je Testfall, wann er zuletzt fachlich geprüft wurde; schreibt `docs/status/testpruefungen.json`. Nutzt die Katalog-Logik aus `scripts/testkatalog.py`, siehe `docs/leitfaden/06_tests.md` Abschnitt 7. |
## Größte Dateien (Kandidaten für das spätere Refactoring)
| Datei | Zeilen |
|---|---:|
| `sn_verfahrensgebiet/functions/grenzpunkt_alkis.py` | 1 674 |
| `sn_basis/modules/print_logic.py` | 1 419 |
| `sn_basis/modules/print_logic.py` | 1 321 |
| `sn_plan41/ui/tab_a_logic.py` | 1 239 |
| `sn_basis/functions/qgiscore_wrapper.py` | 1 474 |
| `sn_basis/modules/print_layout.py` | 1 137 |
| `sn_basis/functions/qgiscore_wrapper.py` | 1 122 |
| `sn_basis/modules/print_layout.py` | 1 078 |
| `sn_verfahrensgebiet/functions/verfahrensgebiet_shape_komplett.py` | 978 |
| `sn_verfahrensgebiet/ui/tabs/working_tab.py` | 820 |
| `sn_verfahrensgebiet/ui/tabs/working_tab.py` | 873 |
| `sn_verfahrensgebiet/functions/knickpunkt_pruefung.py` | 810 |
| `sn_basis/functions/qt_wrapper.py` | 873 |
| `sn_basis/ui/tabs/print_tab.py` | 730 |
| `sn_basis/functions/qt_wrapper.py` | 796 |
| `sn_basis/ui/tabs/print_tab.py` | 709 |
-73
View File
@@ -40,23 +40,6 @@ Vertrag für ein Fachplugin (Muster: `Plugin_SN_Widmung/main.py`):
Optional `set_services(pruefmanager=..., data_grabber=...)` (wird von Fachplugin-Docks aufgerufen) und `cleanup()` (wird beim Schließen des Docks aufgerufen – Signale trennen!).
- Gemeinsame Tabs aus `sn_basis`: `ui.tabs.print_tab.PrintTab` (Druck), `ui.tabs.settings_tab.SettingsTab` (Projekteigenschaften).
- `dock.action` = Referenz auf die Toolbar-Action; `BaseDockWidget.closeEvent` setzt sie zurück.
- **Scroll-Bereich je Tab (Basis #104):** `BaseDockWidget.setWidget(widget)` packt jeden Tab eines `QTabWidget` in einen
`QScrollArea` (`widgetResizable`, ohne Rahmen; Funktion `base_dockwidget.tabs_mit_scrollbereich`). Das gilt auch für
Fachplugins, die ihre Tabs in `_init_tabs_with_services()` selbst aufbauen und per `setWidget` einsetzen. Folge:
`dock.widget().widget(i)` liefert den Scroll-Bereich, die Tab-Instanz ist `….widget(i).widget()`; das Eltern-Widget
eines Tabs ist der Viewport des Scroll-Bereichs, nicht mehr das `QTabWidget`. Tabs vor `setWidget` vollständig hinzufügen.
## 2a. Koordinatenbezugssysteme (Basis #99)
- **Ausdehnungen stehen im KBS ihrer Quelle:** `layer.extent()` im Layer-KBS, `canvas.extent()` im KBS der
Kartenansicht (`canvas.mapSettings().destinationCrs()`), Layoutkarten in `map_item.crs()`. Wer eine Ausdehnung
weitergibt, rechnet sie mit `qgiscore_wrapper.transformiere_rechteck(rechteck, quell_crs, ziel_crs)` um.
- **Zoom auf einen Layer:** `qgisui_wrapper.zoom_auf_layer(layer, canvas=None)` – nie `canvas.setExtent(layer.extent())`.
- **Druck-KBS:** Die Hauptkarte der Layouts (§ 38/§ 41, Baufreigabe) steht im KBS des Verfahrensgebiet-Layers, ohne
diesen im Projekt-KBS (`PrintLogic._druck_crs`); `create_single_page_layout`/`create_baufreigabe_layout` nehmen es
als Parameter `crs` und setzen es vor der Ausdehnung. Alle Druckbereiche werden in dieses KBS umgerechnet.
- **Druckrechteck:** Der Layer „Druckrechteck“ hat das KBS des Verfahrensgebiets; das in der Kartenansicht
gezeichnete Rechteck wird vor dem Speichern umgerechnet. `druckrechteck_xmin/…` stehen im KBS dieses Layers.
## 3. Projektvariablen (gemeinsamer Zustand im QGIS-Projekt)
@@ -72,9 +55,6 @@ Der Wrapper setzt das Präfix `sn_` selbst; Schlüssel **ohne** Präfix übergeb
| `linkliste`, `tab_a_linkliste` | Plan41 Tab A | Plan41 | Pfad der Linkliste (XLSX) |
| `tab_a_layer_id`, `Raumfilter` | Plan41 Tab A | Plan41 | Raumfilter-Einstellung |
| `druckrechteck_xmin/xmax/ymin/ymax` | PrintTab/PrintLogic | Druck | gespeicherter Druckbereich |
| `basemap_auswertebereich` | Basemap-Bereich im Druck-Tab | `basemap_legende` | `verfahrensgebiet` (Standard) oder `druckbereich` (Basis #88) |
| `basemap_legende_erzeugen` | Basemap-Bereich | `print_logic` | `1`/`0`, Standard `1`: Basemap-Legende beim Erstellen einer §-38/§-41-Vorlage |
| `basemap_legende_auswahl` | `basemap_legende`, Stilvorlage laden | Auswahldialog | JSON `{"ausgeblendet": [...], "eingeblendet": [...]}` mit Eintragsschlüsseln des Legendenkatalogs |
| `sn_abdeckungslayer` ⚠ | PrintTab/PrintLogic | Druck (Atlas) | Atlas-Abdeckungslayer. **Schlüssel enthält bereits `sn_` → tatsächliche Variable `sn_sn_abdeckungslayer`**; funktioniert, ist aber inkonsistent |
| `verfahrensgebietslayer` ⚠ | `print_logic.py` | `print_logic.py` | **Zweite Schreibweise neben `verfahrensgebiet_layer`** – vermutlich Altlast, beim Refactoring zusammenführen |
@@ -146,56 +126,3 @@ flowchart LR
## 10. Linkliste-Repository
`linkliste.csv` (Semikolon, Spalten `id;gruppe;ebene;inhalt;url;provider;stil`) → Gitea Action → `linkliste.xml/json/yaml` auf `main`. Die Plan41-Laufzeit nutzt stattdessen die mitgelieferte `assets/Linkliste.xlsx` mit abweichenden Spaltennamen.
## 11. Basemap-Legende im Druck (Basis #88)
- **Welche Layouts:** `print_logic.LAYOUTS_MIT_BASEMAP_LEGENDE` (heute §38, §41). Ein Layout nutzt die Funktion,
wenn es die Layout-Eigenschaft `sn_basemap_legende = 1` trägt (`basemap_legende_layout.markiere_layout`);
`PrintLayout.create_single_page_layout(..., basemap_legende=True)` setzt sie und erzeugt die Legende vor dem
Öffnen des Designers. Neue Layouts: in die Konstante aufnehmen bzw. das Kennzeichen setzen.
- **Layout-Elemente nach ID:** `Hauptkarte` (Bezugskarte), `Legende` (Hauptlegende, Spalte und Oberkante),
`Quellenangabe` (Unterkante der Basemap-Legende), `Legende Basemap` (das Basemap-Element selbst).
Umbenennen dieser IDs bricht die Platzierung.
- **Weitere Layout-Eigenschaften:** `sn_basemap_bereich`, `sn_basemap_massstab`, `sn_basemap_eintraege` (JSON),
`sn_basemap_hilfslayer` (IDs der Hilfslayer, werden beim Aktualisieren ersetzt).
- **Hilfslayer:** leere Speicherlayer, nicht im Layerbaum, Eigenschaften `sn_basemap_legende = <Layoutname>` und
`skipMemoryLayersCheck = 1`. Code, der über `QgsProject.mapLayers()` iteriert, sieht sie.
- **Basemap-Layer-Erkennung:** Vektorkachel-Layer, Quelle enthält `gdz_basemapde_vektor`; Name „basemap.de“ nur
als Rückfall.
- **Legendenkatalog:** `sn_basis/data/basemap_legende.json` (Style-ID → Eintrag), erzeugt/aktualisiert mit
`python modules/basemap_katalog.py`; gehört zur Style-Version `bm_web_col` v2.
- **Stilvorlagen:** lokal unter `<QGIS-Profil>/sn_basis/basemap_stile/`, Standard in `QSettings`
`sn_basis/basemap_standardstil`. Die Begleit-JSON trägt seit #100 das Feld `thema` (Schlüssel aus
`basemap_themen.THEMEN`; fehlt bei älteren Vorlagen). Austauschformat seit #101: ZIP mit genau einer
`<name>.qml` und optional `<name>.json`; der Import nimmt auch eine reine QML-Datei an.
- **Thema und Stil (Basis #100):** *Thema* = vom Dienst als Style-JSON gelieferte Darstellung (`farbe` →
`bm_web_col.json`, `grau` → `bm_web_gry.json`); *Stil* = lokale Anpassung (Stilvorlage). Alle Themen nutzen
dieselbe Kachel-URL `…/tiles/v2/bm_web_de_3857/{z}/{x}/{y}.pbf`; das Thema steht im Quellparameter `styleUrl`.
„Schon vorhanden“ heißt: ein Layer mit identischer Kachel-URL (Quellparameter `url`).
- **Layer-Eigenschaften des Basemap-Layers (#100):** `sn_basemap_thema` (Schlüssel des zuletzt geladenen Themas)
und `sn_basemap_pruefwert` (SHA-256 der QML von Symbologie und Beschriftung ohne QGIS-Version, gesetzt nach
Laden eines Themas oder Stils und nach Speichern als Stil). Fehlt der Prüfwert, gilt der Änderungsstand als
unbekannt und vor dem Themenwechsel wird nachgefragt.
- **Themenwechsel:** `basemap_themen.wechsle_thema` stellt die Quelle per `setDataSource` um und lädt
`loadDefaultStyle()`; Layer-ID, Position im Layerbaum und Bezüge in Layouts bleiben. Ziel ist der im Layerbaum
ausgewählte Basemap-Layer, sonst der erste des Projekts.
- **Neue öffentliche Funktion:** `dialog_wrapper.ask_mehrfachauswahl(titel, hinweis, eintraege, vorauswahl)` –
Liste mit Häkchen, Gruppen, Suche; liefert gewählte Schlüssel oder `None` bei Abbruch.
- **Neue öffentliche Funktionen (#100):** `dialog_wrapper.ask_auswahl(title, message, optionen, default, abbrechen)` –
Rückfrage mit frei benannten Knöpfen `[(schluessel, beschriftung), …]`, liefert den Schlüssel; Esc/Fehler →
`abbrechen`, Mock-Modus → `default`. `qgisui_wrapper.get_active_layer()` – ausgewählter Layer oder `None`.
## 12. Kartenrand im Standardlayout (Basis #93)
`print_kartenrand.ordne_kartenrand_an(layout)` läuft am Ende von `PrintLayout.create_single_page_layout` und findet
die Elemente **über ihre IDs**: `Hauptkarte`, `Legende`, `Legende Basemap`, `Quellenangabe`, `Kartenschild`,
`Kartenschild_Linie_1` … `_6` und die Schriftfeld-Beschriftungen (`Herausgeber` … `Aktenzeichen`, Liste
`UNTERE_ELEMENTE`). Wer im Layoutaufbau eine dieser IDs ändert oder ein neues Element unter die Legenden setzt,
muss die Liste anpassen. Die Seitengröße aus `print_logic` ist danach nur noch eine Mindestgröße: Breite und Höhe
können wachsen, die Karte bleibt bei 10 mm / 10 mm mit unveränderter Größe.
Legenden sind mindestens so breit wie das Kartenschild (180 mm, `MIN_SPALTENBREITE_MM`; die 210 mm in
`print_logic.STANDARD_LAYOUT_FIXBREITE_MM` sind der gesamte Kartenrand mit Abständen). Weil QGIS die Mindestgröße
nicht speichert, trägt das Layout die Eigenschaft `sn_legende_mindestbreite`; `sn_basis.main` verbindet beim Start
`setup_mindestbreiten_listener()` (readProject) und trennt ihn in `unload()` (Basis #96).
@@ -41,3 +41,11 @@ Nur den generierten Katalog (zeigt was getestet wird, aber nicht ob es genügt
geht, fiele weg); nur handgeschriebene Testkonzepte (laufen dem Code hinterher, dieselbe Drift, die die
Wissensbasis sonst vermeidet); Testabdeckung in Prozent als Ziel (misst durchlaufene Zeilen, nicht fachliche
Vollständigkeit, und verleitet zu Tests ohne Aussage).
## Ergänzung (18.09.2026)
Der Testkatalog weist seither zusätzlich einen Abschnitt „Ungetestete Funktionen (strukturelle Lücke)" aus:
Funktionen/Methoden im Quellcode, deren Name in keiner Testdatei des Pakets vorkommt (Namensabgleich per `ast`,
ohne Import und ohne Laufzeitmessung). Das ist **keine** Wiederaufnahme der oben verworfenen
Zeilen-Coverage-in-Prozent: Es gibt keine Prozentzahl als Ziel, sondern eine Lückenliste nach demselben Muster
wie der bestehende Abschnitt „Lücken" für fehlende Docstrings — ein Hinweis, wo ein Mensch hinschauen sollte,
kein Ausführungsnachweis und keine Aussage über fachliche Richtigkeit.
@@ -1,42 +0,0 @@
# 0010 – Basemap-Legende als eigenes Legendenelement mit Hilfslayern und Legendenkatalog
Status: vorgeschlagen · Datum: 2026-10-02 · Beteiligte: Daniel Helbig, Claude Code · Ticket Plugin_SN_Basis #88
## Kontext
QGIS erzeugt für Vektorkachel-Layer keine Legende (`QgsVectorTileLayer` setzt keine `QgsMapLayerLegend`,
geprüft im Quellcode 3.40, 3.44, master). Die §-38-/§-41-Drucklayouts brauchen aber eine Legende der
basemap.de-Objekte, die im Verfahrensgebiet tatsächlich dargestellt werden, mit der Signatur des Projektlayers.
Die Style-JSON von basemap.de hat 569 Style-Layer mit technischen IDs; ein Legendeneintrag wie „Kreisstraße“
verteilt sich auf bis zu 20 Styles (Kontur, Decker, Brücke, getrennte Fahrbahn …).
Ein Spike in QGIS 3.44.4 (offscreen, echte Kacheln, Gebiet bei Meißen, 619 ha) am 02.10.2026 ergab:
- `QgsVectorTileLayer.selectByGeometry()` holt und dekodiert die Kacheln zur Zoomstufe des Maßstabs selbst
(5,8 s für 10 250 Objekte, entdoppelt 3 990; Style-Zuordnung 0,5 s).
- Hilfslayer in der **Hauptlegende** verschwinden beim Rendern, weil diese nach Karteninhalt filtert
(`setLegendFilterByMapEnabled(True)`) und die Hilfslayer nicht in der Karte liegen. Außerdem müsste die
Hauptlegende dafür ihre automatische Aktualisierung verlieren.
- Ein **eigenes Legendenelement** ohne Kartenfilter zeigt alle Einträge, übersteht Speichern und Neuladen des
Projekts; leere Speicherlayer lösen beim Schließen keine Rückfrage aus.
## Entscheidung
Die Basemap-Legende ist ein **eigenes Legendenelement „Legende Basemap“** ohne Kartenfilter und ohne
automatische Aktualisierung, dessen Einträge aus **leeren, kategorisierten Speicherlayern** stammen (je Gruppe
und Geometrietyp, nicht im Layerbaum, mit dem Projekt gespeichert). Welche Styles zu welchem Eintrag gehören
und welche das Symbol bilden, steht in einem **versionierten Legendenkatalog** `sn_basis/data/basemap_legende.json`,
der aus der Style-JSON erzeugt und fachlich nachbearbeitet wird. Signaturen werden zur Laufzeit aus dem
Projektlayer genommen, nicht aus dem Katalog.
## Folgen
- Hauptlegende bleibt unverändert (Auto-Update, Kartenfilter); der Basemap-Layer selbst erscheint dort nicht,
weil er keine Legendenknoten hat und der Filter ihn ausblendet.
- Lokale Änderungen am Basemap-Stil (Farben, abgeschaltete Styles) wirken automatisch auch in der Legende.
- Die Basemap-Legende ist eine Momentaufnahme; nach Änderungen an Karte oder Stil „Basemap-Legende aktualisieren“.
- Bei einer neuen Basemap-Stilversion muss der Katalog mit `modules/basemap_katalog.py` erneuert werden;
unbekannte Styles erscheinen bis dahin unter „Sonstiges“ (abgewählt).
- Je Layout liegen einige leere Speicherlayer im Projekt (nicht im Layerbaum sichtbar).
## Verworfene Alternativen
- **Hilfslayer in der Hauptlegende:** vom Kartenfilter ausgeblendet (Spike), und Verlust der Auto-Aktualisierung.
- **Eigene `QgsMapLayerLegend` (Python-Unterklasse) am Vektorkachel-Layer:** wird nicht im Projekt gespeichert,
nach Neuladen wäre die Legende weg.
- **Legende direkt aus dem Signaturenkatalog:** zeigt die Standarddarstellung, nicht die im Projekt angepasste.
-1
View File
@@ -34,4 +34,3 @@ Kurz, mit Grund.
| 0007 | Branchmodell: drei Kanäle, `stable` als stabiler Kanal, Rückführungspflicht | vorgeschlagen |
| 0008 | Werkzeugunterstützung auf Claude Code fokussiert | vorgeschlagen |
| 0009 | Tests sind Teil der Definition of Done, und sie werden für Menschen dokumentiert | vorgeschlagen |
| 0010 | Basemap-Legende als eigenes Legendenelement mit Hilfslayern und Legendenkatalog | vorgeschlagen |
-276
View File
@@ -1,276 +0,0 @@
# Basemap-Legende und Basemap-Stilvorlagen im Druck
Stand 02.10.2026. Konzept freigegeben und umgesetzt (Branch `feature/88-basemap-legende`, Abschnitt 10), Ticket **Plugin_SN_Basis #88** („Legende für basemap").
Betroffen ist ausschließlich **`sn_basis`** (Druck); `sn_plan41` und `sn_verfahrensgebiet` nutzen den
Druck-Tab aus `sn_basis` und bekommen die Funktion ohne eigene Änderung.
## 1. Ziel
Der Vektorkachel-Dienst basemap.de
(`https://sgx.geodatenzentrum.de/gdz_basemapde_vektor/tiles/v2/bm_web_de_3857/{z}/{x}/{y}.pbf`) hat keine
Legende, die nur die tatsächlich dargestellten Objekte zeigt. Für die Drucklayouts (§ 38, § 41) wird eine solche
Legende gebraucht:
1. Beim Anlegen einer Druckvorlage wird geprüft, ob ein Basemap-Layer im Projekt ist.
2. Die Objekte der Kacheln **im Auswertebereich** (Standard: Verfahrensgebiet) werden ausgewertet.
3. Ein Auswahldialog zeigt die gefundenen Kategorien; der Nutzer wählt ab, was nicht in die Legende soll.
4. Die gewählten Kategorien erscheinen mit der Signatur **aus dem Projektlayer** (Standard „Basemap.de - Farbe")
in der Legende – nicht mit der Signatur aus dem Signaturenkatalog, weil die Darstellung im Projekt abweichen kann.
Dazu kommt ein einklappbarer Bereich **„Basemap"** im Druck-Tab (Auswertebereich, Legende aktualisieren,
Stilvorlagen laden/speichern).
## 2. Festlegungen (mit Daniel abgestimmt, 02.10.2026)
| # | Frage | Festlegung |
|---|---|---|
| 1 | Für welche Layouts? | Funktion layoutunabhängig bauen; jedes Layout kann sie per Kennzeichen nutzen. **Vorerst aktiv für § 38 und § 41**, nicht für „Anlage zur Baufreigabe". |
| 2 | Auswertebereich | **Standard Verfahrensgebiet.** Umschaltbar auf den Druckbereich (Kartenausschnitt der Vorlage) im Basemap-Bereich des Druck-Tabs. Ohne Verfahrensgebiet: Rückfall auf den Druckbereich mit Hinweis. |
| 3 | Feinheit der Einträge | Brücken-, Tunnel- und Fahrbahnvarianten gehen im Grundeintrag auf („Kreisstraße"). „Im Bau" und „Außer Betrieb" werden eigene Einträge. Beschriftungen (`Name_*`, `Nummer_*`), Hausnummern und `Hintergrund` kommen nie in die Legende. |
| 4 | Basemap-Layer in der Hauptlegende | Der Layer selbst (heute nur Name ohne Symbol) wird ausgeblendet und durch die Gruppe „Basemap" ersetzt. |
| 5 | Nachträglich aktualisieren | Knopf „Basemap-Legende aktualisieren" im Basemap-Bereich, für bestehende Vorlagen. |
| 6 | Stilvorlagen | Darstellung des Basemap-Layers als **lokale Stilvorlage** speichern und wieder laden, **mehrere Varianten** möglich, eine davon als Standard markierbar. |
## 3. Technische Grundlagen (recherchiert 02.10.2026)
- **QGIS bietet für Vektorkachel-Layer keine Legende.** `QgsVectorTileLayer` setzt keine `QgsMapLayerLegend`
(Quellcode geprüft für 3.40, 3.44, master). Die Legendeneinträge müssen wir selbst erzeugen.
- **Auswertung über `QgsVectorTileLayer.selectByGeometry()`** (seit QGIS 3.28): holt die Kacheln zur Zoomstufe
des übergebenen Maßstabs (`QgsSelectionContext.setScale`), dekodiert sie, schneidet sie mit der Geometrie (im
Layer-KBS EPSG:3857) und liefert über `selectedFeatures()` Features mit den Zusatzfeldern `tile_layer` und
`tile_zoom`. Mit übergebenem `QgsRenderContext` werden nur Features geliefert, die der Renderer auch zeichnet.
`getRawTile()` ist in Python nicht verfügbar (`SIP_SKIP`). Der Aufruf **verändert die Auswahl des Layers**
– vorher sichern, danach wiederherstellen.
- **Kacheln enden bei Zoomstufe 15** (`bm_web_de_3857.json`). Druckmaßstäbe 1:1.000 bis 1:5.000 werten Stufe 15
aus. Eine Kachel der Stufe 15 deckt in Sachsen rund 0,6 km² ab → ein Verfahrensgebiet von 50 km² braucht
etwa 100 Kacheln. Bereits von der Kartenansicht geladene Kacheln kommen aus dem Netzwerkcache.
- **Der Signaturenkatalog ist die Style-JSON** `https://sgx.geodatenzentrum.de/gdz_basemapde_vektor/styles/bm_web_col.json`
(569 Style-Layer: 283 Linien, 210 Symbole, 66 Flächen, 7 Kreise, 3 Extrusionen; 29 Quell-Layer).
Style-IDs sind technische Namen (`Kontur_Kreisstr`, `Decker_Kreisstr`, `Bruecke_Kreisstr_getrennt_Decker` …),
**ein Legendeneintrag besteht aus mehreren Style-Layern** (Kreisstraße: 17). Lesbare Bezeichnungen liefern die
`klasse`-Werte der Filter (520 Werte über alle Quell-Layer).
- **Beim Import in QGIS wird jede Style-ID zum `styleName`** eines `QgsVectorTileBasicRendererStyle` (Layername,
Geometrietyp, Filterausdruck, Zoombereich, Symbol, aktiv/inaktiv). Beschriftungen landen in
`QgsVectorTileBasicLabeling`. Darüber verbinden wir Katalog und Projektlayer.
- **Zoomabhängige Strichbreiten** (Mapbox-`stops`) werden in QGIS zu datendefinierten Ausdrücken mit
`@vector_tile_zoom`. In der Legende gibt es diese Variable nicht → Werte für die Druck-Zoomstufe festschreiben
oder die Variable am Legendenelement setzen (Spike, Abschnitt 7).
Quellen: [Datenmodell](https://basemap.de/data/produkte/web_vektor/meta/bm_web_vektor_datenmodell.html),
[Signaturenkatalog](https://basemap.de/data/produkte/web_vektor/meta/bm_web_vektor_col_signaturenkatalog.html),
[PyQGIS QgsVectorTileLayer](https://qgis.org/pyqgis/3.44/core/QgsVectorTileLayer.html),
QGIS-Quellcode `src/core/vectortile/qgsvectortilelayer.cpp` (`final-3_40_0`, `final-3_44_0`).
## 4. Ablauf
```mermaid
flowchart TD
A[Vorlage erstellen<br/>oder Basemap-Legende aktualisieren] --> B{Layout nutzt<br/>Basemap-Legende?}
B -- nein --> Z[Layout wie bisher]
B -- ja --> C{Sichtbarer Basemap-Layer<br/>im Projekt?}
C -- nein --> Z
C -- ja --> D[Auswertebereich bestimmen<br/>Verfahrensgebiet / Druckbereich]
D --> E[Geometrie nach EPSG:3857,<br/>kachelweise selectByGeometry<br/>mit Fortschritt und Abbruch]
E --> F[Feature → aktive Renderer-Styles<br/>bei Druck-Zoomstufe]
F --> G[Styles → Legendeneinträge<br/>über Legendenkatalog]
G --> H[Auswahldialog mit Symbolvorschau<br/>Vorbelegung aus Projektvariable]
H --> I[Gruppe Basemap in der Legende<br/>zusammengesetzte Symbole]
I --> J[Auswahl und Einstellungen<br/>am Layout und im Projekt merken]
```
- **Layer-Erkennung:** Layertyp Vektorkachel **und** Quell-URL enthält `gdz_basemapde_vektor`; Name nur als
Rückfall (Layer werden sonst über den Namen gesucht, siehe `fallstricke.md`). Berücksichtigt werden nur Layer,
die in der Karte der Vorlage sichtbar sind (Thema bzw. aktuelle Sichtbarkeit). Mehrere Basemap-Layer
(z. B. Farbe und Grau): jeder bekommt eine eigene Gruppe.
- **Deaktivierte Styles** im Projektlayer erzeugen keine Legendeneinträge. Wer z. B. Hausnummern oder andere
Objekte über eine Stilvorlage ausschaltet, sieht sie automatisch auch nicht in der Legende.
- **Unbekannte Style-IDs** (eigene Ergänzungen im Projektlayer, neue Basemap-Version) erscheinen mit der
Bezeichnung „Quell-Layer: klasse" bzw. dem `styleName` in einer Gruppe „Sonstiges" und sind im Dialog
abgewählt vorbelegt.
## 5. Bausteine
### 5.1 `sn_basis` – neue und geänderte Dateien
| Datei | Inhalt |
|---|---|
| `data/basemap_legende.json` (neu) | **Legendenkatalog:** je Eintrag Schlüssel, Bezeichnung, Gruppe, Reihenfolge, `treffer_stile` (alle Style-IDs, deren Vorkommen den Eintrag auslösen), `symbol_stile` (Style-IDs, die zusammen das Legendensymbol bilden, z. B. `Kontur_Kreisstr` + `Decker_Kreisstr`), dazu eine Liste `nie_in_legende`. Kopf mit Version der Style-JSON. |
| `modules/basemap_legende.py` (neu, < 600 Zeilen) | Layer finden, Auswertebereich bestimmen, Kacheln auswerten, Styles zuordnen (reine Logik, testbar), Symbole zusammensetzen, Gruppe in eine Legende schreiben bzw. ersetzen. Keine direkten QGIS-/Qt-Importe. |
| `modules/basemap_stilvorlagen.py` (neu) | Stilvorlagen auflisten, speichern, laden, löschen, Standard merken. |
| `ui/widgets/basemap_bereich.py` (neu) | Einklappbarer Bereich „Basemap" für den Druck-Tab (Abschnitt 5.2). Eigene Datei, weil `print_tab.py` schon 709 Zeilen hat. |
| `ui/tabs/print_tab.py` | Bereich einbinden (wenige Zeilen), `cleanup()` weiterreichen. |
| `modules/print_logic.py` | Nach der Vorlagenbezeichnung Basemap-Legende ermitteln, wenn das Layout sie nutzt; Ergebnis an das Layout übergeben. Menge der Layouts mit Basemap-Legende als Konstante (`{KARTENNAME_38, KARTENNAME_41}`). |
| `modules/print_layout.py` | Neuer optionaler Parameter für die Basemap-Einträge; Layout-Kennzeichen setzen; Basemap-Layer-Knoten der Hauptlegende ausblenden. |
| `functions/dialog_wrapper.py` | Neuer allgemeiner Dialog `ask_mehrfachauswahl(titel, hinweis, eintraege, vorauswahl)`: Liste mit Häkchen, Symbolvorschau, Gruppen, Suche, „Alle auswählen". Mock: gibt die Vorauswahl zurück. |
| `functions/qgiscore_wrapper.py`, `qgisui_wrapper.py`, `qt_wrapper.py` | Fehlende Symbole mit Mock-Fallback: `QgsVectorTileLayer`, `QgsSelectionContext`, `QgsRenderContext`, `QgsExpression`, `QgsExpressionContext(Scope)`, `QgsCategorizedSymbolRenderer`, `QgsRendererCategory`, `QgsLayerTreeGroup`/`QgsLayerTreeLayer`, `QgsSymbolLayerUtils`, `QgsApplication.qgisSettingsDirPath`, `QgsCollapsibleGroupBox`. |
| `changelog.txt` | Eintrag oben (nächstes Release). |
**Layoutunabhängigkeit:** Ein Layout nutzt die Basemap-Legende, wenn es die Layout-Eigenschaft
`sn_basemap_legende = 1` trägt und ein Legendenelement mit bekannter ID hat (Standard `Legende`). Am Layout werden
außerdem Auswertebereich, Maßstab und gewählte Einträge gespeichert, damit „Aktualisieren" mit denselben
Einstellungen neu rechnen kann. Ein neues Layout schaltet die Funktion ein, indem es das Kennzeichen setzt bzw.
in die Konstante aufgenommen wird – ohne Änderung am Basemap-Modul.
### 5.2 Basemap-Bereich im Druck-Tab
Einklappbar (standardmäßig eingeklappt), unterhalb der bisherigen Einstellungen, oberhalb von „Vorlage erstellen".
Ohne Basemap-Layer im Projekt ist der Bereich deaktiviert und zeigt „Kein Basemap-Layer im Projekt".
```
▸ Basemap (Basemap.de - Farbe)
Legende
Auswertebereich [Verfahrensgebiet ▾] (Verfahrensgebiet | Druckbereich)
[x] Basemap-Legende beim Erstellen der Vorlage erzeugen
Vorlage [§41 Wegeplan ▾] [Basemap-Legende aktualisieren]
Stilvorlage
Variante [Ohne Hausnummern ★ ▾]
[Laden] [Speichern unter …] [Als Standard] [Löschen]
```
- „Vorlage" listet die Layouts des Projekts mit Kennzeichen `sn_basemap_legende`.
- „Aktualisieren" rechnet mit dem aktuell eingestellten Auswertebereich neu, zeigt den Auswahldialog
(vorbelegt mit der letzten Auswahl dieses Layouts) und ersetzt die Gruppe „Basemap" in der Legende.
### 5.3 Stilvorlagen (lokal, mehrere Varianten)
- **Inhalt einer Variante:** Darstellung des Basemap-Layers als QML (Kategorien Symbologie und Beschriftung,
also auch abgeschaltete Styles wie Hausnummern) und eine kleine JSON-Begleitdatei mit Anzeigename,
Erstellungsdatum, Quell-Stil (`bm_web_col` v2) und – optional – den in der Legende standardmäßig abgewählten
Einträgen.
- **Ablage:** lokal im QGIS-Profil, `<Profilordner>/sn_basis/basemap_stile/<name>.qml` + `<name>.json`.
Dateiname über `sanitize_bezeichner`. Der Standard wird in `QSettings` gemerkt (`sn_basis/basemap_standardstil`).
- **Laden:** Rückfrage vor dem Überschreiben der aktuellen Darstellung. Danach Prüfung, ob die `styleName`s der
Vorlage zum Layer passen (Farbe vs. Grau, neue Basemap-Version); bei Abweichung Hinweis mit Anzahl unbekannter
Styles. Laden geschieht **nur über den Knopf**, nicht automatisch beim Öffnen eines Projekts.
Seit #101 zusätzlich: Passt das `thema` der Vorlage (Farbe/Grau) nicht zum Thema des Layers, folgt eine
Rückfrage. Ohne Thema in Vorlage oder Layer (ältere oder als QML importierte Vorlage) gibt es keine Rückfrage.
- **Speichern unter …:** Name abfragen, vorhandene Variante nur nach Rückfrage überschreiben.
- **Exportieren … / Importieren … (#101):** Export schreibt die gewählte Variante als **eine ZIP-Datei**
(`<name>.qml` + `<name>.json`) zum Weitergeben per Mail oder Netzlaufwerk. Import nimmt eine solche ZIP-Datei
oder eine **reine QML-Datei** an (z. B. aus „Stil speichern“ in QGIS), schlägt den Anzeigenamen aus der
Begleitdatei bzw. dem Dateinamen vor und überschreibt eine gleichnamige Variante nur nach Rückfrage. Aus der
fremden Begleitdatei werden nur `erstellt`, `layer`, `stile`, `thema` und `legende_auswahl` übernommen, ergänzt
um `importiert` und `importiert_aus`; der Standard des anderen Rechners nicht. Geprüft wird, dass die QML eine
QGIS-Stildatei ist (`<qgis` am Anfang) und höchstens 100 MB groß ist; ZIP-Einträge werden nie unter ihrem
eigenen Pfad entpackt.
- **Später möglich, nicht Teil dieses Tickets:** mitgelieferte Varianten im Plugin (`styles/basemap/`) und ein
gemeinsamer Ordner (Netzlaufwerk) für die ganze Behörde (Export/Import seit #101 deckt die Weitergabe von Hand ab).
### 5.4 Werkzeug im Projektwissen
`scripts/basemap_katalog.py` (neu, nur Standardbibliothek): lädt `bm_web_col.json`, gruppiert Style-IDs nach
Quell-Layer und `klasse` (Präfixe/Suffixe wie `Kontur_`, `Decker_`, `Bruecke_`, `Tunnel_`, `_getrennt`,
`_Fahrbahnachse`, `_FSZ1` werden zusammengefasst), schlägt `symbol_stile` vor und schreibt einen Entwurf von
`basemap_legende.json`. Bestehende fachliche Nachbearbeitung (Bezeichnungen, Gruppen, Reihenfolge) bleibt bei
einem erneuten Lauf erhalten; neue oder entfallene Style-IDs werden gemeldet.
### 5.5 Neue Schnittstellen (in `schnittstellen.md` nachtragen)
| Art | Schlüssel | Bedeutung |
|---|---|---|
| Projektvariable | `basemap_auswertebereich` | `verfahrensgebiet` (Standard) oder `druckbereich` |
| Projektvariable | `basemap_legende_erzeugen` | `1`/`0`, Standard `1` |
| Projektvariable | `basemap_legende_auswahl` | JSON `{"ausgeblendet": [...], "eingeblendet": [...]}` – zuletzt ab-/angewählte Einträge (Vorbelegung) |
| Layout-Eigenschaft | `sn_basemap_legende`, `sn_basemap_bereich`, `sn_basemap_massstab`, `sn_basemap_eintraege` | Kennzeichen und letzte Einstellungen je Layout |
| QSettings | `sn_basis/basemap_standardstil` | Name der Standard-Stilvorlage |
| Öffentliche Funktion | `dialog_wrapper.ask_mehrfachauswahl(...)` | neuer allgemeiner Dialog |
## 6. Tests (Mock-Modus, ohne Netzwerk)
Jede neue beobachtbare Funktion bekommt mindestens einen Test mit deutschem Docstring („Prüft, dass …").
| Bereich | Testfälle |
|---|---|
| Katalog | Laden und Schema; jede Style-ID höchstens einem Eintrag zugeordnet; `symbol_stile` ⊆ `treffer_stile`; Ausschlussliste greift |
| Zuordnung | Mehrere Styles → ein Eintrag; deaktivierte Styles ignoriert; Zoombereich berücksichtigt; Filterprüfung als übergebene Funktion; unbekannte Style-IDs → „Sonstiges", abgewählt vorbelegt; Reihenfolge nach Gruppe/Reihenfolge |
| Layer-Erkennung | Erkennung über Quell-URL; Name nur als Rückfall; unsichtbarer Layer ignoriert; kein Basemap-Layer → Druck unverändert |
| Auswertebereich | Verfahrensgebiet als Standard; Druckbereich bei Einstellung; ohne Verfahrensgebiet Rückfall mit Hinweis; Auswahl des Layers danach wiederhergestellt |
| Dialog | Mock gibt Vorauswahl zurück; Abbruch → keine Basemap-Gruppe, Vorlage trotzdem erzeugt |
| Layout | Kennzeichen nur bei § 38/§ 41; Gruppe „Basemap" wird beim Aktualisieren ersetzt, nicht verdoppelt; Basemap-Layer-Knoten ausgeblendet |
| Projektvariablen | Auswahl und Auswertebereich werden gespeichert und wieder gelesen |
| Stilvorlagen | Speichern, Auflisten, Laden, Löschen in temporärem Profilordner; Name über `sanitize_bezeichner`; Überschreiben nur nach Bestätigung; Standard in QSettings; fehlende Begleitdatei toleriert |
| Katalog-Skript | Gruppierung Kontur/Decker/Brücke zu einem Eintrag an einem Ausschnitt der Style-JSON (Testdaten im Repo, kein Download) |
**Nur in QGIS prüfbar** (Ergebnis im PR dokumentieren): echte Kachelauswertung, Laufzeit, Aussehen der Symbole
in der Legende, QML-Laden/Speichern am Vektorkachel-Layer, Einklappen des Bereichs unter Qt5 und Qt6.
## 7. Umsetzungsschritte
Ein Feature-Branch `feature/88-basemap-legende` in `Plugin_SN_Basis` von `unstable`, Commits je Schritt.
1. **Spike in QGIS** (Python-Konsole, echtes Verfahrensgebiet, QGIS 3.44 und 4.x). Ergebnis als ADR in
`docs/entscheidungen/`:
- Laufzeit und Kachelzahl von `selectByGeometry()` für ein großes Verfahrensgebiet; kachelweise Aufteilung.
- Auswertung der Style-Filter mit `@vector_tile_zoom`.
- **Darstellung in der Legende:** (a) leere Hilfslayer (Speicherlayer je Geometrietyp, kategorisiert, nicht im
Layerbaum) als Gruppe „Basemap" in der Hauptlegende – offen, ob `setLegendFilterByMapEnabled(True)` sie
wegfiltert; oder (b) eigenes Legendenelement „Basemap" ohne Kartenfilter direkt unter der Hauptlegende.
- Zusammengesetzte Symbole und festgeschriebene Strichbreiten in der Legende.
- `saveNamedStyle`/`loadNamedStyle` am Vektorkachel-Layer inklusive deaktivierter Styles und Beschriftung.
- `QgsCollapsibleGroupBox` unter Qt5/Qt6 verfügbar, sonst Muster des Atlas-Bereichs (Kontrollkästchen
blendet Inhalt ein).
2. **Legendenkatalog:** Skript, erster Entwurf, fachliche Durchsicht der Bezeichnungen und Gruppen.
3. **Auswertung und Zuordnung** (`basemap_legende.py`) mit Tests.
4. **Dialog** `ask_mehrfachauswahl` mit Test.
5. **Layout-Anbindung** in `print_logic`/`print_layout` für § 38/§ 41, Projektvariablen.
6. **Basemap-Bereich im Druck-Tab** mit Aktualisieren-Knopf.
7. **Stilvorlagen** (`basemap_stilvorlagen.py`, Teil des Bereichs).
8. `python scripts/run_tests.py sn_basis --baseline`, `python scripts/testkatalog.py`,
`python scripts/pruefe_umlaute.py Plugin_SN_Basis`, QGIS-Abnahme, `changelog.txt`, PR-Text, Übergabe:
`schnittstellen.md`, `modulkarte.md`, `fallstricke.md` (Katalog hängt an Stil-Version v2), `STATUS.md`.
## 8. Abnahmekriterien
- [ ] Beim Erstellen einer § 38- oder § 41-Vorlage mit sichtbarem Basemap-Layer erscheint der Auswahldialog mit
genau den Kategorien, die im Auswertebereich vorkommen und im Projektlayer aktiv sind.
- [ ] Die gewählten Kategorien stehen als Gruppe „Basemap" mit der Signatur des Projektlayers in der Legende;
zusammengesetzte Signaturen (Straßen) sind als ein Symbol dargestellt.
- [ ] Beschriftungen, Hausnummern und Hintergrund erscheinen nie.
- [ ] Ohne Basemap-Layer, bei Abbruch des Dialogs und bei „Anlage zur Baufreigabe" entsteht die Vorlage wie bisher.
- [ ] Auswertebereich ist im Basemap-Bereich auf Druckbereich umstellbar; die Einstellung bleibt im Projekt erhalten.
- [ ] „Basemap-Legende aktualisieren" ersetzt die Gruppe in einer bestehenden Vorlage, ohne sie zu verdoppeln.
- [ ] Stilvorlagen lassen sich unter eigenem Namen speichern, laden, löschen und als Standard markieren; mehrere
Varianten sind möglich; nach dem Laden einer Variante ohne Hausnummern fehlen diese in Karte und Legende.
- [ ] Neue Tests grün, Baseline nicht verschlechtert, Testkatalog aktualisiert, Ablauf in QGIS 3.44 und 4.x geprüft.
## 9. Risiken
- **Blockierender Netzwerkzugriff** im Hauptthread bei großen Gebieten → kachelweise mit Fortschrittsanzeige und
Abbruch; Hinweis bei mehr als z. B. 400 Kacheln.
- **Neue Basemap-Stilversion** (heute v2) → Katalog veraltet; Skript erneut laufen lassen, unbekannte IDs fallen
nach „Sonstiges".
- **Kachelränder:** Features sind an Kachelgrenzen beschnitten und können mehrfach vorkommen – für die Frage
„kommt vor" unerheblich.
- **Umfang:** Stilvorlagen sind fachlich eigenständig. Werden sie zu groß für einen PR, als eigenes Ticket
abtrennen (Schritte 1–6 bleiben #88).
## 10. Umsetzung und Abweichungen (02.10.2026)
Umgesetzt in `Plugin_SN_Basis`, Branch `feature/88-basemap-legende` (drei Commits). Spike-Ergebnisse und
Begründung der Legendenvariante: ADR 0010.
| Thema | Umsetzung | Abweichung vom Konzept |
|---|---|---|
| Legendendarstellung | Variante (b): eigenes Element „Legende Basemap“, Titel „Kartengrundlage (basemap.de)“ | Spike entschieden |
| Platzierung | unten an der Quellenangabe verankert, wächst nach oben, 1–3 Spalten (nie über den Seitenrand), sonst Hinweis | statt „unter der Hauptlegende“: deren Höhe steht erst nach dem Rendern fest |
| Mehrere Basemap-Layer | ausgewertet wird der erste sichtbare, Hinweis an den Nutzer | statt „je Layer eine Gruppe“ (vereinfacht) |
| Katalog-Generator | `sn_basis/modules/basemap_katalog.py` (nur Standardbibliothek, eigenständig aufrufbar) | statt Skript im Projektwissen – so mit der sn_basis-Suite getestet |
| Auswahl im Projekt | `basemap_legende_auswahl` (ab- und angewählte Einträge) | statt nur `…_ausgeblendet`, damit angewählte „Sonstiges“-Einträge gemerkt werden |
| Module | `basemap_katalog`, `basemap_kacheln`, `basemap_legende`, `basemap_legende_layout`, `basemap_stilvorlagen`, `ui/widgets/basemap_bereich` | Kachelauswertung ausgelagert (Dateigröße) |
| Einklappen | `QToolButton`-Muster wie Atlas-Bereich | `QgsCollapsibleGroupBox` nicht nötig |
| Stilvorlagen | QML (rund 3,7 MB je Vorlage) + JSON mit Legendenauswahl, im QGIS-Profil | wie geplant |
**Katalog:** 434 darstellende Styles in 190 Einträgen; Beschriftungen (`Name_*`, Labeling), Nummernschilder
(`Nummer_*`), Hintergrund, Mittellinien und kleinmaßstäbige Ortspunkte ausgeschlossen. Erster fachlicher
Durchgang der Bezeichnungen ist gemacht; **die fachliche Abnahme steht aus.**
**Bekannte Punkte für die Durchsicht:**
- ~~„Platz“ (Verkehr, Siedlung) in der Legende kaum zu sehen~~ – behoben in **Basis #92**: weiße Flächen ohne Kontur
bekommen im Legendensymbol einen grauen Rand (0,15 mm); die Karte bleibt unverändert.
- ~~„Durchlass, Düker“ und „Baumreihe“ ohne sichtbares Symbol~~ – Ursache gefunden und behoben in **Basis #90**:
basemap.de zeichnet Punktlinien mit Strichlänge 0, die Qt nicht zeichnet (auch nicht in der Karte). Knopf
„Punktlinien korrigieren“ im Basemap-Bereich (12 Styles betroffen).
- Gewässerbreiten sind zu „Fließgewässer (Linie)“ zusammengefasst; Symbol ist die 6-m-Linie.
**Nicht geprüft:** QGIS 4 (Qt6) – lokal nicht verfügbar. QGIS 3.44.4 (Qt5) offscreen geprüft: Auswertung,
Dialog (echte Widgets), Legende im §-41-Layout, Stilvorlage speichern/laden am echten Layer, Basemap-Bereich.
+57 -5
View File
@@ -1,7 +1,7 @@
# Tests: was geprüft wird, wie man es liest, was Pflicht ist
Stand 04.09.2026. Für alle, die an den LNO-Plugins mitarbeiten — auch für Fachleute ohne Programmiererfahrung.
Der Abschnitt 7 ist ausdrücklich für Sie geschrieben: dort geht es darum, zu **beurteilen**, ob eine Testsuite
Der Abschnitt 8 ist ausdrücklich für Sie geschrieben: dort geht es darum, zu **beurteilen**, ob eine Testsuite
fachlich das Richtige prüft. Dafür muss man keinen Code lesen können.
## 1. Warum das hier ernster genommen wird als sonst
@@ -113,10 +113,62 @@ Wozu das gut ist: Man sieht auf zwei Seiten, was die Suite abdeckt, ohne eine ei
Abschnitt „Lücken" am Ende listet alle Tests ohne Docstring — das ist die Arbeitsliste, um den Katalog
vollständig lesbar zu machen.
Ein zweiter Abschnitt, „Ungetestete Funktionen (strukturelle Lücke)", dreht die Blickrichtung um: Er listet
Funktionen und Methoden im **Quellcode**, deren Name in keiner Testdatei des Pakets vorkommt (Namensabgleich
per `ast`, ohne Import). Das ist bewusst **keine** Zeilen-Coverage in Prozent — die wurde in ADR 0009 als Ziel
verworfen, weil sie durchlaufene Zeilen statt fachliche Vollständigkeit misst. Es ist eine Lückenliste wie die
fehlenden Docstrings: ein Hinweis, wo ein Blick lohnt, kein Ausführungsnachweis und kein Ziel in Prozent.
Jede so gefundene Funktion gilt zusätzlich als **beabsichtigt** oder **ungeklärt**: Der Katalog liest dafür
den Docstring der Funktion und erkennt zwei Vermerke — `"""von Test abgesehen, weil …; Kürzel Datum"""` für
eine bewusst als vernachlässigbar eingestufte Funktion, `"""Test ausgesetzt, zunächst Refactor"""` für eine
Funktion, die erst nach einer geplanten Überarbeitung getestet wird. Fehlt der Vermerk, gilt die Funktion als
**ungeklärt** — das ist die eigentliche Arbeitsliste, nicht die beabsichtigten. Im Prüfstand
(`docs/tests/testkatalog.html`) erscheint das je Paket als eigene, aufklappbare Karte mit Kennzahlen
(„X ungeklärt, Y beabsichtigt"), genau wie bei den Testdateien.
Nach dem Hinzufügen von Tests den Katalog neu erzeugen und mit committen. `python scripts/testkatalog.py --pruefen`
meldet, wenn er veraltet ist.
## 7. Testkonzepte: prüfen, ob die Tests fachlich sinnvoll sind
## 7. Test-Audit: wann wurde ein Test zuletzt fachlich geprüft?
Der Testkatalog beantwortet „was prüft die Suite" und „läuft der Test durch" (Baseline, Abschnitt 8). Er
beantwortet **nicht** „hat das ein Mensch fachlich bestätigt". Ein Agent kann einen überzeugenden, aber
fachlich falschen Test schreiben (Abschnitt 1) — weder Docstring noch Baseline zeigen das. Das Test-Audit
schließt diese Lücke: `docs/status/testpruefungen.json` hält je Testfall Datum und Kurzprüfsumme der letzten
Prüfung fest. Ändert sich der Testcode danach, erkennt der Prüfstand das automatisch als **veraltet** — die
Prüfsumme stimmt nicht mehr überein.
Im Prüfstand (`docs/tests/testkatalog.html`) erscheint das als eigene Spalte/Pille je Testfall (unabhängig vom
Baseline-Status: ein grüner Test kann nie geprüft sein, ein roter Baseline-Test kann bereits geprüft sein) und
als eigene Filter-Chips „Nie geprüft" / „Veraltet geprüft".
```bash
python scripts/test_audit.py status sn_verfahrensgebiet # Prüfstatus je Testfall anzeigen
python scripts/test_audit.py status --nur ungeprueft # nur ungeprüfte Testfälle
python scripts/test_audit.py status sn_basis --muster TestX --code # mit Quelltext im Terminal
python scripts/test_audit.py markieren sn_basis TestX.test_y # als heute geprüft markieren
```
**Markiert wird nur auf ausdrückliche Aufforderung eines Menschen.** Die Markierung sagt „fachlich bestätigt",
nicht „ein Agent hat es gelesen". Ein Agent sichtet die Tests, ergänzt Lücken und nennt die Testfälle, die er zur
Markierung vorschlägt; `markieren` (ohne `--trocken`) ruft er erst auf, wenn die Person die Markierung ausdrücklich
freigibt. Ein allgemeiner Auftrag wie „Audit fortsetzen" ist keine solche Freigabe.
`markieren` nimmt exakte Bezeichner oder `fnmatch`-Muster (z. B. `"TestX.*"`) entgegen; `--trocken` zeigt die
Treffer, ohne zu schreiben — vor einem Muster mit vielen Treffern empfohlen. Das Skript importiert die
Katalog-Logik aus `scripts/testkatalog.py`, statt sie zu duplizieren.
`status` zeigt zu jedem Treffer „<Datei>:<Zeile>" — in den meisten Editor-Terminals anklickbar, um den Test
direkt zu öffnen und zu bearbeiten. Der Prüfstand selbst zeigt bewusst **keinen** Quelltext: er ist eine
versionierte, generierte Datei, und Quelltext darin würde bei jeder Codeänderung riesige, wenig aussagekräftige
Diffs erzeugen. Zum Lesen ohne Editor dient `--code`, zum Bearbeiten der übliche Weg über Konsole/Editor.
Abgrenzung zu Abschnitt 8 (Testkonzepte): Das Audit bestätigt, dass **vorhandene** Tests noch fachlich
zutreffen. Ob überhaupt genug getestet wird, zeigen die Testkonzept-Seiten — das ist der nächste, gesonderte
Schritt, kein Ersatz für das Audit.
## 8. Testkonzepte: prüfen, ob die Tests fachlich sinnvoll sind
Der Katalog beantwortet „was wird getestet". Er beantwortet **nicht** „ist das genug". Dafür gibt es je
wichtigem Fachablauf eine eigene Seite in [`docs/tests/`](../tests/), nach der Vorlage
@@ -143,7 +195,7 @@ Ein Beispiel liegt in [`docs/tests/verfahrensgebiet-shape-import.md`](../tests/v
Wenn Sie eine Lücke finden: Issue aufmachen (`python scripts/gitea.py entwurf issue Verfahrensgebiet` legt einen
Entwurf an). Eine gefundene Testlücke ist ein vollwertiges Ticket.
## 8. Die Baseline
## 9. Die Baseline
Nicht alle Tests sind grün. Der Ist-Stand steht in [`docs/status/testbaseline.json`](../status/testbaseline.json)
und wirkt als Sperrklinke: **bekannte rote Tests dürfen bleiben, neue nicht dazukommen.**
@@ -159,7 +211,7 @@ python scripts/run_tests.py sn_verfahrensgebiet --baseline
Die Baseline ändert **nur ein Maintainer** mit `--update-baseline`, nach Absprache. Ein Agent fasst sie nicht an.
Das Grünmachen der bekannten roten Tests läuft über eigene Issues, nicht nebenbei.
## 9. Wenn ein Test rot ist
## 10. Wenn ein Test rot ist
Erst die Frage beantworten: **Ist der Test veraltet oder ist der Code falsch?**
@@ -177,7 +229,7 @@ das ist das Verstecken des Problems vor dem nächsten Leser.
Details zum Deuten einzelner Fehler: Skill `sn-tests`.
## 10. Vor dem Pull Request
## 11. Vor dem Pull Request
- [ ] `python scripts/run_tests.py <paket> --baseline` ohne `NEU ROT`
- [ ] Neue Funktionalität hat mindestens einen Test je neuem Verhalten
+44 -27
View File
@@ -1,7 +1,7 @@
# Status des Projekts
Kurz und aktuell. Wird bei jedem Merge und jeder Übergabe gepflegt (Skill `sn-uebergabe`). Älteres wandert nach unten
in „Erledigt" oder wird gelöscht. **Stand: 02.10.2026.**
in „Erledigt" oder wird gelöscht. **Stand: 18.09.2026.**
## Aktuelle Phase
@@ -13,7 +13,7 @@ spätere Phase und beginnt erst, wenn die Test-Baseline grün ist und das Projek
| Person / Behörde | Schwerpunkt | Stand |
|---|---|---|
| Daniel Helbig (LK Meißen) | Fachfunktionen Verfahrensgebiet, Plan41, VLN-API; Basemap-Legende im Druck (Basis #88, PR vorbereitet) | aktiv |
| Daniel Helbig (LK Meißen) | Fachfunktionen Verfahrensgebiet, Plan41, VLN-API; aktuell Test-Audit (Basis #63 gemergt, weitere Lücken laut Testkatalog offen) | aktiv |
| Michael Otto (LK Mittelsachsen) | Release-Infrastruktur, Linkliste, zuletzt Verfahrensgebiet (Shape-Laden, Beteiligung) | aktiv |
| 22munzke | Druck/Layout-Anforderungen (Issues Basis #37–#44) | Issues |
| weitere Behörden | Einstieg über dieses Repository | ab 09/2026 |
@@ -30,16 +30,18 @@ spätere Phase und beginnt erst, wenn die Test-Baseline grün ist und das Projek
Stable 4.2 wird am 25.09.2026 LTR. Produktentscheidung, blockiert die CI-Matrix
(`docs/konzept/07_qgis_tests_plan.md` Abschnitt 2).
4. **Test-Baseline grün machen.** Ist-Stand Mock-Modus laut `docs/status/testbaseline.json`:
sn_basis 87/87 grün, sn_plan41 43/44 (1 Fehler in `test_tab_a_ui`), sn_verfahrensgebiet 157/201
sn_basis 166/166 grün, sn_plan41 43/44 (1 Fehler in `test_tab_a_ui`), sn_verfahrensgebiet 157/201
(36 rot, 8 übersprungen; meist veraltete Tests nach dem Mehrfachauswahl-Umbau).
Probelauf am 03.09.2026 mit frischen Klonen: `sn_verfahrensgebiet` 154/201, **drei neue rote Tests** in
`test_verfahrensgebiet_alkis_komplett` durch PR #43 („Nur-laden-Option durch Stop-Abfrage ersetzt").
Entscheidung des Maintainers: Tests anpassen oder Baseline mit `--update-baseline` nachziehen.
5. **Testbeschreibungen nachziehen.** Von 332 Testfällen haben nur 100 (30 %) einen Docstring — `sn_basis`
keinen einzigen von 87, `sn_plan41` einen von 44. Ohne Beschreibung ist von außen nicht erkennbar, was ein
Test prüft. Arbeitsliste: Abschnitt „Lücken" in `docs/tests/testkatalog.md`. Pflicht für neue und geänderte
Tests gilt ab sofort (ADR 0009). Seit 15.09.2026 zusätzlich als Dashboard `docs/tests/testkatalog.html`
(lokal im Browser öffnen) – zeigt Testabdeckung und -status auf einen Blick, ohne in den Code zu schauen.
5. **Testbeschreibungen nachziehen.** `sn_basis` und `sn_verfahrensgebiet` (Docstring-Pflicht) sind in Arbeit,
`sn_plan41` weiterhin fast vollständig ohne Docstring (1 von 44). Ohne Beschreibung ist von außen nicht
erkennbar, was ein Test prüft. Arbeitsliste: Abschnitt „Lücken" in `docs/tests/testkatalog.md`. Pflicht für
neue und geänderte Tests gilt ab sofort (ADR 0009). Seit 15.09.2026 zusätzlich als Dashboard
`docs/tests/testkatalog.html` (lokal im Browser öffnen) – zeigt Testabdeckung und -status auf einen Blick,
seit 18.09.2026 auch strukturelle Lücken (Quellcode-Funktionen ohne Testbezug, Abschnitt „Ungetestete
Funktionen"), ohne in den Code zu schauen.
6. **Testlücken beim Shape-Import schließen.** Beim Erstellen von `docs/tests/verfahrensgebiet-shape-import.md`
gefunden und gegen `origin/unstable` geprüft: `_ermittle_gebietstyp_aus_fbschl` hat **keinen** Test — obwohl
PR #44/#45 genau diese Funktion tolerant gemacht hat. Ebenso ungetestet: mehrere Shapefile-Sätze in einer
@@ -63,31 +65,46 @@ spätere Phase und beginnt erst, wenn die Test-Baseline grün ist und das Projek
(fest verdrahteter NAS-Namespace `gid/6.0` in `grenzpunkt_alkis.py`, abgeflachte WFS-Feldnamen in
`sql=`-Filtern). Vergleich 6↔7 und Anpassungsliste: `docs/konzept/09_alkis7_umstellung.md`.
Nächster Schritt: Gitea-Issue in `Plugin_SN_Verfahrensgebiet`.
15. **Basemap-Legende im Druck (Basis #88).** In `unstable` gemergt: #88 (PR #89), Punktlinien-Korrektur #90
(PR #91), Rand für weiße Flächen #92. Offen: **fachliche Abnahme des Legendenkatalogs** `sn_basis/data/basemap_legende.json`
(Bezeichnungen, Gruppen, Zusammenfassungen; Konzept `docs/konzept/10_basemap_legende.md` Abschnitt 10,
ADR 0010; bisher unauffällig). Unter QGIS 4 geprüft (Plugin funktioniert, Rückmeldung 02.10.2026).
16. **Kartenrand-Überlappung bei kleinen Verfahren (Basis #93).** Gemergt (PR #95). Mehrspaltige Legenden schmaler
(#96: Textumbruch 60 mm, ungleiche Spaltenbreiten, zweizeiliger Basemap-Titel, Mindestbreite 180 mm wie das
Kartenschild) auf
`Plugin_SN_Basis:bugfix/96-legenden-spaltenbreite`, gemergt (PR #97).
17. **Basemap hinzufügen und Thema wechseln (Basis #100).** Gemergt (PR #103, Doku PR #25).
Themen Farbe/Grau, Erkennung über Kachel-URL, Prüfwert für ungespeicherte Änderungen. Manueller QGIS-Test
am 05.10.2026 bestanden (Laden über `styleUrl`, Themenwechsel per `setDataSource`, Prüfwert stabil). Folge-Issues: #101
(Import/Export der Stile), P10 Vektor (#102: technisch geprüft 06.10.2026, fachliche Entscheidung offen –
Beta-Lizenz nur zu Testzwecken, siehe `fallstricke.md`), Relief.
18. **Langer Tab verlängert das QGIS-Fenster (Basis #104).** Gemergt (PR #105, Doku PR #26): jeder Tab im
Scroll-Bereich über `BaseDockWidget.setWidget`, wirkt auch für Plan41/Verfahrensgebiet.
19. **Zoom und Drucklayout bei anderem Projekt-KBS (Basis #99).** Behoben auf `Plugin_SN_Basis:bugfix/99-druck-kbs`
und `Plugin_SN_Verfahrensgebiet:bugfix/99-zoom-kbs` (Doku: `Projektwissen:docs/99-druck-kbs`), PRs stehen aus;
**Basis zuerst mergen** (Verfahrensgebiet nutzt `zoom_auf_layer`). Layoutkarte im KBS des Verfahrensgebiets.
Offen: QGIS-Test. Folge-Issue (Entwurf): Projekt-KBS prüfen und amtliches KBS nach Länderkennung vorschlagen.
15. **Test-Audit durchführen (Ticket #16).** Infrastruktur ist fertig, PR steht aus: `scripts/test_audit.py`
(`status`/`markieren`) und `docs/status/testpruefungen.json` machen im Prüfstand
(`docs/tests/testkatalog.html`) je Testfall sichtbar, ob und wann er zuletzt fachlich geprüft wurde
(unabhängig vom Baseline-Status). Aktuell gelten alle 346 Testfälle als „nie geprüft" — nächster Schritt
ist der eigentliche Audit-Durchgang (Team geht die Pakete durch und markiert per `test_audit.py markieren`),
danach getrennt: Testlücken/Fachtests aus den Testkonzept-Seiten ergänzen (Ticket-Text nennt das
ausdrücklich als separaten Folgeschritt).
16. **Standarddatei-Existenzprüfung fehlt (Basis #59).** `Dateipruefer._handle_leere_eingabe()` und
`Pruefmanager._handle_basic_decision()` prüfen bei `standarddatei_vorschlagen` nie `file_exists()` —
bestätigt der Nutzer eine nicht vorhandene Standarddatei, kommt trotzdem `ok=True`/`"ok"` zurück statt
`datei_nicht_gefunden`. Bearbeitung bewusst zurückgestellt: **hängt von der Design-Entscheidung ab, ob
die Funktion „Standarddatei" überhaupt gebraucht wird** — aktuell übergibt kein Aufrufer
(`DataGrabber.py`, `excel_importer.py`) den Parameter `standarddatei`. `TestDateipruefer.test_
standarddatei_vorschlagen` bleibt bis zur Entscheidung bewusst ohne Gegenstück für den Fehlerfall
(kein Testfall-„nie geprüft", sondern Verhalten ungeklärt) — siehe Kommentar im Testfall.
17. **WMS-Zeilen im Datenabruf ungeklärt (Basis #77).** `Datenabruf._fetch_features()` liefert für
`provider == "WMS"` immer `([], None)`, der Kommentar dort verspricht „caller behandelt WMS separat" —
das tut `datenabruf()` aber nicht: jede WMS-Zeile durchläuft dieselbe relevant/ausserhalb-Klassifizierung
wie WFS/REST/OGR und landet deshalb zwangsläufig in `ausserhalb`, ohne dass je ein Layer geschrieben
wird. Offen: ist das gewollt (WMS-Kartendienste werden in diesem Pfad bewusst nicht geladen) oder fehlt
die im Kommentar versprochene Sonderbehandlung? `DatenabrufOrchestrierungTests.
test_wms_zeile_ohne_features_landet_in_ausserhalb` dokumentiert bewusst den Ist-Zustand, nicht den
bestätigt gewünschten — siehe Kommentar im Testfall.
18. **Falscher Aktionscode in `Datenschreiber.schreibe_log()` (Basis #78).** Der Erfolg wird mit
`aktion="standarddatei_vorschlagen"` gemeldet — demselben Code, den `Dateipruefer`/`Pruefmanager` für
die Standarddatei-Rückfrage nutzen (Punkt 16). Aktuell folgenlos, weil `Pruefmanager.verarbeite()` bei
`ok=True` sofort zurückkehrt, bevor die Aktion ausgewertet wird — aber missverständlich und zerbrechlich
bei künftigem Code, der auf diese Aktion filtert. `SchreibeLogTests.
test_schreibt_json_datei_mit_ergebnissen_und_gibt_pfad_zurueck` dokumentiert bewusst den Ist-Zustand —
siehe Kommentar im Testfall.
**Hinweis zum lokalen Stand (04.09.2026):** Die Klone `Plugin_SN_Verfahrensgebiet` (4 Commits: PR #43, PR #45)
und `Repository` (Release 26.8.4-unstable) liegen hinter `origin`. Aktualisieren mit `python scripts/hallo.py`.
## Zuletzt gemergt (unstable)
- 18.09.2026 Basis #63 (PR #64): Tests für die vier bis dahin testlosen Kernmodule der Datenpipeline
(`Datenabruf.py`, `Datenschreiber.py`, `LayerLoader.py`, `excel_importer.py`), 70 neue Testfälle, sn_basis
jetzt 166/166 grün. Nebenbei `_MockQgsProject` um `transformContext()`/`addMapLayer()` ergänzt.
- 18.09.2026 Verfahrensgebiet #53: Grenzpunkt-Stilanbringung, neuer Test.
- 02.09.2026 Verfahrensgebiet #45: FBSchl-Feldsuche tolerant gegenüber abweichenden Feldnamen; #43: Nur-laden-Option
bei ALKIS-Laden durch Stop-Abfrage ersetzt (Release 26.8.4-unstable).
- 02.09.2026 Verfahrensgebiet #42: Shape-Ladevorgang mit Mehrfachauswahl, ZIP-Entpacken, `FBSchl`-Prüfung.
+854
View File
@@ -0,0 +1,854 @@
{
"sn_basis.tests.test_base_dockwidget.CloseEventTests.test_fehler_in_cleanup_wird_abgefangen_und_andere_tabs_laufen_weiter": {
"datum": "2026-09-21",
"hash": "f4a963ed9caa"
},
"sn_basis.tests.test_base_dockwidget.CloseEventTests.test_ignoriert_tabs_ohne_cleanup": {
"datum": "2026-09-21",
"hash": "58feb87af614"
},
"sn_basis.tests.test_base_dockwidget.CloseEventTests.test_ohne_action_wird_nichts_zurueckgesetzt": {
"datum": "2026-09-21",
"hash": "a84f8ea5d6cb"
},
"sn_basis.tests.test_base_dockwidget.CloseEventTests.test_ruft_cleanup_aller_tabs_auf": {
"datum": "2026-09-21",
"hash": "9f131bed4c7e"
},
"sn_basis.tests.test_base_dockwidget.CloseEventTests.test_setzt_toolbar_action_zurueck": {
"datum": "2026-09-21",
"hash": "0b84bc4f86f5"
},
"sn_basis.tests.test_datagrabber.TestDataGrabber.test_aggregate_results_mit_zeilen_liefert_erfolgsergebnis": {
"datum": "2026-09-21",
"hash": "87e624c158da"
},
"sn_basis.tests.test_datagrabber.TestDataGrabber.test_aggregate_results_ohne_zeilen_liefert_keine_validen_eintraege": {
"datum": "2026-09-21",
"hash": "5cbff16ee7da"
},
"sn_basis.tests.test_datagrabber.TestDataGrabber.test_analyze_source_type_detects_excel": {
"datum": "2026-09-16",
"hash": "9559f9923f6f"
},
"sn_basis.tests.test_datagrabber.TestDataGrabber.test_analyze_source_type_detects_service_when_file_check_fails": {
"datum": "2026-09-16",
"hash": "90c4384eac7f"
},
"sn_basis.tests.test_datagrabber.TestDataGrabber.test_analyze_source_type_returns_unbekannte_quelle_on_full_failure": {
"datum": "2026-09-16",
"hash": "3b35bfdb3f04"
},
"sn_basis.tests.test_datagrabber.TestDataGrabber.test_analyze_source_type_returns_unknown_filetype": {
"datum": "2026-09-16",
"hash": "78cd94c858de"
},
"sn_basis.tests.test_datagrabber.TestDataGrabber.test_run_returns_failure_summary_without_rows": {
"datum": "2026-09-16",
"hash": "1369d06aff3d"
},
"sn_basis.tests.test_datagrabber.TestDataGrabber.test_run_returns_success_summary_with_valid_rows": {
"datum": "2026-09-16",
"hash": "55fcd3a0fc84"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_datei_nicht_gefunden": {
"datum": "2026-09-17",
"hash": "9e83de8df1b9"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_datei_ok": {
"datum": "2026-09-17",
"hash": "c9633046fcdd"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_erkenne_dateityp_unterscheidet_excel_datenbank_und_unbekannt": {
"datum": "2026-09-21",
"hash": "ea829ba032a0"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_ist_gueltiger_gpkg_pfad_akzeptiert_vorhandenes_verzeichnis": {
"datum": "2026-09-21",
"hash": "44ffe876b36f"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_ist_gueltiger_gpkg_pfad_lehnt_falsche_endung_ab": {
"datum": "2026-09-21",
"hash": "1adbbbcdbdd3"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_ist_gueltiger_gpkg_pfad_lehnt_fehlendes_verzeichnis_ab": {
"datum": "2026-09-21",
"hash": "b64b61e72220"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_ist_leer_erkennt_none_und_nicht_string_als_leer": {
"datum": "2026-09-21",
"hash": "93f594a311f3"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_ist_leer_erkennt_reinen_whitespace_als_leer": {
"datum": "2026-09-21",
"hash": "0141a1d2a3a8"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_ist_leer_meldet_pfad_mit_sichtbaren_zeichen_nicht_als_leer": {
"datum": "2026-09-21",
"hash": "8bffda4a5f74"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_leere_eingabe_bevorzugt_leereingabe_erlaubt_vor_standarddatei": {
"datum": "2026-09-21",
"hash": "73b3b4878b72"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_leere_eingabe_bevorzugt_standarddatei_vor_temporaer_erlaubt": {
"datum": "2026-09-21",
"hash": "a411d346c6a8"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_leereingabe_erlaubt": {
"datum": "2026-09-17",
"hash": "54c35530e1b3"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_leereingabe_nicht_erlaubt": {
"datum": "2026-09-17",
"hash": "bbb8d936f5f9"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_pfad_laesst_absoluten_pfad_unveraendert": {
"datum": "2026-09-21",
"hash": "fbe7bd8caaf0"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_pfad_verbindet_relativen_pfad_mit_basispfad": {
"datum": "2026-09-21",
"hash": "1686b4174b71"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_standarddatei_vorschlagen": {
"datum": "2026-09-21",
"hash": "2395b97dbfa4"
},
"sn_basis.tests.test_dateipruefer.TestDateipruefer.test_temporaer_erlaubt": {
"datum": "2026-09-17",
"hash": "00cfdb7d23d5"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_default_provider_haengt_generischen_bbox_parameter_an": {
"datum": "2026-09-21",
"hash": "db91265822d6"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_default_provider_ohne_raumfilter_laesst_query_unveraendert": {
"datum": "2026-09-21",
"hash": "ae305bc95c08"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_rest_provider_haengt_query_endpunkt_an": {
"datum": "2026-09-21",
"hash": "006e39a2e481"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_rest_provider_mit_bbox_baut_geometry_envelope_und_srid": {
"datum": "2026-09-21",
"hash": "419db8104fe9"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_url_praefix_wird_entfernt": {
"datum": "2026-09-21",
"hash": "0fd137b2ee4b"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_wfs_baut_standardparameter_und_bbox_mit_crs": {
"datum": "2026-09-21",
"hash": "4d8a5a034b66"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_wfs_ohne_raumfilter_setzt_keine_bbox": {
"datum": "2026-09-21",
"hash": "89bc47b753aa"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_wfs_repariert_doppeltes_fragezeichen": {
"datum": "2026-09-21",
"hash": "637f4ef9773a"
},
"sn_basis.tests.test_datenabruf.BuildProviderUrlTests.test_wms_liefert_link_unveraendert": {
"datum": "2026-09-21",
"hash": "50bcb7d3148a"
},
"sn_basis.tests.test_datenabruf.DatenabrufOrchestrierungTests.test_abbruch_ueber_progress_stoppt_weitere_zeilen": {
"datum": "2026-09-21",
"hash": "06730e19b7b9"
},
"sn_basis.tests.test_datenabruf.DatenabrufOrchestrierungTests.test_fehlende_pflichtfelder_werden_als_ungueltig_gemeldet": {
"datum": "2026-09-21",
"hash": "6a32846a1eb1"
},
"sn_basis.tests.test_datenabruf.DatenabrufOrchestrierungTests.test_wms_zeile_ohne_features_landet_in_ausserhalb": {
"datum": "2026-09-21",
"hash": "b5415522be70"
},
"sn_basis.tests.test_datenabruf.DetermineSpatialFilterTests.test_fehlender_layer_liefert_none": {
"datum": "2026-09-21",
"hash": "2d593c0b6e97"
},
"sn_basis.tests.test_datenabruf.DetermineSpatialFilterTests.test_pufferlayer_liefert_extent_des_pufferlayers": {
"datum": "2026-09-21",
"hash": "1daa2cd15c6a"
},
"sn_basis.tests.test_datenabruf.DetermineSpatialFilterTests.test_pufferlayer_ohne_puffer_liefert_none": {
"datum": "2026-09-21",
"hash": "f3648846089e"
},
"sn_basis.tests.test_datenabruf.DetermineSpatialFilterTests.test_raumfilter_ohne_liefert_none": {
"datum": "2026-09-21",
"hash": "6a388d156309"
},
"sn_basis.tests.test_datenabruf.DetermineSpatialFilterTests.test_unbekannter_raumfilter_liefert_none": {
"datum": "2026-09-21",
"hash": "7e647695312a"
},
"sn_basis.tests.test_datenabruf.DetermineSpatialFilterTests.test_verfahrensgebiet_liefert_extent_und_crs": {
"datum": "2026-09-21",
"hash": "cebbb9f28131"
},
"sn_basis.tests.test_datenabruf.DetermineSpatialFilterTests.test_verfahrensgebiet_ohne_extent_liefert_none": {
"datum": "2026-09-21",
"hash": "3665e39cebde"
},
"sn_basis.tests.test_datenabruf.FetchFeaturesTests.test_abbruch_vor_abruf_liefert_fehlermeldung": {
"datum": "2026-09-21",
"hash": "12b1d6288c42"
},
"sn_basis.tests.test_datenabruf.FetchFeaturesTests.test_json_featurecollection_wird_geparst": {
"datum": "2026-09-21",
"hash": "53b6b78bab8b"
},
"sn_basis.tests.test_datenabruf.FetchFeaturesTests.test_netzwerkfehler_wird_als_fehlermeldung_gemeldet": {
"datum": "2026-09-21",
"hash": "c2a85986efe8"
},
"sn_basis.tests.test_datenabruf.FetchFeaturesTests.test_wfs_xml_liefert_anzahl_aus_numberofmatched": {
"datum": "2026-09-21",
"hash": "c77af9bd078b"
},
"sn_basis.tests.test_datenabruf.FetchFeaturesTests.test_wms_liefert_keine_features_ohne_fehler": {
"datum": "2026-09-21",
"hash": "878771057e04"
},
"sn_basis.tests.test_datenschreiber.LadeLayerTests.test_gueltiger_layer_wird_dem_projekt_hinzugefuegt": {
"datum": "2026-09-21",
"hash": "9d7193dfe584"
},
"sn_basis.tests.test_datenschreiber.LadeLayerTests.test_ohne_layer_path_wird_uebersprungen": {
"datum": "2026-09-21",
"hash": "792dabdcd97c"
},
"sn_basis.tests.test_datenschreiber.LadeLayerTests.test_ungueltiger_layer_meldet_layer_nicht_gefunden": {
"datum": "2026-09-21",
"hash": "8e1f436c1225"
},
"sn_basis.tests.test_datenschreiber.ResolveStylePathTests.test_absoluter_vorhandener_stilpfad_wird_aufgeloest": {
"datum": "2026-09-21",
"hash": "6f5e91c64fff"
},
"sn_basis.tests.test_datenschreiber.ResolveStylePathTests.test_leerer_stilpfad_liefert_none": {
"datum": "2026-09-21",
"hash": "2209002c5cdd"
},
"sn_basis.tests.test_datenschreiber.ResolveStylePathTests.test_nicht_vorhandener_stilpfad_liefert_none": {
"datum": "2026-09-21",
"hash": "63fbf010d51a"
},
"sn_basis.tests.test_datenschreiber.SchreibeDatenTests.test_eintrag_ohne_gueltigen_layer_wird_uebersprungen": {
"datum": "2026-09-21",
"hash": "7209c778971b"
},
"sn_basis.tests.test_datenschreiber.SchreibeDatenTests.test_erfolgreicher_eintrag_liefert_layer_path_und_thema": {
"datum": "2026-09-21",
"hash": "5afabcf4df68"
},
"sn_basis.tests.test_datenschreiber.SchreibeDatenTests.test_ohne_speicherort_wirft_valueerror": {
"datum": "2026-09-21",
"hash": "beb0ef913056"
},
"sn_basis.tests.test_datenschreiber.SchreibeDatenTests.test_ohne_thema_wird_ident_als_layername_verwendet": {
"datum": "2026-09-21",
"hash": "f8d4cdff4193"
},
"sn_basis.tests.test_datenschreiber.SchreibeLogTests.test_ohne_speicherort_wirft_valueerror": {
"datum": "2026-09-21",
"hash": "10b44f5e3001"
},
"sn_basis.tests.test_datenschreiber.SchreibeLogTests.test_schreibt_json_datei_mit_ergebnissen_und_gibt_pfad_zurueck": {
"datum": "2026-09-21",
"hash": "0d66a75e3e47"
},
"sn_basis.tests.test_datenschreiber.StoreStyleInGpkgTests.test_fehlender_stilpfad_meldet_fehler_ueber_pruefmanager_statt_absturz": {
"datum": "2026-09-21",
"hash": "dd56f7b08b30"
},
"sn_basis.tests.test_datenschreiber.StoreStyleInGpkgTests.test_legt_tabelle_an_und_speichert_stil_als_default": {
"datum": "2026-09-21",
"hash": "aabc43a7e54d"
},
"sn_basis.tests.test_datenschreiber.StoreStyleInGpkgTests.test_liest_geometriespalte_ueber_geometrycolumn_aus": {
"datum": "2026-09-21",
"hash": "89e54e04844f"
},
"sn_basis.tests.test_datenschreiber.StoreStyleInGpkgTests.test_setzt_bisherigen_default_stil_desselben_layers_zurueck": {
"datum": "2026-09-21",
"hash": "81ce39c5698e"
},
"sn_basis.tests.test_datenschreiber.WriteLayerToGpkgTests.test_gueltiger_layer_wird_ohne_fehler_geschrieben": {
"datum": "2026-09-21",
"hash": "f71a4fc1c402"
},
"sn_basis.tests.test_datenschreiber.WriteLayerToGpkgTests.test_ungueltiger_layer_liefert_fehlermeldung": {
"datum": "2026-09-21",
"hash": "c28e1d77d4b8"
},
"sn_basis.tests.test_dockmanager.DockManagerShowTests.test_entfernt_andere_sn_docks_aber_nicht_sich_selbst": {
"datum": "2026-09-21",
"hash": "24382480ecf7"
},
"sn_basis.tests.test_dockmanager.DockManagerShowTests.test_fehler_beim_anzeigen_wird_gemeldet": {
"datum": "2026-09-21",
"hash": "d8e7624c3732"
},
"sn_basis.tests.test_dockmanager.DockManagerShowTests.test_fehler_beim_entfernen_wird_als_warnung_gemeldet": {
"datum": "2026-09-21",
"hash": "a2936c8db946"
},
"sn_basis.tests.test_dockmanager.DockManagerShowTests.test_none_dock_meldet_fehler_und_zeigt_nichts_an": {
"datum": "2026-09-21",
"hash": "c4fdeb71426d"
},
"sn_basis.tests.test_dockmanager.DockManagerShowTests.test_setzt_objectname_wenn_leer": {
"datum": "2026-09-21",
"hash": "c72a31202f92"
},
"sn_basis.tests.test_dockmanager.DockManagerShowTests.test_zeigt_neues_dock_mit_default_area_an": {
"datum": "2026-09-21",
"hash": "bd2cdb4f27a1"
},
"sn_basis.tests.test_laenderkennung.TestGetLaenderkennung.test_bekannter_praefix_gibt_kennung_zurueck": {
"datum": "2026-09-17",
"hash": "c1fe3fb105a9"
},
"sn_basis.tests.test_laenderkennung.TestGetLaenderkennung.test_mapping_enthaelt_sachsen": {
"datum": "2026-09-17",
"hash": "b4bed27578b6"
},
"sn_basis.tests.test_laenderkennung.TestGetLaenderkennung.test_ohne_argument_wird_aus_aufrufendem_modul_abgeleitet": {
"datum": "2026-09-17",
"hash": "50ea04ad4c1c"
},
"sn_basis.tests.test_laenderkennung.TestGetLaenderkennung.test_praefix_gross_klein_unabhaengig": {
"datum": "2026-09-17",
"hash": "f7a39c2d9eb0"
},
"sn_basis.tests.test_laenderkennung.TestGetLaenderkennung.test_unbekannter_praefix_wirft_keyerror": {
"datum": "2026-09-17",
"hash": "14f73fb0a974"
},
"sn_basis.tests.test_landkreise.AlleLandkreiseSentinelTests.test_alle_landkreise_sentinel_kollidiert_nicht_mit_echter_kennzahl": {
"datum": "2026-09-22",
"hash": "3904d6ac7626"
},
"sn_basis.tests.test_landkreise.LadeLandkreiseTests.test_alle_kennzahlen_kommen_genau_einmal_vor": {
"datum": "2026-09-22",
"hash": "fca83f397af2"
},
"sn_basis.tests.test_landkreise.LadeLandkreiseTests.test_fehlende_datei_liefert_leere_liste": {
"datum": "2026-09-22",
"hash": "247c9b9bc02e"
},
"sn_basis.tests.test_landkreise.LadeLandkreiseTests.test_laedt_die_echte_landkreisliste_nicht_leer": {
"datum": "2026-09-22",
"hash": "5daef82a286e"
},
"sn_basis.tests.test_landkreise.LadeLandkreiseTests.test_ungueltiges_json_liefert_leere_liste": {
"datum": "2026-09-22",
"hash": "29c14c5d2401"
},
"sn_basis.tests.test_landkreise.LandkreislisteVollstaendigkeitTests.test_landkreisliste_enthaelt_alle_13_saechsischen_gebietskoerperschaften": {
"datum": "2026-09-22",
"hash": "6081fa0fbbd1"
},
"sn_basis.tests.test_layerloader.AddToProjectTests.test_gueltiger_layer_wird_dem_projekt_hinzugefuegt": {
"datum": "2026-09-22",
"hash": "7c8ed62e7051"
},
"sn_basis.tests.test_layerloader.AddToProjectTests.test_none_layer_wird_nicht_hinzugefuegt": {
"datum": "2026-09-22",
"hash": "db489f5f485f"
},
"sn_basis.tests.test_layerloader.AddToProjectTests.test_ungueltiger_layer_wird_nicht_hinzugefuegt": {
"datum": "2026-09-22",
"hash": "1261f9711940"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_ausnahme_beim_erstellen_wird_abgefangen": {
"datum": "2026-09-22",
"hash": "12cd21f33e57"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_ogr_provider_nutzt_link_direkt": {
"datum": "2026-09-22",
"hash": "1910e68956dd"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_rest_featureserver_ergaenzt_layer_index": {
"datum": "2026-09-22",
"hash": "776f68881c59"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_rest_mit_url_praefix_wird_nicht_doppelt_gesetzt": {
"datum": "2026-09-22",
"hash": "25d8a8ad0d5a"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_rest_ohne_featureserver_endung_bleibt_unveraendert": {
"datum": "2026-09-22",
"hash": "fc7415b43710"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_unbekannter_provider_faellt_auf_ogr_zurueck": {
"datum": "2026-09-22",
"hash": "6bb5f7ab89e3"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_ungueltiger_layer_meldet_layer_nicht_verfuegbar": {
"datum": "2026-09-22",
"hash": "feabb435d115"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_wfs_baut_uri_ohne_getfeature_parameter": {
"datum": "2026-09-22",
"hash": "92bb8d53e711"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_wfs_ergaenzt_service_und_version_defaults": {
"datum": "2026-09-22",
"hash": "81ecbf43a140"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_wfs_erkennt_typename_in_grossschreibung": {
"datum": "2026-09-22",
"hash": "2898b56c4e1c"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_wfs_mit_url_praefix_wird_nicht_doppelt_gesetzt": {
"datum": "2026-09-22",
"hash": "5385bc25e511"
},
"sn_basis.tests.test_layerloader.CreateLayerTests.test_wms_baut_url_praefix_und_nutzt_rasterlayer": {
"datum": "2026-09-22",
"hash": "407c1a9ba825"
},
"sn_basis.tests.test_layerloader.FilterByExtentTests.test_abbruch_liefert_none_und_meldet_needs_user_action": {
"datum": "2026-09-22",
"hash": "839e5055e5eb"
},
"sn_basis.tests.test_layerloader.FilterByExtentTests.test_erfolgreicher_filter_liefert_neuen_layer_mit_features": {
"datum": "2026-09-22",
"hash": "d42dbc209f8d"
},
"sn_basis.tests.test_layerloader.FilterByExtentTests.test_falscher_layertyp_wird_unveraendert_zurueckgegeben": {
"datum": "2026-09-22",
"hash": "571bcc79cd34"
},
"sn_basis.tests.test_layerloader.FilterByExtentTests.test_keine_treffer_liefert_none": {
"datum": "2026-09-22",
"hash": "ead34605a071"
},
"sn_basis.tests.test_layerloader.FilterByExtentTests.test_ohne_extent_wird_layer_unveraendert_zurueckgegeben": {
"datum": "2026-09-22",
"hash": "6df5b38eda97"
},
"sn_basis.tests.test_layerloader.FilterByExtentTests.test_ungueltiger_layer_wird_unveraendert_zurueckgegeben": {
"datum": "2026-09-22",
"hash": "f98f92c748d3"
},
"sn_basis.tests.test_layerloader.FilterByLayerTests.test_erfolgreicher_geometriefilter_liefert_neuen_layer": {
"datum": "2026-09-22",
"hash": "8bc46d7cc336"
},
"sn_basis.tests.test_layerloader.FilterByLayerTests.test_filterlayer_ohne_features_liefert_none": {
"datum": "2026-09-22",
"hash": "a8963f651828"
},
"sn_basis.tests.test_layerloader.FilterByLayerTests.test_keine_ueberschneidung_liefert_none": {
"datum": "2026-09-22",
"hash": "4d033b3df276"
},
"sn_basis.tests.test_layerloader.FilterByLayerTests.test_ungueltiger_layer_oder_filterlayer_wird_unveraendert_zurueckgegeben": {
"datum": "2026-09-22",
"hash": "29d5ae987f69"
},
"sn_basis.tests.test_layerloader.TransformExtentTests.test_ausnahme_bei_der_extent_transformation_liefert_extent_unveraendert": {
"datum": "2026-09-22",
"hash": "f11e2c936436"
},
"sn_basis.tests.test_layerloader.TransformExtentTests.test_gleiche_crs_liefert_extent_unveraendert": {
"datum": "2026-09-22",
"hash": "7f5d3da32cfc"
},
"sn_basis.tests.test_layerloader.TransformExtentTests.test_unterschiedliche_crs_nutzt_coordinate_transform": {
"datum": "2026-09-22",
"hash": "1f99cdecd25a"
},
"sn_basis.tests.test_layerloader.TransformGeometryTests.test_ausnahme_bei_der_transformation_liefert_geometrie_unveraendert": {
"datum": "2026-09-22",
"hash": "6cfb8b4dbd06"
},
"sn_basis.tests.test_layerloader.TransformGeometryTests.test_fehlender_layer_liefert_geometrie_unveraendert": {
"datum": "2026-09-22",
"hash": "9577d78fb696"
},
"sn_basis.tests.test_layerloader.TransformGeometryTests.test_gleiche_crs_liefert_geometrie_unveraendert": {
"datum": "2026-09-22",
"hash": "31d753a90fb5"
},
"sn_basis.tests.test_layerloader.TransformGeometryTests.test_unterschiedliche_crs_klont_und_transformiert_geometrie": {
"datum": "2026-09-22",
"hash": "ec11affdda72"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_datenquelle_unerwartet": {
"datum": "2026-09-17",
"hash": "4b838528f751"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_falscher_geotyp": {
"datum": "2026-09-17",
"hash": "2f0c982126cc"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_falscher_layertyp": {
"datum": "2026-09-17",
"hash": "8dc755c3f3fd"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_falsches_crs": {
"datum": "2026-09-17",
"hash": "c04ff66b1456"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_felder_fehlen": {
"datum": "2026-09-17",
"hash": "eda63c51426f"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_layer_exists": {
"datum": "2026-09-17",
"hash": "22e7012bf002"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_layer_leer": {
"datum": "2026-09-17",
"hash": "5482bd99468b"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_layer_nicht_editierbar": {
"datum": "2026-09-17",
"hash": "c9b5c18995a0"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_layer_ok": {
"datum": "2026-09-17",
"hash": "190f2397704f"
},
"sn_basis.tests.test_layerpruefer.TestLayerpruefer.test_layer_unsichtbar": {
"datum": "2026-09-17",
"hash": "37ebf360bee0"
},
"sn_basis.tests.test_linkpruefer.TestLinkpruefer.test_leere_eingabe": {
"datum": "2026-09-17",
"hash": "0eb3f4c67feb"
},
"sn_basis.tests.test_linkpruefer.TestLinkpruefer.test_local_link_not_found": {
"datum": "2026-09-17",
"hash": "16d912fcf3bc"
},
"sn_basis.tests.test_linkpruefer.TestLinkpruefer.test_local_link_ok": {
"datum": "2026-09-17",
"hash": "971bd5136933"
},
"sn_basis.tests.test_linkpruefer.TestLinkpruefer.test_remote_link_error": {
"datum": "2026-09-17",
"hash": "dd1c05ef7b8c"
},
"sn_basis.tests.test_linkpruefer.TestLinkpruefer.test_remote_link_network_error": {
"datum": "2026-09-17",
"hash": "74910c1b9cd9"
},
"sn_basis.tests.test_linkpruefer.TestLinkpruefer.test_remote_link_ok": {
"datum": "2026-09-17",
"hash": "67e86095b7ad"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerExistsTests.test_none_existiert_nicht": {
"datum": "2026-09-23",
"hash": "46610a354f52"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerExistsTests.test_ungueltiger_layer_existiert_trotzdem": {
"datum": "2026-09-23",
"hash": "2723abe4b70a"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerExistsTests.test_vorhandenes_objekt_existiert": {
"datum": "2026-09-23",
"hash": "36946f5654b9"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerIsUsableTests.test_gueltiger_layer_ist_nutzbar": {
"datum": "2026-09-23",
"hash": "d023884b88ed"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerIsUsableTests.test_none_ist_nicht_nutzbar": {
"datum": "2026-09-23",
"hash": "3c3dfa47e10c"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerIsUsableTests.test_ungueltiger_layer_ist_nicht_nutzbar": {
"datum": "2026-09-23",
"hash": "371afd48088a"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerIsValidTests.test_ausnahme_bei_isvalid_liefert_false": {
"datum": "2026-09-23",
"hash": "cdea9c039230"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerIsValidTests.test_gueltiger_layer_liefert_true": {
"datum": "2026-09-23",
"hash": "b59492eacf41"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerIsValidTests.test_none_ist_nicht_gueltig": {
"datum": "2026-09-23",
"hash": "fe9e75b0dd64"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerIsValidTests.test_objekt_ohne_isvalid_ist_nicht_gueltig": {
"datum": "2026-09-23",
"hash": "a9ac192cbaea"
},
"sn_basis.tests.test_ly_existence_wrapper.LayerIsValidTests.test_ungueltiger_layer_liefert_false": {
"datum": "2026-09-23",
"hash": "8c70103cdd59"
},
"sn_basis.tests.test_ly_style_wrapper.ApplyStyleFromPathTests.test_ausnahme_beim_laden_wird_abgefangen": {
"datum": "2026-09-23",
"hash": "9f7b05ef45e3"
},
"sn_basis.tests.test_ly_style_wrapper.ApplyStyleFromPathTests.test_erfolgreiches_laden_liefert_true_und_triggert_repaint": {
"datum": "2026-09-23",
"hash": "bd86c7e8e769"
},
"sn_basis.tests.test_ly_style_wrapper.ApplyStyleFromPathTests.test_fehlender_layer_liefert_false": {
"datum": "2026-09-23",
"hash": "3ff023bcd0f7"
},
"sn_basis.tests.test_ly_style_wrapper.ApplyStyleFromPathTests.test_fehlgeschlagenes_laden_liefert_false_ohne_repaint": {
"datum": "2026-09-23",
"hash": "c1f4a7972411"
},
"sn_basis.tests.test_ly_style_wrapper.ApplyStyleFromPathTests.test_pfad_wird_als_text_an_loadnamedstyle_uebergeben": {
"datum": "2026-09-23",
"hash": "83fd0b51b9df"
},
"sn_basis.tests.test_message_wrapper.GetMessageBarTests.test_faellt_bei_fehlerhaftem_iface_auf_mock_bar_zurueck": {
"datum": "2026-09-23",
"hash": "dc6c3cdbfae1"
},
"sn_basis.tests.test_message_wrapper.GetMessageBarTests.test_liefert_objekt_mit_pushmessage_methode": {
"datum": "2026-09-23",
"hash": "e9d99a0b1f02"
},
"sn_basis.tests.test_message_wrapper.MeldungsstufenTests.test_info_warning_error_success_setzen_die_passende_meldungsstufe": {
"datum": "2026-09-23",
"hash": "04f2f5ea94e9"
},
"sn_basis.tests.test_message_wrapper.PushMessageTests.test_fehler_in_der_message_bar_wird_abgefangen": {
"datum": "2026-09-23",
"hash": "a8fdcf8ba3b8"
},
"sn_basis.tests.test_message_wrapper.PushMessageTests.test_liefert_dict_mit_titel_text_level_und_dauer": {
"datum": "2026-09-23",
"hash": "525b2fdab218"
},
"sn_basis.tests.test_navigation.AddActionTests.test_erzeugt_action_und_fuegt_sie_gruppe_und_liste_hinzu": {
"datum": "2026-09-29",
"hash": "7aca9de43703"
},
"sn_basis.tests.test_navigation.AddActionTests.test_ohne_plugin_group_liefert_none": {
"datum": "2026-09-29",
"hash": "518094424549"
},
"sn_basis.tests.test_navigation.AddActionTests.test_ohne_priority_wird_standardprioritaet_100_verwendet": {
"datum": "2026-09-29",
"hash": "49ed3079911d"
},
"sn_basis.tests.test_navigation.FinalizeMenuAndToolbarTests.test_gleiche_prioritaet_behaelt_registrierungsreihenfolge": {
"datum": "2026-09-29",
"hash": "7fe5c4b93d7b"
},
"sn_basis.tests.test_navigation.FinalizeMenuAndToolbarTests.test_nur_menu_ohne_toolbar_laesst_menu_unveraendert": {
"datum": "2026-09-29",
"hash": "93cc53d73004"
},
"sn_basis.tests.test_navigation.FinalizeMenuAndToolbarTests.test_ohne_menu_oder_toolbar_tut_nichts": {
"datum": "2026-09-29",
"hash": "f8a271e5aedf"
},
"sn_basis.tests.test_navigation.FinalizeMenuAndToolbarTests.test_sortiert_und_fuegt_aktionen_in_prioritaetsreihenfolge_hinzu": {
"datum": "2026-09-29",
"hash": "452ef0a0228b"
},
"sn_basis.tests.test_navigation.RemoveActionTests.test_entfernt_action_aus_menu_toolbar_und_liste": {
"datum": "2026-09-29",
"hash": "3c2aea3516cf"
},
"sn_basis.tests.test_navigation.RemoveActionTests.test_none_action_tut_nichts": {
"datum": "2026-09-29",
"hash": "5f69f2236ec0"
},
"sn_basis.tests.test_navigation.RemoveActionTests.test_ohne_menu_oder_toolbar_entfernt_trotzdem_aus_liste": {
"datum": "2026-09-29",
"hash": "57387489da73"
},
"sn_basis.tests.test_navigation.RemoveAllTests.test_entfernt_menu_toolbar_und_setzt_zustand_zurueck": {
"datum": "2026-09-29",
"hash": "3d4ea907aabe"
},
"sn_basis.tests.test_navigation.RemoveAllTests.test_loescht_menu_und_toolbar_objekt_damit_kein_duplikat_uebrig_bleibt": {
"datum": "2026-09-29",
"hash": "f6b94d873e0a"
},
"sn_basis.tests.test_navigation.RemoveAllTests.test_ohne_menu_und_toolbar_ruft_wrapper_nicht_auf": {
"datum": "2026-09-29",
"hash": "7219c12b1516"
},
"sn_basis.tests.test_navigation.SetActivePluginTests.test_ohne_aktive_action_setzt_alle_auf_false": {
"datum": "2026-09-29",
"hash": "e7234529c346"
},
"sn_basis.tests.test_navigation.SetActivePluginTests.test_setzt_nur_aktive_action_auf_checked": {
"datum": "2026-09-29",
"hash": "3e9505367374"
},
"sn_basis.tests.test_os_wrapper.IsCaseSensitiveFsTests.test_linux_ist_case_sensitiv": {
"datum": "2026-09-29",
"hash": "6dd37c5bcfb1"
},
"sn_basis.tests.test_os_wrapper.IsCaseSensitiveFsTests.test_macos_ist_nicht_case_sensitiv": {
"datum": "2026-09-29",
"hash": "953b361870c7"
},
"sn_basis.tests.test_os_wrapper.IsCaseSensitiveFsTests.test_windows_ist_nicht_case_sensitiv": {
"datum": "2026-09-29",
"hash": "a6ff8a4c0b1e"
},
"sn_basis.tests.test_print_layout.TestPrintLayout.test_configure_hauptkarte_grids_uses_wrapper_constants": {
"datum": "2026-09-29",
"hash": "785b2482b97b"
},
"sn_basis.tests.test_print_layout.TestPrintLayout.test_configure_legend_size_uses_content_adaptive_size": {
"datum": "2026-09-29",
"hash": "630779aecd82"
},
"sn_basis.tests.test_print_layout.TestPrintLayout.test_create_legend_item_does_not_copy_project_layers_into_legend_model": {
"datum": "2026-09-29",
"hash": "c2dcdadb3111"
},
"sn_basis.tests.test_print_layout.TestPrintLayout.test_create_legend_item_links_map_and_enables_map_filtering": {
"datum": "2026-09-29",
"hash": "50f14d31bbb0"
},
"sn_basis.tests.test_print_layout.TestPrintLayout.test_create_single_page_layout_bricht_bei_vorhandenem_layoutnamen_ab": {
"datum": "2026-09-29",
"hash": "ff67ab4dce47"
},
"sn_basis.tests.test_print_layout.TestPrintLayout.test_create_single_page_layout_keeps_legend_linked_to_hauptkarte_and_theme": {
"datum": "2026-09-29",
"hash": "cc7f60d92735"
},
"sn_basis.tests.test_print_layout.TestPrintLayout.test_create_single_page_layout_ohne_thema_oder_aktuell_folgt_keinem_kartenthema": {
"datum": "2026-09-29",
"hash": "da3c5570378b"
},
"sn_basis.tests.test_print_layout.TestPrintLayout.test_create_single_page_layout_setzt_nur_gueltigen_plotmassstab": {
"datum": "2026-09-29",
"hash": "1fdaf9400c3d"
},
"sn_basis.tests.test_pruef_ergebnis.DateipfadTests.test_liefert_none_wenn_kontext_kein_path_ist": {
"datum": "2026-09-29",
"hash": "ce0674d82678"
},
"sn_basis.tests.test_pruef_ergebnis.DateipfadTests.test_liefert_path_wenn_kontext_ein_path_ist": {
"datum": "2026-09-29",
"hash": "1325b88bdf57"
},
"sn_basis.tests.test_pruef_ergebnis.ErlaubtePersistierungTests.test_liefert_false_fuer_ueberspringen_und_reines_existieren": {
"datum": "2026-09-29",
"hash": "6ed3d1c5fb87"
},
"sn_basis.tests.test_pruef_ergebnis.ErlaubtePersistierungTests.test_liefert_true_fuer_erzeugen_ueberschreiben_anhaengen": {
"datum": "2026-09-29",
"hash": "876608170849"
},
"sn_basis.tests.test_pruef_ergebnis.IstVerfahrensDbAktionTests.test_liefert_false_fuer_andere_aktionen": {
"datum": "2026-09-29",
"hash": "99b113c8c52d"
},
"sn_basis.tests.test_pruef_ergebnis.IstVerfahrensDbAktionTests.test_liefert_true_fuer_alle_verfahrens_db_aktionen": {
"datum": "2026-09-29",
"hash": "e247283a0cdf"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_datei_existiert_append": {
"datum": "2026-09-17",
"hash": "25e169c45423"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_datei_existiert_cancel": {
"datum": "2026-09-17",
"hash": "0b7718a5f16f"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_datei_existiert_in_non_qgis_mode_returns_input": {
"datum": "2026-09-17",
"hash": "ccff88a11189"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_datei_existiert_overwrite": {
"datum": "2026-09-17",
"hash": "b1a1017d7970"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_layer_unsichtbar_ja": {
"datum": "2026-09-17",
"hash": "c6090b772bf0"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_layer_unsichtbar_nein": {
"datum": "2026-09-17",
"hash": "c865caa3e4c6"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_leereingabe_erlaubt_ja": {
"datum": "2026-09-17",
"hash": "b7097a4b3c4c"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_leereingabe_erlaubt_nein": {
"datum": "2026-09-17",
"hash": "1b792a3d7a51"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_ok": {
"datum": "2026-09-17",
"hash": "7183f163899a"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_standarddatei_vorschlagen_ja": {
"datum": "2026-09-17",
"hash": "7fe9491d4249"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_standarddatei_vorschlagen_nein": {
"datum": "2026-09-17",
"hash": "f2196cc4a990"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_temporaer_erlaubt_ja": {
"datum": "2026-09-17",
"hash": "9665a3c380d0"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_temporaer_erlaubt_nein": {
"datum": "2026-09-17",
"hash": "3a24d85db9f5"
},
"sn_basis.tests.test_pruefmanager.TestPruefmanager.test_unbekannte_aktion": {
"datum": "2026-09-17",
"hash": "e369c5874b64"
},
"sn_basis.tests.test_settings_logic.TestSettingsLogic.test_load": {
"datum": "2026-09-17",
"hash": "f14c558bc597"
},
"sn_basis.tests.test_settings_logic.TestSettingsLogic.test_load_handles_partial_values_with_empty_fallback": {
"datum": "2026-09-17",
"hash": "7dced8a9ea7f"
},
"sn_basis.tests.test_settings_logic.TestSettingsLogic.test_save": {
"datum": "2026-09-17",
"hash": "f214c8244ae7"
},
"sn_basis.tests.test_settings_logic.TestSettingsLogic.test_save_empty_string_value_is_persisted": {
"datum": "2026-09-17",
"hash": "96f217d347c2"
},
"sn_basis.tests.test_stilpruefer.TestStilpruefer.test_datei_existiert_falsche_endung": {
"datum": "2026-09-17",
"hash": "37de9cd7e14c"
},
"sn_basis.tests.test_stilpruefer.TestStilpruefer.test_datei_existiert_mit_qml": {
"datum": "2026-09-17",
"hash": "1faf026ed344"
},
"sn_basis.tests.test_stilpruefer.TestStilpruefer.test_datei_existiert_nicht": {
"datum": "2026-09-17",
"hash": "2919c732c211"
},
"sn_basis.tests.test_stilpruefer.TestStilpruefer.test_keine_datei_angegeben": {
"datum": "2026-09-17",
"hash": "7a3d7bd800c3"
},
"sn_basis.tests.test_sys_wrapper.TestGetPluginRoot.test_get_plugin_root_folgt_keiner_verzeichnisverknuepfung": {
"datum": "2026-09-17",
"hash": "c9b434520d62"
}
}
File diff suppressed because one or more lines are too long
+978 -1174
View File
File diff suppressed because it is too large Load Diff
@@ -1,93 +0,0 @@
# Testkonzept: Anzeige für den Eigentümer und Korrekturen
Plugin: `sn_verfahrensgebiet` · Stand: 06.10.2026 · Pflege: bei jeder Änderung an diesem Ablauf
## Worum es fachlich geht
Im Termin sitzt der Eigentümer vor einem zweiten Bildschirm. Dort sieht er nur seine eigenen gespeicherten Daten:
Name, Anschrift und E-Mail. Den QGIS-Bildschirm mit Trefferliste, Konten und anderen Personen sieht er nicht.
Die Sachbearbeitung beginnt zu Beginn der Termine eine Sitzung und schiebt das Anzeigefenster auf den Bildschirm des Eigentümers; beim nächsten Mal erscheint es wieder dort. Für jeden Eigentümer wählt sie in der Trefferliste
die passenden Einträge und zeigt sie an. Stimmt etwas nicht, korrigiert sie es im Plugin. Der Eigentümer sieht die
Korrektur sofort. Vor dem nächsten Eigentümer leert sie die Anzeige, ohne das Fenster zu schließen. Am Ende beendet
sie die Sitzung.
Die Eigentümerdatei selbst wird nie verändert. Jede Korrektur landet als eigene Zeile in einer Korrektur-CSV neben
der Eigentümerdatei und kann später in das Fachverfahren übernommen werden.
Die Suche bis zur Trefferliste beschreibt [`verfahrensgebiet-eigentuemersuche.md`](verfahrensgebiet-eigentuemersuche.md).
## Der Ablauf
```mermaid
flowchart TD
A["1 Sitzung beginnen"] --> B["2 Anzeigefenster öffnet leer, mit Rahmen;<br/>Bearbeiter schiebt es auf den zweiten Bildschirm"]
T["Trefferliste: Einträge wählen,<br/>„Daten anzeigen“"] --> C{"Sitzung läuft?"}
C -->|nein| A
C -->|ja| D["3 Eigentümer sieht Name,<br/>Anschrift, E-Mail"]
B --> D
D --> E{"4 Daten richtig?"}
E -->|nein| F["5 Korrigieren: Änderung<br/>in Korrektur-CSV, sofort angezeigt"]
F --> E
E -->|ja| G["6 Anzeige leeren<br/>(Fenster bleibt offen)"]
G --> T
G --> H["7 Sitzung beenden:<br/>Fenster schließt"]
style G fill:#e9f5e9,stroke:#2b8a3e
```
## Was geprüft wird
Die Tests liegen in `Plugin_SN_Verfahrensgebiet/tests/test_eigentuemer_anzeige.py` (Anzeigetext, Fenster öffnen),
`tests/test_eigentuemer_korrektur.py` (Korrekturlogik, Korrektur-CSV) und `tests/test_eigentuemer_tab.py`
(Sitzung, Korrektur im Tab).
| # | Schritt | Wird geprüft durch | Ebene |
|---|---|---|---|
| 2 | Sitzung beginnen: leeres Fenster mit Rahmen, nie Vollbild | `test_sitzung_beginnen_oeffnet_leeres_fenster_mit_rahmen`, `test_normales_fenster_in_standardgroesse` | Mock |
| 2 | Lage des Fensters gilt für die nächste Sitzung | `test_lage_gilt_fuer_naechste_sitzung`, `test_gemerkte_lage_wird_wiederhergestellt`, `test_unbrauchbare_lage_ergibt_standardgroesse` | Mock |
| 3 | „Daten anzeigen“ beginnt bei Bedarf die Sitzung | `test_daten_anzeigen_beginnt_sitzung_bei_bedarf`, `test_daten_anzeigen_gibt_auswahl_weiter` | Mock |
| 3 | Ohne Auswahl nur ein Hinweis | `test_daten_anzeigen_ohne_auswahl` | Mock |
| 3 | Inhalt: Name, Anschrift, E-Mail; mehrere Einträge | `test_name_anschrift_email`, `test_mehrere_eintraege_getrennt` | Mock |
| 3 | Keine internen Angaben für den Eigentümer | `test_keine_internen_angaben` | Mock |
| 3 | Fehlende E-Mail ausdrücklich nennen | `test_fehlende_email_wird_genannt` | Mock |
| 5 | Nur echte Änderungen, Leeren zählt | `test_nur_echte_aenderungen`, `test_feld_leeren_ist_aenderung`, `test_feldwerte` | Mock |
| 5 | Korrektur festhalten und sofort anzeigen | `test_korrektur_wird_festgehalten_und_angezeigt`, `test_wende_an` | Mock |
| 5 | Unverändert oder abgebrochen: nichts schreiben | `test_ohne_aenderung_nichts_schreiben`, `test_abbruch_nichts_schreiben` | Mock |
| 5 | Korrektur-CSV: Kopfzeile, BOM, anhängen | `test_neue_datei_mit_kopfzeile_und_bom`, `test_anhaengen_ohne_zweite_kopfzeile`, `test_ohne_aenderung_keine_datei` | Mock |
| 5 | Pfad neben der Eigentümerdatei, sonst Rückfrage | `test_textdatei_provider`, `test_ogr_provider`, `test_keine_csv`, `test_vorschlag_neben_der_eigentuemerdatei`, `test_ohne_csv_quelle_wird_gefragt` | Mock |
| 5 | Schreibfehler | `test_schreibfehler_wird_weitergereicht`, `test_schreibfehler_warnung_und_anzeige_unveraendert` | Mock |
| 5 | Ohne Anzeige keine Korrektur | `test_ohne_anzeige_keine_korrektur` | Mock |
| 5 | Pfad der Korrektur-Datei unter den Knöpfen | `test_ohne_eigentuemerdatei`, `test_pfad_neben_der_eigentuemerdatei`, `test_ohne_csv_quelle_wird_abgefragt`, `test_gewaehlter_pfad_wird_angezeigt` | Mock |
| 6 | Anzeige leeren, Fenster bleibt offen | `test_anzeige_leeren_laesst_fenster_offen`, `test_leer_nur_platzhalter` | Mock |
| 7 | Sitzung beenden bzw. Fenster von außen geschlossen | `test_sitzung_beenden_schliesst_fenster`, `test_von_aussen_geschlossen_beendet_sitzung` | Mock |
| — | Keine Personendaten auf der Konsole | `test_schreibt_nichts_auf_die_konsole` | Mock |
| — | Sieht das in QGIS richtig aus, auf zwei Bildschirmen? | manueller Test | manuell |
Ebene: `Mock` (ohne QGIS, Sekunden) · `QGIS` (gegen echtes QGIS) · `manuell` (Mensch in QGIS).
## Fachliche Sonderfälle
| Sonderfall | Kommt vor bei | Wird geprüft durch |
|---|---|---|
| Nur ein Bildschirm (Notebook) | Termin ohne zweiten Monitor, Ausprobieren | `test_normales_fenster_in_standardgroesse` (immer mit Rahmen, verdeckt QGIS nie ausweglos) |
| Eheleute oder Miteigentümer erscheinen gemeinsam | mehrere Einträge auf einmal anzeigen und einzeln korrigieren | `test_mehrere_eintraege_getrennt`, `test_korrektur_wird_festgehalten_und_angezeigt` |
| Eigentümer hat keine E-Mail hinterlegt | häufig; soll beim Termin ergänzt werden | `test_fehlende_email_wird_genannt` |
| Neue Anschrift mit Komma („Am Anger 3, Haus B“) | Zusatz zur Hausnummer | `test_neue_datei_mit_kopfzeile_und_bom` |
| Eigentümerdatei liegt in einem schreibgeschützten Ordner | Export auf einem Netzlaufwerk ohne Schreibrecht | `test_ohne_csv_quelle_wird_gefragt` (Rückfrage), `test_schreibfehler_warnung_und_anzeige_unveraendert` |
| Sonderzeichen oder spitze Klammern in den Daten | Firmennamen | `test_werte_werden_maskiert` |
## Bewusst nicht getestet
| Was | Warum | Wie stattdessen abgesichert |
|---|---|---|
| Wiederherstellen der Lage auf dem zweiten Bildschirm | braucht echte Bildschirme; im Mock-Modus gibt es keine | Aufruf mit Attrappe geprüft, manueller Test mit zwei Bildschirmen |
| Korrekturdialog mit echten Eingabefeldern | im Mock-Modus gibt es keine Widgets; die Vorbelegung (`feldwerte`) und die Auswertung sind als reine Funktionen getestet | manueller Test |
| Schriftgröße und Lesbarkeit der Anzeige | Geschmack und Bildschirmgröße | manueller Test im Termin |
## Bekannte Lücken
| Lücke | Auswirkung | Issue |
|---|---|---|
| Wiederherstellen der Lage in der nächsten Sitzung ist in QGIS noch nicht bestätigt | Das Fenster erscheint dann wieder auf dem Hauptbildschirm und muss erneut verschoben werden – lästig, aber gefahrlos | Verfahrensgebiet #56 |
| Die Lage wird nur bis zum Neustart von QGIS gemerkt | nach jedem Start einmal verschieben | bei Bedarf eigenes Issue (QSettings) |
| Eine neue Suche leert die Anzeige nicht von selbst | Wer „Anzeige leeren“ vergisst, zeigt dem nächsten Eigentümer noch die vorherigen Daten | bewusst so (Bearbeiter entscheidet); bei Bedarf eigenes Issue |
@@ -1,88 +0,0 @@
# Testkonzept: Eigentümersuche im Tab „Eigentümer“
Plugin: `sn_verfahrensgebiet` · Stand: 06.10.2026 · Pflege: bei jeder Änderung an diesem Ablauf
## Worum es fachlich geht
Im Termin mit Eigentümern gleicht die Sachbearbeitung die gespeicherten Personendaten ab: Name, Anschrift und
E-Mail. Grundlage ist der Serienbriefexport als CSV-Datei, den die Sachbearbeitung von Hand ins Projekt lädt.
Sie sucht nach Name und/oder Vorname. Die Trefferliste fasst Einträge derselben Person mit derselben Anschrift
zusammen, denn im Export steht eine Person für jedes Eigentumskonto einmal. Dieselbe Person mit einer anderen
Anschrift bleibt ein eigener Eintrag. Damit fällt eine abweichende Anschrift sofort auf. Verstorbene und
Rechtspersonen sind in der Liste gekennzeichnet:
verstorben als Hinweis (`PER_VERSTORBEN` = 1), die Art der Person als Rohwert von `PER_RECHTSPERSON`
(0, 1, 5 oder 9; die Bedeutung der Werte wird später entschlüsselt).
Die Trefferliste sieht nur die Sachbearbeitung. Wie die gewählten Einträge dem Eigentümer angezeigt und korrigiert
werden, beschreibt [`verfahrensgebiet-eigentuemer-anzeige.md`](verfahrensgebiet-eigentuemer-anzeige.md).
## Der Ablauf
```mermaid
flowchart TD
A["1 Anwender lädt den Serienbriefexport<br/>als CSV-Layer ins Projekt"] --> B["2 Eigentümerdatei wählen<br/>(nur Layer mit Nachname und Vorname)"]
B --> C{"3 Eigentümerdatei<br/>gewählt?"}
C -->|nein| D["Hinweis: CSV laden und wählen"]
C -->|ja| E{"4 Name oder Vorname<br/>eingegeben?"}
E -->|nein| F["Hinweis: Namen eingeben"]
E -->|ja| G["5 Einträge suchen<br/>(Teilwort, Groß-/Kleinschreibung<br/>und Umlaute egal)"]
G --> H["6 Gleiche Person mit gleicher<br/>Anschrift zusammenfassen"]
H --> I{"7 Treffer?"}
I -->|nein| J["Hinweis: keine Einträge<br/>(ohne den Namen zu wiederholen)"]
I -->|ja| K["8 Trefferliste mit Anschrift, E-Mail,<br/>Rechtsperson-Wert, verstorben;<br/>Mehrfachauswahl"]
style D fill:#fff4e6,stroke:#d9822b
style F fill:#fff4e6,stroke:#d9822b
```
## Was geprüft wird
Die Tests liegen in `Plugin_SN_Verfahrensgebiet/tests/test_eigentuemer_suche.py` (Suchlogik),
`tests/test_eigentuemer_tab.py` (Bedienung, Trefferliste) und `tests/test_verfahrensgebiet_dialoge.py`
(gemeinsame Auswahltabelle).
| # | Schritt | Wird geprüft durch | Ebene |
|---|---|---|---|
| 2 | Nur Layer mit Nachname und Vorname, auch mit BOM oder anderer Schreibweise | `test_layer_mit_name_und_vorname_ist_eigentuemerlayer`, `test_eigentuemerlayer_im_projekt` | Mock |
| 3 | Keine Eigentümerdatei gewählt | `test_ohne_eigentuemerdatei_warnung` | Mock |
| 3 | Layer ohne die nötigen Spalten | `test_layer_ohne_pflichtspalten` | Mock |
| 4 | Ohne Eingabe keine Komplettliste | `test_ohne_eingabe_fehler`, `test_suchfehler_als_warnung` | Mock |
| 5 | Teilwort, Groß-/Kleinschreibung | `test_teilstring_ohne_gross_kleinschreibung` | Mock |
| 5 | Umlaute und ß | `test_umlaute_und_eszett` | Mock |
| 6 | Zusammenfassen, Konten und E-Mails sammeln | `test_gleiche_person_gleiche_anschrift_zusammengefasst` | Mock |
| 6 | Andere Anschrift bleibt eigener Eintrag | `test_andere_anschrift_eigener_treffer` | Mock |
| 7 | Kein Treffer, Meldung ohne Namen | `test_kein_treffer_ohne_namen_in_meldung` | Mock |
| 8 | Trefferliste öffnen, alte ersetzen | `test_treffer_oeffnen_trefferliste_und_ersetzen_die_alte` | Mock |
| 8 | Spalten der Trefferliste, Kennzeichen | `test_trefferzeile_mit_hinweis`, `test_kennzeichen_verstorben`, `test_rechtsperson_als_rohwert` | Mock |
| 8 | Ausgewählte Einträge, auch nach Umsortieren | `test_ausgewaehlte_eigentuemer`, `test_auswahl_nach_umsortieren` | Mock |
| 8 | Suchfeld in der Trefferliste | `test_suchfilter_ueber_alle_spalten` | Mock |
| — | Keine Personendaten auf der Konsole | `test_suche_gibt_nichts_aus` | Mock |
| — | Sieht das in QGIS richtig aus? | manueller Test | manuell |
Ebene: `Mock` (ohne QGIS, Sekunden) · `QGIS` (gegen echtes QGIS) · `manuell` (Mensch in QGIS).
## Fachliche Sonderfälle
| Sonderfall | Kommt vor bei | Wird geprüft durch |
|---|---|---|
| Eine Person mit mehreren Eigentumskonten | Regelfall im Serienbriefexport | `test_gleiche_person_gleiche_anschrift_zusammengefasst` |
| Schreibweise weicht ab (Groß-/Kleinschreibung, Leerzeichen) | Handeingaben über Jahre | `test_gleiche_person_gleiche_anschrift_zusammengefasst` |
| `Müller` gesucht, `Mueller` gespeichert | ältere Datenbestände | `test_umlaute_und_eszett` |
| PLZ ohne führende Null (`1067`) | QGIS erkennt beim CSV-Laden die Spalte als Zahl | `test_plz_mit_fuehrender_null` |
| `PER_VERSTORBEN` als Text oder als Zahl gelesen | QGIS erkennt beim CSV-Laden die Spalte als Zahl | `test_kennzeichen_verstorben` |
| Eine Person mit verschiedenen `PER_RECHTSPERSON`-Werten | mehrere Konten mit unterschiedlicher Erfassung | `test_rechtsperson_als_rohwert` (Werte werden gesammelt) |
| Leere Felder bzw. QGIS-NULL | unvollständige Datensätze | `test_kennzeichen_verstorben`, `test_rechtsperson_als_rohwert` |
| Rechtsperson ohne Vornamen (z. B. Gemeinde) | Körperschaften als Eigentümer | `test_name_und_anschrift`, `test_rechtsperson_als_rohwert` |
## Bewusst nicht getestet
| Was | Warum | Wie stattdessen abgesichert |
|---|---|---|
| Aufbau von Trefferfenster und Auswahltabelle mit echten Qt-Widgets | im Mock-Modus gibt es keine Widgets; die Filter- und Zuordnungslogik ist als reine Funktion getestet | manueller Test in QGIS |
| Echter Serienbriefexport | personenbezogen, gehört nicht ins Repository | erfundene Testzeilen mit der Kopfzeile der Blanko-Vorlage aus dem Issue |
## Bekannte Lücken
| Lücke | Auswirkung | Issue |
|---|---|---|
| Der manuelle QGIS-Test steht aus, auch für den Landkreis-Dialog, dessen Tabelle jetzt aus der gemeinsamen Funktion kommt | Ein Fehler beim Herauslösen der Tabelle bliebe in beiden Dialogen unbemerkt | Verfahrensgebiet #56 |
@@ -1,84 +0,0 @@
# Testkonzept: Flurstückssuche im Tab „Eigentümer“
Plugin: `sn_verfahrensgebiet` · Stand: 06.10.2026 · Pflege: bei jeder Änderung an diesem Ablauf
## Worum es fachlich geht
Im Termin mit einem Eigentümer soll die Sachbearbeitung ein Flurstück schnell auf der Karte zeigen können.
Sie gibt Gemarkung und Flurstücksnummer ein, das Plugin wählt das Flurstück im geladenen Flurstückslayer aus
und springt dorthin. Gesucht wird nur in den Flurstücken, die vorher mit dem Verfahrensgebiet aus ALKIS geladen
wurden. So muss im Tab keine Gemarkung aus ganz Sachsen ausgewählt werden.
Die Eigentümersuche im selben Tab beschreibt [`verfahrensgebiet-eigentuemersuche.md`](verfahrensgebiet-eigentuemersuche.md).
## Der Ablauf
```mermaid
flowchart TD
A["1 Anwender gibt Gemarkung<br/>und Flurstücksnummer ein"] --> B{"2 Flurstückslayer<br/>im Projekt?"}
B -->|nein| C["Hinweis: zuerst Verfahrensgebiet<br/>und Flurstücke aus ALKIS laden"]
B -->|ja| D{"3 Flurstücksnummer lesbar?<br/>z. B. 562 oder 12/3"}
D -->|nein| E["Hinweis zur Schreibweise"]
D -->|ja| F{"4 Gemarkung als Nummer<br/>oder als Name?"}
F -->|Nummer| H["5 Flurstücke vergleichen"]
F -->|Name| G{"Gemarkungslayer geladen<br/>und Name darin?"}
G -->|nein| E2["Hinweis: Nummer eingeben<br/>oder Gemarkungen laden"]
G -->|ja| H
H --> I{"6 Treffer?"}
I -->|nein| J["Hinweis: nicht gefunden"]
I -->|ja| K["7 Treffer auswählen,<br/>hinzoomen, aufblinken"]
style C fill:#fff4e6,stroke:#d9822b
style E fill:#fff4e6,stroke:#d9822b
style E2 fill:#fff4e6,stroke:#d9822b
```
## Was geprüft wird
Die Tests liegen in `Plugin_SN_Verfahrensgebiet/tests/test_flurstueck_suche.py` (Suchlogik) und
`tests/test_eigentuemer_tab.py` (Bedienung im Tab).
| # | Schritt | Wird geprüft durch | Ebene |
|---|---|---|---|
| — | Tab erscheint nach „Bearbeitung“ | `test_tab_ist_im_dockwidget_eingetragen` | Mock |
| 2 | Kein Flurstückslayer: Suche bricht ab | `test_fehlender_flurstueckslayer_bricht_ab` | Mock |
| 2 | … und der Hinweis kommt als Dialog | `test_ohne_flurstueckslayer_erscheint_hinweisdialog` | Mock |
| 3 | Zähler und Nenner lesen, führende Nullen | `test_flurstuecksnummer_mit_und_ohne_nenner` | Mock |
| 3 | Unlesbare Nummer abweisen | `test_ungueltige_flurstuecksnummer`, `test_eingabefehler_als_warnung` | Mock |
| 4 | Gemarkungsnummer, auch ohne Nullen oder als langer Schlüssel | `test_gemarkungsnummer_aus_ziffern` | Mock |
| 4 | Gemarkungsname, auch mehrfach vorkommend | `test_gemarkungsname_ueber_gemarkungslayer` | Mock |
| 4 | Name ohne Gemarkungslayer oder unbekannt | `test_gemarkungsname_ohne_layer_oder_unbekannt` | Mock |
| 5 | Flurstückskennzeichen zerlegen | `test_kennzeichen_zerlegen` | Mock |
| 5 | Layer ohne Kennzeichenfeld | `test_layer_ohne_kennzeichenfeld` | Mock |
| 6 | Mit Nenner genau ein Treffer | `test_mit_nenner_genau_ein_treffer` | Mock |
| 6 | Ohne Nenner alle mit diesem Zähler, nur in der Gemarkung | `test_ohne_nenner_alle_mit_diesem_zaehler` | Mock |
| 6 | Kein Treffer | `test_kein_treffer` (Logik), `test_kein_treffer` (Tab) | Mock |
| 7 | Auswahl, Zoom, Aufblinken | `test_treffer_werden_ausgewaehlt_und_angezoomt` | Mock |
| 7 | Auswahl auch ohne Kartenansicht | `test_ohne_kartenansicht_bleibt_auswahl` | Mock |
| — | Sieht das in QGIS richtig aus? | manueller Test | manuell |
Ebene: `Mock` (ohne QGIS, Sekunden) · `QGIS` (gegen echtes QGIS) · `manuell` (Mensch in QGIS).
## Fachliche Sonderfälle
| Sonderfall | Kommt vor bei | Wird geprüft durch |
|---|---|---|
| Buchstaben-Nenner (`12/a`) | ältere Flurstücke | `test_mit_nenner_genau_ein_treffer`, `test_kennzeichen_zerlegen` |
| Gleichnamige Gemarkungen | verbreitete Ortsnamen in mehreren Landkreisen | `test_gemarkungsname_ueber_gemarkungslayer` |
| Gemarkungsschlüssel mit Landesnummer (`140268`) | kopiert aus anderen Programmen | `test_gemarkungsnummer_aus_ziffern` |
| Flurstücke mit leerem Kennzeichen | unvollständige Daten | `test_ohne_nenner_alle_mit_diesem_zaehler` (Feature ohne Kennzeichen wird übersprungen) |
| Im Flurstückslayer ist schon etwas ausgewählt | Verfahrensgebiet aus der Flurstücksauswahl bilden | `test_treffer_werden_ausgewaehlt_und_angezoomt`: Die Suche ersetzt die Auswahl, wie die Suchen in QGIS selbst |
## Bewusst nicht getestet
| Was | Warum | Wie stattdessen abgesichert |
|---|---|---|
| Zoomen und Aufblinken in der Kartenansicht | QGIS-Funktionen (`zoomToSelected`, `flashFeatureIds`), im Mock-Modus gibt es keine Karte | manueller Test in QGIS |
| Aussehen des Tabs | nicht sinnvoll automatisiert prüfbar | manueller Test |
| Echter Flurstückslayer aus dem ALKIS-WFS | kein Netzwerk in Tests | Aufbau des Kennzeichens in `../wissen/alkis_objektarten.md`, manueller Test |
## Bekannte Lücken
| Lücke | Auswirkung | Issue |
|---|---|---|
| Der manuelle Test in QGIS steht aus | Zoom auf sehr kleine Flurstücke und das Aufblinken sind nicht gesehen | Verfahrensgebiet #56 |
-8
View File
@@ -37,14 +37,6 @@ Versionsnummern unten nachziehen.
- Praktisch relevant: das Flurstückskennzeichen ist objektbildend; jedes Flurstück gehört zu genau einer
Gemarkung bzw. Flur/Gemarkungsteil. Das Plugin übernimmt das komplette Feldschema des WFS-Layers in den
Memory-Layer, ohne Attribute fest zu benennen.
- **Aufbau von `flurstueckskennzeichen`** (20 Zeichen, unbesetzte Teile mit `_` gefüllt), am Dienst geprüft
am 06.10.2026: `14 0268 ___ 00562 ____ 00` = Land (2), Gemarkungsnummer (4), Flur (3, in Sachsen unbesetzt),
Zähler (5), Nenner (4, auch Buchstaben wie `000a`), Folge (2). Die Flurstückssuche (Verfahrensgebiet #56)
vergleicht deshalb dieses Kennzeichen und nicht die von QGIS abgeflachten Einzelfelder
(`flurstuecksnummer/…/zaehler`), deren Namen vom WFS-Provider abhängen.
- **Keine Eigentümer- oder Buchungsangaben:** Der öffentliche Dienst verweist nur per `istGebucht` auf ein
Buchungsblatt-Objekt, das er selbst nicht ausliefert. Eine Zuordnung Eigentümer ↔ Flurstück braucht eine eigene
Quelle (Verfahrensgebiet #56, dort zurückgestellt).
## `AX_BauRaumOderBodenordnungsrecht` — Bau-, Raum- oder Bodenordnungsrecht
+41 -87
View File
@@ -5,16 +5,35 @@ Kurz, konkret, mit Datum und Quelle. Neue Einträge oben in der passenden Rubrik
## Umgebung und Werkzeuge
- **`qt_wrapper` meldet unter QGIS 3.44 `QT_VERSION == 6`, obwohl Qt5 läuft.** Der „PyQt6“-Zweig importiert
`qgis.PyQt`, das unter QGIS 3 PyQt5 ist; die Qt6-Schreibweise der Enums (`Qt.ItemFlag.ItemIsUserCheckable`)
funktioniert mit PyQt 5.15 trotzdem. `QT_VERSION` also nicht als Qt-Hauptversion verstehen, nur als
„echtes Qt (≠ 0)“. (02.10.2026, QGIS 3.44.4 geprüft, Basis #88)
- **Lücken im Mock-Modus:** `QgsGeometry` hat im Mock kein `fromRect`, `QgsLayoutPoint`/`QgsLayoutSize` haben
`x`/`width` als Attribute statt als Methoden; `QgsRectangle` hatte bis Basis #88 gar keinen Mock. Tests patchen
solche Stellen gezielt, statt die Produktionsfunktion umzubauen. (02.10.2026)
- **QGIS 3.40 ist seit Januar 2026 End of Life.** Aktueller LTR ist 3.44, Stable 4.2 (wird 25.09.2026 LTR). `workspace.toml` und alle `metadata.template` stehen noch auf `3.40` – offene Produktentscheidung, siehe `docs/konzept/07_qgis_tests_plan.md` Abschnitt 2. (04.09.2026, QGIS-Release-Fahrplan)
- **Zwei Qt-Welten.** QGIS 3.40/3.44 laufen mit Qt5/PyQt5, QGIS 4 mit Qt6/PyQt6. `qt_wrapper` lädt PyQt6 zuerst, dann PyQt5, sonst Mock. Enum-Zugriffe unterscheiden sich (`Qt.AlignmentFlag.AlignTop` statt `Qt.AlignTop`), deshalb nur Wrapper-Aliase verwenden. (09/2026, Code)
- **Mock-Modus ist kein QGIS.** `python scripts/run_tests.py` läuft in Sekunden, prüft aber nur Logik gegen Mock-Klassen. Geometrieoperationen, WFS, Layouts und Signale müssen in QGIS geprüft werden (`tests/test_qgis.bat` unter Windows). Manuelle QGIS-Tests im PR dokumentieren. (09/2026)
- **`sqlite3.connect()` in einem `with`-Block schließt die Verbindung nicht.** Das `with`-Statement committet
bzw. rollt nur zurück, `conn` bleibt offen (siehe `Datenschreiber._store_style_in_gpkg`). Unter Windows
sperrt das die Datei, bis die Verbindung per Garbage Collection oder explizitem `close()` freigegeben wird –
ein Test, der danach dasselbe `tempfile.TemporaryDirectory()` verlassen will, bricht mit
`PermissionError: [WinError 32]` ab. Betroffene Produktionsfunktion nicht nebenbei umschreiben (kein
Refactoring im Testticket); stattdessen im Test `tempfile.mkdtemp()` + `try/finally` mit `gc.collect()`
vor `shutil.rmtree(..., ignore_errors=True)` verwenden. (21.09.2026, Issue Basis #70)
- **`_MockQgsProject` war unvollständig:** `transformContext()` und `addMapLayer()` fehlten, wodurch
`Datenschreiber._write_layer_to_gpkg` und `LayerLoader.add_to_project` im Mock-Modus für **jeden** gültigen
Layer eine Ausnahme geworfen bzw. eine Fehlermeldung erzeugt hätten – nicht durch einen Fehler in diesen
Funktionen, sondern durch den unvollständigen Mock. Beim Schreiben neuer Tests für einen dieser Pfade prüfen,
ob `functions/qgiscore_wrapper.py::_MockQgsProject` die benötigte Methode schon hat, statt lange nach dem
„Bug" in der eigentlichen Funktion zu suchen. Ergänzt in Issue Basis #63 (18.09.2026).
- **`_MockQDockWidget` hatte kein `closeEvent()`:** `BaseDockWidget.closeEvent()` ruft am Ende
`super().closeEvent(event)` auf – im Mock-Modus stürzte das für **jede** reale `BaseDockWidget`-Instanz mit
`AttributeError` ab. Ergänzt in Issue Basis #65 (18.09.2026); gleiche Kategorie Fund wie oben – erst den
Mock in `qt_wrapper.py`/`qgiscore_wrapper.py` auf Vollständigkeit prüfen, bevor die eigentliche Funktion in
Verdacht gerät. Bei UI-Klassen mit `__init__`, die selbst nicht QGIS-frei konstruierbar sind (fehlende
`setLayout()`/`QGroupBox` im Mock, z. B. `SettingsTab`), Instanz stattdessen über `Klasse.__new__(Klasse)`
ohne `__init__` erzeugen und nur die für den Test nötigen Attribute von Hand setzen (siehe
`tests/test_base_dockwidget.py`, `tests/test_settings_tab.py`).
- **Zwei Testkatalog-Fehlalarme durch die „Ungetestete Funktionen"-Heuristik entdeckt und real bestätigt (Issue
Basis #60):** `Pruefmanager._ask_use_or_replace_pufferlayer()` referenziert `self.pruefmanager`, das auf
`Pruefmanager`-Instanzen nie existiert (`AttributeError` bei jedem Aufruf) – toter Code, im ganzen Workspace
ohne Aufrufer. Vor einem Test für eine als „testen" markierte Funktion kurz prüfen, ob sie überhaupt
syntaktisch fehlerfrei aufrufbar ist.
- **`openpyxl` ist eine harte Abhängigkeit** von `sn_basis` (Excel-Import) und unter Linux-QGIS oft nicht installiert (Issue Verfahrensgebiet #21). `requests` ist nur optionaler Fallback. Es gibt keine `requirements.txt`. (09/2026)
- **QGIS lädt Plugins in nicht garantierter Reihenfolge.** Fachplugins dürfen in `initGui()` nicht davon ausgehen, dass `sn_basis` fertig ist; `sn_basis` ruft `initGui()` aller `sn_*` nach. (Code `main.py`)
- **Exit-Crash unter QGIS 3.40** entstand durch nicht getrennte Projektsignale beim Unload. Regel: jeder Tab/Manager, der Signale verbindet, bietet `cleanup()`/`teardown_...()` und wird beim Schließen aufgerufen. (Basis, `assets/plan-qgis340ExitCrashFix.prompt.md`)
@@ -22,16 +41,25 @@ Kurz, konkret, mit Datum und Quelle. Neue Einträge oben in der passenden Rubrik
Internetverbindung beim Öffnen bleiben die Baumdiagramme leer, Text/Tabellen/Filter funktionieren trotzdem
(kein Server nötig, einfach lokal im Browser öffnen). Erzeugt zusammen mit `testkatalog.md` durch
`python scripts/testkatalog.py`; beide Dateien müssen zueinander passen (`--pruefen` prüft beide). (09/2026)
- **Test-Audit (`scripts/test_audit.py`, `docs/status/testpruefungen.json`) reagiert auf jede inhaltliche
Änderung am Testkörper, aber nicht auf reines Trailing Whitespace.** Der Hash je Testfall wird über den
`rstrip()`-normalisierten Quelltext gebildet. Eine größere Reformatierung (Docstring-Text, Einrückung,
Assertions) macht bestehende Prüfungen also bewusst „veraltet" – das ist gewollt, sollte aber vor einer
größeren Reformatierungs-PR angekündigt werden, damit niemand über plötzlich viele „veraltet"-Einträge
stolpert. (09/2026, Ticket #16)
- **`scripts/test_audit.py` importiert `scripts/testkatalog.py` als Modul** (`import testkatalog`). Das
funktioniert nur, wenn es als `python scripts/test_audit.py …` aufgerufen wird – Python setzt dabei
automatisch das Verzeichnis des Skripts als ersten Sucheintrag. Ein Aufruf aus einem anderen Arbeitsverzeichnis
über einen vollen Pfad funktioniert genauso; ein Import von `test_audit` als Paket ohne diesen Mechanismus
(z. B. `python -c "import test_audit"` von anderswo) schlägt fehl. (09/2026)
- **`docs/status/testpruefungen.json` wird nur von `scripts/test_audit.py markieren` geschrieben.**
`scripts/testkatalog.py` liest sie ausschließlich (wie bei `testbaseline.json`); die Datei fehlt zunächst und
entsteht erst mit dem ersten `markieren`-Aufruf – der Prüfstand zeigt bis dahin alle Testfälle als „nie
geprüft". (09/2026)
- **`.vscode/` gehört nicht ins Repository.** Im Projektwissen wurde er am 04.09.2026 entfernt; brauchbare Einstellungen stehen jetzt in `docs/leitfaden/04_werkzeuge_einrichten.md` Abschnitt 4.2 zum Kopieren in die Benutzereinstellungen. In `Plugin_SN_Basis`, `Plugin_SN_Plan41`, `Plugin_SN_Verfahrensgebiet` und `Plugin_SN_Widmung` liegt er noch und enthält Pfade eines einzelnen Arbeitsplatzes (OSGeo-Installationspfad, persönliches Benutzerprofil) – nicht als Vorgabe verstehen. (09/2026)
## QGIS-Tests (geplant, siehe `docs/konzept/07_qgis_tests_plan.md`)
- **Spike/Abnahme ohne QGIS-Oberfläche:** Skript mit `QT_QPA_PLATFORM=offscreen` über `python-qgis.bat` starten,
das Plugin-Repo per Junction (`mklink /J <tmp>\sn_basis <Plugin_SN_Basis>`) unter dem Paketnamen in `sys.path`
legen. Für Widgets und Dialoge `QgsApplication([], True)` (mit GUI) – ohne GUI stürzt z. B.
`QgsSymbolLayerUtils.symbolPreviewIcon` ab. Modale Dialoge: `exec_dialog` patchen und im Ersatz die Widgets
prüfen. Layout-Ergebnis mit `QgsLayoutExporter.renderRegionToImage` als PNG ansehen; ohne installierte Schriften
erscheinen Texte als Kästchen. `exportToImage` liefert bei Erfolg `0`. (02.10.2026, Basis #88)
- **`QT_QPA_PLATFORM=offscreen` muss gesetzt sein, bevor die `QgsApplication` erzeugt wird.** Danach wirkt es nicht mehr. (04.09.2026, Recherche)
- **`qgis.utils.iface` ist nach `start_app()` `None`.** Entweder `pytest-qgis` verwenden (patcht automatisch) oder selbst `qgis.utils.iface = get_iface()` setzen – und keine Module zu früh importieren. (04.09.2026)
- **`QgsProject.instance()` ist global.** Ohne Aufräumen zwischen den Tests beeinflussen sie sich gegenseitig. (04.09.2026)
@@ -53,90 +81,16 @@ Kurz, konkret, mit Datum und Quelle. Neue Einträge oben in der passenden Rubrik
## Daten und Dienste
- **Punktlinien aus Mapbox-Styles sind in QGIS unsichtbar.** basemap.de (wie viele MapLibre-Stile) zeichnet Punktlinien
als `line-dasharray` mit Strichlänge 0 und `line-cap: round`. QGIS übernimmt das beim Import 1:1, Qt zeichnet
Striche der Länge 0 aber gar nicht – auch nicht als Punkt, weder in der Karte noch in der Legende. Betroffen
sind bei basemap.de 12 Styles (Baumreihe, Hecke, Durchlass, Seilbahnen …). Abhilfe: Strichlänge 0 durch 0,01
ersetzen (`sn_basis.modules.basemap_stilkorrektur`). Beim Prüfen solcher Effekte die Beschriftung abschalten –
sonst zählen Labels als „sichtbare Pixel“. (02.10.2026, QGIS 3.44 / PyQt 5.15, Basis #90; QGIS 4 ungeprüft)
- **basemap.de-Vektorkacheln (Basis #88):** QGIS zeigt für Vektorkachel-Layer keine Legende. Objekte im Gebiet
liefert `QgsVectorTileLayer.selectByGeometry()` (lädt die Kacheln selbst; `getRawTile` ist in Python gesperrt).
Kacheln enden bei Zoom 15. Der Renderer prüft Styles mit `scaleToZoomLevel(maßstab, False)` und setzt
`@vector_tile_zoom = scaleToZoom(maßstab)` – diese Variable fehlt in der Legende, zoomabhängige Strichmuster
sind dort sonst unsichtbar. Beim Import der Style-JSON werden Beschriftungen zu Labeling (Hausnummern =
Labeling-Style `Hauskoordinate`), `Nummer_*`-Schilder zu Renderer-Symbolen, `fill-extrusion` (3D) entfällt.
Der Legendenkatalog `sn_basis/data/basemap_legende.json` gehört zur Style-Version `bm_web_col` v2; nach einer
neuen Version `python modules/basemap_katalog.py` laufen lassen und Meldungen prüfen. Eine QML-Stilvorlage des
Layers ist rund 3,7 MB groß. (02.10.2026)
- **`symbol_stile` im Basemap-Legendenkatalog müssen alle Zoomstufen abdecken (Basis #98).** Viele basemap.de-Styles
gelten nur in einem Zoombereich (z. B. `*_Autobahn_getrennt` bis Zoom 13, ab Zoom 14
`*_Autobahn_getrennt_Fahrbahnachse`). Ist bei der Druck-Zoomstufe kein `symbol_stil` aktiv, nimmt
`waehle_symbolnamen` den ersten getroffenen Style – oft nur die graue Kontur. Deshalb je Zoombereich ein
Kontur-/Decker-Paar eintragen; inaktive werden übergangen. Lücken findet ein Abgleich der `minzoom`/`maxzoom`
der Style-JSON mit dem Katalog. Weitere Lücken im Druckbereich (Stand 06.10.2026): „Straße im Tunnel“
ab Zoom 14, „Biosphärenreservat“ ab Zoom 11. (06.10.2026)
- **basemap.de-Themen (Basis #100):** Angeboten werden Farbe (`bm_web_col`), Grau (`bm_web_gry`) und Relief
(`bm_web_top`); `bm_web_bin` liegt auf dem Server, steht aber nicht auf basemap.de. Farbe und Grau nutzen nur die
Kachelquelle `bm_web_de_3857`. **Relief braucht zusätzlich** die Höhenlinien-Kacheln `bm_web_hl_de_3857` und zwei
WMS-Schummerungen – ein einzelner QGIS-Vektorkachel-Layer hat nur eine Kachelquelle, Relief ist deshalb vorerst
nicht im Themen-Dropdown. Style-Version der JSONs am 05.10.2026: `basemapde:style-version` 5.1.0.
- **QGIS kennt kein „Darstellung geändert“-Kennzeichen pro Layer.** Für ungespeicherte Änderungen am Thema wird
deshalb ein Prüfwert der QML (Symbologie + Beschriftung, ohne `version`-Attribut) als Layer-Eigenschaft gemerkt
und vor dem Themenwechsel verglichen (`basemap_themen.aenderungsstand`). Die Berechnung schreibt die rund 3,7 MB
große QML in eine temporäre Datei. Dieselbe Darstellung ergibt in QGIS dieselbe QML, der Prüfwert ist also stabil
(manueller QGIS-Test 05.10.2026). Auch „Punktlinien korrigieren“ zählt als Änderung. (05.10.2026)
- **basemap.de P10 Vektor ist kein Kacheldienst (Basis #102).** Es ist ein bundesweites GeoPackage (60,3 GB, 40
Tabellen, **EPSG:25832**, Beta vom 14.08.2026, optimiert für QGIS 3.44.8). Die Basemap-Werkzeuge in `sn_basis`
(Erkennung, `selectByGeometry`, Legendenkatalog nach Style-IDs, Stilvorlagen über `renderer().styles()`) setzen
Vektorkacheln voraus und greifen dort nicht; die QGIS-Legende funktioniert dagegen selbst. Weitere Befunde der
Prüfung vom 06.10.2026:
- Stile gibt es nicht als `layer_styles`, sondern als ein in `qgis_projects` eingebettetes QGIS-Projekt (29 Layer).
Farbe/Grau steuert die Projektvariable `@project_theme` (`'gry'`) zusammen mit 73 benannten Projektfarben
(`project_color_object('Seeblau'|'Seeblau_gry')`). Wer nur die Layerstile übernimmt, verliert die Farben.
- Direktes Lesen aus dem Netz (`/vsicurl/`) ist zu langsam: Die Objekte liegen in der Datei nicht räumlich sortiert,
3 × 3 km und 5 Layer kosteten rund 3 900 Teilabrufe (etwa 8 min); nach einigen tausend Abrufen trennt der Server
die Verbindung. Nur nach vollständigem Download zuschneiden; `ogr2ogr` kopiert `qgis_projects` voraussichtlich nicht mit.
- Die Beta-Lizenz erlaubt die Nutzung nur „zu Testzwecken“ (Nr. 2.2). (06.10.2026)
- **WFS-Beschränkungen der sächsischen ALKIS-Dienste:** POST/GML-Filter werden blockiert, URL-Länge ist begrenzt, serverseitige Feature-Limits. Deshalb arbeiten Flurstücks- und Grenzpunktabrufe mit BBOX, gemarkungsweisen Batches und Nutzerdialogen. Nicht „vereinfachen“, ohne das gegen den Dienst zu testen. Vollständig mit erprobten Anfragen: `docs/wissen/wfs_dienste.md`, Objektarten/Attribute: `docs/wissen/alkis_objektarten.md`. (Verfahrensgebiet, Code)
- **Zwei Linklisten.** Zentrale `Linkliste/linkliste.csv` (Spalten `id;gruppe;ebene;inhalt;url;provider;stil`) und die vom Plugin genutzte `Plugin_SN_Plan41/assets/Linkliste.xlsx` (`ident, gruppe, kartenebene, inhalt, link, provider, stildatei`) sind nicht verbunden. Änderungen an Diensten in **beiden** nachziehen, bis die Zusammenführung entschieden ist. (09/2026)
- **ArcGIS-REST-Layer nicht nach Nummer deuten.** Gleiche Layer-URLs werden in der Linkliste und im Alternativansatz unterschiedlich benannt; Bedeutung und Geometrie immer gegen die Dienstmetadaten prüfen. (Vergleich Alternativansatz 09/2026)
- **CRS:** Plan41 und VLN-API arbeiten in EPSG:25833. Der Alternativansatz erzeugt EPSG:25832. Für neue Layer 25833 verwenden, bis eine Entscheidung dokumentiert ist.
- **Shape-Import erwartet Feld `FBSchl`** mit `901/10110F` (Neuordnungsgebiet) oder `901/10120F` (Neuvermessungsgebiet). Exporte mit abweichendem Feldnamen (`FBSchl.`) wurden bis 26.8.3 abgewiesen; seit PR Verfahrensgebiet #45 (02.09.2026, 26.8.4-unstable) ist die Feldsuche tolerant. Neue Exportvarianten trotzdem gegen die Erkennung testen.
- **Eigentümerdaten sind personenbezogen (Verfahrensgebiet #56).** Der Serienbriefexport wird vom Anwender von Hand als CSV-Layer geladen; das Plugin liest ihn nur. Namen und Anschriften gehören nicht in `print`, Meldungsleiste, Projektvariablen oder Testdaten (Tests nutzen erfundene Namen, `test_suche_gibt_nichts_aus` prüft die Konsole). Ein gespeichertes Projekt enthält nur den Pfad zur CSV, nicht die Daten. Die Korrektur-CSV (`<Eigentümerdatei>_korrekturen.csv`) enthält ebenfalls Personendaten und liegt deshalb neben dem Export, nicht im Projekt- oder Plugin-Ordner. Das Anzeigefenster für den Eigentümer zeigt nur Name, Anschrift und E-Mail; Konten, Personen-IDs und Kennzeichen bleiben im Tab. (06.10.2026)
- **Kein randloses Vollbild für eigene Fenster (Verfahrensgebiet #56).** Das Anzeigefenster für den Eigentümer sollte per `windowHandle().setScreen()`, `setGeometry()` und `showFullScreen()` auf dem zweiten Bildschirm erscheinen. Im QGIS-Test (06.10.2026, Windows) landete es trotzdem immer auf dem Hauptbildschirm und ließ sich im Vollbild weder verschieben noch schließen; es verdeckte QGIS, nur ein hartes Beenden von QGIS half. Seitdem öffnet es als normales Fenster mit Rahmen, der Bearbeiter schiebt es selbst auf den richtigen Bildschirm und kann es dort maximieren; `saveGeometry()`/`restoreGeometry()` merkt die Lage für die nächste Sitzung. Allgemein: Fenster, die QGIS verdecken können, brauchen immer einen Weg hinaus (Rahmen, Schließen-Knopf). (06.10.2026)
- **QGIS liest Zahlen-Spalten einer CSV als Zahl.** Beim Laden als Textdatei-Layer erkennt QGIS Feldtypen; eine PLZ `01067` wird dabei zur Ganzzahl `1067` – in Sachsen beginnt fast jede PLZ mit 0. `eigentuemer_suche._plz` stellt die Null wieder her. Kennungen wie `EIG_KONTO` oder `PER_ID` deshalb als Text vergleichen, nie als Zahl. (06.10.2026)
- **VLN-Upload ersetzt den Serverbestand der VKZ vollständig** (`PUT`). Vor dem Upload sicherstellen, dass alle Teillayer geladen sind.
- **API-Key liegt in `QSettings`** (Registry/Konfigurationsdatei), kein sicherer Schlüsselspeicher. Niemals in Logs oder Tests ausgeben.
## Code-Konventionen, die man kennen muss
- **`layer.extent()` steht im KBS des Layers, nicht im Projekt-KBS.** Solange das Projekt in EPSG:25833 steht wie
alle sächsischen Daten, fällt das nicht auf. Mit einem anderen Projekt-KBS landen `canvas.setExtent(layer.extent())`
und `map_item.setExtent(layer.extent())` an der falschen Stelle; die Layer selbst rendert QGIS trotzdem richtig
(Umprojektion beim Zeichnen). Immer `zoom_auf_layer` bzw. `transformiere_rechteck` verwenden (Basis #99).
Layoutkarten ohne `setCrs` folgen dem Projekt-KBS; Gitter (500 Karteneinheiten) und Maßstab setzen Meter voraus.
(05.10.2026)
- **Dock-Inhalt ohne Scroll-Bereich verlängert das QGIS-Fenster.** Qt verlangt für ein Dock mindestens die Höhe seines
Inhalts (beim `QTabWidget`: des höchsten Tabs). Ist sie größer als der Bildschirm, wächst das Hauptfenster nach unten
aus dem Bild, statt dass ein Scrollbalken erscheint. Abhilfe: Inhalt in `QScrollArea` mit `setWidgetResizable(True)`;
in den LNO-Docks erledigt das `BaseDockWidget.setWidget` (Basis #104). Die VLN-Plugins („VLN Karte“ 2.0, „VLN Karten“
0.5) haben keine eigene Lösung, ihr Inhalt ist nur kurz genug. (05.10.2026)
- **Legendenelemente im Layout (QGIS 3.44):** `QgsLayoutItemLegend.adjustBoxSize()` wirkt erst, nachdem das
Element einmal gezeichnet wurde – beim Anlegen per Code ändert es nichts. Platzbedarf vorher über
`QgsLegendRenderer(legende.model(), einstellungen).minimumSize(QgsLayoutUtils.createRenderContextForLayout(layout, None))`
berechnen; für mehrere Spalten zusätzlich `setSplitLayer(True)`, sonst bleibt ein Layer in einer Spalte.
Eine Legende mit `setLegendFilterByMapEnabled(True)` blendet Layer aus, die nicht in der Karte liegen, und ihre
Höhe steht erst nach dem Rendern fest. (02.10.2026, Spike Basis #88)
Auch `QgsLegendRenderer.minimumSize` liefert vor dem ersten Zeichnen die **ungefilterte** Höhe (Beispiel: 344 statt
177 mm). Verlässlich vermessen: Legende einmal mit geringer Auflösung zeichnen
(`QgsLayoutExporter(layout).renderRegionToImage(legende.sceneBoundingRect(), QSize(), 25)`), danach wirken
Filter und `adjustBoxSize`. (02.10.2026, Basis #93)
Mehrspaltige Legenden: Mit `setEqualColumnWidth(True)` bestimmt der längste Text die Breite **aller** Spalten.
Schmaler wird es mit ungleichen Spalten und `setAutoWrapLinesAfter(mm)`; der Legendentitel bricht dabei **nicht**
automatisch um und bestimmt die Mindestbreite – Zeilenumbruch (`\n`) im Titel setzen. (02.10.2026, Basis #96)
`setMinimumSize` an Layoutelementen wird **nicht im Projekt gespeichert**: Nach dem Neuladen schrumpft eine
Legende mit „an Inhalt anpassen“ bei der nächsten Größenberechnung wieder (gemessen 180 → 43,7 mm). Mindestgröße
am Layout vermerken und beim Laden (`readProject`) neu setzen. (02.10.2026, Basis #96)
- **Projektvariablen-Schlüssel ohne `sn_` übergeben.** `set_variable("sn_abdeckungslayer", ...)` erzeugt `sn_sn_abdeckungslayer` (Altlast in Druckmodulen; funktioniert nur, weil Lesen und Schreiben denselben Fehler machen).
- **Zwei Schreibweisen für den Verfahrensgebiet-Layer:** `verfahrensgebiet_layer` (Manager, Fachplugins) und `verfahrensgebietslayer` (`print_logic.py`). Bis zur Bereinigung nicht auf Gleichheit vertrauen.
- **Layer werden über Anzeigenamen gefunden** (`BROR_LAYER_NAME` usw.). Umbenennungen in der UI brechen Abläufe.
-3
View File
@@ -36,7 +36,4 @@ Flurbereinigungs-Hintergrund. Ergänzen, wenn ein Begriff im Issue erklärt werd
| **Atlas** | QGIS-Serienkarte über einen Abdeckungslayer (`sn_abdeckungslayer`) |
| **Kanal** | Release-Kanal: stable, testing, unstable (QGIS-Plugin-Feeds in `Repository`) |
| **Mock-Modus** | Betrieb der Wrapper ohne QGIS/Qt für Tests |
| **basemap.de** | Bundesweite Hintergrundkarte der Vermessungsverwaltungen; in `sn_basis` als Vektorkachel-Layer genutzt (Basemap-Legende, Basemap-Bereich im Druck-Tab) |
| **Thema (Basemap)** | Vom Dienst basemap.de als Style-JSON bereitgestellte Darstellung: Farbe, Grau (Relief vorerst nicht). Nicht verwechseln mit *Stil* und mit QGIS-Kartenthemen |
| **Stil (Basemap)** | Lokale Anpassung der Darstellung durch den Nutzer, als Stilvorlage im QGIS-Profil gespeichert; vermerkt, zu welchem Thema sie gehört |
| **AG QGIS** | Arbeitsgruppe QGIS der sächsischen Flurbereinigungsbehörden; Gitea-Organisation `AG_QGIS` |
+204
View File
@@ -0,0 +1,204 @@
#!/usr/bin/env python3
"""Test-Audit: zeigt und pflegt, wann ein Testfall zuletzt fachlich geprüft wurde.
Der Testkatalog (scripts/testkatalog.py) beantwortet "was prüft die Suite" und "läuft der Test
durch" (Baseline). Er beantwortet NICHT "hat das ein Mensch fachlich bestätigt" – ein Agent kann
einen überzeugenden, aber fachlich falschen Test schreiben, und weder Docstring noch Baseline
zeigen das. Dieses Skript schließt genau diese Lücke: es liest/schreibt
docs/status/testpruefungen.json (Datum + Kurzprüfsumme der Testfunktion je Testfall) und macht so
sichtbar, welche Tests nie geprüft wurden oder sich seit der letzten Prüfung geändert haben.
Reine Standardbibliothek, kein Import von sn_basis/QGIS nötig, da nur mit ast geparst wird
(genau wie testkatalog.py, dessen Funktionen hier wiederverwendet werden).
`status` zeigt je Treffer "<datei>:<zeile>" – in den meisten Terminals/Editoren (z. B. VS Code) anklickbar,
um den Test direkt zum Bearbeiten zu öffnen. `--code` gibt zusätzlich den Testquelltext im Terminal aus, zum
schnellen fachlichen Lesen ohne Editor. Bearbeitet wird die Testdatei ganz normal über die Konsole/den Editor –
dieses Skript schreibt nur `docs/status/testpruefungen.json`, nie Testdateien.
Aufrufe (aus dem Workspace-Root):
python scripts/test_audit.py status # alle Pakete
python scripts/test_audit.py status sn_verfahrensgebiet # nur ein Paket
python scripts/test_audit.py status sn_basis --nur ungeprueft # Filter auf Prüfstatus
python scripts/test_audit.py status --muster grenzpunkt # Filter auf Bezeichner
python scripts/test_audit.py status sn_basis --muster Test_x --code # mit Quelltext (zum Lesen, nicht editierbar)
python scripts/test_audit.py markieren sn_basis TestHallo.test_x # als heute geprüft markieren
python scripts/test_audit.py markieren sn_basis "TestX.*" --trocken # nur anzeigen, nichts schreiben
python scripts/test_audit.py markieren sn_basis TestX.test_x --datum 2026-08-01 # Nacherfassung
Exit-Code: 0 = in Ordnung, 1 = kein Treffer beim Markieren, 2 = falsche Angabe (unbekanntes Paket,
ungültiges Datum).
"""
from __future__ import annotations
import argparse
import datetime
import fnmatch
import json
import sys
from pathlib import Path
import testkatalog as tk
ROOT = tk.ROOT
def lade_pakete(manifest: dict) -> dict[str, dict]:
return {r["paket"]: r for r in manifest["repos"] if r.get("paket")}
def waehle_pakete(gewuenscht: list[str], repos: dict[str, dict]) -> list[str] | None:
"""Löst die gewünschten Paketnamen auf; leer bedeutet alle mit tests=true. None bei unbekanntem Namen."""
testbare = [p for p, r in repos.items() if r.get("tests")]
ziel = gewuenscht or testbare
unbekannt = [p for p in ziel if p not in repos]
if unbekannt:
print(f"Unbekannte Pakete: {unbekannt}. Bekannt: {sorted(repos)}")
return None
return ziel
def sammle(paket: str, repos: dict[str, dict]) -> tk.Paketkatalog | None:
repo = repos[paket]
if not repo.get("tests"):
print(f"[{paket}] laut workspace.toml ohne Tests – übersprungen")
return None
katalog = tk.sammle_paket(paket, repo)
if katalog is None:
print(f"[{paket}] kein Ordner {repo['name']}/tests – übersprungen")
return katalog
NUR_ZU_PRUEFSTATUS = {
"ungeprueft": "nie geprüft",
"veraltet": "veraltet",
"aktuell": "aktuell geprüft",
}
def befehl_status(args: argparse.Namespace) -> int:
manifest = tk.lade_manifest()
repos = lade_pakete(manifest)
pakete = waehle_pakete(args.pakete, repos)
if pakete is None:
return 2
rot_je_paket, _ = tk.lies_baseline(args.baseline_datei)
pruefungen, _ = tk.lies_pruefungen(args.pruefungsdatei)
gesucht_status = NUR_ZU_PRUEFSTATUS.get(args.nur) if args.nur else None
for paket in pakete:
katalog = sammle(paket, repos)
if katalog is None:
continue
tk.setze_status(katalog, rot_je_paket.get(paket, set()))
tk.setze_pruefstatus(katalog, pruefungen)
k = tk.zaehle(katalog.faelle)
print(
f"[{paket}] {k['gesamt']} Testfälle – {k['aktuell_geprueft']} aktuell geprüft, "
f"{k['veraltet_geprueft']} veraltet, {k['nie_geprueft']} nie geprüft"
)
for datei in katalog.dateien:
for fall in datei.faelle:
if args.muster and args.muster.lower() not in fall.bezeichnung.lower():
continue
if gesucht_status and fall.pruefstatus != gesucht_status:
continue
print(
f" {datei.anzeigepfad}:{fall.zeile} {fall.bezeichnung} -> {tk.pruef_text(fall)}"
)
if args.code:
for zeile in fall.quelltext.splitlines():
print(f" {zeile}")
return 0
def schreibe_pruefungen(pfad: Path, pruefungen: dict) -> None:
"""Schreibt die Prüf-Historie deterministisch (sortierte Schlüssel, feste Formatierung)."""
pfad.parent.mkdir(parents=True, exist_ok=True)
pfad.write_text(
json.dumps(pruefungen, indent=2, ensure_ascii=False, sort_keys=True) + "\n",
encoding="utf-8",
newline="\n",
)
def befehl_markieren(args: argparse.Namespace) -> int:
try:
datum = datetime.date.fromisoformat(args.datum).isoformat()
except ValueError:
print(f"Ungültiges Datum: {args.datum} (erwartet JJJJ-MM-TT)")
return 2
manifest = tk.lade_manifest()
repos = lade_pakete(manifest)
if args.paket not in repos:
print(f"Unbekanntes Paket: {args.paket}. Bekannt: {sorted(repos)}")
return 2
katalog = sammle(args.paket, repos)
if katalog is None:
return 2
treffer: list[tuple[tk.Testdatei, tk.Testfall]] = []
gesehen: set[str] = set()
for datei in katalog.dateien:
for fall in datei.faelle:
voll = tk.voller_testpfad(datei, fall)
if voll in gesehen:
continue
if any(fnmatch.fnmatchcase(fall.bezeichnung, muster) for muster in args.bezeichner):
treffer.append((datei, fall))
gesehen.add(voll)
if not treffer:
print(f"Kein Testfall in {args.paket} passt zu {args.bezeichner}.")
return 1
pruefungen, _ = tk.lies_pruefungen(args.pruefungsdatei)
tk.setze_pruefstatus(katalog, pruefungen)
for datei, fall in treffer:
print(f"{datei.anzeigepfad}:{fall.zeile} {fall.bezeichnung} (vorher: {tk.pruef_text(fall)})")
if args.trocken:
print(f"Trockenlauf – nichts geschrieben. {len(treffer)} Treffer.")
return 0
for datei, fall in treffer:
pruefungen[tk.voller_testpfad(datei, fall)] = {"datum": datum, "hash": fall.quellhash}
schreibe_pruefungen(args.pruefungsdatei, pruefungen)
print(f"{len(treffer)} Testfälle als geprüft am {datum} markiert: {args.pruefungsdatei}")
return 0
def main() -> int:
ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
unter = ap.add_subparsers(dest="befehl", required=True)
p_status = unter.add_parser("status", help="Prüfstatus je Testfall anzeigen")
p_status.add_argument("pakete", nargs="*", help="Paketnamen (Standard: alle mit tests=true)")
p_status.add_argument("--muster", help="nur Testfälle, deren Bezeichner diesen Text enthält (Teilstring)")
p_status.add_argument("--nur", choices=sorted(NUR_ZU_PRUEFSTATUS), help="nur diesen Prüfstatus anzeigen")
p_status.add_argument("--code", action="store_true", help="Quelltext jeder passenden Testmethode mit ausgeben")
p_status.add_argument("--baseline-datei", type=Path, default=tk.BASELINE_DEFAULT)
p_status.add_argument("--pruefungsdatei", type=Path, default=tk.PRUEFUNGEN_DEFAULT)
p_status.set_defaults(func=befehl_status)
p_markieren = unter.add_parser("markieren", help="Testfälle als heute geprüft markieren")
p_markieren.add_argument("paket", help="Paketname, z. B. sn_basis")
p_markieren.add_argument(
"bezeichner", nargs="+", help="Klasse.methode, exakt oder als fnmatch-Muster (z. B. 'TestX.*')"
)
p_markieren.add_argument("--datum", default=datetime.date.today().isoformat(), help="Standard: heute")
p_markieren.add_argument("--trocken", action="store_true", help="nur anzeigen, nichts schreiben")
p_markieren.add_argument("--pruefungsdatei", type=Path, default=tk.PRUEFUNGEN_DEFAULT)
p_markieren.set_defaults(func=befehl_markieren)
args = ap.parse_args()
return args.func(args)
if __name__ == "__main__":
sys.exit(main())
+430 -20
View File
@@ -16,6 +16,11 @@ dieses Skript mit jedem Python >= 3.11 ohne jede Abhängigkeit, auch ohne QGIS.
Der Status je Testfall stammt aus docs/status/testbaseline.json; dort stehen
unter <paket>.rot Einträge der Form "<methode> (<modulpfad>.<Klasse>.<methode>)".
Eine dritte Datenquelle ist docs/status/testpruefungen.json: sie hält je Testfall fest, wann er zuletzt von
einem Menschen fachlich geprüft wurde (Datum plus Kurzprüfsumme der Testfunktion, damit eine Änderung am
Testcode die Prüfung automatisch als veraltet kennzeichnet). Diese Datei wird hier nur gelesen; geschrieben
wird sie von scripts/test_audit.py.
Determinismus: Die erzeugte Datei wird versioniert, darf also bei unverändertem
Eingang keine Diffs erzeugen. Deshalb steht im Kopf weder Uhrzeit noch
Erzeugungsdatum – auch ein reines Tagesdatum würde die Datei bei jedem Lauf an
@@ -60,6 +65,7 @@ from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
MANIFEST = ROOT / "workspace.toml"
BASELINE_DEFAULT = ROOT / "docs" / "status" / "testbaseline.json"
PRUEFUNGEN_DEFAULT = ROOT / "docs" / "status" / "testpruefungen.json"
AUSGABE_DEFAULT = ROOT / "docs" / "tests" / "testkatalog.md"
HTML_AUSGABE_DEFAULT = ROOT / "docs" / "tests" / "testkatalog.html"
@@ -87,6 +93,11 @@ class Testfall:
grund: str = ""
erwarteter_fehlschlag: bool = False
status: str = "grün"
quellhash: str = ""
pruefstatus: str = "nie geprüft"
pruefdatum: str = ""
zeile: int = 0
quelltext: str = ""
@property
def bezeichnung(self) -> str:
@@ -117,6 +128,17 @@ class Testdatei:
return [f for g in self.gruppen for f in g.faelle]
@dataclass
class Quellfunktion:
"""Eine Top-Level-Funktion oder Klassenmethode im Quellcode (kein Test)."""
datei: str
name: str
zeile: int
referenziert: bool = False
absichtlich_grund: str = ""
@dataclass
class Paketkatalog:
"""Alle Testdateien eines Pakets samt Kennzahlen."""
@@ -125,6 +147,7 @@ class Paketkatalog:
ordner: str
rolle: str
dateien: list[Testdatei] = field(default_factory=list)
quellfunktionen: list[Quellfunktion] = field(default_factory=list)
@property
def faelle(self) -> list[Testfall]:
@@ -188,6 +211,22 @@ def lies_skip(dekoratoren: list[ast.expr]) -> tuple[bool, str, bool]:
return uebersprungen, grund, erwartet
def _funktionsquelle(zeilen: list[str], knoten: ast.FunctionDef | ast.AsyncFunctionDef) -> str:
"""Quelltext einer Testmethode inkl. eigener Dekoratoren, Trailing Whitespace entfernt.
Trailing Whitespace wird bewusst ignoriert, damit reine Whitespace-Nacharbeit keine Prüfung
veraltet macht. Einrückung und sonstiger Inhalt bleiben signifikant.
"""
start = min([knoten.lineno] + [d.lineno for d in knoten.decorator_list])
ende = knoten.end_lineno or knoten.lineno
return "\n".join(zeile.rstrip() for zeile in zeilen[start - 1:ende])
def _funktionshash(zeilen: list[str], knoten: ast.FunctionDef | ast.AsyncFunctionDef) -> str:
"""SHA-256-Kurzprüfsumme (12 Zeichen) einer Testmethode, für den Abgleich in testpruefungen.json."""
return hashlib.sha256(_funktionsquelle(zeilen, knoten).encode("utf-8")).hexdigest()[:12]
def ist_testcase(klasse: ast.ClassDef) -> bool:
"""True für Klassen, die als unittest-TestCase gelten.
@@ -209,6 +248,7 @@ def ist_testcase(klasse: ast.ClassDef) -> bool:
def lies_testdatei(pfad: Path, paket: str) -> Testdatei:
"""Parst eine Testdatei per ast (ohne sie zu importieren)."""
quelle = pfad.read_text(encoding="utf-8")
zeilen = quelle.splitlines()
baum = ast.parse(quelle, filename=str(pfad))
datei = Testdatei(
pfad=pfad,
@@ -235,6 +275,9 @@ def lies_testdatei(pfad: Path, paket: str) -> Testdatei:
uebersprungen=skip or klassen_skip,
grund=grund or (klassen_grund if klassen_skip else ""),
erwarteter_fehlschlag=erwartet or klassen_erwartet,
quellhash=_funktionshash(zeilen, glied),
zeile=glied.lineno,
quelltext=_funktionsquelle(zeilen, glied),
)
)
if gruppe.faelle:
@@ -253,6 +296,122 @@ def sammle_paket(paket: str, repo: dict) -> Paketkatalog | None:
return katalog
AUSSCHLUSS_ORDNER = {"tests", "__pycache__"}
AUSSCHLUSS_DATEIEN = {"main.py", "__init__.py"}
WORTZEICHEN = re.compile(r"[A-Za-zÄÖÜäöüß_][A-Za-zÄÖÜäöüß0-9_]*")
def _ist_dunder(name: str) -> bool:
return name.startswith("__") and name.endswith("__")
ABSICHTLICH_MARKER = ("von Test abgesehen", "Test ausgesetzt")
def absichtlicher_verzicht(docstring: str | None) -> str:
"""Docstring-Zeile, die einen bewusst dokumentierten Testverzicht enthält, sonst "".
Erkennt die beiden im Projekt verwendeten Vermerke: "von Test abgesehen, weil …" (bewusst
vernachlässigbar) und "Test ausgesetzt, zunächst Refactor" (zurückgestellt bis zu einer geplanten
Überarbeitung). Ein Namensabgleich wie bei `sammle_referenzierte_namen` – reicht der Vermerk nicht
wörtlich, wird die Funktion weiterhin als offen (ungeklärt) geführt.
"""
if not docstring:
return ""
for zeile in docstring.splitlines():
text = " ".join(zeile.split())
if text and any(marker in text for marker in ABSICHTLICH_MARKER):
return text
return ""
def sammle_quellcode(ordner: Path) -> list[Quellfunktion]:
"""Listet Top-Level-Funktionen und Methoden im Quellcode eines Pakets (ohne tests/).
`main.py`/`__init__.py` bleiben außen vor: reine QGIS-Einstiegspunkte (`classFactory`,
`initGui`, `unload`) lassen sich ohne laufendes QGIS nicht sinnvoll unit-testen. Dunder-
Methoden (`__init__`, `__str__`, …) bleiben ebenfalls außen vor, sonst überwiegt Rauschen
aus Standardmethoden die eigentlich interessanten Lücken.
"""
ergebnisse: list[Quellfunktion] = []
for pfad in sorted(ordner.rglob("*.py")):
rel = pfad.relative_to(ordner)
if AUSSCHLUSS_ORDNER & set(rel.parts[:-1]):
continue
if rel.name in AUSSCHLUSS_DATEIEN:
continue
anzeigepfad = rel.as_posix()
baum = ast.parse(pfad.read_text(encoding="utf-8"), filename=str(pfad))
for knoten in baum.body:
if isinstance(knoten, (ast.FunctionDef, ast.AsyncFunctionDef)):
ergebnisse.append(
Quellfunktion(
datei=anzeigepfad,
name=knoten.name,
zeile=knoten.lineno,
absichtlich_grund=absichtlicher_verzicht(ast.get_docstring(knoten)),
)
)
elif isinstance(knoten, ast.ClassDef):
for glied in knoten.body:
if isinstance(glied, (ast.FunctionDef, ast.AsyncFunctionDef)) and not _ist_dunder(glied.name):
ergebnisse.append(
Quellfunktion(
datei=anzeigepfad,
name=f"{knoten.name}.{glied.name}",
zeile=glied.lineno,
absichtlich_grund=absichtlicher_verzicht(ast.get_docstring(glied)),
)
)
return ergebnisse
def sammle_referenzierte_namen(testdateien: list[Path]) -> set[str]:
"""Alle Bezeichner, die irgendwo in den Testdateien eines Pakets vorkommen.
Erfasst werden Namen (Aufrufe, Importe), Attributzugriffe (`self.x.methode()`) und
Wortbestandteile in Zeichenketten (deckt `mock.patch("modul.Klasse.methode")` ab). Bewusst
großzügig: ein Treffer gilt schon als Bezug, auch wenn er nur zufällig denselben Namen trifft –
lieber eine echte Lücke übersehen als eine vortäuschen, die keine ist.
"""
namen: set[str] = set()
for pfad in testdateien:
baum = ast.parse(pfad.read_text(encoding="utf-8"), filename=str(pfad))
for knoten in ast.walk(baum):
if isinstance(knoten, ast.Name):
namen.add(knoten.id)
elif isinstance(knoten, ast.Attribute):
namen.add(knoten.attr)
elif isinstance(knoten, ast.Constant) and isinstance(knoten.value, str):
namen.update(WORTZEICHEN.findall(knoten.value))
return namen
def setze_referenzstatus(katalog: Paketkatalog) -> None:
"""Füllt katalog.quellfunktionen und markiert, welche in keiner Testdatei referenziert werden."""
katalog.quellfunktionen = sammle_quellcode(ROOT / katalog.ordner)
referenziert = sammle_referenzierte_namen([d.pfad for d in katalog.dateien])
for funktion in katalog.quellfunktionen:
bezeichner = funktion.name.rsplit(".", 1)[-1]
funktion.referenziert = bezeichner in referenziert
def zaehle_quellfunktionen(funktionen: list[Quellfunktion]) -> dict[str, int]:
ohne_bezug = [f for f in funktionen if not f.referenziert]
return {
"gesamt": len(funktionen),
"referenziert": sum(1 for f in funktionen if f.referenziert),
"ohne_bezug": len(ohne_bezug),
"absichtlich": sum(1 for f in ohne_bezug if f.absichtlich_grund),
"ungeklaert": sum(1 for f in ohne_bezug if not f.absichtlich_grund),
}
def voller_testpfad(datei: Testdatei, fall: Testfall) -> str:
"""Voller Schlüssel eines Testfalls – identisch zum Format in testbaseline.json/testpruefungen.json."""
return f"{datei.modulpfad}.{fall.bezeichnung}"
def lies_baseline(pfad: Path) -> tuple[dict[str, set[str]], str]:
"""Rote Tests je Paket als Menge '<modulpfad>.<Klasse>.<methode>' plus Kurzprüfsumme."""
if not pfad.exists():
@@ -274,7 +433,7 @@ def lies_baseline(pfad: Path) -> tuple[dict[str, set[str]], str]:
def setze_status(katalog: Paketkatalog, rot: set[str]) -> None:
for datei in katalog.dateien:
for fall in datei.faelle:
voll = f"{datei.modulpfad}.{fall.bezeichnung}"
voll = voller_testpfad(datei, fall)
if fall.uebersprungen:
fall.status = "übersprungen"
elif fall.erwarteter_fehlschlag:
@@ -285,6 +444,27 @@ def setze_status(katalog: Paketkatalog, rot: set[str]) -> None:
fall.status = "grün"
def lies_pruefungen(pfad: Path) -> tuple[dict[str, dict], str]:
"""Prüf-Historie je Testfall plus Kurzprüfsumme der Datei; ({}, "") wenn sie fehlt."""
if not pfad.exists():
return {}, ""
rohdaten = pfad.read_bytes()
kurz = hashlib.sha256(rohdaten).hexdigest()[:12]
return json.loads(rohdaten.decode("utf-8")), kurz
def setze_pruefstatus(katalog: Paketkatalog, pruefungen: dict[str, dict]) -> None:
for datei in katalog.dateien:
for fall in datei.faelle:
eintrag = pruefungen.get(voller_testpfad(datei, fall))
if eintrag is None:
fall.pruefstatus, fall.pruefdatum = "nie geprüft", ""
elif eintrag.get("hash") == fall.quellhash:
fall.pruefstatus, fall.pruefdatum = "aktuell geprüft", eintrag.get("datum", "")
else:
fall.pruefstatus, fall.pruefdatum = "veraltet", eintrag.get("datum", "")
def zaehle(faelle: list[Testfall]) -> dict[str, int]:
return {
"gesamt": len(faelle),
@@ -293,6 +473,9 @@ def zaehle(faelle: list[Testfall]) -> dict[str, int]:
"uebersprungen": sum(1 for f in faelle if f.status in ("übersprungen", "erwarteter Fehlschlag")),
"erwartet": sum(1 for f in faelle if f.status == "erwarteter Fehlschlag"),
"mit_docstring": sum(1 for f in faelle if f.beschreibung),
"nie_geprueft": sum(1 for f in faelle if f.pruefstatus == "nie geprüft"),
"aktuell_geprueft": sum(1 for f in faelle if f.pruefstatus == "aktuell geprüft"),
"veraltet_geprueft": sum(1 for f in faelle if f.pruefstatus == "veraltet"),
}
@@ -313,10 +496,29 @@ def status_text(fall: Testfall) -> str:
return fall.status
def erzeuge_markdown(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline_kurz: str) -> str:
def pruef_text(fall: Testfall) -> str:
"""Anzeigetext für den Prüfstatus (Prüfstand-Spalte 'geprüft')."""
if fall.pruefstatus == "aktuell geprüft":
return f"geprüft am {fall.pruefdatum}"
if fall.pruefstatus == "veraltet":
return f"veraltet seit Änderung – zuletzt geprüft am {fall.pruefdatum}"
return "nie geprüft"
def erzeuge_markdown(
kataloge: list[Paketkatalog],
baseline_pfad: Path,
baseline_kurz: str,
pruefungen_pfad: Path,
pruefungen_kurz: str,
) -> str:
alle = [f for k in kataloge for f in k.faelle]
summe = zaehle(alle)
summe_qf = zaehle_quellfunktionen([f for k in kataloge for f in k.quellfunktionen])
baseline_anzeige = baseline_pfad.relative_to(ROOT).as_posix() if baseline_pfad.is_relative_to(ROOT) else str(baseline_pfad)
pruefungen_anzeige = (
pruefungen_pfad.relative_to(ROOT).as_posix() if pruefungen_pfad.is_relative_to(ROOT) else str(pruefungen_pfad)
)
z: list[str] = []
z.append("# Testkatalog der sn_*-Plugins")
@@ -332,6 +534,12 @@ def erzeuge_markdown(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline
z.append(f"Stand der Baseline: `{baseline_anzeige}` (SHA-256 `{baseline_kurz}`)")
else:
z.append(f"Stand der Baseline: `{baseline_anzeige}` **nicht gefunden** – alle Testfälle gelten als grün.")
if pruefungen_kurz:
z.append(f"Stand des Prüf-Audits: `{pruefungen_anzeige}` (SHA-256 `{pruefungen_kurz}`)")
else:
z.append(
f"Stand des Prüf-Audits: `{pruefungen_anzeige}` **nicht gefunden** – alle Testfälle gelten als nie geprüft."
)
z.append("")
z.append(
f"Gesamt: {len(kataloge)} Pakete, {sum(len(k.dateien) for k in kataloge)} Testdateien, "
@@ -339,22 +547,37 @@ def erzeuge_markdown(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline
f"{summe['uebersprungen']} übersprungen."
)
z.append(f"Mit Beschreibung (Docstring): {anteil(summe['mit_docstring'], summe['gesamt'])}.")
z.append(
f"Fachlich geprüft: {anteil(summe['aktuell_geprueft'], summe['gesamt'])} aktuell, "
f"{summe['veraltet_geprueft']} veraltet seit Codeänderung, {summe['nie_geprueft']} nie geprüft."
)
z.append(
f"Strukturelle Lücken (heuristisch, Namensabgleich): {anteil(summe_qf['ohne_bezug'], summe_qf['gesamt'])} "
"Funktionen/Methoden ohne erkennbaren Testbezug – Abschnitt „Ungetestete Funktionen“."
)
z.append("")
z.append("## Zusammenfassung")
z.append("")
z.append("| Paket | Testdateien | Testfälle | grün | rot (Baseline) | übersprungen | mit Beschreibung |")
z.append("| --- | ---: | ---: | ---: | ---: | ---: | ---: |")
z.append(
"| Paket | Testdateien | Testfälle | grün | rot (Baseline) | übersprungen | mit Beschreibung | "
"fachlich geprüft | ohne Testbezug |"
)
z.append("| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |")
for katalog in kataloge:
k = zaehle(katalog.faelle)
qf = zaehle_quellfunktionen(katalog.quellfunktionen)
z.append(
f"| `{katalog.paket}` | {len(katalog.dateien)} | {k['gesamt']} | {k['gruen']} | "
f"{k['rot']} | {k['uebersprungen']} | {anteil(k['mit_docstring'], k['gesamt'])} |"
f"{k['rot']} | {k['uebersprungen']} | {anteil(k['mit_docstring'], k['gesamt'])} | "
f"{anteil(k['aktuell_geprueft'], k['gesamt'])} | {anteil(qf['ohne_bezug'], qf['gesamt'])} |"
)
z.append(
f"| **Summe** | **{sum(len(k.dateien) for k in kataloge)}** | **{summe['gesamt']}** | "
f"**{summe['gruen']}** | **{summe['rot']}** | **{summe['uebersprungen']}** | "
f"**{anteil(summe['mit_docstring'], summe['gesamt'])}** |"
f"**{anteil(summe['mit_docstring'], summe['gesamt'])}** | "
f"**{anteil(summe['aktuell_geprueft'], summe['gesamt'])}** | "
f"**{anteil(summe_qf['ohne_bezug'], summe_qf['gesamt'])}** |"
)
z.append("")
if summe["erwartet"]:
@@ -368,6 +591,19 @@ def erzeuge_markdown(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline
z.append(f"- **rot (Baseline)** – der Testfall schlägt bereits fehl und ist in `{baseline_anzeige}` vermerkt; er darf nicht ignoriert, aber auch nicht als neuer Fehler gewertet werden.")
z.append("- **übersprungen** – per `@unittest.skip`/`skipIf`/`skipUnless` abgeschaltet; der Grund steht dabei.")
z.append("- Ein Testfall heißt `Testgruppe.test_name`; die Testgruppe fasst zusammengehörige Testfälle einer Datei zusammen.")
z.append(
"- **geprüft** – Prüf-Audit (`scripts/test_audit.py`): **nie geprüft** kein Eintrag in "
f"`{pruefungen_anzeige}`; **geprüft am …** ein Mensch hat den Testfall bestätigt und der Testcode hat sich "
"seither nicht geändert; **veraltet seit Änderung …** der Testcode wurde nach der letzten Prüfung geändert."
)
z.append(
"- **ohne Testbezug** – Funktionen/Methoden im Quellcode, deren Name in keiner Testdatei des Pakets "
"vorkommt (weder als Aufruf noch als `mock.patch(\"…\")`-Ziel). Ein Namensabgleich, kein Ausführungsnachweis "
"– siehe Abschnitt „Ungetestete Funktionen“ für die Grenzen dieser Heuristik. Das ist bewusst **keine** "
"Zeilen-Coverage in Prozent (siehe ADR 0009, „Verworfene Alternativen“), sondern eine Lückenliste wie bei "
"fehlenden Beschreibungen. Davon **beabsichtigt** – der Docstring dokumentiert den Testverzicht; "
"**ungeklärt** – weder Test noch Vermerk, die eigentliche Arbeitsliste."
)
z.append("")
for katalog in kataloge:
@@ -399,10 +635,12 @@ def erzeuge_markdown(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline
for gruppe in datei.gruppen:
z.append(f"- `{gruppe.name}` ({len(gruppe.faelle)} Testfälle): {zelle(gruppe.beschreibung)}")
z.append("")
z.append("| Testfall | prüft | Status |")
z.append("| --- | --- | --- |")
z.append("| Testfall | prüft | Status | geprüft |")
z.append("| --- | --- | --- | --- |")
for fall in datei.faelle:
z.append(f"| `{fall.bezeichnung}` | {zelle(fall.beschreibung)} | {status_text(fall)} |")
z.append(
f"| `{fall.bezeichnung}` | {zelle(fall.beschreibung)} | {status_text(fall)} | {pruef_text(fall)} |"
)
z.append("")
z.append("## Lücken")
@@ -430,6 +668,48 @@ def erzeuge_markdown(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline
for fall in luecken:
z.append(f"- `{fall.bezeichnung}`")
z.append("")
z.append("## Ungetestete Funktionen (strukturelle Lücke)")
z.append("")
z.append(
"Heuristik, kein Beweis: Diese Funktionen und Methoden kommen unter ihrem Namen in keiner Testdatei"
" des Pakets vor. Das schließt nicht aus, dass sie indirekt über eine andere, getestete Funktion"
" mitlaufen – umgekehrt gilt: Taucht der Name irgendwo in einer Testdatei auf, gilt die Funktion schon"
" als referenziert, auch bei zufälliger Namensgleichheit mit etwas anderem. `main.py`/`__init__.py`"
" (QGIS-Einstiegspunkte wie `classFactory`, `initGui`, `unload`) und Dunder-Methoden sind ausgenommen."
" Diese Liste ersetzt keine fachliche Prüfung, ob ein Test sinnvoll wäre – dafür braucht es einen"
" Menschen, der die Funktion kennt."
)
z.append(
"„beabsichtigt“ liest den Docstring der Funktion: Enthält er einen Vermerk wie „von Test abgesehen,"
" weil …“ oder „Test ausgesetzt, zunächst Refactor“, gilt der fehlende Test als bewusste Entscheidung."
" Alles andere ist „ungeklärt“ – die eigentliche Arbeitsliste."
)
z.append("")
for katalog in kataloge:
qf = zaehle_quellfunktionen(katalog.quellfunktionen)
z.append(
f"### `{katalog.paket}` – {anteil(qf['ohne_bezug'], qf['gesamt'])} ohne Testbezug "
f"({qf['ungeklaert']} ungeklärt, {qf['absichtlich']} beabsichtigt)"
)
z.append("")
luecken_qf = [f for f in katalog.quellfunktionen if not f.referenziert]
if not luecken_qf:
z.append("Keine Lücken.")
z.append("")
continue
je_datei: dict[str, list[Quellfunktion]] = {}
for funktion in luecken_qf:
je_datei.setdefault(funktion.datei, []).append(funktion)
for datei, funktionen in je_datei.items():
z.append(f"#### `{datei}` ({len(funktionen)})")
z.append("")
for funktion in funktionen:
if funktion.absichtlich_grund:
z.append(f"- `{funktion.name}` (Zeile {funktion.zeile}) — **beabsichtigt:** {zelle(funktion.absichtlich_grund)}")
else:
z.append(f"- `{funktion.name}` (Zeile {funktion.zeile}) — ungeklärt")
z.append("")
return "\n".join(z) + "\n"
@@ -440,6 +720,12 @@ STATUS_KLASSE = {
"erwarteter Fehlschlag": "skip",
}
PRUEF_KLASSE = {
"aktuell geprüft": "ok",
"veraltet": "warn",
"nie geprüft": "skip",
}
def _slug(text: str) -> str:
return re.sub(r"[^a-zA-Z0-9]+", "-", text).strip("-").lower()
@@ -480,6 +766,10 @@ def _html_karte_fuer_datei(datei: Testdatei) -> str:
zaehler[STATUS_KLASSE.get(fall.status, "ok")] += 1
mit_doc = sum(1 for f in faelle if f.beschreibung)
doc_pct = round(100 * mit_doc / gesamt) if gesamt else 0
aktuell_geprueft = sum(1 for f in faelle if f.pruefstatus == "aktuell geprüft")
audit_pct = round(100 * aktuell_geprueft / gesamt) if gesamt else 0
hat_ungeprueft = any(f.pruefstatus == "nie geprüft" for f in faelle)
hat_veraltet = any(f.pruefstatus == "veraltet" for f in faelle)
if not datei.gruppen:
koerper = (
@@ -501,6 +791,7 @@ def _html_karte_fuer_datei(datei: Testdatei) -> str:
kurz = {"grün": "grün", "rot (Baseline)": "rot", "übersprungen": "übersp.", "erwarteter Fehlschlag": "übersp."}
for fall in faelle:
klasse = STATUS_KLASSE.get(fall.status, "ok")
pruef_klasse = PRUEF_KLASSE.get(fall.pruefstatus, "skip")
pruft = (
f'<span class="nodoc">— (Docstring fehlt)</span>'
if not fall.beschreibung
@@ -511,10 +802,12 @@ def _html_karte_fuer_datei(datei: Testdatei) -> str:
f'<tr><td class="mono">{html.escape(fall.klasse)}<br>'
f'<span class="testname">{html.escape(fall.name)}</span></td>'
f"<td>{pruft}</td>"
f'<td><span class="pill pill-{klasse}"{titel}>{kurz.get(fall.status, fall.status)}</span></td></tr>'
f'<td><span class="pill pill-{klasse}"{titel}>{kurz.get(fall.status, fall.status)}</span></td>'
f'<td><span class="pill pill-pr-{pruef_klasse}">{html.escape(pruef_text(fall))}</span></td></tr>'
)
tabelle = (
'<table class="test-table"><thead><tr><th>Testfall</th><th>prüft</th><th>Status</th></tr></thead>'
'<table class="test-table"><thead><tr><th>Testfall</th><th>prüft</th><th>Status</th>'
"<th>geprüft</th></tr></thead>"
f"<tbody>{''.join(zeilen)}</tbody></table>"
)
diagramm = (
@@ -536,38 +829,111 @@ def _html_karte_fuer_datei(datei: Testdatei) -> str:
'<span class="card-meta">'
f'<span class="count-total">{gesamt} Testfälle</span>{pills}'
f'<span class="docbadge" title="Anteil mit Docstring">{doc_pct}% beschrieben</span>'
f'<span class="auditbadge" title="Anteil fachlich aktuell geprüft">{audit_pct}% geprüft</span>'
'<span class="chev" aria-hidden="true">▾</span></span></button>'
)
return (
f'<article class="filecard" data-search="{suchtext}" '
f'data-hasred="{1 if zaehler["warn"] else 0}" data-hasskip="{1 if zaehler["skip"] else 0}" '
f'data-nodoc="{1 if doc_pct < 50 else 0}">'
f'data-nodoc="{1 if doc_pct < 50 else 0}" '
f'data-ungeprueft="{1 if hat_ungeprueft else 0}" data-veraltet="{1 if hat_veraltet else 0}">'
f"{header}"
f'<div class="card-body" id="body-{fid}">{koerper}</div>'
"</article>"
)
def _html_luecken_fuer_paket(katalog: Paketkatalog) -> str:
"""Ausklappbare Karte je Paket (wie eine Testdatei-Karte): Quellfunktionen ohne erkennbaren Testbezug."""
qf = zaehle_quellfunktionen(katalog.quellfunktionen)
if not qf["gesamt"]:
return ""
fid = _slug(f"{katalog.paket}-luecken")
luecken = sorted([f for f in katalog.quellfunktionen if not f.referenziert], key=lambda f: (f.datei, f.zeile))
if not luecken:
tabelle = '<p class="empty-note">Keine Lücken.</p>'
else:
zeilen = []
for f in luecken:
if f.absichtlich_grund:
status = f'<span class="pill pill-skip" title="{html.escape(f.absichtlich_grund)}">beabsichtigt</span>'
else:
status = '<span class="pill pill-warn">ungeklärt</span>'
zeilen.append(
f'<tr><td class="mono">{html.escape(f.datei)}</td><td class="mono">{html.escape(f.name)}</td>'
f"<td>{f.zeile}</td><td>{status}</td></tr>"
)
tabelle = (
'<table class="test-table"><thead><tr><th>Datei</th><th>Funktion/Methode</th><th>Zeile</th>'
"<th>Status</th></tr></thead>"
f"<tbody>{''.join(zeilen)}</tbody></table>"
)
beschreibung = (
'<p class="filedesc">Heuristik: Name kommt in keiner Testdatei des Pakets vor (Details siehe '
'<span class="mono">docs/tests/testkatalog.md</span>). <b>beabsichtigt</b> liest den Docstring der '
"Funktion – ein Vermerk wie „von Test abgesehen, weil …“ oder „Test ausgesetzt, zunächst Refactor“ "
"gilt als bewusste Entscheidung. <b>ungeklärt</b> hat weder Test noch Vermerk.</p>"
)
suchtext = html.escape(f"ungetestete funktionen {katalog.paket}".lower())
header = (
f'<button class="card-toggle" data-target="{fid}" aria-expanded="false">'
'<span class="card-path mono">Ungetestete Funktionen</span>'
'<span class="card-meta">'
f'<span class="count-total">{qf["gesamt"]} Funktionen</span>'
f'<span class="cpill cpill-warn">{qf["ungeklaert"]} ungeklärt</span>'
f'<span class="cpill cpill-skip">{qf["absichtlich"]} beabsichtigt</span>'
'<span class="chev" aria-hidden="true">▾</span></span></button>'
)
return (
f'<article class="filecard gapcard" data-search="{suchtext}">'
f"{header}"
f'<div class="card-body" id="body-{fid}">{beschreibung}{tabelle}</div>'
"</article>"
)
def _html_abschnitt_fuer_paket(katalog: Paketkatalog) -> str:
k = zaehle(katalog.faelle)
qf = zaehle_quellfunktionen(katalog.quellfunktionen)
rolle = ROLLENTEXT.get(katalog.rolle, katalog.rolle or "Plugin")
karten = "".join(_html_karte_fuer_datei(d) for d in katalog.dateien) or "<p>Keine Testdateien gefunden.</p>"
gesamt = k["gesamt"] or 1
ok_pct = round(100 * k["gruen"] / gesamt)
warn_pct = round(100 * k["rot"] / gesamt)
skip_pct = max(0, 100 - ok_pct - warn_pct)
doc_pct = round(100 * k["mit_docstring"] / k["gesamt"]) if k["gesamt"] else 0
audit_pct = round(100 * k["aktuell_geprueft"] / k["gesamt"]) if k["gesamt"] else 0
kacheln = [
("", len(katalog.dateien), "Testdateien"),
("", k["gesamt"], "Testfälle"),
("ok", k["gruen"], "grün"),
("warn", k["rot"], "rot (Baseline)"),
("skip", k["uebersprungen"], "übersprungen"),
("", f"{doc_pct}%", "mit Docstring"),
("", f"{audit_pct}%", "geprüft"),
("warn" if qf["ungeklaert"] else "", qf["ohne_bezug"], "ohne Testbezug"),
]
tiles = "".join(
f'<div class="stat stat-sm{" " + klasse if klasse else ""}"><span class="n">{wert}</span>'
f'<span class="l">{label}</span></div>'
for klasse, wert, label in kacheln
)
return f"""
<section class="pkg-section" id="pkg-{html.escape(katalog.paket)}">
<div class="pkg-head">
<div>
<h2>{html.escape(katalog.paket)}</h2>
<p class="pkg-sub">{html.escape(rolle)} · Ordner <span class="mono">{html.escape(katalog.ordner)}</span> · {len(katalog.dateien)} Testdateien · {k['gesamt']} Testfälle</p>
<p class="pkg-sub">{html.escape(rolle)} · Ordner <span class="mono">{html.escape(katalog.ordner)}</span></p>
</div>
<div class="pkg-bar" role="img" aria-label="{k['gruen']} grün, {k['rot']} rot, {k['uebersprungen']} übersprungen">
<span class="seg seg-ok" style="width:{ok_pct}%"></span><span class="seg seg-warn" style="width:{warn_pct}%"></span><span class="seg seg-skip" style="width:{skip_pct}%"></span>
</div>
</div>
<div class="pkg-summary">{tiles}</div>
<div class="card-grid">{karten}</div>
{_html_luecken_fuer_paket(katalog)}
</section>
"""
@@ -649,6 +1015,10 @@ _HTML_KOPF = """<title>Prüfstand</title>
.pkg-bar{ width:220px; height:9px; border-radius:6px; overflow:hidden; display:flex; background:var(--surface-2); border:1px solid var(--line); }
.pkg-bar .seg{ height:100%; display:block; }
.seg-ok{ background:var(--ok); } .seg-warn{ background:var(--warn); } .seg-skip{ background:var(--skip); }
.pkg-summary{ max-width:100%; margin:0 0 16px; display:grid; gap:8px; grid-template-columns:repeat(auto-fit,minmax(108px,1fr)); }
.stat-sm{ padding:8px 10px; }
.stat-sm .n{ font-size:17px; }
.stat-sm .l{ font-size:10px; }
.card-grid{ display:grid; gap:12px; }
.filecard{ background:var(--surface); border:1px solid var(--line); border-radius:12px; box-shadow:var(--shadow); overflow:hidden; }
.card-toggle{ width:100%; display:flex; flex-wrap:wrap; align-items:center; gap:8px 14px; justify-content:space-between;
@@ -661,6 +1031,7 @@ _HTML_KOPF = """<title>Prüfstand</title>
.cpill{ font-family:"IBM Plex Mono",monospace; font-variant-numeric:tabular-nums; font-size:11.5px; padding:2px 7px; border-radius:999px; font-weight:600; }
.cpill-ok{ background:var(--ok-bg); color:var(--ok); } .cpill-warn{ background:var(--warn-bg); color:var(--warn); } .cpill-skip{ background:var(--skip-bg); color:var(--skip); }
.docbadge{ color:var(--muted); border:1px solid var(--line-strong); border-radius:999px; padding:2px 8px; }
.auditbadge{ color:var(--muted); border:1px solid var(--line-strong); border-radius:999px; padding:2px 8px; }
.chev{ color:var(--muted); transition:transform .15s ease; }
.filecard.open .chev{ transform:rotate(180deg); }
.card-body{ max-height:0; overflow:hidden; transition:max-height .22s ease; border-top:0 solid var(--line); }
@@ -684,6 +1055,7 @@ _HTML_KOPF = """<title>Prüfstand</title>
.nodoc{ color:var(--muted); font-style:italic; }
.pill{ font-size:11.5px; padding:2px 8px; border-radius:999px; font-weight:600; white-space:nowrap; }
.pill-ok{ background:var(--ok-bg); color:var(--ok); } .pill-warn{ background:var(--warn-bg); color:var(--warn); } .pill-skip{ background:var(--skip-bg); color:var(--skip); }
.pill-pr-ok{ background:var(--ok-bg); color:var(--ok); } .pill-pr-warn{ background:var(--warn-bg); color:var(--warn); } .pill-pr-skip{ background:var(--skip-bg); color:var(--skip); }
footer{ max-width:1180px; margin:40px auto 30px; color:var(--muted); font-size:12px; border-top:1px solid var(--line); padding-top:14px; }
[hidden]{ display:none !important; }
@media (max-width:640px){ .pkg-bar{ width:130px; } .controls{ position:static; } }
@@ -723,13 +1095,13 @@ _HTML_SKRIPT = """
function applyFilters(){
var active = document.querySelector('.chip[aria-pressed="true"]').dataset.filter;
var q = document.getElementById('searchInput').value.trim().toLowerCase();
document.querySelectorAll('.filecard').forEach(function(card){
document.querySelectorAll('.filecard:not(.gapcard)').forEach(function(card){
var passFilter = active === 'all' || card.dataset[active] === '1';
var passSearch = !q || card.dataset.search.indexOf(q) !== -1;
card.hidden = !(passFilter && passSearch);
});
document.querySelectorAll('.pkg-section').forEach(function(sec){
sec.hidden = !sec.querySelector('.filecard:not([hidden])');
sec.hidden = !sec.querySelector('.filecard:not(.gapcard):not([hidden])');
});
}
document.querySelectorAll('.chip').forEach(function(chip){
@@ -747,7 +1119,13 @@ _HTML_SKRIPT = """
"""
def erzeuge_html(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline_kurz: str) -> str:
def erzeuge_html(
kataloge: list[Paketkatalog],
baseline_pfad: Path,
baseline_kurz: str,
pruefungen_pfad: Path,
pruefungen_kurz: str,
) -> str:
"""Erzeugt das HTML-Dashboard 'Prüfstand' – dieselben Daten wie erzeuge_markdown, als
interaktive Seite mit Baumdiagramm (Mermaid) je Testdatei. Läuft lokal ohne Server."""
alle = [f for k in kataloge for f in k.faelle]
@@ -755,11 +1133,19 @@ def erzeuge_html(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline_kur
baseline_anzeige = (
baseline_pfad.relative_to(ROOT).as_posix() if baseline_pfad.is_relative_to(ROOT) else str(baseline_pfad)
)
pruefungen_anzeige = (
pruefungen_pfad.relative_to(ROOT).as_posix() if pruefungen_pfad.is_relative_to(ROOT) else str(pruefungen_pfad)
)
meta_zeile = (
f'Baseline: <span class="mono">{html.escape(baseline_anzeige)}</span> (SHA-256 {baseline_kurz})'
if baseline_kurz
else f'Baseline <span class="mono">{html.escape(baseline_anzeige)}</span> nicht gefunden'
)
meta_zeile_audit = (
f'Prüf-Audit: <span class="mono">{html.escape(pruefungen_anzeige)}</span> (SHA-256 {pruefungen_kurz})'
if pruefungen_kurz
else f'Prüf-Audit <span class="mono">{html.escape(pruefungen_anzeige)}</span> nicht gefunden'
)
nav_links = "\n ".join(
f'<a href="#pkg-{html.escape(k.paket)}">{html.escape(k.paket)} <span class="mono">({len(k.faelle)})</span></a>'
@@ -789,7 +1175,9 @@ def erzeuge_html(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline_kur
teile.append(
'<span class="tagline">Testkatalog der sn_*-Plugins — was die Suite heute prüft, auf einen Blick.</span></div>'
)
teile.append(f'<div class="meta-line">Quelle: <b>docs/tests/testkatalog.md</b><br>{meta_zeile}</div></div>')
teile.append(
f'<div class="meta-line">Quelle: <b>docs/tests/testkatalog.md</b><br>{meta_zeile}<br>{meta_zeile_audit}</div></div>'
)
teile.append('<div class="summary">')
teile.append(f'<div class="stat"><span class="n">{summe["gesamt"]}</span><span class="l">Testfälle</span></div>')
@@ -797,8 +1185,13 @@ def erzeuge_html(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline_kur
teile.append(f'<div class="stat warn"><span class="n">{summe["rot"]}</span><span class="l">rot (Baseline)</span></div>')
teile.append(f'<div class="stat skip"><span class="n">{summe["uebersprungen"]}</span><span class="l">übersprungen</span></div>')
doc_pct = round(100 * summe["mit_docstring"] / summe["gesamt"]) if summe["gesamt"] else 0
audit_pct = round(100 * summe["aktuell_geprueft"] / summe["gesamt"]) if summe["gesamt"] else 0
teile.append(f'<div class="stat"><span class="n">{doc_pct}%</span><span class="l">mit Docstring</span></div>')
teile.append(f'<div class="stat"><span class="n">{audit_pct}%</span><span class="l">aktuell geprüft</span></div>')
teile.append(f'<div class="stat"><span class="n">{sum(len(k.dateien) for k in kataloge)}</span><span class="l">Testdateien</span></div>')
summe_qf = zaehle_quellfunktionen([f for k in kataloge for f in k.quellfunktionen])
qf_pct = round(100 * summe_qf["ohne_bezug"] / summe_qf["gesamt"]) if summe_qf["gesamt"] else 0
teile.append(f'<div class="stat warn"><span class="n">{qf_pct}%</span><span class="l">ohne Testbezug</span></div>')
teile.append("</div>")
teile.append('<div class="pkg-bars"><div class="pkg-bars-title">Verteilung je Paket</div>')
@@ -812,6 +1205,8 @@ def erzeuge_html(kataloge: list[Paketkatalog], baseline_pfad: Path, baseline_kur
teile.append('<button class="chip" data-filter="hasred" aria-pressed="false">Mit rot</button>')
teile.append('<button class="chip" data-filter="hasskip" aria-pressed="false">Mit übersprungen</button>')
teile.append('<button class="chip" data-filter="nodoc" aria-pressed="false">Schwach beschrieben (&lt;50%)</button>')
teile.append('<button class="chip" data-filter="ungeprueft" aria-pressed="false">Nie geprüft</button>')
teile.append('<button class="chip" data-filter="veraltet" aria-pressed="false">Veraltet geprüft</button>')
teile.append("</div>")
teile.append(
'<div class="searchbox"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" '
@@ -863,6 +1258,8 @@ def main() -> int:
help="Zieldatei für das HTML-Dashboard (Standard: docs/tests/testkatalog.html)")
ap.add_argument("--ohne-html", action="store_true", help="kein HTML-Dashboard erzeugen/prüfen")
ap.add_argument("--baseline-datei", type=Path, default=BASELINE_DEFAULT)
ap.add_argument("--pruefungsdatei", type=Path, default=PRUEFUNGEN_DEFAULT,
help="Zieldatei für den Prüfstatus (Standard: docs/status/testpruefungen.json)")
args = ap.parse_args()
manifest = lade_manifest()
@@ -879,6 +1276,9 @@ def main() -> int:
rot_je_paket, baseline_kurz = lies_baseline(args.baseline_datei)
if not baseline_kurz:
print(f"Keine Baseline unter {args.baseline_datei} – alle Testfälle werden als grün geführt.")
pruefungen, pruefungen_kurz = lies_pruefungen(args.pruefungsdatei)
if not pruefungen_kurz:
print(f"Kein Prüf-Audit unter {args.pruefungsdatei} – alle Testfälle gelten als nie geprüft.")
kataloge: list[Paketkatalog] = []
for paket in reihenfolge:
@@ -890,10 +1290,14 @@ def main() -> int:
print(f"[{paket}] kein Ordner {repos[paket]['name']}/tests – übersprungen")
continue
setze_status(katalog, rot_je_paket.get(paket, set()))
setze_pruefstatus(katalog, pruefungen)
setze_referenzstatus(katalog)
k = zaehle(katalog.faelle)
qf = zaehle_quellfunktionen(katalog.quellfunktionen)
print(f"[{paket}] {len(katalog.dateien)} Testdateien, {k['gesamt']} Testfälle "
f"({k['gruen']} grün, {k['rot']} rot, {k['uebersprungen']} übersprungen, "
f"{k['mit_docstring']} mit Docstring)")
f"{k['mit_docstring']} mit Docstring); {qf['ohne_bezug']} von {qf['gesamt']} "
f"Quellfunktionen ohne Testbezug")
if not katalog.dateien:
print(f" Keine Datei tests/test_*.py gefunden.")
kataloge.append(katalog)
@@ -902,9 +1306,15 @@ def main() -> int:
print("Keine Pakete mit Testdateien gefunden – nichts zu tun.")
return 2
ausgaben = [(args.ausgabe, erzeuge_markdown(kataloge, args.baseline_datei, baseline_kurz))]
ausgaben = [(
args.ausgabe,
erzeuge_markdown(kataloge, args.baseline_datei, baseline_kurz, args.pruefungsdatei, pruefungen_kurz),
)]
if not args.ohne_html:
ausgaben.append((args.html_ausgabe, erzeuge_html(kataloge, args.baseline_datei, baseline_kurz)))
ausgaben.append((
args.html_ausgabe,
erzeuge_html(kataloge, args.baseline_datei, baseline_kurz, args.pruefungsdatei, pruefungen_kurz),
))
ergebnis = 0
for ziel, text in ausgaben:
+236
View File
@@ -0,0 +1,236 @@
"""Tests für scripts/test_audit.py und die Prüf-Audit-Funktionen in scripts/testkatalog.py.
Reines unittest, ohne QGIS/sn_basis-Abhängigkeit. Arbeitet auf einem eigenen, temporären
Mini-Workspace (nicht auf den echten Plugin-Repos), damit diese Tests unabhängig vom Inhalt der
sn_*-Testsuiten bleiben.
Ausführung (aus dem Workspace-Root): python -m unittest discover -s scripts/tests -p "test_*.py"
"""
from __future__ import annotations
import ast
import contextlib
import io
import sys
import tempfile
import unittest
from pathlib import Path
from unittest import mock
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # scripts/
import test_audit # noqa: E402
import testkatalog as tk # noqa: E402
WORKSPACE_TOML = """
[workspace]
name = "Test"
arbeitsbranch = "main"
[[repos]]
name = "Testpaket"
paket = "testpaket"
rolle = "infrastruktur"
branch = "main"
tests = true
abhaengigkeiten = []
"""
TESTDATEI_INHALT = '''"""Beispieltestdatei für den Test-Audit-Selbsttest."""
import unittest
class TestBeispiel(unittest.TestCase):
def test_eins(self):
"""Prüft, dass eins gleich eins ist."""
self.assertEqual(1, 1)
def test_zwei(self):
"""Prüft, dass zwei gleich zwei ist."""
self.assertEqual(2, 2)
'''
def _knoten(quelltext: str) -> tuple[list[str], ast.FunctionDef]:
"""Parst eine einzelne Funktionsdefinition; liefert ihre Zeilen und den ast-Knoten."""
zeilen = quelltext.splitlines()
baum = ast.parse(quelltext)
return zeilen, baum.body[0]
class HashTests(unittest.TestCase):
def test_gleicher_quelltext_ergibt_gleichen_hash(self):
"""Prüft, dass zwei identische Testfunktionen denselben Hash ergeben."""
quelltext = "def test_x(self):\n self.assertEqual(1, 1)\n"
h1 = tk._funktionshash(*_knoten(quelltext))
h2 = tk._funktionshash(*_knoten(quelltext))
self.assertEqual(h1, h2)
def test_geaenderter_testkoerper_aendert_hash(self):
"""Prüft, dass eine inhaltliche Änderung am Testkörper den Hash ändert."""
original = "def test_x(self):\n self.assertEqual(1, 1)\n"
geaendert = "def test_x(self):\n self.assertEqual(1, 2)\n"
self.assertNotEqual(tk._funktionshash(*_knoten(original)), tk._funktionshash(*_knoten(geaendert)))
def test_trailing_whitespace_aendert_hash_nicht(self):
"""Prüft, dass reines Trailing Whitespace am Zeilenende den Hash nicht ändert."""
ohne = "def test_x(self):\n self.assertEqual(1, 1)\n"
mit_leerzeichen = "def test_x(self): \n self.assertEqual(1, 1) \n"
self.assertEqual(tk._funktionshash(*_knoten(ohne)), tk._funktionshash(*_knoten(mit_leerzeichen)))
class LiesPruefungenTests(unittest.TestCase):
def test_lies_pruefungen_ohne_datei_gibt_leeres_ergebnis(self):
"""Prüft, dass eine fehlende Prüfungsdatei ein leeres Ergebnis ohne Prüfsumme liefert."""
with tempfile.TemporaryDirectory() as tmp:
daten, kurz = tk.lies_pruefungen(Path(tmp) / "nicht_vorhanden.json")
self.assertEqual(daten, {})
self.assertEqual(kurz, "")
def test_lies_pruefungen_liefert_kurzpruefsumme(self):
"""Prüft, dass eine vorhandene Prüfungsdatei eine 12-stellige Kurzprüfsumme liefert."""
with tempfile.TemporaryDirectory() as tmp:
pfad = Path(tmp) / "testpruefungen.json"
pfad.write_text('{"a": {"datum": "2026-01-01", "hash": "abc123"}}', encoding="utf-8")
daten, kurz = tk.lies_pruefungen(pfad)
self.assertEqual(daten["a"]["hash"], "abc123")
self.assertEqual(len(kurz), 12)
class SetzePruefstatusTests(unittest.TestCase):
def test_setze_pruefstatus_erkennt_nie_geprueft_aktuell_und_veraltet(self):
"""Prüft, dass setze_pruefstatus zwischen nie geprüft, aktuell geprüft und veraltet unterscheidet."""
with tempfile.TemporaryDirectory() as tmp:
pfad = Path(tmp) / "test_beispiel.py"
pfad.write_text(TESTDATEI_INHALT, encoding="utf-8")
with mock.patch.object(tk, "ROOT", Path(tmp)):
datei = tk.lies_testdatei(pfad, "testpaket")
faelle = {f.name: f for f in datei.faelle}
pruefungen = {
tk.voller_testpfad(datei, faelle["test_zwei"]): {
"datum": "2026-01-01",
"hash": faelle["test_zwei"].quellhash,
},
}
katalog = tk.Paketkatalog(paket="testpaket", ordner="Testpaket", rolle="infrastruktur", dateien=[datei])
tk.setze_pruefstatus(katalog, pruefungen)
self.assertEqual(faelle["test_eins"].pruefstatus, "nie geprüft")
self.assertEqual(faelle["test_zwei"].pruefstatus, "aktuell geprüft")
pruefungen[tk.voller_testpfad(datei, faelle["test_zwei"])]["hash"] = "veraltet-hash"
tk.setze_pruefstatus(katalog, pruefungen)
self.assertEqual(faelle["test_zwei"].pruefstatus, "veraltet")
def test_pruef_text_formatiert_alle_drei_zustaende(self):
"""Prüft, dass pruef_text für jeden Prüfstatus den erwarteten Anzeigetext liefert."""
nie = tk.Testfall(klasse="T", name="test_a", beschreibung="")
aktuell = tk.Testfall(klasse="T", name="test_b", beschreibung="", pruefstatus="aktuell geprüft", pruefdatum="2026-01-01")
veraltet = tk.Testfall(klasse="T", name="test_c", beschreibung="", pruefstatus="veraltet", pruefdatum="2026-01-01")
self.assertEqual(tk.pruef_text(nie), "nie geprüft")
self.assertEqual(tk.pruef_text(aktuell), "geprüft am 2026-01-01")
self.assertEqual(tk.pruef_text(veraltet), "veraltet seit Änderung – zuletzt geprüft am 2026-01-01")
class SchreibePruefungenTests(unittest.TestCase):
def test_markieren_schreibt_deterministisch(self):
"""Prüft, dass schreibe_pruefungen unabhängig von der Einfügereihenfolge dieselbe Datei erzeugt."""
eintrag_a = {"datum": "2026-01-01", "hash": "aaa"}
eintrag_b = {"datum": "2026-01-02", "hash": "bbb"}
with tempfile.TemporaryDirectory() as tmp:
pfad1 = Path(tmp) / "eins.json"
pfad2 = Path(tmp) / "zwei.json"
test_audit.schreibe_pruefungen(pfad1, {"a": eintrag_a, "b": eintrag_b})
test_audit.schreibe_pruefungen(pfad2, {"b": eintrag_b, "a": eintrag_a})
self.assertEqual(pfad1.read_bytes(), pfad2.read_bytes())
class WorkspaceGestuetzteTests(unittest.TestCase):
"""Basisklasse mit einem eigenen Mini-Workspace (ein Paket, eine Testdatei)."""
def setUp(self):
self._tmp = tempfile.TemporaryDirectory()
self.addCleanup(self._tmp.cleanup)
self.root = Path(self._tmp.name)
(self.root / "Testpaket" / "tests").mkdir(parents=True)
(self.root / "Testpaket" / "tests" / "test_beispiel.py").write_text(TESTDATEI_INHALT, encoding="utf-8")
(self.root / "workspace.toml").write_text(WORKSPACE_TOML, encoding="utf-8")
for patch in (
mock.patch.object(tk, "ROOT", self.root),
mock.patch.object(tk, "MANIFEST", self.root / "workspace.toml"),
):
patch.start()
self.addCleanup(patch.stop)
self.pruefungsdatei = self.root / "testpruefungen.json"
def _stdout(self, aufruf) -> tuple[int, str]:
puffer = io.StringIO()
with contextlib.redirect_stdout(puffer):
code = aufruf()
return code, puffer.getvalue()
def test_status_befehl_zeigt_ungeprueften_test_an(self):
"""Prüft, dass der status-Befehl einen noch nie geprüften Testfall als solchen anzeigt."""
import argparse
args = argparse.Namespace(
pakete=[], muster=None, nur=None, code=False,
baseline_datei=self.root / "keine_baseline.json",
pruefungsdatei=self.pruefungsdatei,
)
code, ausgabe = self._stdout(lambda: test_audit.befehl_status(args))
self.assertEqual(code, 0)
self.assertIn("test_eins", ausgabe)
self.assertIn("nie geprüft", ausgabe)
self.assertRegex(ausgabe, r"test_beispiel\.py:\d+")
def test_status_befehl_mit_code_gibt_quelltext_aus(self):
"""Prüft, dass --code den Testquelltext der passenden Methode mit ausgibt."""
import argparse
args = argparse.Namespace(
pakete=[], muster="test_eins", nur=None, code=True,
baseline_datei=self.root / "keine_baseline.json",
pruefungsdatei=self.pruefungsdatei,
)
_, ausgabe = self._stdout(lambda: test_audit.befehl_status(args))
self.assertIn("def test_eins(self):", ausgabe)
self.assertIn("assertEqual(1, 1)", ausgabe)
def test_markieren_ohne_treffer_gibt_exitcode_1(self):
"""Prüft, dass ein Muster ohne Treffer Exit-Code 1 liefert und keine Datei schreibt."""
import argparse
args = argparse.Namespace(
paket="testpaket", bezeichner=["NichtVorhanden.*"], datum="2026-01-01",
trocken=False, pruefungsdatei=self.pruefungsdatei,
)
code, _ = self._stdout(lambda: test_audit.befehl_markieren(args))
self.assertEqual(code, 1)
self.assertFalse(self.pruefungsdatei.exists())
def test_markieren_schreibt_treffer_und_status_zeigt_es_danach_an(self):
"""Prüft, dass ein markierter Testfall im Status anschließend als aktuell geprüft erscheint."""
import argparse
markieren_args = argparse.Namespace(
paket="testpaket", bezeichner=["TestBeispiel.test_eins"], datum="2026-01-01",
trocken=False, pruefungsdatei=self.pruefungsdatei,
)
code, _ = self._stdout(lambda: test_audit.befehl_markieren(markieren_args))
self.assertEqual(code, 0)
self.assertTrue(self.pruefungsdatei.exists())
status_args = argparse.Namespace(
pakete=[], muster="test_eins", nur=None, code=False,
baseline_datei=self.root / "keine_baseline.json",
pruefungsdatei=self.pruefungsdatei,
)
_, ausgabe = self._stdout(lambda: test_audit.befehl_status(status_args))
self.assertIn("geprüft am 2026-01-01", ausgabe)
if __name__ == "__main__":
unittest.main()
@@ -0,0 +1,182 @@
"""Tests für die strukturelle Lückenanalyse in scripts/testkatalog.py (Abschnitt „Ungetestete Funktionen").
Reines unittest, ohne QGIS/sn_basis-Abhängigkeit. Arbeitet auf temporären Mini-Paketen, nicht auf den
echten Plugin-Repos.
Ausführung (aus dem Workspace-Root): python -m unittest discover -s scripts/tests -p "test_*.py"
"""
from __future__ import annotations
import sys
import tempfile
import unittest
from pathlib import Path
from unittest import mock
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # scripts/
import testkatalog as tk # noqa: E402
QUELLDATEI_INHALT = '''"""Beispielmodul für den Selbsttest der Lückenanalyse."""
def oeffentliche_funktion(x):
return x
def _private_funktion(x):
return x
class Beispielklasse:
def __init__(self):
self.wert = 0
def getestete_methode(self):
return self.wert
def ungetestete_methode(self):
return self.wert
def bewusst_ausgelassene_methode(self):
"""von Test abgesehen, weil vernachlässigbar; XY 01.01.2026"""
return self.wert
'''
TESTDATEI_MIT_AUFRUF = '''"""Testet Beispielklasse."""
import unittest
from unittest import mock
class TestBeispielklasse(unittest.TestCase):
def test_oeffentliche_funktion(self):
"""Prüft, dass oeffentliche_funktion den übergebenen Wert zurückgibt."""
self.assertEqual(1, 1)
def test_getestete_methode(self):
"""Prüft, dass getestete_methode über mock.patch angesprochen wird."""
with mock.patch("paket.modul.Beispielklasse.getestete_methode"):
pass
'''
class SammleQuellcodeTests(unittest.TestCase):
def setUp(self):
self._tmp = tempfile.TemporaryDirectory()
self.addCleanup(self._tmp.cleanup)
self.ordner = Path(self._tmp.name)
(self.ordner / "modul.py").write_text(QUELLDATEI_INHALT, encoding="utf-8")
(self.ordner / "main.py").write_text("def classFactory(iface):\n return None\n", encoding="utf-8")
(self.ordner / "__init__.py").write_text("VERSION = 1\n", encoding="utf-8")
(self.ordner / "tests").mkdir()
(self.ordner / "tests" / "test_modul.py").write_text(
"def test_hilfsfunktion():\n pass\n", encoding="utf-8"
)
def test_main_und_init_werden_ausgeschlossen(self):
"""Prüft, dass main.py und __init__.py nicht in die Quellcode-Analyse aufgenommen werden."""
funktionen = tk.sammle_quellcode(self.ordner)
dateien = {f.datei for f in funktionen}
self.assertNotIn("main.py", dateien)
self.assertNotIn("__init__.py", dateien)
def test_tests_ordner_wird_ausgeschlossen(self):
"""Prüft, dass Dateien unter tests/ nicht in die Quellcode-Analyse aufgenommen werden."""
funktionen = tk.sammle_quellcode(self.ordner)
self.assertFalse(any(f.datei.startswith("tests/") for f in funktionen))
def test_modulfunktion_und_methode_werden_mit_zeile_erfasst(self):
"""Prüft, dass Top-Level-Funktionen und Methoden mit qualifiziertem Namen und Zeile erfasst werden."""
funktionen = {f.name: f for f in tk.sammle_quellcode(self.ordner)}
self.assertIn("oeffentliche_funktion", funktionen)
self.assertIn("_private_funktion", funktionen)
self.assertIn("Beispielklasse.getestete_methode", funktionen)
self.assertEqual(funktionen["oeffentliche_funktion"].zeile, 4)
def test_dunder_methoden_werden_ausgeschlossen(self):
"""Prüft, dass Dunder-Methoden wie __init__ nicht in die Quellcode-Analyse aufgenommen werden."""
namen = {f.name for f in tk.sammle_quellcode(self.ordner)}
self.assertNotIn("Beispielklasse.__init__", namen)
def test_docstring_mit_vermerk_setzt_absichtlich_grund(self):
"""Prüft, dass eine Methode mit „von Test abgesehen“-Vermerk im Docstring absichtlich_grund gesetzt bekommt."""
funktionen = {f.name: f for f in tk.sammle_quellcode(self.ordner)}
self.assertIn("von Test abgesehen", funktionen["Beispielklasse.bewusst_ausgelassene_methode"].absichtlich_grund)
def test_docstring_ohne_vermerk_laesst_absichtlich_grund_leer(self):
"""Prüft, dass eine Methode ohne Vermerk im Docstring ein leeres absichtlich_grund behält."""
funktionen = {f.name: f for f in tk.sammle_quellcode(self.ordner)}
self.assertEqual(funktionen["Beispielklasse.ungetestete_methode"].absichtlich_grund, "")
class AbsichtlicherVerzichtTests(unittest.TestCase):
def test_erkennt_von_test_abgesehen_marker(self):
"""Prüft, dass absichtlicher_verzicht den 'von Test abgesehen'-Vermerk erkennt."""
text = tk.absichtlicher_verzicht("Kurzbeschreibung.\n\nvon Test abgesehen, weil vernachlässigbar; XY 01.01.2026")
self.assertIn("von Test abgesehen", text)
def test_erkennt_test_ausgesetzt_marker(self):
"""Prüft, dass absichtlicher_verzicht den 'Test ausgesetzt'-Vermerk erkennt."""
self.assertEqual(tk.absichtlicher_verzicht("Test ausgesetzt, zunächst Refactor"), "Test ausgesetzt, zunächst Refactor")
def test_liefert_leeren_string_ohne_marker(self):
"""Prüft, dass absichtlicher_verzicht ohne bekannten Vermerk einen leeren String liefert."""
self.assertEqual(tk.absichtlicher_verzicht("Ganz normale Beschreibung ohne Vermerk."), "")
def test_liefert_leeren_string_fuer_fehlenden_docstring(self):
"""Prüft, dass absichtlicher_verzicht für None einen leeren String liefert."""
self.assertEqual(tk.absichtlicher_verzicht(None), "")
class SammleReferenzierteNamenTests(unittest.TestCase):
def test_erkennt_aufruf_attribut_und_string_ziel(self):
"""Prüft, dass Aufrufe, Attributzugriffe und mock.patch-Zeichenketten als Referenz zählen."""
with tempfile.TemporaryDirectory() as tmp:
pfad = Path(tmp) / "test_modul.py"
pfad.write_text(TESTDATEI_MIT_AUFRUF, encoding="utf-8")
namen = tk.sammle_referenzierte_namen([pfad])
self.assertIn("oeffentliche_funktion", namen)
self.assertIn("getestete_methode", namen)
self.assertNotIn("ungetestete_methode", namen)
class SetzeReferenzstatusTests(unittest.TestCase):
def test_markiert_referenzierte_und_ungetestete_funktionen(self):
"""Prüft, dass setze_referenzstatus referenzierte von ungetesteten Funktionen unterscheidet."""
with tempfile.TemporaryDirectory() as tmp:
ordner = Path(tmp)
(ordner / "modul.py").write_text(QUELLDATEI_INHALT, encoding="utf-8")
(ordner / "tests").mkdir()
testpfad = ordner / "tests" / "test_modul.py"
testpfad.write_text(TESTDATEI_MIT_AUFRUF, encoding="utf-8")
with mock.patch.object(tk, "ROOT", ordner):
datei = tk.lies_testdatei(testpfad, "testpaket")
katalog = tk.Paketkatalog(paket="testpaket", ordner=str(ordner), rolle="infrastruktur", dateien=[datei])
tk.setze_referenzstatus(katalog)
status = {f.name: f.referenziert for f in katalog.quellfunktionen}
self.assertTrue(status["oeffentliche_funktion"])
self.assertTrue(status["Beispielklasse.getestete_methode"])
self.assertFalse(status["Beispielklasse.ungetestete_methode"])
self.assertFalse(status["_private_funktion"])
class ZaehleQuellfunktionenTests(unittest.TestCase):
def test_zaehlt_referenzierte_beabsichtigte_und_ungeklaerte_funktionen_korrekt(self):
"""Prüft, dass zaehle_quellfunktionen zwischen referenziert, beabsichtigt und ungeklärt unterscheidet."""
funktionen = [
tk.Quellfunktion(datei="modul.py", name="a", zeile=1, referenziert=True),
tk.Quellfunktion(datei="modul.py", name="b", zeile=2, referenziert=False, absichtlich_grund="von Test abgesehen, weil x"),
tk.Quellfunktion(datei="modul.py", name="c", zeile=3, referenziert=False),
]
ergebnis = tk.zaehle_quellfunktionen(funktionen)
self.assertEqual(
ergebnis,
{"gesamt": 3, "referenziert": 1, "ohne_bezug": 2, "absichtlich": 1, "ungeklaert": 1},
)
if __name__ == "__main__":
unittest.main()