pyloid 0.13.0__py3-none-any.whl → 0.14.0__py3-none-any.whl

pyloid/filewatcher.py

@@ -1,35 +1,163 @@
 from PySide6.QtCore import QFileSystemWatcher, QObject, Signal
 
 class FileWatcher(QObject):
+    """
+    FileWatcher class for monitoring file and directory changes.
+
+    This class automatically detects changes in specific files or directories and provides notifications.
+
+    Attributes
+    ----------
+    file_changed : Signal
+        Signal emitted when a file is changed.
+    directory_changed : Signal
+        Signal emitted when a directory is changed.
+
+    Methods
+    -------
+    add_path(path)
+        Adds a file or directory to the watch list.
+    remove_path(path)
+        Removes a file or directory from the watch list.
+    get_watched_paths()
+        Returns all currently watched paths (files and directories).
+    get_watched_files()
+        Returns all currently watched files.
+    get_watched_directories()
+        Returns all currently watched directories.
+    remove_all_paths()
+        Removes all paths from the watch list.
+    """
+
     file_changed = Signal(str)
     directory_changed = Signal(str)
 
     def __init__(self):
+        """
+        Initializes the FileWatcher object.
+        """
         super().__init__()
         self.watcher = QFileSystemWatcher()
         self.watcher.fileChanged.connect(self.file_changed)
         self.watcher.directoryChanged.connect(self.directory_changed)
 
     def add_path(self, path):
-        """Add a file or directory to the watch list."""
+        """
+        Adds a file or directory to the watch list.
+
+        Parameters
+        ----------
+        path : str
+            The path of the file or directory to watch.
+
+        Returns
+        -------
+        bool
+            Whether the path was successfully added.
+
+        Examples
+        --------
+        >>> watcher = FileWatcher()
+        >>> result = watcher.add_path("/path/to/file_or_directory")
+        >>> if result:
+        >>>     print("Watch started")
+        >>> else:
+        >>>     print("Failed to start watching")
+        """
         return self.watcher.addPath(path)
 
     def remove_path(self, path):
-        """Remove a file or directory from the watch list."""
+        """
+        Removes a file or directory from the watch list.
+
+        Parameters
+        ----------
+        path : str
+            The path of the file or directory to remove.
+
+        Returns
+        -------
+        bool
+            Whether the path was successfully removed.
+
+        Examples
+        --------
+        >>> watcher = FileWatcher()
+        >>> result = watcher.remove_path("/path/to/file_or_directory")
+        >>> if result:
+        >>>     print("Successfully stopped watching")
+        >>> else:
+        >>>     print("Failed to stop watching")
+        """
         return self.watcher.removePath(path)
 
     def get_watched_paths(self):
-        """Return all currently watched paths (files + directories)."""
+        """
+        Returns all currently watched paths (files and directories).
+
+        Returns
+        -------
+        list of str
+            All currently watched paths.
+
+        Examples
+        --------
+        >>> watcher = FileWatcher()
+        >>> paths = watcher.get_watched_paths()
+        >>> print("Watched paths:", paths)
+        """
         return self.watcher.files() + self.watcher.directories()
-      
+
     def get_watched_files(self):
-        """Return all currently watched files."""
+        """
+        Returns all currently watched files.
+
+        Returns
+        -------
+        list of str
+            All currently watched files.
+
+        Examples
+        --------
+        >>> watcher = FileWatcher()
+        >>> files = watcher.get_watched_files()
+        >>> print("Watched files:", files)
+        """
         return self.watcher.files()
-    
+
     def get_watched_directories(self):
-        """Return all currently watched directories."""
+        """
+        Returns all currently watched directories.
+
+        Returns
+        -------
+        list of str
+            All currently watched directories.
+
+        Examples
+        --------
+        >>> watcher = FileWatcher()
+        >>> directories = watcher.get_watched_directories()
+        >>> print("Watched directories:", directories)
+        """
         return self.watcher.directories()
-    
+
     def remove_all_paths(self):
-        """Remove all paths from the watch list."""
+        """
+        Removes all paths from the watch list.
+
+        Returns
+        -------
+        bool
+            Whether all paths were successfully removed.
+
+        Examples
+        --------
+        >>> watcher = FileWatcher()
+        >>> result = watcher.remove_all_paths()
+        >>> if result:
+        >>>     print("Successfully removed all paths")
+        >>> else:
+        >>>     print("Failed to remove all paths")
+        """
         return self.watcher.removePaths(self.get_watched_paths())

pyloid/js_api/event_api.py

