pythonnative 0.22.1__py3-none-any.whl → 0.23.0__py3-none-any.whl

pythonnative/virtual_rows.py

@@ -0,0 +1,137 @@
+"""Row subtrees for natively virtualized lists.
+
+Native virtualized lists (Android ``RecyclerView`` via
+``PNVirtualListView``, iOS ``UITableView``) own row lifecycle on the
+platform side: the platform decides when a row enters the viewport,
+hands PythonNative an empty native container, and recycles that
+container when the row scrolls away.
+
+Each visible row hosts a full PythonNative subtree driven by its own
+nested [`Reconciler`][pythonnative.reconciler.Reconciler]. The
+[`RowSubtree`][pythonnative.virtual_rows.RowSubtree] class wraps that
+per-row reconciler: it mounts the row element into fresh native views,
+re-reconciles in place when the platform rebinds the same container to
+a different row index (recycling), and tears everything down when the
+list is destroyed.
+
+State inside rows works: hooks like ``use_state`` mark the row's own
+reconciler dirty and a guarded flush re-renders just that row.
+"""
+
+from typing import Any, Callable, Dict
+
+from .element import Element
+
+__all__ = ["RowSubtree", "RowHostPool"]
+
+
+class RowSubtree:
+    """One list row's mounted PythonNative subtree.
+
+    Owns a nested reconciler whose viewport is the row's cell size.
+    The native root view produced by
+    [`mount`][pythonnative.virtual_rows.RowSubtree.mount] is what the
+    platform handler attaches to the recycled cell container.
+    """
+
+    def __init__(self) -> None:
+        from .native_views import get_registry
+        from .reconciler import Reconciler
+
+        self._reconciler = Reconciler(get_registry())
+        # Guarded synchronous flush so ``use_state`` inside a row
+        # re-renders the row. Re-entrant requests (a setter firing
+        # during the flush itself) are queued and drained after.
+        self._flushing = False
+        self._flush_queued = False
+        self._reconciler._screen_re_render = self._request_flush
+        self.native_root: Any = None
+
+    def _request_flush(self) -> None:
+        if self._flushing:
+            self._flush_queued = True
+            return
+        self._flushing = True
+        try:
+            for _ in range(8):
+                self._flush_queued = False
+                self.native_root = self._reconciler.flush_dirty()
+                if not self._flush_queued:
+                    break
+        finally:
+            self._flushing = False
+
+    def mount(self, element: Element, width: float, height: float) -> Any:
+        """Mount ``element`` at the given cell size; returns the native root."""
+        self.native_root = self._reconciler.mount(element)
+        self._reconciler.set_viewport_size(float(width), float(height))
+        return self.native_root
+
+    def rebind(self, element: Element, width: float, height: float) -> Any:
+        """Reconcile the subtree to ``element`` (cell recycled to a new row).
+
+        Cheaper than unmount + mount when consecutive rows share a
+        shape, which is the overwhelmingly common case in lists.
+        Returns the (possibly replaced) native root.
+        """
+        self._reconciler.set_viewport_size(float(width), float(height))
+        self.native_root = self._reconciler.reconcile(element)
+        return self.native_root
+
+    def unmount(self) -> None:
+        """Destroy the subtree and release its native views."""
+        try:
+            self._reconciler.unmount()
+        except Exception:
+            pass
+        self.native_root = None
+
+
+class RowHostPool:
+    """Per-list bookkeeping of row subtrees keyed by native container.
+
+    Platform handlers create one pool per virtualized list view. Keys
+    are platform-stable container identities (Java identity hash on
+    Android, ``contentView`` pointer on iOS).
+    """
+
+    def __init__(self) -> None:
+        self._subtrees: Dict[int, RowSubtree] = {}
+
+    def bind(
+        self,
+        container_key: int,
+        make_element: Callable[[], Element],
+        width: float,
+        height: float,
+    ) -> Any:
+        """Mount or rebind the subtree for ``container_key``.
+
+        Returns the subtree's native root. The caller must (re)attach
+        it to the container: platforms strip a recycled cell's
+        children before rebinding, so even an unchanged root needs
+        re-attachment.
+        """
+        element = make_element()
+        subtree = self._subtrees.get(container_key)
+        if subtree is None:
+            subtree = RowSubtree()
+            self._subtrees[container_key] = subtree
+            return subtree.mount(element, width, height)
+        return subtree.rebind(element, width, height)
+
+    def release(self, container_key: int) -> None:
+        """Unmount the subtree for one recycled container, if any."""
+        subtree = self._subtrees.pop(container_key, None)
+        if subtree is not None:
+            subtree.unmount()
+
+    def release_all(self) -> None:
+        """Unmount every subtree (list destroyed)."""
+        subtrees = list(self._subtrees.values())
+        self._subtrees.clear()
+        for subtree in subtrees:
+            subtree.unmount()
+
+    def __len__(self) -> int:
+        return len(self._subtrees)

