pythonnative 0.46.0__tar.gz → 0.47.0__tar.gz

{pythonnative-0.46.0/src/pythonnative.egg-info → pythonnative-0.47.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.46.0
+Version: 0.47.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License

{pythonnative-0.46.0 → pythonnative-0.47.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.46.0"
+version = "0.47.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }

{pythonnative-0.46.0 → pythonnative-0.47.0}/src/pythonnative/__init__.py

@@ -62,7 +62,7 @@ Example:
     ```
 """
 
-__version__ = "0.46.0"
+__version__ = "0.47.0"
 
 from . import appearance, diagnostics, gestures, icons, runtime, sdk, svg
 from .alerts import Alert
@@ -276,6 +276,9 @@ __all__ = [
     "DatePicker",
     "ErrorBoundary",
     "FlatList",
+    "ListData",
+    "Section",
+    "ViewableItem",
     "Fragment",
     "Icon",
     "IconName",
@@ -505,3 +508,5 @@ __all__ = [
     "element_factory",
     "sdk",
 ]
+
+from .list_data import ListData, Section, ViewableItem

{pythonnative-0.46.0 → pythonnative-0.47.0}/src/pythonnative/bridge/__init__.py

@@ -199,7 +199,7 @@ def native_callback(kind: str, tag: int, name: str, payload: str) -> Optional[st
 
     loop = get_loop()
     if loop.is_running() and not _on_loop_thread(loop):
-        if kind == "event" and name in {"on_scroll", "on_selection_change", "on_gesture_update"}:
+        if kind == "event" and name in {"on_scroll", "on_window", "on_selection_change", "on_gesture_update"}:
             key = (tag, name)
             slot = _continuous.get(key)
             if slot is None:
@@ -252,7 +252,11 @@ def _on_event(tag: int, name: str, payload: str) -> Optional[str]:
     args = codec.loads(payload)
     from ..native_views import get_backend
 
-    accept = getattr(get_backend(), "accept_event", None)
+    backend = get_backend()
+    defer = getattr(backend, "defer_event", None)
+    if defer is not None and defer(tag, name, args):
+        return None
+    accept = getattr(backend, "accept_event", None)
     if accept is not None:
         if not accept(tag, name, args):
             return None

{pythonnative-0.46.0 → pythonnative-0.47.0}/src/pythonnative/bridge/android.py

@@ -21,6 +21,7 @@ class AndroidTransport:
     """Thin wrapper over the static ``PNBridge`` methods."""
 
     name = "android"
+    asynchronous_commits = True
 
     def __init__(self, bridge_class: Any = None) -> None:
         if bridge_class is None:

{pythonnative-0.46.0 → pythonnative-0.47.0}/src/pythonnative/bridge/codec.py

@@ -131,15 +131,20 @@ def build_transaction(
     """
     from ..sdk.schema import COMPONENTS
 
-    names = dict(types or {})
+    names: dict[int, str] = {}
+    base_names = types or {}
+    fields_cache: dict[str, frozenset[str]] = {}
 
     def python_fields(name: str) -> frozenset[str]:
+        if name in fields_cache:
+            return fields_cache[name]
         schema = COMPONENTS.get(name)
-        return (
+        fields_cache[name] = (
             frozenset(key for key, field in schema.props.items() if field.get("native", {}).get("python_only"))
             if schema
             else frozenset()
         )
+        return fields_cache[name]
 
     encoded: List[Any] = []
     sidecar: List[Tuple[int, Dict[str, Any]]] = []
@@ -152,7 +157,7 @@ def build_transaction(
                 sidecar.append((op.tag, python))
         elif isinstance(op, UpdateOp):
             removed = [key for key, value in op.changed_props.items() if value is UNSET]
-            wire, python = split_props(op.changed_props, python_fields(names.get(op.tag, "")))
+            wire, python = split_props(op.changed_props, python_fields(names.get(op.tag) or base_names.get(op.tag, "")))
             encoded.append(["u", op.tag, wire, removed])
             if python:
                 sidecar.append((op.tag, python))

{pythonnative-0.46.0 → pythonnative-0.47.0}/src/pythonnative/bridge/commits.py

@@ -10,11 +10,12 @@ from __future__ import annotations
 import math
 from collections.abc import Iterator, MutableMapping
 from dataclasses import dataclass, field
-from typing import Any
+from typing import Any, Callable
 
 from ..profiling import count, profiled
+from .list_store import ListStore
 
-PROTOCOL_VERSION = 3
+PROTOCOL_VERSION = 4
 
 
 class CommitError(RuntimeError):
@@ -29,6 +30,7 @@ class ViewState:
     props: dict[str, Any]
     parent: int | None = None
     children: list[int] = field(default_factory=list)
+    list_store: ListStore | None = None
 
 
 class ViewOverlay(MutableMapping[int, ViewState]):
@@ -72,7 +74,9 @@ class ViewOverlay(MutableMapping[int, ViewState]):
         """Return a writable copy of this record, copying it at most once."""
         if tag not in self.changed:
             view = self[tag]
-            self.changed[tag] = ViewState(view.type_name, dict(view.props), view.parent, list(view.children))
+            self.changed[tag] = ViewState(
+                view.type_name, dict(view.props), view.parent, list(view.children), view.list_store
+            )
             count("commit.records_copied")
         return self.changed[tag]
 
@@ -93,11 +97,13 @@ class CommitState:
     revision: int = 0
     views: MutableMapping[int, ViewState] = field(default_factory=dict)
 
+    _list_publications: dict[int, Callable[[], None]] = field(default_factory=dict)
+
     @profiled("validation")
     def prepare(self, envelope: Any) -> CommitState:
         """Validate without mutating this state and return the candidate state."""
         if not isinstance(envelope, dict) or envelope.get("version") != PROTOCOL_VERSION:
-            raise CommitError("Expected a protocol v3 commit envelope; rebuild the native client")
+            raise CommitError("Expected a protocol v4 commit envelope; rebuild the native client")
         application, surface, revision = (envelope.get(k) for k in ("application", "surface", "revision"))
         if not isinstance(application, str) or not application or type(surface) is not int or surface <= 0:
             raise CommitError("Invalid application or surface identity")
@@ -120,6 +126,9 @@ class CommitState:
 
     def publish(self) -> CommitState:
         """Accept a successfully mounted candidate; the prior state is consumed."""
+        for publish in self._list_publications.values():
+            publish()
+        self._list_publications.clear()
         if isinstance(self.views, ViewOverlay):
             self.views = self.views.publish()
         return self
@@ -139,7 +148,11 @@ class CommitState:
             if tag in self.views or not isinstance(op[2], str) or not op[2] or not isinstance(op[3], dict):
                 raise ValueError("Invalid or duplicate create")
             self._validate_props(op[2], op[3], False)
-            self.views[tag] = ViewState(op[2], dict(op[3]))
+            view = ViewState(op[2], dict(op[3]))
+            self.views[tag] = view
+            if op[2] == "VirtualList":
+                view.list_store = ListStore()
+                self._prepare_list(tag, view, op[3])
             return
         view = self.views[tag] if code == "f" else self._edit(tag)
         if code == "u":
@@ -154,6 +167,8 @@ class CommitState:
             from ..mutations import UNSET
 
             self._validate_props(view.type_name, {name: UNSET for name in removed}, True)
+            if view.list_store is not None:
+                self._prepare_list(tag, view, op[2])
             view.props.update(op[2])
             for name in removed:
                 view.props.pop(name, None)
@@ -185,6 +200,13 @@ class CommitState:
             if op[4] < 0 or op[5] < 0:
                 raise ValueError("Frame sizes must be nonnegative")
 
+    def _prepare_list(self, tag: int, view: ViewState, props: dict[str, Any]) -> None:
+        if "dataset" in props:
+            if tag in self._list_publications:
+                raise ValueError("A list may receive only one dataset patch per commit")
+            assert view.list_store is not None
+            self._list_publications[tag] = view.list_store.prepare(props["dataset"])
+
     @staticmethod
     def _validate_props(name: str, props: dict[str, Any], partial: bool) -> None:
         from ..sdk.schema import COMPONENTS

{pythonnative-0.46.0 → pythonnative-0.47.0}/src/pythonnative/bridge/ios.py

@@ -26,6 +26,7 @@ class IOSTransport:
     """Bind the ``pn_bridge_*`` symbols and expose them as Python methods."""
 
     name = "ios"
+    asynchronous_commits = True
 
     def __init__(self, lib: Any = None) -> None:
         self._lib = lib if lib is not None else ctypes.CDLL(None)

pythonnative-0.47.0/src/pythonnative/bridge/list_store.py

@@ -0,0 +1,135 @@
+"""Revisioned list patch semantics shared by validation and headless renderers."""
+
+from __future__ import annotations
+
+import math
+from dataclasses import dataclass, field
+from typing import Any, Callable
+
+from ..profiling import count
+
+
+@dataclass(frozen=True)
+class ListRow:
+    """Wire metadata for one logical row; application values stay in Python."""
+
+    key: str
+    revision: int
+    extent: float
+    sticky: bool = False
+
+    def wire(self) -> list[Any]:
+        """Return the compact row record used by each renderer."""
+        return [self.key, self.revision, self.extent, self.sticky]
+
+
+@dataclass
+class ListStore:
+    """Apply list patches atomically, copying order only for structural edits."""
+
+    revision: int = 0
+    keys: list[str] = field(default_factory=list)
+    rows: dict[str, ListRow] = field(default_factory=dict)
+
+    def apply(self, packet: Any) -> None:
+        """Validate the entire packet before publishing any of its changes."""
+        self.prepare(packet)()
+
+    def prepare(self, packet: Any) -> Callable[[], None]:
+        """Validate a patch and return its publication without editing live state."""
+        if not isinstance(packet, dict) or set(packet) != {"base", "revision", "changes"}:
+            raise ValueError("Invalid list packet")
+        base, revision, changes = (packet[key] for key in ("base", "revision", "changes"))
+        if (
+            type(base) is not int
+            or base != self.revision
+            or type(revision) is not int
+            or revision != base + 1
+            or revision > 9_007_199_254_740_991
+        ):
+            raise ValueError("Stale list revision")
+        if not isinstance(changes, list):
+            raise ValueError("List changes must be an array")
+        keys = self.keys
+        edited: dict[str, ListRow] = {}
+        deleted: set[str] = set()
+        reset = False
+
+        def exists(key: Any) -> bool:
+            return isinstance(key, str) and key not in deleted and (key in edited or not reset and key in self.rows)
+
+        def order() -> list[str]:
+            nonlocal keys
+            if keys is self.keys:
+                keys = list(keys)
+                count("list.order_copies")
+            return keys
+
+        def row(values: Any) -> ListRow:
+            if not isinstance(values, list) or len(values) != 4:
+                raise ValueError("Invalid list row")
+            key, version, extent, sticky = values
+            if (
+                not isinstance(key, str)
+                or not key
+                or type(version) is not int
+                or not 1 <= version <= 9_007_199_254_740_991
+            ):
+                raise ValueError("Invalid list key or item revision")
+            if type(extent) not in (int, float) or not math.isfinite(extent) or extent <= 0 or type(sticky) is not bool:
+                raise ValueError("Invalid list extent or sticky flag")
+            count("list.rows_validated")
+            return ListRow(key, version, float(extent), sticky)
+
+        for change in changes:
+            if not isinstance(change, list) or not change:
+                raise ValueError("Invalid list change")
+            code = change[0]
+            if code == "reset" and len(change) == 2 and isinstance(change[1], list):
+                if reset or edited or deleted or keys is not self.keys:
+                    raise ValueError("List reset must be the first change")
+                reset, keys = True, []
+                for values in change[1]:
+                    item = row(values)
+                    if item.key in edited:
+                        raise ValueError("List keys must be unique")
+                    keys.append(item.key)
+                    edited[item.key] = item
+            elif code == "i" and len(change) == 3:
+                index, item = change[1], row(change[2])
+                if type(index) is not int or not 0 <= index <= len(keys) or exists(item.key):
+                    raise ValueError("Invalid list insertion")
+                order().insert(index, item.key)
+                edited[item.key] = item
+                deleted.discard(item.key)
+            elif code == "u" and len(change) == 2:
+                item = row(change[1])
+                if not exists(item.key):
+                    raise ValueError("Unknown list update key")
+                edited[item.key] = item
+            elif code == "d" and len(change) == 2 and exists(change[1]):
+                order().remove(change[1])
+                edited.pop(change[1], None)
+                deleted.add(change[1])
+            elif code == "m" and len(change) == 3 and exists(change[1]):
+                index = change[2]
+                if type(index) is not int or not 0 <= index < len(keys):
+                    raise ValueError("Invalid list move index")
+                order().remove(change[1])
+                keys.insert(index, change[1])
+            else:
+                raise ValueError("Invalid list change")
+
+        def publish() -> None:
+            if self.revision != base:
+                raise ValueError("List changed before patch publication")
+            if reset:
+                self.rows = edited
+            else:
+                for key in deleted:
+                    self.rows.pop(key, None)
+                self.rows.update(edited)
+            self.keys, self.revision = keys, revision
+            count("list.patches", len(changes))
+
+        return publish

{pythonnative-0.46.0 → pythonnative-0.47.0}/src/pythonnative/bridge/web.py

@@ -68,6 +68,7 @@ class WebTransport:
     """
 
     name = "web"
+    asynchronous_commits = True
 
     def __init__(self, *, log: Optional[Callable[[str], None]] = None) -> None:
         self._log = log or (lambda line: print(line, file=sys.stderr, flush=True))