| # shared-gui |
|
|
| ## Was ist das? |
| Gemeinsame GTK3-Basisklasse fuer alle Desktop-Apps in diesem Setup. Stellt `BaseApp` bereit — ein GTK3-Fenster mit Catppuccin-Theme, COSMIC Dark/Light Auto-Detection, HeaderBar, StatusBar und Refresh-Timer-Management. Wird von ClaudeCodePanel und Sidecar genutzt. |
|
|
| ## Architektur & Tech-Stack |
|
|
| ``` |
| gui_base.py (204 LOC) |
| | |
| BaseApp(Gtk.Window) |
| |-- __init__(title, width, height, icon_name) |
| | HeaderBar + content_box + StatusBar |
| | |
| |-- set_subtitle(text) |
| |-- add_header_widget(widget, end=True) |
| |-- set_status(text, css_class) # "status-saved" | "status-error" |
| |-- start_refresh(interval_s, cb) # GLib.timeout_add_seconds |
| |-- stop_all_refresh() |
| |-- add_css(css_string) # Palette-aware extra CSS |
| |-- run() # show_all() + Gtk.main() |
| | |
| |-- _apply_full_css() # intern: Theme-CSS + Base-CSS laden |
| |-- _base_css(palette) # intern: Card, Badge, Button CSS |
| |
| Abhaengigkeit: ~/Projekte/ClaudeCodePanel/theme.py |
| build_css(palette), get_palette(), setup_theme_watcher() |
| ``` |
|
|
| **Stack:** Python 3, GTK3 (gi.repository), GLib, Catppuccin-Palette aus ClaudeCodePanel/theme.py |
|
|
| **CSS-Klassen die BaseApp mitbringt:** |
| - `.base-card` — abgerundete Karte mit Hover |
| - `.base-toolbar` — Toolbar-Hintergrund |
| - `.base-badge`, `.base-badge-ok`, `.base-badge-warn`, `.base-badge-error` |
| - `.base-accent-btn` — Haupt-Akzent-Button |
|
|
| ## Starten / Nutzen |
|
|
| Nicht direkt ausfuehrbar. Als Library importieren: |
|
|
| ```python |
| # In einer neuen GTK3-App: |
| import sys |
| sys.path.insert(0, str(Path.home() / "Projekte" / "shared-gui")) |
| from gui_base import BaseApp |
| import gi |
| gi.require_version("Gtk", "3.0") |
| from gi.repository import Gtk |
| |
| class MeineApp(BaseApp): |
| def __init__(self): |
| super().__init__("Meine App", 800, 600) |
| label = Gtk.Label(label="Hallo") |
| self.content_box.pack_start(label, True, True, 0) |
| |
| MeineApp().run() |
| ``` |
|
|
| ## Was funktioniert |
| - Fenster-Setup mit HeaderBar (Titel, Untertitel, Close-Button) |
| - StatusBar unten mit Text + CSS-Klassen (ok/error) |
| - Catppuccin-Theme wird automatisch geladen (hell/dunkel je nach COSMIC-Setting) |
| - Theme-Watcher: GUI aktualisiert sich live bei Theme-Wechsel |
| - Refresh-Timer (GLib.timeout_add_seconds) mit sauberem Cleanup |
| - Erweiterbare CSS via `add_css()` — eigene Klassen hinzufuegen ohne Theme zu ueberschreiben |
| - `add_header_widget()` fuer Buttons/Labels in der HeaderBar (links oder rechts) |
|
|
| ## Was fehlt |
| - Kein Packaging/`__init__.py` — direkter Import via sys.path Hack |
| - Keine Tests |
| - Kein Fallback wenn ClaudeCodePanel/theme.py nicht existiert (hard dependency) |
| - Kein `icon_name` Default (None = kein App-Icon) |
|
|
| ## Entscheidungen & Lessons Learned |
| - **Abhaengigkeit zu ClaudeCodePanel/theme.py**: ClaudeCodePanel war zuerst da und hat das Theme-System. shared-gui baut darauf auf statt es zu duplizieren. Kopplung ist bewusst — beide liegen lokal. |
| - **GTK3 statt GTK4**: COSMIC Desktop nutzt GTK3. GTK4-Migration ist unnoetig und wuerde Kompatiblitaet brechen. |
| - **Kein eigenes Python-Package**: Nur eine Datei, kein Overhead durch setup.py/pyproject.toml. Fuer 1-2 Consumer reicht sys.path.insert(). |
| - **Refresh via GLib**: GLib.timeout_add_seconds laeuft im GTK-Main-Loop — kein Threading noetig, kein Race Condition. |
|
|
| ## Next Steps |
| 1. Fallback implementieren falls ClaudeCodePanel/theme.py fehlt (eigene Mini-Palette) |
| 2. `__init__.py` hinzufuegen damit `from shared_gui import BaseApp` sauber funktioniert |
| 3. Bei mehr als 2 Consumern: als lokales pip-Package installierbar machen |
|
|