{pythonnative-0.22.1.dist-info → pythonnative-0.23.0.dist-info}/METADATA

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

{pythonnative-0.22.1.dist-info → pythonnative-0.23.0.dist-info}/RECORD

@@ -1,26 +1,29 @@
-pythonnative/__init__.py,sha256=ZdUkmJeUWu3oWKFzUxJ6O56P8_7nGgqirhQp_csapHQ,8551
+pythonnative/__init__.py,sha256=vDBibKua43iWhsjL-R5bptS2tJKdkf69RqYs2o61NAw,8861
 pythonnative/_ios_log.py,sha256=Oi7V28VxcVoZyrpAirvLeEmUW18McqnU87V4d37Zzlw,2582
 pythonnative/alerts.py,sha256=mIANysFlaHwL5EqKnvNcyiJN9rGiZi9XDrD9Jpz1RFM,9340
 pythonnative/animated.py,sha256=IBokHVfp_Ud5VC8b4drY9DX8A4uG9wqRUjcW3y-EtkI,36233
-pythonnative/components.py,sha256=0BjsgQUVbiUZkpsX_0vxpuRs8zGV7P9V2HEnZHFEcAE,85248
+pythonnative/appearance.py,sha256=vMkDRIz9ptaprMmlPmiYJLVwrDslfnc1bhwyE27M2ZI,3891
+pythonnative/components.py,sha256=zz3SOZDXABRXHE3bmS56Z9v24X0ewebHnbO_y3r5KOc,115170
 pythonnative/element.py,sha256=W9varJj0Cl9HpckL8BcsC1u4ryUQOPVMrvetro4ilAE,2725
 pythonnative/events.py,sha256=H3XmZW99M16Q1OiRq1NbS6e-Pdopi6piCh6qdkmEu40,7632
 pythonnative/gestures.py,sha256=6qe_s3Cv2M5_V-_PgAQ5y9QbYV812B0xVmh8dRDHYMY,29940
-pythonnative/hooks.py,sha256=spKlbJSFQNg1jKTR9BFwyAf9soYDE5A8_L43W4cu9wU,38987
+pythonnative/hooks.py,sha256=bM0t1WgkRhJ1myovY0AQY_QsHkO66lkeq4hFfRg8d58,40150
 pythonnative/hot_reload.py,sha256=g-PKXRw7IXZgLyuGwjQmztH10JjT8ULM-szrWWTKe7U,25024
+pythonnative/images.py,sha256=JFjBJdZzZoQmAOfQ7QHqi7dYJ75XTs3u2lweQHGbdPc,6466
 pythonnative/layout.py,sha256=Ck_FCLSk0g4hdOzHo0c50cbvLe8Q8caQAxywXgnFhKM,49077
