pyloid 0.14.0__py3-none-any.whl → 0.14.1__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.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyloid
-Version: 0.14.0
+Version: 0.14.1
 Summary: 
 Author: aesthetics-of-record
 Author-email: 111675679+aesthetics-of-record@users.noreply.github.com

{pyloid-0.14.0.dist-info → pyloid-0.14.1.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.1.dist-info/LICENSE,sha256=F96EzotgWhhpnQTW2TcdoqrMDir1jyEo6H915tGQ-QE,11524
+pyloid-0.14.1.dist-info/METADATA,sha256=eyeeXrbtl3ramdS7Lha7bbo0y77tGFt_WGF4luLyzhs,3634
+pyloid-0.14.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+pyloid-0.14.1.dist-info/RECORD,,