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
+2 -2
View File
@@ -68,7 +68,7 @@ def http(method: str, url: str, **kw):
# *** KORRIGIERTE FUNKTION ***
def get_project_by_short_name(name: str):
"""Sucht die interne ID des Projekts anhand des Kürzels (z.B. 'MP').
Versucht zuerst /api/projects, fällt bei Fehler auf /api/admin/projects zurück.
Versucht zuerst /api/projects, fällt bei Fehlern auf /api/admin/projects zurück.
"""
# 1) Primärer, nicht-admin Endpunkt
url1 = yt_url("/api/projects?fields=id,shortName")
@@ -160,7 +160,7 @@ def find_article_in_kb_by_title(title: str, parent_id: str | None = None):
return None
# *** KORRIGIERTE FUNKTION ***
def create_article(title: str, markdown: str, parent_id: str = None):
def create_article(title: str, markdown: str, parent_id: str | None = None):
"""Erstellt einen neuen Artikel in der Knowledge Base des Projekts.
Fallback: Wenn keine KB existiert (KB_ID is None), wird der Artikel dem Projekt zugeordnet.
"""