pyloid 0.22.0.dev5__tar.gz → 0.22.1__tar.gz

{pyloid-0.22.0.dev5 → pyloid-0.22.1}/LICENSE

@@ -198,4 +198,4 @@ Apache License
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
+   limitations under the License.

{pyloid-0.22.0.dev5 → pyloid-0.22.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyloid
-Version: 0.22.0.dev5
+Version: 0.22.1
 Summary: 
 Author: aesthetics-of-record
 Author-email: 111675679+aesthetics-of-record@users.noreply.github.com

{pyloid-0.22.0.dev5 → pyloid-0.22.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pyloid"
-version = "0.22.0-dev5"
+version = "0.22.1"
 description = ""
 authors = ["aesthetics-of-record <111675679+aesthetics-of-record@users.noreply.github.com>"]
 readme = "README.md"

{pyloid-0.22.0.dev5 → pyloid-0.22.1}/src/pyloid/pyloid.py

@@ -78,7 +78,6 @@ class _WindowController(QObject):
     )
 
 
-
 # Only Work in Main Thread
 class _Pyloid(QApplication):
     def __init__(
@@ -111,7 +110,7 @@ class _Pyloid(QApplication):
         ```
         """
         super().__init__(sys.argv)
-        
+
         self.data = data
 
         self.windows_dict = {}  # 윈도우 ID를 키로 사용하는 딕셔너리
@@ -396,12 +395,18 @@ class _Pyloid(QApplication):
         if self.windows_dict:
             # 첫 번째 윈도우 가져오기
             main_window = next(iter(self.windows_dict.values()))
-            main_window._window.activateWindow()
-            main_window._window.raise_()
-            main_window._window.setWindowState(
-                main_window._window.windowState() & ~Qt.WindowMinimized
-                | Qt.WindowActive
+            was_on_top = bool(
+                main_window._window._window.windowFlags() & Qt.WindowStaysOnTopHint
             )
+            if not was_on_top:
+                main_window._window._window.setWindowFlag(Qt.WindowStaysOnTopHint, True)
+                main_window._window._window.show()
+            main_window._window.activateWindow()
+            if not was_on_top:
+                main_window._window._window.setWindowFlag(
+                    Qt.WindowStaysOnTopHint, False
+                )
+                main_window._window._window.show()
 
     def show_and_focus_main_window(self):
         """
@@ -417,12 +422,19 @@ class _Pyloid(QApplication):
         if self.windows_dict:
             main_window = next(iter(self.windows_dict.values()))
             main_window._window.show()
-            main_window._window.activateWindow()
-            main_window._window.raise_()
-            main_window._window.setWindowState(
-                main_window._window.windowState() & ~Qt.WindowMinimized
-                | Qt.WindowActive
+
+            was_on_top = bool(
+                main_window._window._window.windowFlags() & Qt.WindowStaysOnTopHint
             )
+            if not was_on_top:
+                main_window._window._window.setWindowFlag(Qt.WindowStaysOnTopHint, True)
+                main_window._window._window.show()
+            main_window._window._window.activateWindow()
+            if not was_on_top:
+                main_window._window._window.setWindowFlag(
+                    Qt.WindowStaysOnTopHint, False
+                )
+                main_window._window._window.show()
 
     def close_all_windows(self):
         """
@@ -449,7 +461,7 @@ class _Pyloid(QApplication):
         app.quit()
         ```
         """
-        
+
         for window in self.windows_dict.values():
             window._window.close()
             window.web_page.deleteLater()
@@ -464,7 +476,7 @@ class _Pyloid(QApplication):
     def get_window_by_id(self, window_id: str) -> Optional[BrowserWindow]:
         """
         Returns the window with the given ID.
-        
+
         Parameters
         ----------
         window_id : str
@@ -474,14 +486,14 @@ class _Pyloid(QApplication):
         -------
         Optional[BrowserWindow]
             The window object with the given ID. Returns None if the window is not found.
-        
+
         Examples
         --------
         ```python
         app = Pyloid(app_name="Pyloid-App")
-        
+
         window = app.get_window_by_id("123e4567-e89b-12d3-a456-426614174000")
-        
+
         if window:
             print("Window found:", window)
         ```
@@ -1409,13 +1421,18 @@ class _Pyloid(QApplication):
             window.web_view.page().setBackgroundColor(
                 Qt.GlobalColor.black if self.theme == "dark" else Qt.GlobalColor.white
             )
-            
+
 
 class Pyloid(QObject):
     command_signal = Signal(str, str, object)
     result_signal = Signal(str, object)
-    
-    def __init__(self, app_name: str, single_instance: bool = True, data: Optional[Dict[str, Any]] = None):
+
+    def __init__(
+        self,
+        app_name: str,
+        single_instance: bool = True,
+        data: Optional[Dict[str, Any]] = None,
+    ):
         """
         Initialize the Pyloid application.
 
@@ -1438,13 +1455,13 @@ class Pyloid(QObject):
         and is used as an API key to connect to the integrated backend FastAPI server.
         """
         super().__init__()
-        
+
         self.data = data
 
         self.app = _Pyloid(app_name, single_instance, self.data)
-        
+
         self.command_signal.connect(self._handle_command)
-    
+
     @Slot(str, str, object)
     def _handle_command(self, command_id, command_type, params):
         result = None
@@ -1461,7 +1478,7 @@ class Pyloid(QObject):
                 y=params.get("y", 200),
                 frame=params.get("frame", True),
                 context_menu=params.get("context_menu", False),
-                dev_tools=params.get("dev_tools", False)
+                dev_tools=params.get("dev_tools", False),
             )
             result = window
 
@@ -1502,7 +1519,9 @@ class Pyloid(QObject):
             result = self.app.show_notification(params["title"], params["message"])
 
         elif command_type == "set_tray_icon_animation":
-            result = self.app.set_tray_icon_animation(params["icon_frames"], params.get("interval", 200))
+            result = self.app.set_tray_icon_animation(
+                params["icon_frames"], params.get("interval", 200)
+            )
 
         elif command_type == "set_tray_tooltip":
             result = self.app.set_tray_tooltip(params["message"])
@@ -1574,39 +1593,40 @@ class Pyloid(QObject):
             return None
 
         self.result_signal.emit(command_id, result)
-    
-    def execute_command(self, command_type: str, params: object, timeout: Optional[int] = None):
+
+    def execute_command(
+        self, command_type: str, params: object, timeout: Optional[int] = None
+    ):
         command_id = str(uuid.uuid4())
-        
+
         result_data = [None]
         loop = QEventLoop()
-        
+
         if timeout:
             timer = QTimer()
             timer.setSingleShot(True)
             timer.timeout.connect(loop.quit)
             timer.start(timeout)
-        
+
         def on_result(received_id, result):
             if received_id == command_id:
-                result_data[0] = result     
+                result_data[0] = result
                 loop.quit()
 
-        
         self.result_signal.connect(on_result, Qt.QueuedConnection)
-        
+
         self.command_signal.emit(command_id, command_type, params)
-                
+
         loop.exec()
-                
+
         self.result_signal.disconnect(on_result)
-        
+
         return result_data[0]
-    
+
     # -------------------------------------------------------------------
     # Execute_command 래퍼 (wrapper) 함수들
     # -------------------------------------------------------------------
-    
+
     def set_icon(self, icon_path: str) -> bool:
         """
         Dynamically sets the application's icon.
@@ -1622,7 +1642,7 @@ class Pyloid(QObject):
         >>> app.set_icon("icons/icon.png")
         """
         return self.execute_command("set_icon", {"icon_path": icon_path})
-    
+
     def create_window(
         self,
         title: str,
@@ -1677,7 +1697,7 @@ class Pyloid(QObject):
             "dev_tools": dev_tools,
         }
         return self.execute_command("create_window", params)
-    
+
     def run(self) -> None:
         """
         Runs the application event loop.
@@ -1688,7 +1708,7 @@ class Pyloid(QObject):
         >>> app.run()
         """
         return self.app.run()
-    
+
     def get_windows(self) -> Dict[str, BrowserWindow]:
         """
         Returns a list of all browser windows.
@@ -1704,7 +1724,7 @@ class Pyloid(QObject):
         >>> windows = app.get_windows()
         """
         return self.execute_command("get_windows", {})
-    
+
     def show_main_window(self) -> None:
         """
         Shows and focuses the first window.
@@ -1715,7 +1735,7 @@ class Pyloid(QObject):
         >>> app.show_main_window()
         """
         return self.execute_command("show_main_window", {})
-    
+
     def focus_main_window(self) -> None:
         """
         Focuses the first window.
@@ -1726,7 +1746,7 @@ class Pyloid(QObject):
         >>> app.focus_main_window()
         """
         return self.execute_command("focus_main_window", {})
-    
+
     def show_and_focus_main_window(self) -> None:
         """
         Shows and focuses the first window.
@@ -1737,7 +1757,7 @@ class Pyloid(QObject):
         >>> app.show_and_focus_main_window()
         """
         return self.execute_command("show_and_focus_main_window", {})
-    
+
     def close_all_windows(self) -> None:
         """
         Closes all windows.
@@ -1748,7 +1768,7 @@ class Pyloid(QObject):
         >>> app.close_all_windows()
         """
         return self.execute_command("close_all_windows", {})
-    
+
     def quit(self) -> None:
         """
         Quits the application.
@@ -1759,7 +1779,7 @@ class Pyloid(QObject):
         >>> app.quit()
         """
         return self.execute_command("quit", {})
-    
+
     def get_window_by_id(self, window_id: str) -> Optional[BrowserWindow]:
         """
         Returns the window with the given ID.
@@ -1780,7 +1800,7 @@ class Pyloid(QObject):
         >>> window = app.get_window_by_id("some-window-id")
         """
         return self.execute_command("get_window_by_id", {"window_id": window_id})
-    
+
     def set_tray_icon(self, tray_icon_path: str) -> bool:
         """
         Dynamically sets the tray icon.
@@ -1796,8 +1816,10 @@ class Pyloid(QObject):
         >>> app.set_tray_icon("icons/icon.png")
         """
         return self.execute_command("set_tray_icon", {"tray_icon_path": tray_icon_path})
-    
-    def set_tray_menu_items(self, tray_menu_items: List[Dict[str, Union[str, Callable]]]) -> bool:
+
+    def set_tray_menu_items(
+        self, tray_menu_items: List[Dict[str, Union[str, Callable]]]
+    ) -> bool:
         """
         Dynamically sets the tray menu items.
 
@@ -1813,8 +1835,10 @@ class Pyloid(QObject):
         >>>               {"label": "Exit", "callback": app.quit}]
         >>> app.set_tray_menu_items(menu_items)
         """
-        return self.execute_command("set_tray_menu_items", {"tray_menu_items": tray_menu_items})
-    
+        return self.execute_command(
+            "set_tray_menu_items", {"tray_menu_items": tray_menu_items}
+        )
+
     def set_tray_actions(self, actions: Dict[TrayEvent, Callable]) -> bool:
         """
         Dynamically sets the actions for tray icon activation.
@@ -1830,7 +1854,7 @@ class Pyloid(QObject):
         >>> app.set_tray_actions({TrayEvent.DoubleClick: lambda: print("Double-clicked")})
         """
         return self.execute_command("set_tray_actions", {"actions": actions})
-    
+
     def show_notification(self, title: str, message: str) -> bool:
         """
         Displays a notification in the system tray.
@@ -1847,9 +1871,13 @@ class Pyloid(QObject):
         >>> app = Pyloid(app_name="Pyloid-App")
         >>> app.show_notification("Update Available", "A new update is available for download.")
         """
-        return self.execute_command("show_notification", {"title": title, "message": message})
-    
-    def set_tray_icon_animation(self, icon_frames: List[str], interval: int = 200) -> bool:
+        return self.execute_command(
+            "show_notification", {"title": title, "message": message}
+        )
+
+    def set_tray_icon_animation(
+        self, icon_frames: List[str], interval: int = 200
+    ) -> bool:
         """
         Dynamically sets and starts the animation for the tray icon.
 
@@ -1865,8 +1893,11 @@ class Pyloid(QObject):
         >>> app = Pyloid(app_name="Pyloid-App")
         >>> app.set_tray_icon_animation(["frame1.png", "frame2.png", "frame3.png"], 100)
         """
-        return self.execute_command("set_tray_icon_animation", {"icon_frames": icon_frames, "interval": interval})
-    
+        return self.execute_command(
+            "set_tray_icon_animation",
+            {"icon_frames": icon_frames, "interval": interval},
+        )
+
     def set_tray_tooltip(self, message: str) -> bool:
         """
         Dynamically sets the tooltip for the tray icon.
@@ -1882,7 +1913,7 @@ class Pyloid(QObject):
         >>> app.set_tray_tooltip("Pyloid is running")
         """
         return self.execute_command("set_tray_tooltip", {"message": message})
-    
+
     def set_notification_callback(self, callback: Callable[[str], None]) -> bool:
         """
         Sets the callback function to be called when a notification is clicked.
@@ -1900,7 +1931,7 @@ class Pyloid(QObject):
         >>> app.set_notification_callback(on_notification_click)
         """
         return self.execute_command("set_notification_callback", {"callback": callback})
-    
+
     def get_all_monitors(self) -> List[Monitor]:
         """
         Returns information about all connected monitors.
@@ -1918,7 +1949,7 @@ class Pyloid(QObject):
         >>>     print(monitor.info())
         """
         return self.execute_command("get_all_monitors", {})
-    
+
     def get_primary_monitor(self) -> Monitor:
         """
         Returns information about the primary monitor.
@@ -1935,7 +1966,7 @@ class Pyloid(QObject):
         >>> print(primary_monitor.info())
         """
         return self.execute_command("get_primary_monitor", {})
-    
+
     def set_clipboard_text(self, text: str) -> None:
         """
         Copies text to the clipboard.
@@ -1951,7 +1982,7 @@ class Pyloid(QObject):
         >>> app.set_clipboard_text("Hello, World!")
         """
         return self.execute_command("set_clipboard_text", {"text": text})
-    
+
     def get_clipboard_text(self) -> str:
         """
         Retrieves text from the clipboard.
@@ -1968,7 +1999,7 @@ class Pyloid(QObject):
         >>> print(text)
         """
         return self.execute_command("get_clipboard_text", {})
-    
+
     def set_clipboard_image(self, image: Union[str, bytes, os.PathLike]) -> None:
         """
         Copies an image to the clipboard.
@@ -1984,7 +2015,7 @@ class Pyloid(QObject):
         >>> app.set_clipboard_image("/path/to/image.png")
         """
         return self.execute_command("set_clipboard_image", {"image": image})
-    
+
     def get_clipboard_image(self) -> QImage:
         """
         Retrieves an image from the clipboard.
@@ -2002,7 +2033,7 @@ class Pyloid(QObject):
         >>>     image.save("/path/to/save/image.png")
         """
         return self.execute_command("get_clipboard_image", {})
-    
+
     def set_auto_start(self, enable: bool) -> Union[bool, None]:
         """
         Sets the application to start automatically at system startup.
@@ -2023,7 +2054,7 @@ class Pyloid(QObject):
         >>> app.set_auto_start(True)
         """
         return self.execute_command("set_auto_start", {"enable": enable})
-    
+
     def is_auto_start(self) -> bool:
         """
         Checks if the application is set to start automatically at system startup.
@@ -2040,7 +2071,7 @@ class Pyloid(QObject):
         >>> print(auto_start_enabled)
         """
         return self.execute_command("is_auto_start", {})
-    
+
     def watch_file(self, file_path: str) -> bool:
         """
         Adds a file to the watch list.
@@ -2061,7 +2092,7 @@ class Pyloid(QObject):
         >>> app.watch_file("/path/to/file.txt")
         """
         return self.execute_command("watch_file", {"file_path": file_path})
-    
+
     def watch_directory(self, dir_path: str) -> bool:
         """
         Adds a directory to the watch list.
@@ -2082,7 +2113,7 @@ class Pyloid(QObject):
         >>> app.watch_directory("/path/to/directory")
         """
         return self.execute_command("watch_directory", {"dir_path": dir_path})
-    
+
     def stop_watching(self, path: str) -> bool:
         """
         Removes a file or directory from the watch list.
@@ -2103,7 +2134,7 @@ class Pyloid(QObject):
         >>> app.stop_watching("/path/to/file_or_directory")
         """
         return self.execute_command("stop_watching", {"path": path})
-    
+
     def get_watched_paths(self) -> List[str]:
         """
         Returns all currently watched paths.
@@ -2120,7 +2151,7 @@ class Pyloid(QObject):
         ['/path/to/file1.txt', '/path/to/directory']
         """
         return self.execute_command("get_watched_paths", {})
-    
+
     def get_watched_files(self) -> List[str]:
         """
         Returns all currently watched files.
@@ -2137,7 +2168,7 @@ class Pyloid(QObject):
         ['/path/to/file1.txt', '/path/to/file2.txt']
         """
         return self.execute_command("get_watched_files", {})
-    
+
     def get_watched_directories(self) -> List[str]:
         """
         Returns all currently watched directories.
@@ -2154,7 +2185,7 @@ class Pyloid(QObject):
         ['/path/to/directory1', '/path/to/directory2']
         """
         return self.execute_command("get_watched_directories", {})
-    
+
     def remove_all_watched_paths(self) -> None:
         """
         Removes all paths from the watch list.
@@ -2165,7 +2196,7 @@ class Pyloid(QObject):
         >>> app.remove_all_watched_paths()
         """
         return self.execute_command("remove_all_watched_paths", {})
-    
+
     def set_file_change_callback(self, callback: Callable[[str], None]) -> None:
         """
         Sets the callback function to be called when a file is changed.
@@ -2183,7 +2214,7 @@ class Pyloid(QObject):
         >>> app.set_file_change_callback(on_file_change)
         """
         return self.execute_command("set_file_change_callback", {"callback": callback})
-    
+
     def set_directory_change_callback(self, callback: Callable[[str], None]) -> None:
         """
         Sets the callback function to be called when a directory is changed.
@@ -2200,9 +2231,13 @@ class Pyloid(QObject):
         >>> app = Pyloid(app_name="Pyloid-App")
         >>> app.set_directory_change_callback(on_directory_change)
         """
-        return self.execute_command("set_directory_change_callback", {"callback": callback})
-    
-    def open_file_dialog(self, dir: Optional[str] = None, filter: Optional[str] = None) -> Optional[str]:
+        return self.execute_command(
+            "set_directory_change_callback", {"callback": callback}
+        )
+
+    def open_file_dialog(
+        self, dir: Optional[str] = None, filter: Optional[str] = None
+    ) -> Optional[str]:
         """
         Opens a file dialog to select a file to open.
 
@@ -2224,8 +2259,10 @@ class Pyloid(QObject):
         >>> file_path = app.open_file_dialog(dir="/home/user", filter="Text Files (*.txt)")
         """
         return self.execute_command("open_file_dialog", {"dir": dir, "filter": filter})
-    
-    def save_file_dialog(self, dir: Optional[str] = None, filter: Optional[str] = None) -> Optional[str]:
+
+    def save_file_dialog(
+        self, dir: Optional[str] = None, filter: Optional[str] = None
+    ) -> Optional[str]:
         """
         Opens a file dialog to select a file to save.
 
@@ -2247,7 +2284,7 @@ class Pyloid(QObject):
         >>> file_path = app.save_file_dialog(dir="/home/user", filter="Text Files (*.txt)")
         """
         return self.execute_command("save_file_dialog", {"dir": dir, "filter": filter})
-    
+
     def select_directory_dialog(self, dir: Optional[str] = None) -> Optional[str]:
         """
         Opens a dialog to select a directory.
@@ -2267,4 +2304,4 @@ class Pyloid(QObject):
         >>> app = Pyloid(app_name="Pyloid-App")
         >>> directory_path = app.select_directory_dialog(dir="/home/user")
         """
-        return self.execute_command("select_directory_dialog", {"dir": dir})
+        return self.execute_command("select_directory_dialog", {"dir": dir})