pyloid 0.15.1__py3-none-any.whl → 0.16.0__py3-none-any.whl

pyloid/browser_window.py

@@ -22,6 +22,8 @@ from PySide6.QtWidgets import (
 )
 from .custom.titlebar import CustomTitleBar
 from .js_api.window_api import WindowAPI
+from PySide6.QtGui import QPixmap, QMovie
+from PySide6.QtWidgets import QSplashScreen, QLabel
 
 
 # 어차피 load 부분에만 쓰이니까 나중에 분리해서 load 위에서 선언하자.
@@ -341,6 +343,10 @@ class BrowserWindow:
                 ]
             )
             self.web_view.page().runJavaScript(js_code % js_api_init)
+
+            # if splash screen is set, close it when the page is loaded
+            if self.close_on_load and self.splash_screen:
+                self.close_splash_screen()
         else:
             pass
 
@@ -1261,3 +1267,229 @@ class BrowserWindow:
         ```
         """
         return self.resizable
+
+    ###########################################################################################
+    # For Custom Pyside6 Features
+    ###########################################################################################
+    def get_QMainWindow(self) -> QMainWindow:
+        """
+        Returns the QMainWindow object of the window.
+
+        you can use all the features of QMainWindow for customizing the window.
+
+        Returns
+        -------
+        QMainWindow
+            QMainWindow object of the window
+
+        Examples
+        --------
+        ```python
+        from PySide6.QtCore import Qt
+        from pyloid import Pyloid
+
+        app = Pyloid(app_name="Pyloid-App")
+
+        window = app.create_window("pyloid-window")
+        qmain = window.get_QMainWindow()
+
+        qmain.setWindowFlags(qmain.windowFlags() | Qt.WindowStaysOnTopHint) # window stays on top
+        ```
+        """
+        return self._window
+
+    ###########################################################################################
+    # QMainWindow flags
+    ###########################################################################################
+    def set_window_stay_on_top(self, on_top: bool):
+        """
+        Sets the window stay on top flag of the window.
+
+        Parameters
+        ----------
+        on_top : bool
+            True to keep the window on top, False otherwise
+
+        Examples
+        --------
+        ```python
+        window.set_window_stay_on_top(True)
+        window.set_window_stay_on_top(False)
+        ```
+        """
+        flags = self._window.windowFlags()
+        if on_top:
+            flags |= Qt.WindowStaysOnTopHint
+        else:
+            flags &= ~Qt.WindowStaysOnTopHint
+
+        # Maintain existing flags while only changing WindowStaysOnTopHint
+        # Explicitly add the close button
+        flags |= Qt.WindowCloseButtonHint
+
+        self._window.setWindowFlags(flags)
+
+        # Show the window again to apply the changes
+        self._window.show()
+
+    def set_window_stay_on_bottom(self, on_bottom: bool):
+        """
+        Sets the window stay on bottom flag of the window.
+
+        Parameters
+        ----------
+        on_bottom : bool
+            True to keep the window on bottom, False otherwise
+
+        Examples
+        --------
+        ```python
+        window.set_window_stay_on_bottom(True)
+        window.set_window_stay_on_bottom(False)
+        ```
+        """
+        flags = self._window.windowFlags()
+        if on_bottom:
+            flags |= Qt.WindowStaysOnBottomHint
+        else:
+            flags &= ~Qt.WindowStaysOnBottomHint
+
+        # Maintain existing flags while only changing WindowStaysOnBottomHint
+        # Explicitly add the close button
+        flags |= Qt.WindowCloseButtonHint
+
+        self._window.setWindowFlags(flags)
+
+        # Show the window again to apply the changes
+        self._window.show()
+
+    ###########################################################################################
+    # Splash Screen
+    ###########################################################################################
+    def set_static_image_splash_screen(
+        self,
+        image_path: str,
+        close_on_load: bool = True,
+        stay_on_top: bool = True,
+        clickable: bool = True,
+    ):
+        """
+        Sets the static image splash screen of the window.
+
+        Parameters
+        ----------
+        image_path : str
+            Path to the image file
+        close_on_load : bool, optional
+            True to close the splash screen when the page is loaded, False otherwise (default is True)
+        stay_on_top : bool, optional
+            True to keep the splash screen on top, False otherwise (default is True)
+        clickable : bool, optional
+            True to make the splash screen clickable, False otherwise (default is True)
+            if clickable is True, you can click the splash screen to close it.
+
+        Examples
+        --------
+        ```python
+        window.set_image_splash_screen("./assets/loading.png", close_on_load=True, stay_on_top=True)
+        ```
+        """
+        pixmap = QPixmap(image_path)
+
+        if not clickable:
+
+            class NonClickableSplashScreen(QSplashScreen):
+                def mousePressEvent(self, event):
+                    pass  # Ignore click events
+
+            splash = NonClickableSplashScreen(
+                pixmap, Qt.WindowStaysOnTopHint if stay_on_top else Qt.WindowType(0)
+            )
+        else:
+            splash = QSplashScreen(
+                pixmap, Qt.WindowStaysOnTopHint if stay_on_top else Qt.WindowType(0)
+            )
+
+        self.close_on_load = close_on_load
+        self.splash_screen = splash
+        self.splash_screen.show()
+
+    def set_gif_splash_screen(
+        self,
+        gif_path: str,
+        close_on_load: bool = True,
+        stay_on_top: bool = True,
+        clickable: bool = True,
+    ):
+        """
+        Sets the gif splash screen of the window.
+
+        Parameters
+        ----------
+        gif_path : str
+            Path to the gif file
+        close_on_load : bool, optional
+            True to close the splash screen when the page is loaded, False otherwise (default is True)
+        stay_on_top : bool, optional
+            True to keep the splash screen on top, False otherwise (default is True)
+        clickable : bool, optional
+            True to make the splash screen clickable, False otherwise (default is True)
+            if clickable is True, you can click the splash screen to close it.
+
+        Examples
+        --------
+        ```python
+        window.set_gif_splash_screen("./assets/loading.gif", close_on_load=True, stay_on_top=True)
+        ```
+        """
+
+        if not clickable:
+
+            class NonClickableSplashScreen(QSplashScreen):
+                def mousePressEvent(self, event):
+                    pass  # Ignore click events
+
+            # Create splash screen (using animated GIF)
+            splash = NonClickableSplashScreen(
+                QPixmap(1, 1),
+                Qt.WindowStaysOnTopHint if stay_on_top else Qt.WindowType(0),
+            )  # Start with 1x1 transparent pixmap
+        else:
+            splash = QSplashScreen(
+                QPixmap(1, 1),
+                Qt.WindowStaysOnTopHint if stay_on_top else Qt.WindowType(0),
+            )
+
+        splash.setAttribute(Qt.WA_TranslucentBackground)
+
+        # Create QLabel for GIF animation
+        label = QLabel(splash)
+        movie = QMovie(gif_path)
+        label.setMovie(movie)
+
+        # Start animation and show splash screen
+        movie.start()
+        splash.show()
+
+        # Adjust splash screen size to match GIF size
+        movie.frameChanged.connect(
+            lambda: splash.setFixedSize(movie.currentPixmap().size())
+        )
+
+        self.close_on_load = close_on_load
+        self.splash_screen = splash
+
+    def close_splash_screen(self):
+        """
+        Closes the splash screen if it exists.
+
+        Examples
+        --------
+        ```python
+        window.close_splash_screen()
+        ```
+        """
+        if hasattr(self, "splash_screen") and self.splash_screen:
+            self.splash_screen.close()
+            self.close_on_load = None
+            self.splash_screen = None

{pyloid-0.15.1.dist-info → pyloid-0.16.0.dist-info}/METADATA

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

{pyloid-0.15.1.dist-info → pyloid-0.16.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 pyloid/__init__.py,sha256=OOPhOKNQVmAM8hnfTeE7lHzxb8LsFNcgegBAvDrA-vY,293
 pyloid/api.py,sha256=np0pFVUlen_GpN0svY0A3awY_ZjVFk-RpHQZZKFUMuo,2157
 pyloid/autostart.py,sha256=K7DQYl4LHItvPp0bt1V9WwaaZmVSTeGvadkcwG-KKrI,3899
-pyloid/browser_window.py,sha256=L2dKvXzSVol1pKgsUf4bJD6MYBL7OJEtdWwGdgZHR_4,39513
+pyloid/browser_window.py,sha256=-w7Y5BFSjrDzP-DrcVBaU8bYSaTAk0wJjiM1dLaLSk0,47293
 pyloid/custom/titlebar.py,sha256=itzK9pJbZMQ7BKca9kdbuHMffurrw15UijR6OU03Xsk,3894
 pyloid/filewatcher.py,sha256=3M5zWVUf1OhlkWJcDFC8ZA9agO4Q-U8WdgGpy6kaVz0,4601
 pyloid/js_api/event_api.py,sha256=_52yyBonqecmMvJpFW7OMNi_jX8Nrteqw_kI6r-DGG0,951
@@ -11,7 +11,7 @@ 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.15.1.dist-info/LICENSE,sha256=MTYF-6xpRekyTUglRweWtbfbwBL1I_3Bgfbm_SNOuI8,11525
-pyloid-0.15.1.dist-info/METADATA,sha256=bJP9CLF9fBirFlzPGLCl__s5cw9fb1pmK5wtXs8MmOE,3050
-pyloid-0.15.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-pyloid-0.15.1.dist-info/RECORD,,
+pyloid-0.16.0.dist-info/LICENSE,sha256=MTYF-6xpRekyTUglRweWtbfbwBL1I_3Bgfbm_SNOuI8,11525
+pyloid-0.16.0.dist-info/METADATA,sha256=t5HJxUTwX3uls5dQd_x5tlu63z29C1fCkWDa4evyttg,3050
+pyloid-0.16.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+pyloid-0.16.0.dist-info/RECORD,,