pgwidgets-python 0.3.1__tar.gz → 0.3.3__tar.gz

{pgwidgets_python-0.3.1 → pgwidgets_python-0.3.3}/PKG-INFO

@@ -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 → pgwidgets_python-0.3.3}/README.md

@@ -1,3 +1,7 @@
+<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 → pgwidgets_python-0.3.3}/docs/WhatsNew.rst

@@ -4,6 +4,40 @@ What's New
 Recent changes — since ``v0.3.0``
 ---------------------------------
 
+``Application.open_url``
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A new method asks the connected browser(s) to open a URL in a new
+tab/window (``window.open``):
+
+.. code-block:: python
+
+   app.open_url('https://example.com/')
+
+This opens the link in the *user's* browser rather than on the host
+running Python.  It is a fire-and-forget, per-session broadcast (like
+``set_default_font``) and is available on both the sync and async
+``Application``.  (Note: a browser popup blocker may suppress it if
+the originating user-activation has lapsed.)
+
+Containers report their children: ``get_children``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``Frame``, ``Expander``, ``TopLevel`` and ``Page`` (single-child
+containers) and the menu / toolbar widgets ``Menu``, ``MenuBar`` and
+``ToolBar`` are now container widgets, so their generated wrappers
+expose the container method set -- ``get_children`` / ``num_children``
+/ ``remove`` / ``remove_widget`` / ``remove_all``.  ``get_children()``
+returns the contained widgets (a 0- or 1-element list for the
+single-child containers; the menu actions / submenus / toolbar items
+for the menu/toolbar widgets).
+
+TreeView / TableView: ``set_row_spacing`` / ``set_column_spacing``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Two new methods set the vertical (row) and horizontal (column) cell
+padding (in pixels).  ``set_row_spacing(0)`` yields tight rows.
+
 Custom fonts: ``Application.register_font`` / ``set_default_font``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

{pgwidgets_python-0.3.1 → pgwidgets_python-0.3.3}/docs/async.rst

@@ -79,6 +79,10 @@ are replayed to every new and reconnecting session before
 with ``set_font(family, ...)`` always find the face already
 declared.
 
+``open_url(url)`` is also available (same as the sync backend; see
+:doc:`sync`) -- it asks the connected browser(s) to open ``url`` in a
+new tab via ``window.open``.
+
 Session
 -------
 

{pgwidgets_python-0.3.1 → pgwidgets_python-0.3.3}/docs/conf.py

@@ -17,6 +17,8 @@ exclude_patterns = ["_build"]
 # -- HTML output --
 html_theme = "furo"
 html_title = "pgwidgets-python"
+# project logo (single source: the package's icons/ data folder)
+html_logo = "../pgwidgets/icons/pgw-python-logo.png"
 
 # -- autodoc --
 autodoc_member_order = "bysource"

{pgwidgets_python-0.3.1 → pgwidgets_python-0.3.3}/docs/sync.rst

@@ -117,6 +117,19 @@ nginx the same route is served from the Python process.
 See also the JS-side write-up at :ref:`custom-fonts` in the
 pgwidgets-js documentation.
 
+Opening a URL in the browser
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: python
+
+   app.open_url('https://example.com/')
+
+``open_url(url)`` asks the connected browser(s) to open ``url`` in a
+new tab/window (``window.open``) -- i.e. in the *user's* browser, not
+on the host running Python.  It is a fire-and-forget, per-session
+broadcast.  (A browser popup blocker may suppress it if the
+user-activation from the originating click has already lapsed.)
+
 Session
 -------
 

{pgwidgets_python-0.3.1 → pgwidgets_python-0.3.3}/docs/widgets.rst

@@ -631,6 +631,7 @@ Hierarchical tree/list display.
   ``select_all(state)``,
   ``set_column_width(col_key, width)``,
   ``set_optimal_column_widths()``,
+  ``set_row_spacing(px)``, ``set_column_spacing(px)``,
   ``sort_by_column(col_key, ascending)``, ``scroll_to_path(path)``,
   ``scroll_to_end()``, ``get_column_count()``, ``get_row_count()``,
   ``set_show_grid(tf)``, ``set_show_row_numbers(tf)``,
@@ -815,6 +816,11 @@ Browser file open/save dialog.
 Menus and Toolbars
 ------------------
 
+``MenuBar``, ``Menu`` and ``ToolBar`` are container widgets: the menu
+actions, submenus and toolbar items they hold are reported by
+``get_children()`` / ``num_children()`` (separators and spacers
+excluded).
+
 MenuBar
 ~~~~~~~
 

{pgwidgets_python-0.3.1 → pgwidgets_python-0.3.3}/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_python-0.3.1 → pgwidgets_python-0.3.3}/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_python-0.3.1 → pgwidgets_python-0.3.3}/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 → pgwidgets_python-0.3.3}/pgwidgets_python.egg-info/PKG-INFO

@@ -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 → pgwidgets_python-0.3.3}/pgwidgets_python.egg-info/SOURCES.txt

@@ -46,6 +46,7 @@ pgwidgets/async_/application.py
 pgwidgets/async_/widget.py
 pgwidgets/extras/__init__.py
 pgwidgets/extras/file_browser.py
+pgwidgets/icons/pgw-python-logo.png
 pgwidgets/sync/Widgets.py
 pgwidgets/sync/__init__.py
 pgwidgets/sync/application.py
@@ -54,8 +55,11 @@ pgwidgets_python.egg-info/PKG-INFO
 pgwidgets_python.egg-info/SOURCES.txt
 pgwidgets_python.egg-info/dependency_links.txt
 pgwidgets_python.egg-info/requires.txt