-pythonnative/mutations.py,sha256=aIhA4ESajEIPb1FxGJ6KkJ19vhs6wo1w82A5d52ql9s,4021
+pythonnative/mutations.py,sha256=whmxO6ENWjm-yYH0QteoCV1Gdw_v-fJrhicMQJ5A0rk,3827
 pythonnative/navigation.py,sha256=4U57lHqiJJbqRJdTdvveRHKJ58BJhrwvkDOSoFt02I8,35566
 pythonnative/net.py,sha256=8D7EyEC8-JkYxlrtVfTDApOGzzdcA4P4kaCdYBBZI8E,8082
 pythonnative/platform.py,sha256=WtjxR04CqVhSnjJu-3upk8bwXYaSWr2N0MOVoNov-h0,4994
 pythonnative/platform_metrics.py,sha256=1r1kMbgS9LcVTbdpP5qRD4oHEvw70te5BXEyd_16Ihc,8961
-pythonnative/preview.py,sha256=ZBXOtXuFBeaRXdClhkpIhcQWsLu9fho0qChfPxnbr7w,16982
+pythonnative/preview.py,sha256=bzwW_LgdnCFx8lCBiqlEjwMUa1ggFLYPWmHoMWqyKtg,18041
 pythonnative/reconciler.py,sha256=QFIFG3KjgoPas8LVDHRWouWEEtunegPz-jl6i5Hwno8,57082
 pythonnative/runtime.py,sha256=Ij3xxr_RyWESX7jP7b-RpsYjqjsJi1OpoV3WL3WTBWU,18245
-pythonnative/screen.py,sha256=GxDA8xE1GG35Evf4XwMq6tLTzcggkHN26HtVJFLeHOQ,64834
+pythonnative/screen.py,sha256=AtoQP37HIWrIReecAvQXWHVx9MfW8tTO6AaBWlvroZI,68876
 pythonnative/storage.py,sha256=pp2mqlAy7wPr8vNwtcmalxc2658lD6z7PU4ilbnxAwE,12001
-pythonnative/style.py,sha256=lvJEWm9Gkp77_QQ1PMyum9CLEXFkyqT_7MtCyPZYMsA,15159
+pythonnative/style.py,sha256=kB3tkxJ7LfRr52fodbA2n_OpvSeQAtgMhIVC6oMQISw,17290
 pythonnative/utils.py,sha256=-hwe_YS19ebpjeygdl3dGeVsYzO4G74rYD53svSi0rI,7593
+pythonnative/virtual_rows.py,sha256=4YK3CeZobW-6F6GCXzGNFfmOaAiigmH4HXtqjYDRbyU,5056
 pythonnative/cli/__init__.py,sha256=NM1psvKe8jT0vzp8Ak4MMoygZz4P_msk5g-YEsY8xLk,232
 pythonnative/cli/pn.py,sha256=a0DXYHvcDZtfsmC91mIKgCFTO1Y8T-kkS68RH8_7kaY,28191
 pythonnative/native_modules/__init__.py,sha256=pgigpHuzT-rqwcjlwJvu93_4L8Nozal1HJid0S_JlmM,2636
@@ -38,15 +41,15 @@ pythonnative/native_modules/notifications.py,sha256=WVtzdimc_aGfnxU6syCFPkjHF9YR
 pythonnative/native_modules/permissions.py,sha256=ABIWiCuLIiZJmfA-B7dnw56_Iz7ApGzdtLAs6X694QU,6704
 pythonnative/native_modules/secure_store.py,sha256=PsnUwHzUPt-CzCAwM6BhidOBi9yofRD2uNtQIqAGofU,5953
 pythonnative/native_modules/share.py,sha256=B9ovknmnjeQvGQ8MQ14Hmq6E1x-JA469APMburJ0KUg,4727
-pythonnative/native_views/__init__.py,sha256=8RK0o8pixuqyHhiT5HMWDiya2vHBRJhntjjXzB2HB-U,15638
-pythonnative/native_views/android.py,sha256=RAly8MHQMWt2SY6GNqQB_FYeZpKmivo5Ja7N5LAuAo8,109796
+pythonnative/native_views/__init__.py,sha256=93v7pt0_7f8BWqOiwSvlq20F1oJLfCnmQBvLlCDA-Xk,15340
+pythonnative/native_views/android.py,sha256=2pgsv569rC2eWdHGoIrr1kmI-qB4ZklrMV2G9AO6OpQ,130838
 pythonnative/native_views/base.py,sha256=NFDlEIoKCINzcVkf2uobT9TgujPb1RClLS3TzwH72MY,9668
