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

pyloid/pyloid.py

@@ -4,6 +4,7 @@ from PySide6.QtWidgets import (
     QApplication,
     QSystemTrayIcon,
     QMenu,
+    QFileDialog,
 )
 from PySide6.QtGui import (
     QIcon,
@@ -1240,3 +1241,83 @@ class Pyloid(QApplication):
         """
         self.file_watcher.directory_changed.connect(callback)
 
+    ###########################################################################################
+    # File dialog
+    ###########################################################################################
+    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. If None, the dialog will open in the current working directory.
+        filter : str, optional
+            A string that specifies the file types that can be selected. For example, "Text Files (*.txt);;All Files (*)".
+
+        Returns
+        -------
+        Optional[str]
+            The path of the selected file. Returns 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)")
+        >>> if file_path:
+        >>>     print("Selected file:", file_path)
+        """
+        file_path, _ = QFileDialog.getOpenFileName(None, dir=dir, filter=filter)
+        return file_path if file_path else None
+
+    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. If None, the dialog will open in the current working directory.
+        filter : str, optional
+            A string that specifies the file types that can be saved. For example, "Text Files (*.txt);;All Files (*)".
+
+        Returns
+        -------
+        Optional[str]
+            The path of the selected file. Returns 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)")
+        >>> if file_path:
+        >>>     print("File will be saved to:", file_path)
+        """
+        file_path, _ = QFileDialog.getSaveFileName(None, dir=dir, filter=filter)
+        return file_path if file_path else None
+
+    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. If None, the dialog will open in the current working directory.
+
+        Returns
+        -------
+        Optional[str]
+            The path of the selected directory. Returns None if no directory is selected.
+
+        Examples
+        --------
+        >>> app = Pyloid(app_name="Pyloid-App")
+        >>> directory_path = app.select_directory_dialog(dir="/home/user")
+        >>> if directory_path:
+        >>>     print("Selected directory:", directory_path)
+        """
+        directory_path = QFileDialog.getExistingDirectory(None, dir=dir)
+        return directory_path if directory_path else None
+
+

{pyloid-0.14.0.dist-info → pyloid-0.14.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyloid
-Version: 0.14.0
+Version: 0.14.2
 Summary: 
 Author: aesthetics-of-record
 Author-email: 111675679+aesthetics-of-record@users.noreply.github.com
@@ -23,18 +23,22 @@ Pyloid is the Python backend version of Electron and Tauri, designed to simplify
 
 With Pyloid, you can leverage the full power of Python in your desktop applications. Its simplicity and flexibility make it the perfect choice for both beginners and experienced developers looking for a Python-focused alternative to Electron or Tauri. It is especially optimized for building AI-powered desktop applications.
 
-## Key Features 🚀
+### Key Features 🚀
 
 - **Web-based GUI Generation**: Easily build the UI for desktop applications using HTML, CSS, and JavaScript.
 - **System Tray Icon Support** 🖥️: Implement system tray icons with ease to add various utilities to your app.
 - **Multi-Window Management**: Create and manage multiple windows effortlessly.
 - **Bridge API between Python and JavaScript** 🌉: Facilitates smooth communication between Python and JavaScript to integrate various functionalities.
-- **Single Instance Application Support**: Prevents duplicate app instances and manages applications with a single instance.
-- **Comprehensive Desktop App Features**: Provides a wide range of functions for desktop apps, including monitor management, desktop capture, notifications, shortcuts, and clipboard access.
+- **Single Instance Application / Multi Instance Application Support**: Supports both single and multi instance applications.
+- **Comprehensive Desktop App Features**: Provides a wide range of functions for desktop apps, including monitor management, desktop capture, notifications, shortcuts, auto start, filewatcher and clipboard access.
 - **Clean and Intuitive Code Structure**: Offers a simple and readable code structure that enhances developer productivity.
 - **Live UI Development Experience**: Experience real-time UI updates as you modify your code, providing an efficient development workflow.
-- **Cross-Platform Support**: Runs on various operating systems, including Windows, macOS, and Linux.
+- **Cross-Platform Support**: Runs on various operating systems, including Windows, macOS, and Linux, Raspberry Pi OS.
 - **Integration with Various Frontend Libraries**: Supports integration with frontend frameworks like HTML/CSS/JS and React.
+- **Window Customization**: Customize window title bar and draggable region.
+
+* **Direct Utilization of PySide6 Features** 🛠️: Leverage almost all features of PySide6 to customize and extend the Pyloid API, offering limitless possibilities.
+* **Detailed Numpy-style Docstrings** 📚: Provide detailed and clear Numpy-style docstrings that greatly enhance the development experience, making it easy to understand and apply the API.
 
 ## Documentation 📚
 

{pyloid-0.14.0.dist-info → pyloid-0.14.2.dist-info}/RECORD

@@ -7,11 +7,11 @@ pyloid/filewatcher.py,sha256=3M5zWVUf1OhlkWJcDFC8ZA9agO4Q-U8WdgGpy6kaVz0,4601
 pyloid/js_api/event_api.py,sha256=_52yyBonqecmMvJpFW7OMNi_jX8Nrteqw_kI6r-DGG0,951
 pyloid/js_api/window_api.py,sha256=JDAFIMMiw75PNcyO8_163PJdRY-dvFNBO3IN0TA-Xsw,5383
 pyloid/monitor.py,sha256=nmcoOmlHeTysrZVT5mmL92ASbqMg8aH-hQg35qKWi0M,27540
-pyloid/pyloid.py,sha256=e_5G4wdkhZchPiwgydo2w5IIIpj-ZP8ge4ZQp9lmcXs,37889
+pyloid/pyloid.py,sha256=3YymePkpM_hKPzvHSSgELuSHkmbDsKW60HnRwwBMY7A,41178
 pyloid/timer.py,sha256=RqMsChFUd93cxMVgkHWiIKrci0QDTBgJSTULnAtYT8M,8712
 pyloid/tray.py,sha256=D12opVEc2wc2T4tK9epaN1oOdeziScsIVNM2uCN7C-A,1710
 pyloid/utils.py,sha256=VGZE2liY8_AElEqxVe1YLbk3fWlcAevpRc6oOTTgi-U,1927
-pyloid-0.14.0.dist-info/LICENSE,sha256=F96EzotgWhhpnQTW2TcdoqrMDir1jyEo6H915tGQ-QE,11524
-pyloid-0.14.0.dist-info/METADATA,sha256=QhNFQVNOyvDMqwD2QIz4RMpdxP_QUWkimmLaUsPO_jE,3634
-pyloid-0.14.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-pyloid-0.14.0.dist-info/RECORD,,
+pyloid-0.14.2.dist-info/LICENSE,sha256=F96EzotgWhhpnQTW2TcdoqrMDir1jyEo6H915tGQ-QE,11524
+pyloid-0.14.2.dist-info/METADATA,sha256=q1n-HGrGsAzDyw8CN3FEDA4VmtVX0IAN6JlrwI5rssc,4114
+pyloid-0.14.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+pyloid-0.14.2.dist-info/RECORD,,