init

desktop/kadence_desktop/integrations/launcher.py

@@ -0,0 +1,43 @@
+"""Progress on the dock icon, via `com.canonical.Unity.LauncherEntry`.
+
+A signal, not a service: anything listening (Plasma's task manager, Dash to
+Dock, Latte) picks it up, and nothing breaks where nobody listens. The result is
+a progress bar filling under the icon as the interval runs and a badge with the
+pomodoro count for the day — the timer stays readable with the window closed.
+"""
+
+from __future__ import annotations
+
+from PyQt6.QtCore import QVariant
+from PyQt6.QtDBus import QDBusConnection, QDBusMessage
+
+_PATH = "/org/kadence/Desktop"
+_IFACE = "com.canonical.Unity.LauncherEntry"
+_APP_URI = "application://kadence.desktop"
+
+
+class LauncherEntry:
+    def __init__(self) -> None:
+        self._bus = QDBusConnection.sessionBus()
+
+    def update(self, *, progress: float | None = None, count: int | None = None, urgent: bool = False) -> None:
+        """Push a new state. `progress` is 0..1; `count` is the badge number."""
+        properties: dict[str, QVariant] = {}
+        if progress is None:
+            properties["progress-visible"] = QVariant(False)
+        else:
+            properties["progress"] = QVariant(max(0.0, min(1.0, progress)))
+            properties["progress-visible"] = QVariant(True)
+        if count is None:
+            properties["count-visible"] = QVariant(False)
+        else:
+            properties["count"] = QVariant(int(count))
+            properties["count-visible"] = QVariant(True)
+        properties["urgent"] = QVariant(bool(urgent))
+
+        message = QDBusMessage.createSignal(_PATH, _IFACE, "Update")
+        message.setArguments([_APP_URI, properties])
+        self._bus.send(message)
+
+    def clear(self) -> None:
+        self.update(progress=None, count=None, urgent=False)