-pythonnative/native_views/desktop.py,sha256=731Uz-TPb0lGhPAcAo_8l-8B62lgZIr8h_H1BViSFGw,57116
-pythonnative/native_views/ios.py,sha256=ySsTKYRcVLfbaw60U6yNTguEOSYqXLC_8xy59G4hjA4,141502
+pythonnative/native_views/desktop.py,sha256=GnZEchJLUcH74jG_21CCzjdYcEmm-5etUX2D0-_WNtQ,59735
+pythonnative/native_views/ios.py,sha256=fgskhuENQO-aiw527xOrveeRClX8uFt5UdqKSCsBT_8,169080
 pythonnative/project/__init__.py,sha256=kAhWLONs53H1L7xVtczLmzYcQSOOkdRZTAJnIMhpBts,2064
 pythonnative/project/android.py,sha256=SX0uu4-tz4WdYAf9sbycQPSmoQ8fbtAADeUWk9G8ybM,19127
 pythonnative/project/builder.py,sha256=DokY-YidsDeWYgaixrpD3Kzp7_XudibltI8X_WdBIcE,19096
-pythonnative/project/config.py,sha256=LeaRgwXznuk2hazbM2aOIDGeZ6FBoSkUBVmony5Wg-Q,24210
+pythonnative/project/config.py,sha256=jH9_MnE5kmKGe3yA4tfPHic5LlKcWys58jxOmUSJTd4,23839
 pythonnative/project/doctor.py,sha256=ETg-lvEyaNzaxgsDn9f4DBapNKBttMHA-9kwgX-yb3g,7943
 pythonnative/project/icons.py,sha256=GaXpktQ9v4v2JZPM3ppueNPmwjTuFiLanHJDaZbLGuo,7945
 pythonnative/project/ios.py,sha256=DHQs_Wf_uJ9eoI3gqGmcjFuF2shwMwa8mLKGtuTDffw,14004
@@ -62,9 +65,12 @@ pythonnative/templates/android_template/settings.gradle,sha256=GKZiYUYWsaXxaiKOB
 pythonnative/templates/android_template/app/build.gradle,sha256=zHYbYXjKUiW-ZSYXT2GfveyVnjOCNLXvXpPxI76O5t4,1864
 pythonnative/templates/android_template/app/proguard-rules.pro,sha256=Vv2WDPIl9spA-YKxOl27DYvD394T_3ZCKCXGBw0KGJA,750
 pythonnative/templates/android_template/app/src/androidTest/java/com/pythonnative/android_template/ExampleInstrumentedTest.kt,sha256=Am8Yla3i1eR_ac5FVgPU_RsuMrCbyT79h1BcajGE-zI,693
-pythonnative/templates/android_template/app/src/main/AndroidManifest.xml,sha256=MdWrXxOrwUjnqtDbV952NI4nVF2dTUX9xwSS8chhd9I,940
+pythonnative/templates/android_template/app/src/main/AndroidManifest.xml,sha256=eprO6TQuZN0UEVsMcg2oXDaPUuVuYJWMg3GScNsfC8k,995
 pythonnative/templates/android_template/app/src/main/java/com/pythonnative/android_template/MainActivity.kt,sha256=1dSBEX-AB2aUPxFFDnWwcmVHRi00T-iwbXi4yt4RQk8,1481
 pythonnative/templates/android_template/app/src/main/java/com/pythonnative/android_template/Navigator.kt,sha256=mDfzKTTXRP-zbSnfIPxAYyjtr9_IyyQwXM-dovcfVbg,1723
