nicegui 3.0.2__tar.gz → 3.0.3__tar.gz

{nicegui-3.0.2 → nicegui-3.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nicegui
-Version: 3.0.2
+Version: 3.0.3
 Summary: Create web-based user interfaces with Python. The nice way.
 License: MIT
 License-File: LICENSE

{nicegui-3.0.2 → nicegui-3.0.3}/nicegui/core.py

@@ -17,3 +17,8 @@ air: Air | None = None
 root: Callable | None = None
 script_mode: bool = False
 script_client: Client | None = None
+
+
+def is_script_mode_preflight() -> bool:
+    """Return whether this is the preflight run of the script mode."""
+    return script_mode and not app.is_started  # pylint: disable=undefined-variable # noqa: F821

{nicegui-3.0.2 → nicegui-3.0.3}/nicegui/elements/table.py

@@ -43,6 +43,12 @@ class Table(FilterElement, component='table.js'):
 
         A table based on Quasar's `QTable <https://quasar.dev/vue-components/table>`_ component.
 
+        If ``selection`` is "single" or "multiple", then a ``selected`` property is accessible containing the selected rows.
+
+        Note:
+        Cells in ``rows`` must not contain lists because they can cause the browser to crash.
+        To display complex data structures, convert them to strings first (e.g., using ``str()`` or custom formatting).
+
         :param rows: list of row objects
         :param columns: list of column objects (defaults to the columns of the first row *since version 2.0.0*)
         :param column_defaults: optional default column properties, *added in version 2.0.0*
@@ -52,8 +58,6 @@ class Table(FilterElement, component='table.js'):
         :param pagination: a dictionary correlating to a pagination object or number of rows per page (`None` hides the pagination, 0 means "infinite"; default: `None`).
         :param on_select: callback which is invoked when the selection changes
         :param on_pagination_change: callback which is invoked when the pagination changes
-
-        If selection is 'single' or 'multiple', then a `selected` property is accessible containing the selected rows.
         """
         super().__init__()
 

{nicegui-3.0.2 → nicegui-3.0.3}/nicegui/event.py

@@ -7,6 +7,7 @@ from collections.abc import Awaitable, Callable
 from contextlib import nullcontext
 from dataclasses import dataclass
 from typing import Any, ClassVar, Generic
+from weakref import WeakSet
 
 from typing_extensions import ParamSpec
 
@@ -41,13 +42,13 @@ class Callback(Generic[P]):
 
 
 class Event(Generic[P]):
-    instances: ClassVar[list[Event]] = []
+    instances: ClassVar[WeakSet[Event]] = WeakSet()
 
     def __init__(self) -> None:
         """Event
 
-        Events are a powerful tool distribute information between different parts of your code.
-        The following demo shows how to define an event, subscribe a callback and emit it.
+        Events are a powerful tool distribute information between different parts of your code,
+        especially from long-living objects like data models to the short-living UI.
 
         Handlers can be synchronous or asynchronous.
         They can also take arguments if the event contains arguments.
@@ -55,7 +56,7 @@ class Event(Generic[P]):
         *Added in version 3.0.0*
         """
         self.callbacks: list[Callback[P]] = []
-        self.instances.append(self)
+        self.instances.add(self)
 
     def subscribe(self, callback: Callable[P, Any] | Callable[[], Any], *,
                   unsubscribe_on_disconnect: bool | None = None) -> None:
@@ -75,15 +76,14 @@ class Event(Generic[P]):
         frame = frame.f_back
         assert frame is not None
         callback_ = Callback[P](func=callback, filepath=frame.f_code.co_filename, line=frame.f_lineno)
-        try:
+        client: Client | None = None
+        if Slot.get_stack():  # NOTE: additional check before accessing `context.slot` which would enter script mode
             callback_.slot = weakref.ref(context.slot)
-            client: Client | None = context.client
-        except RuntimeError:
-            client = None
+            client = context.client
         if callback_.slot is None and unsubscribe_on_disconnect is True:
             raise RuntimeError('Calling `subscribe` with `unsubscribe_on_disconnect=True` outside of a UI context '
                                'is not supported.')
-        if client is not None and unsubscribe_on_disconnect is not False:
+        if client is not None and unsubscribe_on_disconnect is not False and not core.is_script_mode_preflight():
             async def register_disconnect() -> None:
                 try:
                     await client.connected()

{nicegui-3.0.2 → nicegui-3.0.3}/nicegui/persistence/redis_persistent_dict.py

@@ -17,13 +17,13 @@ class RedisPersistentDict(PersistentDict):
         if not optional_features.has('redis'):
             raise ImportError('Redis is not installed. Please run "pip install nicegui[redis]".')
         self.url = url
-        self.redis_client = redis.from_url(
-            url,
-            health_check_interval=10,
-            socket_connect_timeout=5,
-            retry_on_timeout=True,
-            socket_keepalive=True,
-        )
+        self._redis_client_params = {
+            'health_check_interval': 10,
+            'socket_connect_timeout': 5,
+            'retry_on_timeout': True,
+            **({'socket_keepalive': True} if not url.startswith('unix://') else {}),
+        }
+        self.redis_client = redis.from_url(self.url, **self._redis_client_params)
         self.pubsub = self.redis_client.pubsub()
         self.key = key_prefix + id
         self._should_listen = True
@@ -40,13 +40,7 @@ class RedisPersistentDict(PersistentDict):
 
     def initialize_sync(self) -> None:
         """Load initial data from Redis and start listening for changes in a synchronous context."""
-        with redis_sync.from_url(
-            self.url,
-            health_check_interval=10,
-            socket_connect_timeout=5,
-            retry_on_timeout=True,
-            socket_keepalive=True,
-        ) as redis_client_sync:
+        with redis_sync.from_url(self.url, **self._redis_client_params) as redis_client_sync:
             try:
                 data = redis_client_sync.get(self.key)
                 self.update(json.loads(data) if data else {})

{nicegui-3.0.2 → nicegui-3.0.3}/nicegui/storage.py

@@ -82,7 +82,7 @@ class Storage:
         Therefore it is normally better to use `app.storage.user` instead,
         which can be modified anytime, reduces overall payload, improves security and has larger storage capacity.
         """
-        if core.script_mode and not core.app.is_started:
+        if core.is_script_mode_preflight():
             return {}
         request: Optional[Request] = request_contextvar.get()
         if request is None:
@@ -103,7 +103,7 @@ class Storage:
         The data is stored on the server.
         It is shared between all browser tabs by identifying the user via session cookie ID.
         """
-        if core.script_mode and not core.app.is_started:
+        if core.is_script_mode_preflight():
             return PseudoPersistentDict()
         request: Optional[Request] = request_contextvar.get()
         if request is None:

{nicegui-3.0.2 → nicegui-3.0.3}/nicegui/timer.py

@@ -41,7 +41,7 @@ class Timer:
         self._current_invocation: Optional[asyncio.Task] = None
 
         coroutine = self._run_once if once else self._run_in_loop
-        if core.script_mode and not core.app.is_started:
+        if core.is_script_mode_preflight():
             return
         if core.app.is_started:
             background_tasks.create(coroutine(), name=str(callback))

{nicegui-3.0.2 → nicegui-3.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "nicegui"
-version = "v3.0.2"
+version = "v3.0.3"
 description = "Create web-based user interfaces with Python. The nice way."
 authors = ["Zauberzeug GmbH <info@zauberzeug.com>"]
 license = "MIT"