pyloid 0.20.2.dev2__py3-none-any.whl → 0.22.0__py3-none-any.whl

pyloid/pyloid.py

@@ -26,9 +26,14 @@ import logging
 from .browser_window import BrowserWindow
 from .tray import TrayEvent
 from PySide6.QtCore import QCoreApplication
-from PySide6.QtCore import QRunnable, QThreadPool, Signal, QObject
-import time
-from .thread_pool import PyloidThreadPool
+from PySide6.QtCore import Signal, QObject, Slot
+import uuid
+from PySide6.QtCore import QEventLoop
+import socket
+from typing import Any
+
+# software backend
+os.environ["QT_QUICK_BACKEND"] = "software"
 
 # for linux debug
 os.environ["QTWEBENGINE_DICTIONARIES_PATH"] = "/"
@@ -73,11 +78,14 @@ class _WindowController(QObject):
     )
 
 
-class Pyloid(QApplication):
+
+# Only Work in Main Thread
+class _Pyloid(QApplication):
     def __init__(
         self,
         app_name,
         single_instance=True,
+        data=None,
     ):
         """
         Initializes the Pyloid application.
@@ -88,6 +96,8 @@ class Pyloid(QApplication):
             The name of the application
         single_instance : bool, optional
             Whether to run the application as a single instance (default is True)
+        data : dict, optional
+            Data to be transmitted to the frontend web engine via IPC
 
         Examples
         --------
@@ -101,8 +111,10 @@ class Pyloid(QApplication):
         ```
         """
         super().__init__(sys.argv)
+        
+        self.data = data
 
-        self.windows = []
+        self.windows_dict = {}  # 윈도우 ID를 키로 사용하는 딕셔너리
         self.server = None
 
         self.app_name = app_name
@@ -199,8 +211,8 @@ class Pyloid(QApplication):
         self.icon = QIcon(icon_path)
 
         # Immediately update the icon for all open windows.
-        for window in self.windows:
-            window._window.setWindowIcon(self.icon)
+        for window in self.windows_dict.values():
+            window.set_icon(self.icon)
 
     def create_window(
         self,
@@ -261,7 +273,8 @@ class Pyloid(QApplication):
             dev_tools,
             js_apis,
         )
-        return self.windows[-1]
+        latest_window_id = list(self.windows_dict.keys())[-1]
+        return self.windows_dict[latest_window_id]
 
     def _create_window_signal_function(
         self,
@@ -289,7 +302,7 @@ class Pyloid(QApplication):
             dev_tools,
             js_apis,
         )
-        self.windows.append(window)
+        self.windows_dict[window._window.id] = window
         return window
 
     def run(self):
@@ -333,7 +346,7 @@ class Pyloid(QApplication):
     ###########################################################################################
     # App window
     ###########################################################################################
-    def get_windows(self) -> List[BrowserWindow]:
+    def get_windows(self) -> Dict[str, BrowserWindow]:
         """
         Returns a list of all browser windows.
 
@@ -351,7 +364,7 @@ class Pyloid(QApplication):
             print(window.get_id())
         ```
         """
-        return self.windows
+        return self.windows_dict
 
     def show_main_window(self):
         """
@@ -364,8 +377,9 @@ class Pyloid(QApplication):
         app.show_main_window()
         ```
         """
-        if self.windows:
-            main_window = self.windows[0]
+        if self.windows_dict:
+            # 첫 번째 윈도우 가져오기
+            main_window = next(iter(self.windows_dict.values()))
             main_window._window.show()
 
     def focus_main_window(self):
@@ -379,8 +393,9 @@ class Pyloid(QApplication):
         app.focus_main_window()
         ```
         """
-        if self.windows:
-            main_window = self.windows[0]
+        if self.windows_dict:
+            # 첫 번째 윈도우 가져오기
+            main_window = next(iter(self.windows_dict.values()))
             main_window._window.activateWindow()
             main_window._window.raise_()
             main_window._window.setWindowState(
@@ -399,8 +414,8 @@ class Pyloid(QApplication):
         app.show_and_focus_main_window()
         ```
         """
-        if self.windows:
-            main_window = self.windows[0]
+        if self.windows_dict:
+            main_window = next(iter(self.windows_dict.values()))
             main_window._window.show()
             main_window._window.activateWindow()
             main_window._window.raise_()
@@ -420,7 +435,7 @@ class Pyloid(QApplication):
         app.close_all_windows()
         ```
         """
-        for window in self.windows:
+        for window in self.windows_dict.values():
             window._window.close()
 
     def quit(self):