+pythonnative/templates/android_template/app/src/main/java/com/pythonnative/android_template/PNAccessibilityDelegate.kt,sha256=R2PC6BA3VCaKET0XV33tXTFf4Ht9udvvLu9TT_RfWp4,1819
+pythonnative/templates/android_template/app/src/main/java/com/pythonnative/android_template/PNBorderDrawable.kt,sha256=ejdFhpzn0-2TZa0nvG41r2m0xoejU2fXXuJSmO6tnBU,2205
+pythonnative/templates/android_template/app/src/main/java/com/pythonnative/android_template/PNVirtualListView.java,sha256=1ve74nvOFqsduyaLOGPb8Sd9Jrwz-sELRB9y1NMN1AI,6072
 pythonnative/templates/android_template/app/src/main/java/com/pythonnative/android_template/ScreenFragment.kt,sha256=lSxWYH6cGDpGalo0kDzTAT5H3NuhJVLT7BQYcfCydOc,5138
 pythonnative/templates/android_template/app/src/main/res/drawable/ic_launcher_background.xml,sha256=7UI8c6b0Ck0pCfCQHmBSezqAfNWeG1WTvKrhgIscYyE,5606
 pythonnative/templates/android_template/app/src/main/res/drawable-v24/ic_launcher_foreground.xml,sha256=AdGmpsEjTrf-Jw0JfrKD1yucla5RGIhvG2VzqtKA8fc,1702
@@ -105,9 +111,9 @@ pythonnative/templates/ios_template/ios_template.xcodeproj/project.xcworkspace/x
 pythonnative/templates/ios_template/ios_templateTests/ios_templateTests.swift,sha256=YnwzZx7yXB13xKAXEGNgz17VuhWeqkHTRTtBJ2Vu3_E,1238
 pythonnative/templates/ios_template/ios_templateUITests/ios_templateUITests.swift,sha256=HLRr3cmouRqQeXG13WrZ2XSAmgMgCsNXfZpbwkxeFcs,1385
 pythonnative/templates/ios_template/ios_templateUITests/ios_templateUITestsLaunchTests.swift,sha256=f5JrG0uVtLMeJQy26Yyz7Om-JUkT220osqcbeIVkj2g,815
-pythonnative-0.22.1.dist-info/licenses/LICENSE,sha256=A69iG7TIAe6KkGQf6xoVHkc5JSZtOr5eRSvC5iuivnI,1067
-pythonnative-0.22.1.dist-info/METADATA,sha256=8AdKrxbqYwpGdyEc69TN-a6_4T1Sg20NDHkMv1sEbV4,10347
-pythonnative-0.22.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-pythonnative-0.22.1.dist-info/entry_points.txt,sha256=iUtDawWSAJAEyWTycpZxDuYz73ol31butpzDIEAgPO0,48
-pythonnative-0.22.1.dist-info/top_level.txt,sha256=kT4SEATY2ywzrZ2Pgea6_zxyym44Q_PbOsUoOYjJLFE,13
-pythonnative-0.22.1.dist-info/RECORD,,
+pythonnative-0.23.0.dist-info/licenses/LICENSE,sha256=A69iG7TIAe6KkGQf6xoVHkc5JSZtOr5eRSvC5iuivnI,1067
+pythonnative-0.23.0.dist-info/METADATA,sha256=t0952y_u74dbBtuyPdG1VHdQO3E8M8Iqi_EAxtmPGH4,10347
+pythonnative-0.23.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+pythonnative-0.23.0.dist-info/entry_points.txt,sha256=iUtDawWSAJAEyWTycpZxDuYz73ol31butpzDIEAgPO0,48
+pythonnative-0.23.0.dist-info/top_level.txt,sha256=kT4SEATY2ywzrZ2Pgea6_zxyym44Q_PbOsUoOYjJLFE,13
+pythonnative-0.23.0.dist-info/RECORD,,

{pythonnative-0.22.1.dist-info → pythonnative-0.23.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (83.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any