@@ -0,0 +1,25 @@
+from ..pyloid import Pyloid
+from ..api import PyloidAPI, Bridge
+from typing import Optional, Callable
+
+
+# class EventAPI(PyloidAPI):
+#     def __init__(self, window_id: str, app):
+#         super().__init__()
+#         self.window_id: str = window_id
+#         self.app: PylonApp = app
+#         self.subscribers = {}
+
+#     @Bridge(str, Callable)
+#     def on(self, event_name: str, callback: Callable):
+#         """특정 이벤트를 구독합니다."""
+#         if event_name not in self.subscribers:
+#             self.subscribers[event_name] = []
+#         self.subscribers[event_name].append(callback)
+
+#     @Bridge(str, result=Optional[str])
+#     def emit(self, event_name: str, *args, **kwargs):
+#         """다른 윈도우로 특정 이벤트를 보냅니다."""
+#         if event_name in self.subscribers:
+#             for callback in self.subscribers[event_name]:
+#                 callback(*args, **kwargs)

pyloid/js_api/window_api.py

@@ -0,0 +1,166 @@
+from ..api import PyloidAPI, Bridge
+from typing import Optional
+
+class WindowAPI(PyloidAPI):
+    def __init__(self, window_id: str, app):
+        super().__init__()
+        self.window_id: str = window_id
+        self.app = app
+
+    @Bridge(result=str)
+    def getWindowId(self):
+        """Returns the current window ID."""
+        return self.window_id
+
+    @Bridge(result=dict)
+    def getWindowProperties(self):
+        """Returns the properties of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        window_properties = window.get_window_properties()
+        return window_properties
+
+    @Bridge()
+    def close(self):
+        """Closes the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.close()
+
+    @Bridge()
+    def hide(self):
+        """Hides the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.hide()
+
+    @Bridge()
+    def show(self):
+        """Shows and focuses the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.show()
+
+    @Bridge()
+    def toggleFullscreen(self):
+        """Toggles fullscreen mode for the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.toggle_fullscreen()
+
+    @Bridge()
+    def minimize(self):
+        """Minimizes the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.minimize()
+
+    @Bridge()
+    def maximize(self):
+        """Maximizes the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.maximize()
+
+    @Bridge()
+    def unmaximize(self):
+        """Restores the window to its normal state."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.unmaximize()
+
+    @Bridge(str)
+    def setTitle(self, title: str):
+        """Sets the title of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.set_title(title)
+
+    @Bridge(int, int)
+    def setSize(self, width: int, height: int):
+        """Sets the size of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.set_size(width, height)
+
+    @Bridge(int, int)
+    def setPosition(self, x: int, y: int):
+        """Sets the position of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.set_position(x, y)
+
+    @Bridge(bool)
+    def setFrame(self, frame: bool):
+        """Sets the frame of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.set_frame(frame)
+
+    @Bridge(bool)
+    def setContextMenu(self, context_menu: bool):
+        """Sets the context menu of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.set_context_menu(context_menu)
+
+    @Bridge(bool)
+    def setDevTools(self, enable: bool):
+        """Sets the developer tools of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.set_dev_tools(enable)
+
+    @Bridge(str, result=Optional[str])
+    def capture(self, save_path: str) -> Optional[str]:
+        """Captures the current window."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            return window.capture(save_path)
+        return None
+
+    @Bridge(result=bool)
+    def getFrame(self):
+        """Returns whether the window has a frame."""
+        window = self.app.get_window_by_id(self.window_id)
+        return window.frame if window else False
+
+    @Bridge(result=bool)
+    def getContextMenu(self):
+        """Returns whether the window has a context menu."""
+        window = self.app.get_window_by_id(self.window_id)
+        return window.context_menu if window else False
+
+    @Bridge(result=bool)
+    def getDevTools(self):
+        """Returns whether the window has developer tools."""
+        window = self.app.get_window_by_id(self.window_id)
+        return window.dev_tools if window else False
+
+    @Bridge(result=str)
+    def getTitle(self):
+        """Returns the title of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        return window.title if window else ""
+
+    @Bridge(result=dict)
+    def getSize(self):
+        """Returns the size of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        return (
+            {"width": window.width, "height": window.height}
+            if window
+            else {"width": 0, "height": 0}
+        )
+
+    @Bridge(result=dict)
+    def getPosition(self):
+        """Returns the position of the window."""
+        window = self.app.get_window_by_id(self.window_id)
+        return {"x": window.x, "y": window.y} if window else {"x": 0, "y": 0}
+
+    @Bridge()
+    def startSystemDrag(self):
+        """Starts the system drag."""
+        window = self.app.get_window_by_id(self.window_id)
+        if window:
+            window.web_view.start_system_drag()