@@ -435,12 +450,12 @@ class Pyloid(QApplication):
         ```
         """
         
-        # 윈도우 정리
-        for window in self.windows:
+        for window in self.windows_dict.values():
             window._window.close()
             window.web_page.deleteLater()
             window.web_view.deleteLater()
 
+        self.windows_dict.clear()
         QApplication.quit()
 
     ###########################################################################################
@@ -449,7 +464,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
@@ -459,22 +474,19 @@ 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)
         ```
         """
-        for window in self.windows:
-            if window.id == window_id:
-                return window
-        return None
+        return self.windows_dict.get(window_id)
 
     def hide_window_by_id(self, window_id: str):
         """
@@ -520,12 +532,7 @@ class Pyloid(QApplication):
         """
         window = self.get_window_by_id(window_id)
         if window:
-            window._window.show()
-            window._window.activateWindow()
-            window._window.raise_()
-            window._window.setWindowState(
-                window._window.windowState() & ~Qt.WindowMinimized | Qt.WindowActive
-            )
+            window.show()
 
     def close_window_by_id(self, window_id: str):
         """
@@ -1397,8 +1404,867 @@ class Pyloid(QApplication):
         """
 
         # 모든 윈도우에 변경사항 적용
-        for window in self.windows:
+        for window in self.windows_dict.values():
             window.web_view.page().runJavaScript(js_code)
             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):
+        """
+        Initialize the Pyloid application.
+
+        This application is designed to work in a multi-threaded environment.
+        All Qt GUI related operations are executed in the main thread's event queue regardless of the calling thread,
+        ensuring thread safety for GUI operations.
+
+        Parameters
+        ----------
+        app_name : str, required
+            The name of the application.
+        single_instance : bool, optional
+            Determines whether to run as a single instance. (Default is True)
+        data : dict, optional
+            Data to be transmitted to the frontend web engine via IPC
+
+        Notes
+        -----
+        The generated or passed `id` is transmitted to the frontend via IPC,
+        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
+
+        if command_type == "set_icon":
+            result = self.app.set_icon(params["icon_path"])
+
+        elif command_type == "create_window":
+            window = self.app.create_window(
+                title=params.get("title", ""),
+                width=params.get("width", 800),
+                height=params.get("height", 600),
+                x=params.get("x", 200),
+                y=params.get("y", 200),
+                frame=params.get("frame", True),
+                context_menu=params.get("context_menu", False),
+                dev_tools=params.get("dev_tools", False)
+            )
+            result = window
+
+        elif command_type == "run":
+            result = self.app.run()
+
+        elif command_type == "get_windows":
+            result = self.app.get_windows()
+
+        elif command_type == "show_main_window":
+            result = self.app.show_main_window()
+
+        elif command_type == "focus_main_window":
+            result = self.app.focus_main_window()
+
+        elif command_type == "show_and_focus_main_window":
+            result = self.app.show_and_focus_main_window()
+
+        elif command_type == "close_all_windows":
+            result = self.app.close_all_windows()
+
+        elif command_type == "quit":
+            result = self.app.quit()
+
+        elif command_type == "get_window_by_id":
+            result = self.app.get_window_by_id(params["window_id"])
+
+        elif command_type == "set_tray_icon":
+            result = self.app.set_tray_icon(params["tray_icon_path"])
+
+        elif command_type == "set_tray_menu_items":
+            result = self.app.set_tray_menu_items(params["tray_menu_items"])
+
+        elif command_type == "set_tray_actions":
+            result = self.app.set_tray_actions(params["actions"])
+
+        elif command_type == "show_notification":
+            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))
+
+        elif command_type == "set_tray_tooltip":
+            result = self.app.set_tray_tooltip(params["message"])
+
+        elif command_type == "set_notification_callback":
+            result = self.app.set_notification_callback(params["callback"])
+
+        elif command_type == "get_all_monitors":
+            result = self.app.get_all_monitors()
+
+        elif command_type == "get_primary_monitor":
+            result = self.app.get_primary_monitor()
+
+        elif command_type == "set_clipboard_text":
+            result = self.app.set_clipboard_text(params["text"])
+
+        elif command_type == "get_clipboard_text":
+            result = self.app.get_clipboard_text()
+
+        elif command_type == "set_clipboard_image":
+            result = self.app.set_clipboard_image(params["image"])
+
+        elif command_type == "get_clipboard_image":
+            result = self.app.get_clipboard_image()
+
+        elif command_type == "set_auto_start":
+            result = self.app.set_auto_start(params["enable"])
+
+        elif command_type == "is_auto_start":
+            result = self.app.is_auto_start()
+
+        elif command_type == "watch_file":
+            result = self.app.watch_file(params["file_path"])
+
+        elif command_type == "watch_directory":
+            result = self.app.watch_directory(params["dir_path"])
+
+        elif command_type == "stop_watching":
+            result = self.app.stop_watching(params["path"])
+
+        elif command_type == "get_watched_paths":
+            result = self.app.get_watched_paths()
+
+        elif command_type == "get_watched_files":
+            result = self.app.get_watched_files()
+
+        elif command_type == "get_watched_directories":
+            result = self.app.get_watched_directories()
+
+        elif command_type == "remove_all_watched_paths":
+            result = self.app.remove_all_watched_paths()
+
+        elif command_type == "set_file_change_callback":
+            result = self.app.set_file_change_callback(params["callback"])
+
+        elif command_type == "set_directory_change_callback":
+            result = self.app.set_directory_change_callback(params["callback"])
+
+        elif command_type == "open_file_dialog":
+            result = self.app.open_file_dialog(params.get("dir"), params.get("filter"))
+
+        elif command_type == "save_file_dialog":
+            result = self.app.save_file_dialog(params.get("dir"), params.get("filter"))
+
+        elif command_type == "select_directory_dialog":
+            result = self.app.select_directory_dialog(params.get("dir"))
+
+        else:
+            return None
+
+        self.result_signal.emit(command_id, result)
+    
+    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     
+                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.
+
+        Parameters
+        ----------
+        icon_path : str
+            Path to the new icon file
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> app.set_icon("icons/icon.png")
+        """
+        return self.execute_command("set_icon", {"icon_path": icon_path})
+    
+    def create_window(
+        self,
+        title: str,
+        width: int = 800,
+        height: int = 600,
+        x: int = 200,
+        y: int = 200,
+        frame: bool = True,
+        context_menu: bool = False,
+        dev_tools: bool = False,
+    ) -> BrowserWindow:
+        """
+        Creates a new browser window.
+
+        Parameters
+        ----------
+        title : str, required
+            Title of the window
+        width : int, optional
+            Width of the window (default is 800)
+        height : int, optional
+            Height of the window (default is 600)
+        x : int, optional
+            X coordinate of the window (default is 200)
+        y : int, optional
+            Y coordinate of the window (default is 200)
+        frame : bool, optional
+            Whether the window has a frame (default is True)
+        context_menu : bool, optional
+            Whether to use the context menu (default is False)
+        dev_tools : bool, optional
+            Whether to use developer tools (default is False)
+
+        Returns
+        -------
+        BrowserWindow
+            The created browser window object
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> window_id = app.create_window(title="New Window", width=1024, height=768)
+        """
+        params = {
+            "title": title,
+            "width": width,
+            "height": height,
+            "x": x,
+            "y": y,
+            "frame": frame,
+            "context_menu": context_menu,
+            "dev_tools": dev_tools,
+        }
+        return self.execute_command("create_window", params)
+    
+    def run(self) -> None:
+        """
+        Runs the application event loop.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> app.run()
+        """
+        return self.app.run()
+    
+    def get_windows(self) -> Dict[str, BrowserWindow]:
+        """
+        Returns a list of all browser windows.
+
+        Returns
+        -------
+        Dict[str, BrowserWindow]
+            Dictionary of all browser windows
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> windows = app.get_windows()
+        """
+        return self.execute_command("get_windows", {})
+    
+    def show_main_window(self) -> None:
+        """
+        Shows and focuses the first window.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> app.show_main_window()
+        """
+        return self.execute_command("show_main_window", {})
+    
+    def focus_main_window(self) -> None:
+        """
+        Focuses the first window.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> app.show_and_focus_main_window()
+        """
+        return self.execute_command("show_and_focus_main_window", {})
+    
+    def close_all_windows(self) -> None:
+        """
+        Closes all windows.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> app.close_all_windows()
+        """
+        return self.execute_command("close_all_windows", {})
+    
+    def quit(self) -> None:
+        """
+        Quits the application.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        window_id : str
+            The ID of the window to find
+
+        Returns
+        -------
+        Optional[BrowserWindow]
+            The window object with the given ID. Returns None if the window is not found.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        tray_icon_path : str
+            The path of the new tray icon file
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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:
+        """
+        Dynamically sets the tray menu items.
+
+        Parameters
+        ----------
+        tray_menu_items : List[Dict[str, Union[str, Callable]]]
+            The list of new tray menu items
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> menu_items = [{"label": "Open", "callback": lambda: print("Open clicked")},
+        >>>               {"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})
+    
+    def set_tray_actions(self, actions: Dict[TrayEvent, Callable]) -> bool:
+        """
+        Dynamically sets the actions for tray icon activation.
+
+        Parameters
+        ----------
+        actions : Dict[TrayEvent, Callable]
+            Dictionary with TrayEvent enum values as keys and corresponding callback functions as values
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        title : str
+            Notification title
+        message : str
+            Notification message
+
+        Examples
+        --------
+        >>> 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:
+        """
+        Dynamically sets and starts the animation for the tray icon.
+
+        Parameters
+        ----------
+        icon_frames : list of str
+            List of animation frame image paths
+        interval : int, optional
+            Frame interval in milliseconds, default is 200
+
+        Examples
+        --------
+        >>> 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})
+    
+    def set_tray_tooltip(self, message: str) -> bool:
+        """
+        Dynamically sets the tooltip for the tray icon.
+
+        Parameters
+        ----------
+        message : str
+            New tooltip message
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        callback : function
+            Callback function to be called when a notification is clicked
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> def on_notification_click():
+        >>>     print("Notification clicked")
+        >>> 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.
+
+        Returns
+        -------
+        List[Monitor]
+            List containing monitor information
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> monitors = app.get_all_monitors()
+        >>> for monitor in monitors:
+        >>>     print(monitor.info())
+        """
+        return self.execute_command("get_all_monitors", {})
+    
+    def get_primary_monitor(self) -> Monitor:
+        """
+        Returns information about the primary monitor.
+
+        Returns
+        -------
+        Monitor
+            Primary monitor information
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> primary_monitor = app.get_primary_monitor()
+        >>> print(primary_monitor.info())
+        """
+        return self.execute_command("get_primary_monitor", {})
+    
+    def set_clipboard_text(self, text: str) -> None:
+        """
+        Copies text to the clipboard.
+
+        Parameters
+        ----------
+        text : str
+            Text to copy to the clipboard
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Returns
+        -------
+        str
+            Text stored in the clipboard
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> text = app.get_clipboard_text()
+        >>> 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.
+
+        Parameters
+        ----------
+        image : Union[str, bytes, os.PathLike]
+            Path to the image file to copy to the clipboard
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Returns
+        -------
+        QImage
+            QImage object stored in the clipboard (None if no image)
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> image = app.get_clipboard_image()
+        >>> if image is not None:
+        >>>     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.
+
+        Parameters
+        ----------
+        enable : bool
+            True to enable auto start, False to disable
+
+        Returns
+        -------
+        bool or None
+            True if auto start is successfully set, False if disabled, None if not supported in non-production environment
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Returns
+        -------
+        bool
+            True if auto start is enabled, False otherwise
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> auto_start_enabled = app.is_auto_start()
+        >>> 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.
+
+        Parameters
+        ----------
+        file_path : str
+            Path to the file to watch
+
+        Returns
+        -------
+        bool
+            True if the file is successfully added to the watch list, False otherwise
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        dir_path : str
+            Path to the directory to watch
+
+        Returns
+        -------
+        bool
+            True if the directory is successfully added to the watch list, False otherwise
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        path : str
+            Path to the file or directory to stop watching
+
+        Returns
+        -------
+        bool
+            True if the path is successfully removed from the watch list, False otherwise
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Returns
+        -------
+        List[str]
+            List of all watched paths
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> app.get_watched_paths()
+        ['/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.
+
+        Returns
+        -------
+        List[str]
+            List of all watched files
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> app.get_watched_files()
+        ['/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.
+
+        Returns
+        -------
+        List[str]
+            List of all watched directories
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> app.get_watched_directories()
+        ['/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.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        callback : Callable[[str], None]
+            Function to be called when a file is changed
+
+        Examples
+        --------
+        >>> def on_file_change(file_path):
+        >>>     print(f"File changed: {file_path}")
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        callback : Callable[[str], None]
+            Function to be called when a directory is changed
+
+        Examples
+        --------
+        >>> def on_directory_change(dir_path):
+        >>>     print(f"Directory changed: {dir_path}")
+        >>> 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]:
+        """
+        Opens a file dialog to select a file to open.
+
+        Parameters
+        ----------
+        dir : str, optional
+            The initial directory that the dialog will open in.
+        filter : str, optional
+            A string that specifies the file types that can be selected.
+
+        Returns
+        -------
+        Optional[str]
+            The path of the selected file or None if no file is selected.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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]:
+        """
+        Opens a file dialog to select a file to save.
+
+        Parameters
+        ----------
+        dir : str, optional
+            The initial directory that the dialog will open in.
+        filter : str, optional
+            A string that specifies the file types that can be saved.
+
+        Returns
+        -------
+        Optional[str]
+            The path of the selected file or None if no file is selected.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> 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.
+
+        Parameters
+        ----------
+        dir : str, optional
+            The initial directory that the dialog will open in.
+
+        Returns
+        -------
+        Optional[str]
+            The path of the selected directory or None if no directory is selected.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> directory_path = app.select_directory_dialog(dir="/home/user")
+        """
+        return self.execute_command("select_directory_dialog", {"dir": dir})