pyloid 0.24.5__py3-none-any.whl → 0.24.6__py3-none-any.whl

pyloid/browser_window.py

@@ -317,6 +317,7 @@ class _BrowserWindow:
         dev_tools: bool = False,
         # js_apis: List[PyloidAPI] = [],
         rpc: Optional[PyloidRPC] = None,
+        transparent: bool = False,
     ):
         ###########################################################################################
         self.id = str(uuid.uuid4())  # Generate unique ID
@@ -344,6 +345,7 @@ class _BrowserWindow:
         self.x = x
         self.y = y
         self.frame = frame
+        self.transparent = transparent
         self.context_menu = context_menu
         self.dev_tools = dev_tools
 
@@ -413,6 +415,20 @@ class _BrowserWindow:
 
         self._window.show()
 
+    def _apply_transparency(self):
+        """Applies transparency settings based on self.transparent and self.frame."""
+        if self.transparent:
+            # It's generally better if FramelessWindowHint is set for full transparency,
+            # but WA_TranslucentBackground can still have effects otherwise.
+            self._window.setAttribute(Qt.WA_TranslucentBackground, True)
+            self.web_view.setAttribute(Qt.WA_TranslucentBackground, True)
+            self.web_view.page().setBackgroundColor(Qt.transparent)
+        else:
+            self._window.setAttribute(Qt.WA_TranslucentBackground, False)
+            self.web_view.setAttribute(Qt.WA_TranslucentBackground, False)
+            # Reset background color for web_view page, QColor() or a specific color like Qt.white
+            self.web_view.page().setBackgroundColor(Qt.white)
+
     def _load(self):
         self.set_title(self.title)
 
@@ -491,9 +507,11 @@ class _BrowserWindow:
         # Remove title bar and borders (if needed)
         if not self.frame:
             self._window.setWindowFlags(Qt.FramelessWindowHint)
-            self._window.setAttribute(Qt.WA_TranslucentBackground)
-            self.web_view.setAttribute(Qt.WA_TranslucentBackground)
-            self.web_view.page().setBackgroundColor(Qt.transparent)
+        else:
+            # Ensure standard window flags if frame is True, otherwise flags might be missing
+            self._window.setWindowFlags(Qt.Window)
+
+        self._apply_transparency()
 
         # Disable default context menu
         if not self.context_menu:
@@ -817,12 +835,43 @@ class _BrowserWindow:
             self._window.setWindowFlags(Qt.Window)
         else:
             self._window.setWindowFlags(Qt.FramelessWindowHint)
-            self._window.setAttribute(Qt.WA_TranslucentBackground)
-            self.web_view.setAttribute(Qt.WA_TranslucentBackground)
-            self.web_view.page().setBackgroundColor(Qt.transparent)
+
+        self._apply_transparency()
+
         if was_visible:
             self._window.show()
 
+    def set_transparent(self, transparent: bool):
+        """
+        Sets the transparency of the window.
+
+        Parameters
+        ----------
+        transparent : bool
+            If True, the window background will be transparent.
+            If False, it will be opaque.
+
+        Examples
+        --------
+        >>> window.set_transparent(True)
+        """
+        self.transparent = transparent
+        self._apply_transparency()
+
+        if self._window.isVisible():
+            self._window.show()
+
+    def get_transparent(self) -> bool:
+        """
+        Returns the transparency state of the window.
+
+        Returns
+        -------
+        bool
+            True if the window is set to be transparent, False otherwise.
+        """
+        return self.transparent
+
     def set_context_menu(self, context_menu: bool):
         """
         Sets the context menu of the window.
@@ -1296,6 +1345,7 @@ class _BrowserWindow:
             "x": self.x,
             "y": self.y,
             "frame": self.frame,
+            "transparent": self.transparent,  # Add transparent to properties
             "context_menu": self.context_menu,
             "dev_tools": self.dev_tools,
         }
@@ -2069,14 +2119,26 @@ class BrowserWindow(QObject):
         height: int,
         x: int,
         y: int,
-        frame: bool,
-        context_menu: bool,
-        dev_tools: bool,
+        frame: bool = True,
+        context_menu: bool = False,
+        dev_tools: bool = False,
         rpc: Optional[PyloidRPC] = None,
+        transparent: bool = False,
     ):
         super().__init__()
         self._window = _BrowserWindow(
-            app, self, title, width, height, x, y, frame, context_menu, dev_tools, rpc
+            app,
+            self,
+            title,
+            width,
+            height,
+            x,
+            y,
+            frame,
+            context_menu,
+            dev_tools,
+            rpc,
+            transparent,
         )
         self.command_signal.connect(self._handle_command)
 
@@ -2112,6 +2174,10 @@ class BrowserWindow(QObject):
             result = self._window.set_position_by_anchor(params["anchor"])
         elif command_type == "set_frame":
             result = self._window.set_frame(params["frame"])
+        elif command_type == "set_transparent":
+            result = self._window.set_transparent(params["transparent"])
+        elif command_type == "get_transparent":
+            result = self._window.get_transparent()
         elif command_type == "set_context_menu":
             result = self._window.set_context_menu(params["context_menu"])
         elif command_type == "set_dev_tools":
@@ -2395,6 +2461,34 @@ class BrowserWindow(QObject):
         """
         return self.execute_command("set_frame", {"frame": frame})
 
