refactor(scripts): Frontmatter-Validator überarbeiten; kleine Typ-Korrektur im YouTrack-KB-Sync

- validate-frontmatter.py:
  - In ein sauberes, idiomatisches Skript mit Funktionen (load_schema, extract_frontmatter, validate_file, main) refaktoriert.
  - Pfadbehandlung auf pathlib umgestellt; robustere Frontmatter-Erkennung via Regex (unterstützt LF/CRLF, nur am Datei‑Anfang).
  - Verbesserte, klare Fehlermeldungen; Exit-Code jetzt 0/1 über sys.exit(main()).
  - Typannotationen und Module‑Docstring ergänzt; __future__ für |‑Unions hinzugefügt.
  - Sichere Schema-Ladung mit Fehlerbehandlung (Datei fehlt / ungültiges JSON).

- youtrack-sync-kb.py:
  - Kleinere, idiomatische Typkorrektur: parent_id als Optional (str | None) in create_article, keine Verhaltensänderung.

Ergebnis
- Die beiden Python-Skripte folgen nun einer sauberen Syntax und idiomatischen Python‑Praktiken (klare Funktionen, Typen, robuste Fehlerbehandlung). Das Verhalten der bestehenden YouTrack‑Synchronisation bleibt unverändert.
This commit is contained in:
2025-11-11 11:52:21 +01:00
parent 5771b5e968
commit 94f2ff9873
4 changed files with 89 additions and 30 deletions
+6
View File
@@ -25,3 +25,9 @@ logs/
# Generated diagrams
build/diagrams/
# Python virtual environment
.venv/
venv/
*.pyc
__pycache__/