pgwidgets-python 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

pgwidgets/__init__.py

@@ -16,4 +16,17 @@ Usage (asynchronous):
     top = await W.TopLevel(title="Hello", resizable=True)
     ...
     await app.run()
+
+Version:
+    import pgwidgets
+    print(pgwidgets.__version__)
 """
+
+from importlib.metadata import version as _pkg_version, PackageNotFoundError
+
+try:
+    __version__ = _pkg_version("pgwidgets")
+except PackageNotFoundError:
+    # Package not installed (e.g. running from a source checkout
+    # without `pip install -e .`).  Fall back to a sentinel.
+    __version__ = "0.0.0+unknown"

pgwidgets/_json.py

@@ -0,0 +1,63 @@
+"""JSON encoding helper for the remote protocol.
+
+The wire format between Python and the browser is JSON.  The stdlib
+encoder has two issues for scientific data:
+
+1. It rejects numpy scalars other than ``np.float64`` (which inherits
+   from float), numpy arrays, and similar buffer-protocol objects —
+   silently dropping a TreeView payload that happens to contain
+   ``np.int64`` cell values.
+
+2. It writes the literal tokens ``NaN`` / ``Infinity`` / ``-Infinity``
+   for non-finite floats, which browsers' ``JSON.parse`` reject — a
+   single masked / missing cell in a float column makes the whole
+   payload silently fail to parse on the JS side.
+
+``JsonEncoder`` handles both: ``.item()`` / ``.tolist()`` fall-backs
+for numpy/pandas types, and a pre-walk that replaces non-finite floats
+with ``None`` (encoded as JSON ``null``).  Use it via
+``json.dumps(obj, cls=JsonEncoder)``.
+"""
+
+import json
+import math
+
+
+def _scrub_nan(obj):
+    """Recursively replace non-finite floats with None so the result
+    is RFC-8259-valid JSON when re-encoded.  Cheap walk: O(n) and
+    only visits dicts/lists/tuples/floats."""
+    if isinstance(obj, float):
+        return obj if math.isfinite(obj) else None
+    if isinstance(obj, dict):
+        return {k: _scrub_nan(v) for k, v in obj.items()}
+    if isinstance(obj, (list, tuple)):
+        return [_scrub_nan(v) for v in obj]
+    return obj
+
+
+def _coerce_scalar(v):
+    """If *v* is a float, replace non-finite values with None."""
+    if isinstance(v, float) and not math.isfinite(v):
+        return None
+    return v
+
+
+class JsonEncoder(json.JSONEncoder):
+    def default(self, obj):
+        item = getattr(obj, "item", None)
+        if callable(item):
+            try:
+                return _coerce_scalar(item())
+            except (TypeError, ValueError):
+                pass
+        tolist = getattr(obj, "tolist", None)
+        if callable(tolist):
+            try:
+                return _scrub_nan(tolist())
+            except (TypeError, ValueError):
+                pass
+        return super().default(obj)
+
+    def iterencode(self, o, _one_shot=False):
+        return super().iterencode(_scrub_nan(o), _one_shot=_one_shot)

pgwidgets/async_/application.py

@@ -23,6 +23,7 @@ from pathlib import Path
 import websockets
 
 from pgwidgets_js import get_static_path, get_remote_html
+from pgwidgets._json import JsonEncoder
 from pgwidgets.defs import WIDGETS
 from pgwidgets.method_types import (
     SPECIAL_SETTERS, FIXED_SETTERS, CHILD_METHODS as CHILD_METHOD_NAMES,
@@ -492,7 +493,7 @@ class Session:
         self._next_id += 1
         msg["id"] = msg_id
         try:
-            payload = json.dumps(msg)
+            payload = json.dumps(msg, cls=JsonEncoder)
         except Exception as e:
             self._logger.error(
                 f"JSON encode failed for "
@@ -510,7 +511,7 @@ class Session:
             ff_id = self._next_id
             self._next_id += 1
             msg_copy = dict(msg, id=ff_id)
-            ff_payload = json.dumps(msg_copy)
+            ff_payload = json.dumps(msg_copy, cls=JsonEncoder)
             for ws in self._connections[1:]:
                 _schedule_ws_send(ws, ff_payload)
         result = await future
@@ -541,7 +542,7 @@ class Session:
                 "method": method,
                 "args": list(args),
                 "silent": True,
-            })
+            }, cls=JsonEncoder)
         except Exception as e:
             self._logger.error(
                 f"JSON encode failed for push {method} "
@@ -567,7 +568,7 @@ class Session:
             "id": msg_id,
             "wid": wid,
             "action": action,
-        })
+        }, cls=JsonEncoder)
         for ws in self._connections:
             _schedule_ws_send(ws, payload)
 
@@ -630,7 +631,7 @@ class Session:
             "wid": wid,
             "method": method,
             "args": list(args),
-        })
+        }, cls=JsonEncoder)
         async def _pair(ws):
             await ws.send(header)
             await ws.send(data)
@@ -1332,7 +1333,8 @@ class Application:
     async def _ws_handler(self, ws):
         # Init handshake: send init, receive ack which may contain
         # session_id + token for reconnection.
-        await ws.send(json.dumps({"type": "init", "id": 0}))
+        await ws.send(json.dumps({"type": "init", "id": 0},
+                                 cls=JsonEncoder))
         ack_data = await ws.recv()
         ack = json.loads(ack_data)
         reconnect_sid = ack.get("session_id")
@@ -1399,7 +1401,7 @@ class Application:
             "type": "session-info",
             "session_id": session.id,
             "token": session.token,
-        }))
+        }, cls=JsonEncoder))
 
         if is_reconnect:
             async def do_reconstruct():

pgwidgets/async_/widget.py

@@ -776,14 +776,19 @@ def _add_tree_view_methods(attrs, all_methods):
 
 
 def _init_params(pos_names, opt_names):
-    """Build the parameter string for the generated __init__."""
+    """Build the parameter string for the generated __init__.
+
+    Options are exposed as positional-or-keyword (no ``*`` separator)
+    so that single-option widgets like Frame accept ``Frame("Title")``
+    in addition to ``Frame(title="Title")``, matching the pyodide
+    bridge's behavior.  Each option still defaults to ``None`` so
+    omitted ones don't override state from prior calls.
+    """
     params = ["self", "session"]
     for name in pos_names:
         params.append(f"{name}=None")
-    if opt_names:
-        params.append("*")
-        for name in opt_names:
-            params.append(f"{name}=None")
+    for name in opt_names:
+        params.append(f"{name}=None")
     params.append("**kwargs")
     return ", ".join(params)
 

pgwidgets/sync/application.py

@@ -25,6 +25,7 @@ from pathlib import Path
 import websockets
 
 from pgwidgets_js import get_static_path, get_remote_html
+from pgwidgets._json import JsonEncoder
 from pgwidgets.defs import WIDGETS
 from pgwidgets.sync.widget import Widget, build_all_widget_classes
 from pgwidgets.method_types import (
@@ -260,6 +261,15 @@ class Session:
             if threading.current_thread() is not self._cb_thread:
                 self._cb_thread.join(timeout=2)
 
+    def get_session_thread(self):
+        mode = self._app._concurrency
+        if mode == "serialized":
+            return threading.get_ident()
+        elif mode == "per_session":
+            return self._cb_thread
+        else:
+            return None
+
     # -- Message handling --
 
     def _handle_message(self, data):
@@ -541,7 +551,7 @@ class Session:
             self._next_id += 1
         msg["id"] = msg_id
         try:
-            payload = json.dumps(msg)
+            payload = json.dumps(msg, cls=JsonEncoder)
         except Exception as e:
             self._logger.error(
                 f"JSON encode failed for "
@@ -565,7 +575,7 @@ class Session:
                 ff_id = self._next_id
                 self._next_id += 1
             msg_copy = dict(msg, id=ff_id)
-            ff_payload = json.dumps(msg_copy)
+            ff_payload = json.dumps(msg_copy, cls=JsonEncoder)
             for ws in self._connections[1:]:
                 _schedule_ws_send(self._app._loop, ws, ff_payload)
         event.wait()
@@ -605,7 +615,7 @@ class Session:
                 "method": method,
                 "args": list(args),
                 "silent": True,
-            })
+            }, cls=JsonEncoder)
         except Exception as e:
             self._logger.error(
                 f"JSON encode failed for push {method} "
@@ -677,7 +687,7 @@ class Session:
             "wid": wid,
             "method": method,
             "args": list(args),
-        })
+        }, cls=JsonEncoder)
         # Send header + binary as an atomic pair on each connection so
         # they can't be interleaved with other sends from another
         # thread.  The pair is wrapped in a single coroutine.
@@ -1512,7 +1522,8 @@ class Application:
     async def _ws_handler(self, ws):
         # Init handshake: send init, receive ack which may contain
         # session_id + token for reconnection.
-        await ws.send(json.dumps({"type": "init", "id": 0}))
+        await ws.send(json.dumps({"type": "init", "id": 0},
+                                 cls=JsonEncoder))
         ack_data = await ws.recv()
         ack = json.loads(ack_data)
         reconnect_sid = ack.get("session_id")
@@ -1582,7 +1593,7 @@ class Application:
             "type": "session-info",
             "session_id": session.id,
             "token": session.token,
-        }))
+        }, cls=JsonEncoder))
 
         if is_reconnect:
             # Dispatch reconstruction to the session thread — calling

pgwidgets/sync/widget.py

@@ -842,14 +842,19 @@ def __init__({_init_params(pos_names, opt_names)}):
 
 
 def _init_params(pos_names, opt_names):
-    """Build the parameter string for the generated __init__."""
+    """Build the parameter string for the generated __init__.
+
+    Options are exposed as positional-or-keyword (no ``*`` separator)
+    so that single-option widgets like Frame accept ``Frame("Title")``
+    in addition to ``Frame(title="Title")``, matching the pyodide
+    bridge's behavior.  Each option still defaults to ``None`` so
+    omitted ones don't override state from prior calls.
+    """
     params = ["self", "session"]
     for name in pos_names:
         params.append(f"{name}=None")
-    if opt_names:
-        params.append("*")
-        for name in opt_names:
-            params.append(f"{name}=None")
+    for name in opt_names:
+        params.append(f"{name}=None")
     params.append("**kwargs")
     return ", ".join(params)
 

{pgwidgets_python-0.2.0.dist-info → pgwidgets_python-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pgwidgets-python
-Version: 0.2.0
+Version: 0.2.1
 Summary: Python bindings for the pgwidgets JavaScript widget library
 Author: PGWidgets Developers
 License: BSD-3-Clause
@@ -17,7 +17,7 @@ Classifier: Topic :: Software Development :: User Interfaces
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
-Requires-Dist: pgwidgets-js
+Requires-Dist: pgwidgets-js>=0.2.0
 Requires-Dist: websockets>=12
 Provides-Extra: dev
 Requires-Dist: sphinx; extra == "dev"

{pgwidgets_python-0.2.0.dist-info → pgwidgets_python-0.2.1.dist-info}/RECORD

@@ -1,19 +1,20 @@
-pgwidgets/__init__.py,sha256=365yX_Iq5Uh8ZYPVUDmdTWJa0E8PfLQG82LffdZJi88,476
+pgwidgets/__init__.py,sha256=fKKHAt9GxLbficihVyImWsqrnQvdQZQAmeGaRUF8cBE,857
+pgwidgets/_json.py,sha256=o21qywJ6yAldbqxTq3nLwgK9O67r3a8JxhvI_WAJnMY,2184
 pgwidgets/callbacks.py,sha256=gA2FnX0N5BmbmOMyEV35yHySgAfVjfAZcZhZbo7j4-c,3314
 pgwidgets/defs.py,sha256=Q8qhvTeansFU1Av6j5ncdwF2xSNHrpXuKErdHWQ3HiA,436
 pgwidgets/method_types.py,sha256=AoNXYY7iU-ttAWPqL104Dpl4AtUvyF6I2OmzpRw2HWQ,15637
 pgwidgets/async_/Widgets.py,sha256=vld2xkvusBBEVbhbezaJsjBRRj3L7c17Up0pOVs8PGo,723
 pgwidgets/async_/__init__.py,sha256=rXB-v9XRrYt1imYuYikhkzIyiRqaYhlTpQei2LHaQ18,564
-pgwidgets/async_/application.py,sha256=hKsa6PBh49n7AxwwXqdWjBfL_cL6eixX-MeU_lkD9CY,64651
-pgwidgets/async_/widget.py,sha256=bL-wL7T9j6Ic5xsAchw5BdJQtgHX1GuCOF732cJEpbQ,35589
+pgwidgets/async_/application.py,sha256=97jGnnwtrPHQYuh4BKsvl1yfWQnMe-fzIexvEiozw_o,64843
+pgwidgets/async_/widget.py,sha256=y4tjgNunM3CUMlZIe00f07kL15w0zuu4whbcTRG8CGw,35871
 pgwidgets/extras/__init__.py,sha256=AXUmFtnn4RSlp6pJX6z55j-m_29VmfzpYIjQvAy7pO0,325
 pgwidgets/extras/file_browser.py,sha256=PWzJltjQZbmsD1ykbbC2xJ6ErEkJj7KafhmVkd9q9Ac,16963
 pgwidgets/sync/Widgets.py,sha256=7SaocMVMzFHhi51pjuEAr47Wez90b_a61kDbiv0jOfM,706
 pgwidgets/sync/__init__.py,sha256=SF5RTAvtu8BbYBWzpiCPipy6DJzNXf6nqk9xdvwxUhQ,542
-pgwidgets/sync/application.py,sha256=WNT96gG6BhRJug7Dt-AerAjV_AZFq-BE--1XFj6ObgI,75392
-pgwidgets/sync/widget.py,sha256=UkMgM7dKA1g-CtjukL27vjCZD7FAHyMOpJVD9mpN5-w,35655
-pgwidgets_python-0.2.0.dist-info/licenses/LICENSE.md,sha256=LoM3fMTiMnQuHRCJghdjOtjnCrL8soBpu2PFk24Xvyg,1528
-pgwidgets_python-0.2.0.dist-info/METADATA,sha256=NDMZH7W7Va2LzqYHF_kDK3ryykos_aM5rO5IczPT-uE,4561
-pgwidgets_python-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-pgwidgets_python-0.2.0.dist-info/top_level.txt,sha256=wwL6fBq0gU-JwzlM6TdduY1qYpu39ysqnnbQT-1bqAs,10
-pgwidgets_python-0.2.0.dist-info/RECORD,,
+pgwidgets/sync/application.py,sha256=6x3zPcnDi2d2zNB7JzlLvr8lVAgbZNwsUj-ibcmxIGU,75823
+pgwidgets/sync/widget.py,sha256=sMJVs4nrLg_8tTeJ3yqNh-bONGnwyhkzpn1TfYh0jAE,35937
+pgwidgets_python-0.2.1.dist-info/licenses/LICENSE.md,sha256=LoM3fMTiMnQuHRCJghdjOtjnCrL8soBpu2PFk24Xvyg,1528
+pgwidgets_python-0.2.1.dist-info/METADATA,sha256=QNcxLsgguIdFIAvn9mOS1YTL6Pq-V6uYRapohdYY7xE,4568
+pgwidgets_python-0.2.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pgwidgets_python-0.2.1.dist-info/top_level.txt,sha256=wwL6fBq0gU-JwzlM6TdduY1qYpu39ysqnnbQT-1bqAs,10
+pgwidgets_python-0.2.1.dist-info/RECORD,,