nevaforget/greetd-moongreet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
greetd-moongreet/CLAUDE.md
nevaforget 4cd73a430b fix: Audit-Findings — Realize-Handler, Thread-Safety, Input-Validierung 
- _on_realize implementiert (war nur connected, nicht definiert)
- do_unrealize für as_file() Context-Manager-Cleanup
- threading.Lock für _greetd_sock Race Condition
- TOML-Parsing-Fehler abfangen statt Crash
- last-user Datei: Längen- und Zeichenvalidierung
- detect_locale: non-alpha LANG-Werte abweisen
- exec_cmd Plausibility-Check mit shutil.which
- Exception-Details ins Log statt in die UI
- subprocess.run Timeout für Power-Actions
- Sequence[Path] statt tuple[Path, ...] in get_sessions
- Mock-Server _recvall für fragmentierte Reads
- [behavior]-Config-Sektion entfernt (unimplementiert)
- Design Decisions in CLAUDE.md dokumentiert
2026-03-26 12:56:52 +01:00

2.2 KiB
Raw Blame History

Moongreet

Name: Selene (Mondgöttin — passend zu Moon-greet)

Projekt

Moongreet ist ein greetd-Greeter für Wayland, gebaut mit Python + GTK4 + gtk4-layer-shell. Teil des Moonarch-Ökosystems.

Tech-Stack

  • Python 3.11+, PyGObject (GTK 4.0)
  • gtk4-layer-shell für Wayland Layer Shell
  • greetd IPC über Unix Domain Socket (length-prefixed JSON)
  • pytest für Tests

Projektstruktur

  • src/moongreet/ — Quellcode
  • src/moongreet/data/ — Package-Assets (Default-Avatar, Icons) — werden mit dem Wheel ausgeliefert
  • tests/ — pytest Tests
  • data/ — User-Assets (wallpaper.jpg) — nicht Teil des Packages
  • config/ — Beispiel-Konfigurationsdateien für /etc/moongreet/ und /etc/greetd/

Kommandos

# Tests ausführen
uv run pytest tests/ -v

# Typ-Checks
uv run pyright src/

# Greeter starten (nur zum Testen, braucht normalerweise greetd)
uv run moongreet

Architektur

  • ipc.py — greetd Socket-Kommunikation (length-prefixed JSON)
  • users.py — Benutzer aus /etc/passwd, Avatare, GTK-Themes
  • sessions.py — Wayland/X11 Sessions aus .desktop Files
  • power.py — Reboot/Shutdown via loginctl
  • i18n.py — Locale-Erkennung (LANG / /etc/locale.conf) und String-Tabellen (DE/EN)
  • greeter.py — GTK4 UI (Overlay-Layout), Faillock-Warnung nach 2 Fehlversuchen
  • main.py — Entry Point, GTK App, Layer Shell Setup

Design Decisions

  • Synchrones I/O im GTK-Konstruktor: load_config, load_strings, get_users und get_sessions laufen synchron in GreeterWindow.__init__. Async Loading mit Placeholder-UI wäre möglich, erhöht aber die Komplexität erheblich. Der Greeter startet 1x pro Boot auf lokaler Hardware — die Daten sind klein (passwd, locale.conf, wenige .desktop-Files), die Latenz im Normalfall vernachlässigbar.
  • Synchrones Avatar-Decoding: GdkPixbuf.Pixbuf.new_from_file_at_scale läuft synchron auf dem Main Thread. Bei großen Bildern als .face-Datei kann die UI kurz stocken. Der Avatar-Cache (_avatar_cache) federt das nach dem ersten Laden ab. Async Decoding per Worker-Thread + GLib.idle_add wäre die Alternative, rechtfertigt aber den Aufwand nicht für einen Single-User-Greeter.