+pgwidgets_python.egg-info/scm_file_list.json
+pgwidgets_python.egg-info/scm_version.json
 pgwidgets_python.egg-info/top_level.txt
 tests/__init__.py
+tests/test_async_session.py
 tests/test_defs.py
 tests/test_extras.py
 tests/test_fonts.py

pgwidgets_python-0.3.3/pgwidgets_python.egg-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/pgwidgets_python.egg-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"
+}

{pgwidgets_python-0.3.1 → pgwidgets_python-0.3.3}/pyproject.toml

@@ -46,3 +46,6 @@ local_scheme = "node-and-date"
 
 [tool.setuptools.packages.find]
 include = ["pgwidgets*"]
+
+[tool.setuptools.package-data]
+pgwidgets = ["icons/*"]

pgwidgets_python-0.3.3/tests/test_async_session.py

@@ -0,0 +1,68 @@
+"""
+Tests for the async backend's session lifecycle.
+
+``create_session`` is a plain (synchronous) method, so these tests need
+no running event loop.  They mirror the auto-id / collision-safety tests
+of the sync backend in ``test_session.py``.
+"""
+
+import logging
+import threading
+
+from pgwidgets.async_.application import Application
+
+
+def _make_app(**kwargs):
+    """Create an async Application without starting servers."""
+    app = Application.__new__(Application)
+    app._host = "127.0.0.1"
+    app._ws_port = 9500
+    app._http_port = 9501
+    app._use_http_server = False
+    app._concurrency = kwargs.get("concurrency", "concurrent")
+    app._max_sessions = None
+    app._sessions = {}
+    app._next_session_id = 1
+    app._on_connect = None
+    app._on_disconnect = None
+    app._widget_classes = {}
+
+    logger = logging.getLogger("pgwidgets.test.async")
+    logger.addHandler(logging.NullHandler())
+    app._logger = logger
+
+    return app
+
+
+class TestAsyncSessionCreation:
+    def test_create_session_auto_id(self):
+        app = _make_app()
+        s1 = app.create_session()
+        s2 = app.create_session()
+        assert s1.id == 1
+        assert s2.id == 2
+
+    def test_create_session_auto_id_skips_existing(self):
+        # A default session is created with an explicit id, then more are
+        # auto-allocated.  An auto-allocated id must not collide with /
+        # silently overwrite the explicitly-created one.
+        app = _make_app()
+        default = app.create_session(session_id=1)
+        extra = app.create_session()        # auto-allocated
+        assert extra.id != default.id
+        assert app._sessions[default.id] is default   # not overwritten
+        assert app._sessions[extra.id] is extra
+
+    def test_create_session_explicit_id(self):
+        app = _make_app()
+        s = app.create_session(session_id="my-session")
+        assert s.id == "my-session"
+
+    def test_create_session_duplicate_id_raises(self):
+        app = _make_app()
+        app.create_session(session_id="dup")
+        try:
+            app.create_session(session_id="dup")
+            assert False, "Should have raised ValueError"
+        except ValueError as e:
+            assert "dup" in str(e)

{pgwidgets_python-0.3.1 → pgwidgets_python-0.3.3}/tests/test_session.py

@@ -6,7 +6,9 @@ tokens, manage multiple connections, handle graceful no-connection
 operation, and can be destroyed.
 """
 
+import queue
 import threading
+import time
 from unittest.mock import MagicMock, AsyncMock
 
 from pgwidgets.sync.application import Application, Session
@@ -59,6 +61,18 @@ class TestSessionCreation:
         assert s1.id == 1
         assert s2.id == 2
 
+    def test_create_session_auto_id_skips_existing(self):
+        # Mirrors the Ginga pgw Application pattern: a default session is
+        # created with an explicit id, then more are auto-allocated.  An
+        # auto-allocated id must not collide with / silently overwrite the
+        # explicitly-created one.
+        app = _make_app()
+        default = app.create_session(session_id=1)
+        extra = app.create_session()        # auto-allocated
+        assert extra.id != default.id
+        assert app._sessions[default.id] is default   # not overwritten
+        assert app._sessions[extra.id] is extra
+
     def test_create_session_explicit_id(self):
         app = _make_app()
         s = app.create_session(session_id="my-session")
@@ -375,3 +389,39 @@ class TestCallbackSuppression:
         types = [m["type"] for m in messages]
         assert types[0] == "reconstruct-start"
         assert types[-1] == "reconstruct-end"
+
+
+class TestProcessEventsDrain:
+    """Test the non-blocking drain mode of process_events (timeout=0)."""
+
+    def _serial_app(self):
+        app = _make_app(concurrency="serialized")
+        app._cb_queue = queue.Queue()
+        app._shutdown = threading.Event()
+        return app
+
+    def test_zero_drains_all_without_blocking(self):
+        app = self._serial_app()
+        ran = []
+        for i in range(3):
+            app._cb_queue.put((lambda i=i: ran.append(i), (), {}, None))
+        start = time.monotonic()
+        app.process_events(0)
+        elapsed = time.monotonic() - start
+        assert ran == [0, 1, 2]
+        assert app._cb_queue.empty()
+        assert elapsed < 0.05   # returned without blocking
+
+    def test_zero_empty_queue_returns_immediately(self):
+        app = self._serial_app()
+        start = time.monotonic()
+        app.process_events(0)   # nothing queued
+        assert time.monotonic() - start < 0.05
+
+    def test_zero_propagates_result_slot(self):
+        app = self._serial_app()
+        slot = {"event": threading.Event()}
+        app._cb_queue.put((lambda: 42, (), {}, slot))
+        app.process_events(0)
+        assert slot["value"] == 42
+        assert slot["event"].is_set()