Files
lucid/.github/instructions/python-helpers.instructions.md
Sn3aky 2eea91205d Lucid 1.20.5.5, a beta
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-31 11:30:47 +01:00

1.0 KiB

applyTo, description
applyTo description
**/*.py Conventions and practices for Python helper scripts and bridges in Lucid

Python Helpers & Bridge Scripts Guidelines

When modifying or adding Python scripts in Lucid:

Output Format

  • Python scripts invoked by Quickshell processes (Process, ProcessView) should output strict, clean JSON over stdout without extra stdout log noise.
  • Direct debug or diagnostic logs to sys.stderr.

Dependencies & Portability

  • Maintain compatibility with standard Linux environments (Python 3.10+).
  • Use standard library modules (subprocess, json, sys, os, pathlib, re, argparse) wherever possible.
  • If using external dependencies (e.g. PIL, numpy, fontTools in lucidshot/ocr.py or gi / GObject / Gio in kdeconnect-bridge.py), fail gracefully or provide readable stderr diagnostics.

Error Handling

  • Handlers should handle subprocess failures (e.g., nmcli, hyprctl, kdeconnect-cli) cleanly without throwing unhandled exceptions that leave hanging processes.