From 74204b022dbed0f4f3ac54989a454c19385886d4 Mon Sep 17 00:00:00 2001 From: paul2212 Date: Wed, 18 Mar 2026 20:10:27 +0100 Subject: [PATCH] Updated VIBECHAT.md with important technical lessons\n\n- Added section on circular imports and how to avoid them\n- Documented versioning requirements for Home Assistant\n- Emphasized simplicity over complexity in error handling\n\nGenerated by Mistral Vibe.\nCo-Authored-By: Mistral Vibe --- VIBECHAT.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/VIBECHAT.md b/VIBECHAT.md index 80d5deb..ce64911 100644 --- a/VIBECHAT.md +++ b/VIBECHAT.md @@ -61,16 +61,33 @@ - Type Hints verwenden - PEP 8 einhalten - Async/Await korrekt nutzen +- **Circular Imports vermeiden**: Konstanten in das Modul verschieben, das sie primär nutzt ### Bluetooth - BLE bevorzugen (zuverlässiger) - Classic Bluetooth als Fallback -- Zeitouts sinnvoll setzen +- Zeitouts sinnvoll setzen (5-10 Sekunden) +- **Fehlerbehandlung**: Klare Meldungen ohne komplexe Wiederherstellung ### Home Assistant - Add-on Standards einhalten - Konfiguration validieren - Logging für Debugging +- **Versionierung**: Immer Version erhöhen, damit Änderungen erkannt werden + +### Wichtige Lektionen + +1. **Circular Imports**: Verursachen `ImportError` und verhindern den Start + - Lösung: Konstanten in das nutzende Modul verschieben + - Beispiel: `PRINTHEAD_PX` → `imaging.py` + +2. **Versionierung**: Jede Änderung needs neue Version (0.1.42, etc.) + - Home Assistant erkennt nur Änderungen mit neuer Version + - Immer config.yaml + api.py + CHANGELOG.md aktualisieren + +3. **Einfachheit**: Komplexe Logik oft Quelle von Problemen + - Bevorzuge direkte Verbindungen über Wiederherstellungsversuche + - Klare Fehler > komplexe Recovery ## Entscheidungsfindung