+    # TODO: Can't use this function in runtime
+    # def set_transparent(self, transparent: bool) -> None:
+    #     """
+    #     Sets the transparency of the window.
+
+    #     Parameters
+    #     ----------
+    #     transparent : bool
+    #         If True, the window background will be transparent.
+    #         If False, it will be opaque.
+
+    #     Examples
+    #     --------
+    #     >>> window.set_transparent(True)
+    #     """
+    #     return self.execute_command("set_transparent", {"transparent": transparent})
+
+    def get_transparent(self) -> bool:
+        """
+        Returns the transparency state of the window.
+
+        Returns
+        -------
+        bool
+            True if the window is set to be transparent, False otherwise.
+        """
+        return self.execute_command("get_transparent", {})
+
     def set_context_menu(self, context_menu: bool) -> None:
         """
         Sets the context menu of the window.

pyloid/pyloid.py

@@ -243,6 +243,7 @@ class _Pyloid(QApplication):
         context_menu: bool = False,
         dev_tools: bool = False,
         rpc: Optional[PyloidRPC] = None,
+        transparent: bool = False,
     ) -> BrowserWindow:
         """
         Creates a new browser window.
@@ -267,6 +268,8 @@ class _Pyloid(QApplication):
             Whether to use developer tools (default is False)
         rpc : PyloidRPC, optional
             The RPC server instance to be used in the window
+        transparent : bool, optional
+            Whether the window is transparent (default is False)
 
         Returns
         -------
@@ -290,6 +293,7 @@ class _Pyloid(QApplication):
             context_menu,
             dev_tools,
             rpc,
+            transparent,
         )
         self.windows_dict[window._window.id] = window
         # latest_window_id = list(self.windows_dict.keys())[-1]
@@ -1654,6 +1658,7 @@ class Pyloid(QObject):
                 context_menu=params.get("context_menu", False),
                 dev_tools=params.get("dev_tools", False),
                 rpc=params.get("rpc", None),
+                transparent=params.get("transparent", False),
             )
             result = window
 
@@ -1829,6 +1834,7 @@ class Pyloid(QObject):
         context_menu: bool = False,
         dev_tools: bool = False,
         rpc: Optional[PyloidRPC] = None,
