pgwidgets-python 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

pgwidgets/async_/application.py

@@ -1557,6 +1557,15 @@ class Application:
             }
         self._broadcast_font_msg(self._font_default_msg())
 
+    def open_url(self, url):
+        """Ask the connected browser(s) to open *url* in a new tab/window.
+
+        Fire-and-forget app-level command; opens the link in the *user's*
+        browser rather than on the host running Python.  (Reuses the
+        generic per-session broadcast helper.)
+        """
+        self._broadcast_font_msg({"type": "open-url", "url": str(url)})
+
     def _font_register_msg(self, entry):
         return {
             "type": "register-font",
@@ -1788,8 +1797,14 @@ class Application:
             The newly created session.
         """
         if session_id is None:
+            # skip ids already taken by explicitly-created sessions
+            # (e.g. a pre-created default session) so we never
+            # silently overwrite an existing session
             session_id = self._next_session_id
             self._next_session_id += 1
+            while session_id in self._sessions:
+                session_id = self._next_session_id
+                self._next_session_id += 1
         elif session_id in self._sessions:
             # If the existing session was auto-created by a browser
             # reconnect with the same token, return it so the user's
@@ -1954,12 +1969,14 @@ class Application:
 
         In the async API, callbacks are dispatched by the asyncio event
         loop directly, so this simply yields control for the requested
-        duration.
+        duration.  A *timeout* of ``0`` yields once (a non-blocking drain
+        of ready callbacks), matching the sync API's contract.
 
         Parameters
         ----------
         timeout : float
             Seconds to yield to the event loop (default 0.1).
+            Use ``0`` for a single non-blocking yield.
         """
         await asyncio.sleep(timeout)
 

pgwidgets/method_types.py

@@ -56,7 +56,7 @@ JS_ONLY_METHODS = {
     # ComboBox
     "get_alpha",
     # Container
-    "num_children",
+    "num_children", "is_container",
     # TabWidget lookups
     "get_tab_id", "get_child", "index_of",
     # MDIWidget

pgwidgets/sync/application.py

@@ -1828,6 +1828,20 @@ class Application:
             except Exception:
                 pass
 
+    def open_url(self, url):
+        """Ask the connected browser(s) to open *url* in a new tab/window.
+
+        Fire-and-forget app-level command (mirrors set_default_font's
+        per-session send).  This opens the link in the *user's* browser
+        rather than on the host running Python.
+        """
+        msg = {"type": "open-url", "url": str(url)}
+        for session in list(self._sessions.values()):
+            try:
+                session._send(msg)
+            except Exception:
+                pass
+
     def _font_register_msg(self, entry):
         return {
             "type": "register-font",
@@ -2062,8 +2076,14 @@ class Application:
         """
         with self._session_lock:
             if session_id is None:
+                # skip ids already taken by explicitly-created sessions
+                # (e.g. a pre-created default session) so we never
+                # silently overwrite an existing session
                 session_id = self._next_session_id
                 self._next_session_id += 1
+                while session_id in self._sessions:
+                    session_id = self._next_session_id
+                    self._next_session_id += 1
             elif session_id in self._sessions:
                 # If the existing session was auto-created by a browser
                 # reconnect with the same token, return it so the user's
@@ -2279,22 +2299,35 @@ class Application:
         ``concurrent`` modes, callbacks already run on their own threads
         so this method simply yields control briefly.
 
+        A *timeout* of ``0`` drains every callback currently queued and
+        returns immediately without blocking -- useful when pumping from
+        within another event loop (e.g. a Jupyter kernel's asyncio loop).
+
         Parameters
         ----------
         timeout : float
             Maximum seconds to spend processing events (default 0.1).
+            Use ``0`` for a non-blocking drain of the pending queue.
         """
         if self._concurrency == "serialized":
+            non_blocking = (timeout == 0)
             deadline = time.monotonic() + timeout
             while not self._shutdown.is_set():
-                remaining = deadline - time.monotonic()
-                if remaining <= 0:
-                    break
-                try:
-                    handler, args, kwargs, result_slot = \
-                        self._cb_queue.get(timeout=min(remaining, 0.5))
-                except queue.Empty:
-                    continue
+                if non_blocking:
+                    try:
+                        handler, args, kwargs, result_slot = \
+                            self._cb_queue.get_nowait()
+                    except queue.Empty:
+                        break
+                else:
+                    remaining = deadline - time.monotonic()
+                    if remaining <= 0:
+                        break
+                    try:
+                        handler, args, kwargs, result_slot = \
+                            self._cb_queue.get(timeout=min(remaining, 0.5))
+                    except queue.Empty:
+                        continue
                 try:
                     rv = handler(*args, **kwargs)
                     if result_slot is not None:

{pgwidgets_python-0.3.1.dist-info → pgwidgets_python-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pgwidgets-python
-Version: 0.3.1
+Version: 0.3.3
 Summary: Python bindings for the pgwidgets JavaScript widget library
 Author: PGWidgets Developers
 License: BSD-3-Clause
@@ -27,6 +27,10 @@ Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
 Dynamic: license-file
 
+<p align="center">
+  <img src="pgwidgets/icons/pgw-python-logo.png" alt="pgwidgets-python logo" width="500">
+</p>
+
 # pgwidgets — Python Bindings
 
 Python bindings for the [pgwidgets](https://github.com/naojsoft/pgwidgets-js)

{pgwidgets_python-0.3.1.dist-info → pgwidgets_python-0.3.3.dist-info}/RECORD

@@ -3,19 +3,22 @@ pgwidgets/_json.py,sha256=o21qywJ6yAldbqxTq3nLwgK9O67r3a8JxhvI_WAJnMY,2184
 pgwidgets/buffer.py,sha256=BYj_nb6fuyGsBqUp3_Z1YrzUm4h5VmoWPGKvpTjWrYk,4048
 pgwidgets/callbacks.py,sha256=gA2FnX0N5BmbmOMyEV35yHySgAfVjfAZcZhZbo7j4-c,3314
 pgwidgets/defs.py,sha256=Q8qhvTeansFU1Av6j5ncdwF2xSNHrpXuKErdHWQ3HiA,436
-pgwidgets/method_types.py,sha256=1gOTR8pdX_t7E_UEyUy4rnWiFoh10tJSUAINA1mE-SU,18298
+pgwidgets/method_types.py,sha256=_-rdE5BOYLra8x3BMKv5-QS4Z8YB29DBhUCDsGiB-Gw,18314
 pgwidgets/async_/Widgets.py,sha256=vld2xkvusBBEVbhbezaJsjBRRj3L7c17Up0pOVs8PGo,723
 pgwidgets/async_/__init__.py,sha256=rXB-v9XRrYt1imYuYikhkzIyiRqaYhlTpQei2LHaQ18,564
-pgwidgets/async_/application.py,sha256=5tUlfyE9ie0aFPh2WAs2VRvgyuqQmdaGTX0d1IkSB7o,80077
+pgwidgets/async_/application.py,sha256=2RJNRerXu5LXG_UcMSi9HWOCAlEOu96TrRaoIcUZ86Q,80957
 pgwidgets/async_/widget.py,sha256=gO7eJh9LV3UY7yRLdeml_0gqmHnFB5VU3NWlDURLtfc,38042
 pgwidgets/extras/__init__.py,sha256=AXUmFtnn4RSlp6pJX6z55j-m_29VmfzpYIjQvAy7pO0,325
 pgwidgets/extras/file_browser.py,sha256=CXQSfJx1VQ-fJfhKNrVyqrkKTJEQngmiP954y70Fjo0,17229
+pgwidgets/icons/pgw-python-logo.png,sha256=_Rxicp9EKy2Pzz1HtobxEnntSI-y5TtAVPlIzZIsfYs,2428840
 pgwidgets/sync/Widgets.py,sha256=7SaocMVMzFHhi51pjuEAr47Wez90b_a61kDbiv0jOfM,706
 pgwidgets/sync/__init__.py,sha256=SF5RTAvtu8BbYBWzpiCPipy6DJzNXf6nqk9xdvwxUhQ,542
-pgwidgets/sync/application.py,sha256=Gfft77F66PfRnr_8_FBqU0v_gWe4YC9M-q5rww1N-2U,94741
+pgwidgets/sync/application.py,sha256=tcAJvSVdijfT_KBP4llY1tyg2AAmQM-1qocw8Zf51nM,96240
 pgwidgets/sync/widget.py,sha256=yrScNkZB34u0JXn3-kCB-1mPLxLysVbuaPsCjC8kq0E,38343
-pgwidgets_python-0.3.1.dist-info/licenses/LICENSE.md,sha256=LoM3fMTiMnQuHRCJghdjOtjnCrL8soBpu2PFk24Xvyg,1528
-pgwidgets_python-0.3.1.dist-info/METADATA,sha256=QKWuFclVrksOLKxHPqSM-6CoNVskbt_bw_rqaUa3WpI,4568
-pgwidgets_python-0.3.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-pgwidgets_python-0.3.1.dist-info/top_level.txt,sha256=wwL6fBq0gU-JwzlM6TdduY1qYpu39ysqnnbQT-1bqAs,10
-pgwidgets_python-0.3.1.dist-info/RECORD,,
+pgwidgets_python-0.3.3.dist-info/licenses/LICENSE.md,sha256=LoM3fMTiMnQuHRCJghdjOtjnCrL8soBpu2PFk24Xvyg,1528
+pgwidgets_python-0.3.3.dist-info/METADATA,sha256=zGKe1dIOc9aQaTS5ROZQu5NFO0rXlqfv3FuavZmjKsA,4683
+pgwidgets_python-0.3.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pgwidgets_python-0.3.3.dist-info/scm_file_list.json,sha256=EpRYjywwhXPISys2-onyGmwpWbD6-PyVRKtlpIbaRsM,1943
+pgwidgets_python-0.3.3.dist-info/scm_version.json,sha256=QuXBS8rkNOzsOyOLL_7d599vXJRfhJZxVPwFnAqG4fk,160
+pgwidgets_python-0.3.3.dist-info/top_level.txt,sha256=wwL6fBq0gU-JwzlM6TdduY1qYpu39ysqnnbQT-1bqAs,10
+pgwidgets_python-0.3.3.dist-info/RECORD,,

pgwidgets_python-0.3.3.dist-info/scm_file_list.json

@@ -0,0 +1,68 @@
+{
+  "files": [
+    ".flake8",
+    "test_pg2.py",
+    "README.md",
+    "pyproject.toml",
+    "LICENSE.md",
+    ".readthedocs.yaml",
+    ".gitignore",
+    "docs/web-servers.rst",
+    "docs/WhatsNew.rst",
+    "docs/subclassing.rst",
+    "docs/sync.rst",
+    "docs/utilities.rst",
+    "docs/extras.rst",
+    "docs/async.rst",
+    "docs/architecture.rst",
+    "docs/widgets.rst",
+    "docs/conf.py",
+    "docs/Makefile",
+    "docs/index.rst",
+    "docs/callbacks.rst",
+    "docs/getting-started.rst",
+    "docs/api/async.rst",
+    "docs/api/sync.rst",
+    "docs/api/index.rst",
+    "tests/test_protocol.py",
+    "tests/__init__.py",
+    "tests/test_stateful.py",
+    "tests/test_resolve_kwargs.py",
+    "tests/test_async_session.py",
+    "tests/test_defs.py",
+    "tests/test_fonts.py",
+    "tests/test_session.py",
+    "tests/test_extras.py",
+    "tests/test_widget_classes.py",
+    "tests/test_reconstruct.py",
+    "pgwidgets/_json.py",
+    "pgwidgets/__init__.py",
+    "pgwidgets/callbacks.py",
+    "pgwidgets/method_types.py",
+    "pgwidgets/buffer.py",
+    "pgwidgets/defs.py",
+    "pgwidgets/sync/Widgets.py",
+    "pgwidgets/sync/__init__.py",
+    "pgwidgets/sync/application.py",
+    "pgwidgets/sync/widget.py",
+    "pgwidgets/extras/__init__.py",
+    "pgwidgets/extras/file_browser.py",
+    "pgwidgets/icons/pgw-python-logo.png",
+    "pgwidgets/async_/Widgets.py",
+    "pgwidgets/async_/application.py",
+    "pgwidgets/async_/__init__.py",
+    "pgwidgets/async_/widget.py",
+    "examples/demo_sync.py",
+    "examples/all_widgets.py",
+    "examples/all_widgets_async.py",
+    "examples/README.md",
+    "examples/demo_treeview.py",
+    "examples/demo_async.py",
+    "examples/flask-multi-process/server.py",
+    "examples/flask-multi-process/README.md",
+    "examples/flask-multi-process/nginx.conf",
+    "examples/flask-multi-process/gunicorn.conf.py",
+    "examples/flask-multi-process/user_app.py",
+    ".github/workflows/tests.yml"
+  ]
+}

pgwidgets_python-0.3.3.dist-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.3.3",
+  "distance": 0,
+  "node": "g522f05596d51c6b3f6f671895e54ec014515d3c7",
+  "dirty": false,
+  "branch": "main",
+  "node_date": "2026-06-25"
+}