ring-cli 0.2.0__py3-none-any.whl

ring/notify/osascript_notifier.py

@@ -0,0 +1,32 @@
+"""osascript 後端（macOS 純文字，點擊不可聚焦——terminal-notifier 被擋掉時的退路）。"""
+
+from __future__ import annotations
+
+from ring.config import get_config
+from ring.i18n import gettext as _
+from ring.notify.base import notify_message
+from ring.notify.command import CommandNotifier
+from ring.osascript import osascript
+from ring.registry import Session
+
+
+class OsascriptNotifier(CommandNotifier):
+    name = "osascript"
+
+    def supports_click(self) -> bool:
+        return False
+
+    def send(self, sessions: list[Session]) -> None:
+        """用 osascript 逐 session 各發一則純文字通知（fallback，點擊不可聚焦）。"""
+        cfg = get_config()
+        for s in sessions:
+            message = notify_message(s)
+            title = _("RiNG · {project} 在等你回話", project=s.project)
+            sound = f' sound name "{cfg.notify_sound_name}"' if cfg.notify_sound else ""
+            try:
+                osascript(f'display notification "{message}" with title "{title}"{sound}')
+            except Exception:
+                pass
+
+
+notifier = OsascriptNotifier()

ring/notify/terminal_notifier.py

@@ -0,0 +1,64 @@
+"""terminal-notifier 後端（macOS，支援點擊 ``ring focus`` 跳轉）。"""
+
+from __future__ import annotations
+
+import shlex
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+from ring.config import get_config
+from ring.i18n import gettext as _
+from ring.notify.base import notify_message
+from ring.notify.command import CommandNotifier
+from ring.registry import Session
+
+
+def _ring_executable() -> str:
+    """回傳可被 terminal-notifier click callback 執行的 ring 路徑。
+
+    macOS 從通知中心觸發 ``-execute`` 時不一定有使用者 shell 的 PATH；通知建立時
+    先解析成絕對路徑，點擊才不會因找不到 ``ring`` 而失效。
+    """
+    current = Path(sys.argv[0])
+    if current.is_absolute() and current.exists():
+        return str(current)
+    found = shutil.which("ring")
+    return found or "ring"
+
+
+def _ring_focus_command(session_id: str) -> str:
+    return f"{shlex.quote(_ring_executable())} focus {shlex.quote(session_id)}"
+
+
+class TerminalNotifierNotifier(CommandNotifier):
+    name = "terminal-notifier"
+
+    def supports_click(self) -> bool:
+        return True
+
+    def send(self, sessions: list[Session]) -> None:
+        """每個 session 各發一則 terminal-notifier 通知，帶點擊聚焦回呼。"""
+        cfg = get_config()
+        for s in sessions:
+            cmd = [
+                "terminal-notifier",
+                "-title",
+                _("RiNG · {project} 在等你回話", project=s.project),
+                "-message",
+                notify_message(s),
+                "-execute",
+                _ring_focus_command(s.session_id),
+            ]
+            if cfg.notify_sound:
+                cmd.extend(["-sound", cfg.notify_sound_name or "default"])
+            if cfg.notify_ignore_dnd:
+                cmd.append("-ignoreDnD")
+            try:
+                subprocess.run(cmd, capture_output=True, timeout=10)
+            except Exception:
+                pass
+
+
+notifier = TerminalNotifierNotifier()

ring/osascript.py

@@ -0,0 +1,17 @@
+"""跑一段 AppleScript 的小工具——平台中立的共用 helper。
+
+focus（找終端分頁）、notify（osascript 後端）、cli（doctor 探 app 是否在跑）都用它，
+所以放在不綁任何 feature 的中性模組，而不是塞在 ``focus`` 裡讓別人反向依賴 focus。
+"""
+
+from __future__ import annotations
+
+import subprocess
+
+
+def osascript(script: str) -> tuple[int, str, str]:
+    try:
+        result = subprocess.run(["osascript", "-e", script], capture_output=True, text=True, timeout=5)
+    except (OSError, subprocess.SubprocessError) as exc:
+        return 1, "", str(exc)
+    return result.returncode, result.stdout.strip(), result.stderr.strip()