+        transparent: bool = False,
     ) -> BrowserWindow:
         """
         Creates a new browser window.
@@ -1853,6 +1859,8 @@ class Pyloid(QObject):
             Whether to use developer tools (default is False)
         rpc : PyloidRPC, optional
             The RPC server instance to be used in the window
+        transparent : bool, optional
+            Whether the window is transparent (default is False)
 
         Returns
         -------
@@ -1874,6 +1882,7 @@ class Pyloid(QObject):
             "context_menu": context_menu,
             "dev_tools": dev_tools,
             "rpc": rpc,
+            "transparent": transparent,
         }
         return self.execute_command("create_window", params)
 

{pyloid-0.24.5.dist-info → pyloid-0.24.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyloid
-Version: 0.24.5
+Version: 0.24.6
 Summary: 
 Author: aesthetics-of-record
 Author-email: 111675679+aesthetics-of-record@users.noreply.github.com

{pyloid-0.24.5.dist-info → pyloid-0.24.6.dist-info}/RECORD

@@ -1,14 +1,14 @@
 pyloid/__init__.py,sha256=YKwMCSOds1QVi9N7EGfY0Z7BEjJn8j6HGqRblZlZClA,235
 pyloid/api.py,sha256=A61Kmddh8BlpT3LfA6NbPQNzFmD95vQ4WKX53oKsGYU,2419
 pyloid/autostart.py,sha256=K7DQYl4LHItvPp0bt1V9WwaaZmVSTeGvadkcwG-KKrI,3899
-pyloid/browser_window.py,sha256=ujdygs3Oq1GXH-lh9u1rStez6Zckuf-X1oIPRR1Mb5M,101262
+pyloid/browser_window.py,sha256=EkYcqwdX_WC2woIUcElwI7E4BgpXk_a_hgJJcDS1vc4,104226
 pyloid/custom/titlebar.py,sha256=itzK9pJbZMQ7BKca9kdbuHMffurrw15UijR6OU03Xsk,3894
 pyloid/filewatcher.py,sha256=3M5zWVUf1OhlkWJcDFC8ZA9agO4Q-U8WdgGpy6kaVz0,4601
 pyloid/js_api/base.py,sha256=Z3ID-4AJ0eHusmljRltlSaK4m2RKvRNfmqX76NLF77o,8585
 pyloid/js_api/event_api.py,sha256=w0z1DcmwcmseqfcoZWgsQmFC2iBCgTMVJubTaHeXI1c,957
 pyloid/js_api/window_api.py,sha256=-isphU3m2wGB5U0yZrSuK_4XiBz2mG45HsjYTUq7Fxs,7348
 pyloid/monitor.py,sha256=1mXvHm5deohnNlTLcRx4sT4x-stnOIb0dUQnnxN50Uo,28295
-pyloid/pyloid.py,sha256=y3kHGahvNkJ_4vMESBVHh1j3OU9foM4GLQF2MID3Vhg,84099
+pyloid/pyloid.py,sha256=DSHpMRDW4WvZgAAo2nJMesMJuOkNTVEEsDhCFIvjB5w,84509
 pyloid/rpc.py,sha256=OnF1sRGok9OJ-Q5519eQARD4oZTohyPhsPAT2Mg4_Gg,20377
 pyloid/serve.py,sha256=wJIBqiLr1-8FvBdV3yybeBtVXsu94FfWYKjHL0eQ68s,1444
 pyloid/store.py,sha256=teoa-HYzwm93Rivcw3AhKw6rAmQqQ_kmF6XYSkC3G_I,4541
@@ -17,7 +17,7 @@ pyloid/timer.py,sha256=RqMsChFUd93cxMVgkHWiIKrci0QDTBgJSTULnAtYT8M,8712
 pyloid/tray.py,sha256=D12opVEc2wc2T4tK9epaN1oOdeziScsIVNM2uCN7C-A,1710
 pyloid/url_interceptor.py,sha256=AFjPANDELc9-E-1TnVvkNVc-JZBJYf0677dWQ8LDaqw,726
 pyloid/utils.py,sha256=J6owgVE1YDOEfcOPmoP9m9Q6nbYDyNEo9uqPsJs5p5g,6644
-pyloid-0.24.5.dist-info/LICENSE,sha256=MTYF-6xpRekyTUglRweWtbfbwBL1I_3Bgfbm_SNOuI8,11525
-pyloid-0.24.5.dist-info/METADATA,sha256=zn8TgAWx2pKIHGsJOJvpRr0IUL42VQiHXmV8DNizAvY,2204
-pyloid-0.24.5.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-pyloid-0.24.5.dist-info/RECORD,,
+pyloid-0.24.6.dist-info/LICENSE,sha256=MTYF-6xpRekyTUglRweWtbfbwBL1I_3Bgfbm_SNOuI8,11525
+pyloid-0.24.6.dist-info/METADATA,sha256=MUdtV5-iru99UsWv46KP_VVAtmFu3f-nP6NAreUTy1g,2204
+pyloid-0.24.6.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+pyloid-0.24.6.dist-info/RECORD,,