prkit 0.2.0__tar.gz → 0.2.1__tar.gz

{prkit-0.2.0 → prkit-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: prkit
-Version: 0.2.0
+Version: 0.2.1
 Summary: A cross-platform system-tray presentation toolkit
 Author: meebox
 Author-email: meebox <meebox@gmail.com>
@@ -36,12 +36,12 @@ Description-Content-Type: text/markdown
 
 | 平台 | 下載檔案 | 啟動方式 |
 | --- | --- | --- |
-| Windows x64 | `PRKit-0.2.0-windows-x64.zip` | 完整解壓後執行 `PRKit/PRKit.exe` |
-| macOS Apple Silicon | `PRKit-0.2.0-macos-arm64.zip` | 解壓後將 `PRKit.app` 移到「應用程式」再開啟 |
+| Windows x64 | `PRKit-0.2.1-windows-x64.exe` | 直接開啟執行 |
+| macOS Apple Silicon | `PRKit-0.2.1-macos-arm64.dmg` | 開啟 DMG，將 `PRKit.app` 拖到「Applications」捷徑後啟動 |
 
-Windows 須保留同資料夾的 `prkit-cursor-watchdog.exe` 與 `_internal`，不可只複製主程式。macOS 目前僅提供 Apple Silicon 版。程式啟動後顯示在系統匣／選單列，不會開啟主視窗。
+Windows 為單一 EXE，已包含執行環境與游標復原 watchdog，不需額外下載檔案。macOS 目前僅提供 Apple Silicon 版。程式啟動後顯示在系統匣／選單列，不會開啟主視窗。
 
-桌面版尚未使用 Windows 發行者憑證或 Apple Developer ID 簽署／公證；macOS 僅使用 ad-hoc 簽章。若系統阻擋你確認來源的下載檔案，請依系統安全提示允許開啟。macOS 按鍵顯示仍需在「輸入監控」允許 `PRKit`；輸入法狀態模式不需此權限。每個 ZIP 另提供 `.sha256` 校驗檔。
+桌面版尚未使用 Windows 發行者憑證或 Apple Developer ID 簽署／公證；macOS 僅使用 ad-hoc 簽章。若系統阻擋你確認來源的下載檔案，請依系統安全提示允許開啟。macOS 按鍵顯示仍需在「輸入監控」允許 `PRKit`；輸入法狀態模式不需此權限。每個下載檔另提供 `.sha256` 校驗檔。
 
 版本標籤會自動觸發 GitHub 雲端打包與成品測試；手動建置可在 Actions 的 **Build desktop apps** 執行，成品在該次執行的 Artifacts。詳細操作見[發佈指南](docs/RELEASING.md)。
 
@@ -68,7 +68,7 @@ uv tool install git+https://github.com/codemee/prkit.git@latest
 prkit
 ```
 
-若要固定特定版本，將 `latest` 改成版本標籤，例如 `v0.2.0`。
+若要固定特定版本，將 `latest` 改成版本標籤，例如 `v0.2.1`。
 
 若安裝後找不到 `prkit` 指令，執行 `uv tool update-shell`，再重新開啟終端機。移除工具可使用 `uv tool uninstall prkit`。
 

{prkit-0.2.0 → prkit-0.2.1}/README.md

@@ -19,12 +19,12 @@
 
 | 平台 | 下載檔案 | 啟動方式 |
 | --- | --- | --- |
-| Windows x64 | `PRKit-0.2.0-windows-x64.zip` | 完整解壓後執行 `PRKit/PRKit.exe` |
-| macOS Apple Silicon | `PRKit-0.2.0-macos-arm64.zip` | 解壓後將 `PRKit.app` 移到「應用程式」再開啟 |
+| Windows x64 | `PRKit-0.2.1-windows-x64.exe` | 直接開啟執行 |
+| macOS Apple Silicon | `PRKit-0.2.1-macos-arm64.dmg` | 開啟 DMG，將 `PRKit.app` 拖到「Applications」捷徑後啟動 |
 
-Windows 須保留同資料夾的 `prkit-cursor-watchdog.exe` 與 `_internal`，不可只複製主程式。macOS 目前僅提供 Apple Silicon 版。程式啟動後顯示在系統匣／選單列，不會開啟主視窗。
+Windows 為單一 EXE，已包含執行環境與游標復原 watchdog，不需額外下載檔案。macOS 目前僅提供 Apple Silicon 版。程式啟動後顯示在系統匣／選單列，不會開啟主視窗。
 
-桌面版尚未使用 Windows 發行者憑證或 Apple Developer ID 簽署／公證；macOS 僅使用 ad-hoc 簽章。若系統阻擋你確認來源的下載檔案，請依系統安全提示允許開啟。macOS 按鍵顯示仍需在「輸入監控」允許 `PRKit`；輸入法狀態模式不需此權限。每個 ZIP 另提供 `.sha256` 校驗檔。
+桌面版尚未使用 Windows 發行者憑證或 Apple Developer ID 簽署／公證；macOS 僅使用 ad-hoc 簽章。若系統阻擋你確認來源的下載檔案，請依系統安全提示允許開啟。macOS 按鍵顯示仍需在「輸入監控」允許 `PRKit`；輸入法狀態模式不需此權限。每個下載檔另提供 `.sha256` 校驗檔。
 
 版本標籤會自動觸發 GitHub 雲端打包與成品測試；手動建置可在 Actions 的 **Build desktop apps** 執行，成品在該次執行的 Artifacts。詳細操作見[發佈指南](docs/RELEASING.md)。
 
@@ -51,7 +51,7 @@ uv tool install git+https://github.com/codemee/prkit.git@latest
 prkit
 ```
 
-若要固定特定版本，將 `latest` 改成版本標籤，例如 `v0.2.0`。
+若要固定特定版本，將 `latest` 改成版本標籤，例如 `v0.2.1`。
 
 若安裝後找不到 `prkit` 指令，執行 `uv tool update-shell`，再重新開啟終端機。移除工具可使用 `uv tool uninstall prkit`。
 

{prkit-0.2.0 → prkit-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "prkit"
-version = "0.2.0"
+version = "0.2.1"
 description = "A cross-platform system-tray presentation toolkit"
 readme = "README.md"
 requires-python = ">=3.12"

{prkit-0.2.0 → prkit-0.2.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "prkit"
-version = "0.2.0"
+version = "0.2.1"
 description = "A cross-platform system-tray presentation toolkit"
 readme = "README.md"
 authors = [

{prkit-0.2.0 → prkit-0.2.1}/src/prkit/__init__.py

@@ -1,3 +1,3 @@
 """Presentation tools for the system tray."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

{prkit-0.2.0 → prkit-0.2.1}/src/prkit/cursor_watchdog.py

@@ -6,6 +6,7 @@ from ctypes import wintypes
 
 SPI_SETCURSORS = 0x0057
 SYNCHRONIZE = 0x00100000
+EVENT_MODIFY_STATE = 0x0002
 WAIT_OBJECT_0 = 0
 INFINITE = 0xFFFFFFFF
 
@@ -14,10 +15,20 @@ def restore_system_cursors() -> None:
     ctypes.windll.user32.SystemParametersInfoW(SPI_SETCURSORS, 0, None, 0)
 
 
-def watch(parent_pid: int, stop_event_name: str) -> int:
+def watch(parent_pid: int, stop_event_name: str, ready_event_name: str | None = None) -> int:
     kernel32 = ctypes.windll.kernel32
     kernel32.OpenProcess.restype = wintypes.HANDLE
+    kernel32.OpenProcess.argtypes = [wintypes.DWORD, wintypes.BOOL, wintypes.DWORD]
     kernel32.OpenEventW.restype = wintypes.HANDLE
+    kernel32.OpenEventW.argtypes = [wintypes.DWORD, wintypes.BOOL, wintypes.LPCWSTR]
+    kernel32.SetEvent.argtypes = [wintypes.HANDLE]
+    kernel32.CloseHandle.argtypes = [wintypes.HANDLE]
+    kernel32.WaitForMultipleObjects.argtypes = [
+        wintypes.DWORD,
+        ctypes.POINTER(wintypes.HANDLE),
+        wintypes.BOOL,
+        wintypes.DWORD,
+    ]
     parent = kernel32.OpenProcess(SYNCHRONIZE, False, parent_pid)
     stop_event = kernel32.OpenEventW(SYNCHRONIZE, False, stop_event_name)
     if not parent or not stop_event:
@@ -28,6 +39,15 @@ def watch(parent_pid: int, stop_event_name: str) -> int:
             kernel32.CloseHandle(stop_event)
         return 1
     try:
+        if ready_event_name is not None:
+            ready = kernel32.OpenEventW(EVENT_MODIFY_STATE, False, ready_event_name)
+            if not ready:
+                return 1
+            try:
+                if not kernel32.SetEvent(ready):
+                    return 1
+            finally:
+                kernel32.CloseHandle(ready)
         handles = (wintypes.HANDLE * 2)(parent, stop_event)
         result = kernel32.WaitForMultipleObjects(2, handles, False, INFINITE)
         if result == WAIT_OBJECT_0:
@@ -39,9 +59,9 @@ def watch(parent_pid: int, stop_event_name: str) -> int:
 
 
 def main() -> int:
-    if sys.platform != "win32" or len(sys.argv) != 3:
+    if sys.platform != "win32" or len(sys.argv) not in {3, 4}:
         return 2
-    return watch(int(sys.argv[1]), sys.argv[2])
+    return watch(int(sys.argv[1]), sys.argv[2], sys.argv[3] if len(sys.argv) == 4 else None)
 
 
 if __name__ == "__main__":

{prkit-0.2.0 → prkit-0.2.1}/src/prkit/windows_cursor.py

@@ -101,29 +101,61 @@ class CursorWatchdog:
     def __init__(self) -> None:
         self._kernel32 = ctypes.windll.kernel32
         self._kernel32.CreateEventW.restype = wintypes.HANDLE
+        self._kernel32.CreateEventW.argtypes = [
+            ctypes.c_void_p,
+            wintypes.BOOL,
+            wintypes.BOOL,
+            wintypes.LPCWSTR,
+        ]
+        self._kernel32.SetEvent.argtypes = [wintypes.HANDLE]
+        self._kernel32.CloseHandle.argtypes = [wintypes.HANDLE]
+        self._kernel32.WaitForSingleObject.argtypes = [wintypes.HANDLE, wintypes.DWORD]
         self._event_name = f"Local\\PrtoolsCursorRestore-{uuid.uuid4()}"
+        self._ready_event_name = self._event_name + "-ready"
         self._event = self._kernel32.CreateEventW(None, True, False, self._event_name)
         if not self._event:
             raise CursorBackendError("無法建立游標復原事件")
+        ready = self._kernel32.CreateEventW(None, True, False, self._ready_event_name)
+        if not ready:
+            self._kernel32.CloseHandle(self._event)
+            self._event = None
+            raise CursorBackendError("無法建立游標監控就緒事件")
         try:
+            environment = os.environ.copy()
+            if getattr(sys, "frozen", False):
+                # The watchdog must outlive the GUI and own its unpacked runtime.
+                environment["PYINSTALLER_RESET_ENVIRONMENT"] = "1"
             self._process = subprocess.Popen(
                 self._command(),
                 creationflags=CREATE_NO_WINDOW,
                 close_fds=True,
+                env=environment,
             )
-            time.sleep(0.05)
-            if self._process.poll() is not None:
-                raise CursorBackendError("游標復原監控程序啟動失敗")
+            deadline = time.monotonic() + 30
+            while self._kernel32.WaitForSingleObject(ready, 100) != 0:
+                if self._process.poll() is not None:
+                    raise CursorBackendError("游標復原監控程序啟動失敗")
+                if time.monotonic() >= deadline:
+                    raise CursorBackendError("游標復原監控程序啟動逾時")
         except Exception:
+            self._kernel32.SetEvent(self._event)
+            if hasattr(self, "_process") and self._process.poll() is None:
+                self._process.terminate()
+                self._process.wait(timeout=5)
             self._kernel32.CloseHandle(self._event)
             self._event = None
             raise
+        finally:
+            self._kernel32.CloseHandle(ready)
 
     def _command(self) -> list[str]:
+        arguments = [str(os.getpid()), self._event_name, self._ready_event_name]
+        if getattr(sys, "frozen", False):
+            return [sys.executable, "--cursor-watchdog", *arguments]
         sibling = Path(sys.executable).with_name("prkit-cursor-watchdog.exe")
         if sibling.is_file():
-            return [str(sibling), str(os.getpid()), self._event_name]
-        if getattr(sys, "frozen", False) or "__compiled__" in globals():
+            return [str(sibling), *arguments]
+        if "__compiled__" in globals():
             raise CursorBackendError("找不到 prkit-cursor-watchdog.exe")
         pythonw = Path(sys.executable).with_name("pythonw.exe")
         executable = pythonw if pythonw.is_file() else Path(sys.executable)
@@ -131,8 +163,7 @@ class CursorWatchdog:
             str(executable),
             "-m",
             "prkit.cursor_watchdog",
-            str(os.getpid()),
-            self._event_name,
+            *arguments,
         ]
 
     def stop(self) -> None:
@@ -140,7 +171,7 @@ class CursorWatchdog:
             return
         self._kernel32.SetEvent(self._event)
         try:
-            self._process.wait(timeout=2)
+            self._process.wait(timeout=10)
         except subprocess.TimeoutExpired:
             self._process.terminate()
         self._kernel32.CloseHandle(self._event)