pythonnative 0.7.0__py3-none-any.whl → 0.8.0__py3-none-any.whl

pythonnative/reconciler.py

@@ -11,8 +11,12 @@ Supports:
   ``@component``).  Their hook state is preserved across renders.
 - **Provider elements** (type ``"__Provider__"``), which push/pop
   context values during tree traversal.
+- **Error boundary elements** (type ``"__ErrorBoundary__"``), which
+  catch exceptions in child subtrees and render a fallback.
 - **Key-based child reconciliation** for stable identity across
   re-renders.
+- **Post-render effect flushing**: after each mount or reconcile pass,
+  all queued effects are executed so they see the committed native tree.
 """
 
 from typing import Any, List, Optional
@@ -36,6 +40,10 @@ class VNode:
 class Reconciler:
     """Create, diff, and patch native view trees from Element descriptors.
 
+    After each ``mount`` or ``reconcile`` call the reconciler walks the
+    committed tree and flushes all pending effects so that effect
+    callbacks run **after** native mutations are applied.
+
     Parameters
     ----------
     backend:
@@ -56,6 +64,7 @@ class Reconciler:
     def mount(self, element: Element) -> Any:
         """Build native views from *element* and return the root native view."""
         self._tree = self._create_tree(element)
+        self._flush_effects()
         return self._tree.native_view
 
     def reconcile(self, new_element: Element) -> Any:
@@ -65,11 +74,28 @@ class Reconciler:
         """
         if self._tree is None:
             self._tree = self._create_tree(new_element)
+            self._flush_effects()
             return self._tree.native_view
 
         self._tree = self._reconcile_node(self._tree, new_element)
+        self._flush_effects()
         return self._tree.native_view
 
+    # ------------------------------------------------------------------
+    # Effect flushing
+    # ------------------------------------------------------------------
+
+    def _flush_effects(self) -> None:
+        """Walk the committed tree and flush pending effects (depth-first)."""
+        if self._tree is not None:
+            self._flush_tree_effects(self._tree)
+
+    def _flush_tree_effects(self, node: VNode) -> None:
+        for child in node.children:
+            self._flush_tree_effects(child)
+        if node.hook_state is not None:
+            node.hook_state.flush_pending_effects()
+
     # ------------------------------------------------------------------
     # Internal helpers
     # ------------------------------------------------------------------
@@ -87,6 +113,10 @@ class Reconciler:
             children = [child_node] if child_node else []
             return VNode(element, native_view, children)
 
+        # Error boundary: catch exceptions in the child subtree
+        if element.type == "__ErrorBoundary__":
+            return self._create_error_boundary(element)
+
         # Function component: call with hook context
         if callable(element.type):
             from .hooks import HookState, _set_hook_state
@@ -114,6 +144,20 @@ class Reconciler:
             children.append(child_node)
         return VNode(element, native_view, children)
 
+    def _create_error_boundary(self, element: Element) -> VNode:
+        fallback_fn = element.props.get("__fallback__")
+        try:
+            child_node = self._create_tree(element.children[0]) if element.children else None
+        except Exception as exc:
+            if fallback_fn is not None:
+                fallback_el = fallback_fn(exc) if callable(fallback_fn) else fallback_fn
+                child_node = self._create_tree(fallback_el)
+            else:
+                raise
+        native_view = child_node.native_view if child_node else None
+        children = [child_node] if child_node else []
+        return VNode(element, native_view, children)
+
     def _reconcile_node(self, old: VNode, new_el: Element) -> VNode:
         if not self._same_type(old.element, new_el):
             new_node = self._create_tree(new_el)
@@ -138,6 +182,10 @@ class Reconciler:
             old.element = new_el
             return old
 
+        # Error boundary
+        if new_el.type == "__ErrorBoundary__":
+            return self._reconcile_error_boundary(old, new_el)
+
         # Function component
         if callable(new_el.type):
             from .hooks import _set_hook_state
@@ -175,10 +223,34 @@ class Reconciler:
         old.element = new_el
         return old
 
+    def _reconcile_error_boundary(self, old: VNode, new_el: Element) -> VNode:
+        fallback_fn = new_el.props.get("__fallback__")
+        try:
+            if old.children and new_el.children:
+                child = self._reconcile_node(old.children[0], new_el.children[0])
+                old.children = [child]
+                old.native_view = child.native_view
+            elif new_el.children:
+                child = self._create_tree(new_el.children[0])
+                old.children = [child]
+                old.native_view = child.native_view
+        except Exception as exc:
+            for c in old.children:
+                self._destroy_tree(c)
+            if fallback_fn is not None:
+                fallback_el = fallback_fn(exc) if callable(fallback_fn) else fallback_fn
+                child = self._create_tree(fallback_el)
+                old.children = [child]
+                old.native_view = child.native_view
+            else:
+                raise
+        old.element = new_el
+        return old
+
     def _reconcile_children(self, parent: VNode, new_children: List[Element]) -> None:
         old_children = parent.children
         parent_type = parent.element.type
-        is_native = isinstance(parent_type, str) and parent_type != "__Provider__"
+        is_native = isinstance(parent_type, str) and parent_type not in ("__Provider__", "__ErrorBoundary__")
 
         old_by_key: dict = {}
         old_unkeyed: list = []
@@ -215,7 +287,11 @@ class Reconciler:
                     self.backend.insert_child(parent.native_view, node.native_view, parent_type, i)
                 new_child_nodes.append(node)
             else:
+                old_native = matched.native_view
                 updated = self._reconcile_node(matched, new_el)
+                if is_native and updated.native_view is not old_native:
+                    self.backend.remove_child(parent.native_view, old_native, parent_type)
+                    self.backend.insert_child(parent.native_view, updated.native_view, parent_type, i)
                 new_child_nodes.append(updated)
 
         # Destroy unused old nodes
@@ -229,6 +305,18 @@ class Reconciler:
                 self.backend.remove_child(parent.native_view, node.native_view, parent_type)
             self._destroy_tree(node)
 
+        # Reorder native children when keyed children changed positions.
+        # Without this, native sibling order drifts from the logical tree
+        # when keyed children swap positions across reconcile passes.
+        if is_native and used_keyed:
+            old_key_order = [c.element.key for c in old_children if c.element.key in used_keyed]
+            new_key_order = [n.element.key for n in new_child_nodes if n.element.key in used_keyed]
+            if old_key_order != new_key_order:
+                for node in new_child_nodes:
+                    self.backend.remove_child(parent.native_view, node.native_view, parent_type)
+                for node in new_child_nodes:
+                    self.backend.add_child(parent.native_view, node.native_view, parent_type)
+
         parent.children = new_child_nodes
 
     def _destroy_tree(self, node: VNode) -> None:

{pythonnative-0.7.0.dist-info → pythonnative-0.8.0.dist-info}/METADATA

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

{pythonnative-0.7.0.dist-info → pythonnative-0.8.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
-pythonnative/__init__.py,sha256=jhPsaI_qyTEQ_YMT5pJumYOQKYamfHbPalWd5VbJ5vY,1575
-pythonnative/components.py,sha256=dvLaXmCFU8O6bnYdudwBVsvad1DkwvmMJoTZRAZi540,10534
+pythonnative/__init__.py,sha256=PJ5VzzASR3xUdgP1iPlGtwXaxzNmC-c_UlJeKu0mCBQ,2038
+pythonnative/components.py,sha256=zF24vXM6halq-fweLtLHxZrmBrUKCa9c44hf9Bych-Y,12767
 pythonnative/element.py,sha256=RBUsXzzzM7KdK-NqMD-InVPKdAb8XJ0h0VpI2rwsfHs,1795
-pythonnative/hooks.py,sha256=UMoNTFoMKON4uJpUU9WHBv60tR2GUvx4Q_OgfG24Xcg,10361
-pythonnative/hot_reload.py,sha256=GoooBkRm2_zu_bQGOsOvUx-x9GdFcvRwSWEkhltFg2Y,4498
-pythonnative/native_views.py,sha256=VuqseL-QRHsEoGe3j3Ubh-iPo0dAkx-rcieZqWlt5ho,62037
-pythonnative/page.py,sha256=Pjf2o-0ufmn_6q2hyRZ3zrnHWkDTm2PD6rI4niQTfS8,14803
-pythonnative/reconciler.py,sha256=4Ah8NtYawZH9ZHXoMMjMTfdrTkZ0b4OT3e_85WLTrbU,9850
+pythonnative/hooks.py,sha256=bqnJvEpbYSlbwkBKphT5lLEXQ1mO6AlO4r9SCTBlu7w,13768
+pythonnative/hot_reload.py,sha256=dtppJaQI6Rl7muCTMgLjFNsD4_F4yYnkEpliCLaaWm8,4508
+pythonnative/navigation.py,sha256=dDY9qBPLJKr2NnvdIDs8Xy-6kFesQNCEaLjUDT-0_l8,19042
+pythonnative/page.py,sha256=ya-UUk_0_lO2YLx3UmBjtPL0j1YXItzP3VhPIloRhXQ,16168
+pythonnative/reconciler.py,sha256=EuB8InxqlbZpZ0qI8hSjwNQsS-lsvh0vdqGzTnmY1M8,14133
 pythonnative/style.py,sha256=NG58FSJCBTBBWRrDOyUiHZsTxQDA3jg2PSOcCsU2F5g,3882
 pythonnative/utils.py,sha256=IqR_GYknveM_NfAblcaizg9S66hCZfrfiH08HzpOc-4,2537
 pythonnative/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -15,6 +15,10 @@ pythonnative/native_modules/camera.py,sha256=b3UErkABhBm2nQ-e72lEeFOgXoVDY6245cV
 pythonnative/native_modules/file_system.py,sha256=2fvYsIboCtjEyxmVeV72glOjtc9fJN3jTM6uaccru6E,4478
 pythonnative/native_modules/location.py,sha256=bMSNbtG60hAorKXh4RR2vybX88M_BwHkCpTprRbMsZU,1883
 pythonnative/native_modules/notifications.py,sha256=g-zT1GD-ojPsLN5eGXWkyNHTncSxdiEYtjllCXlsBSc,5377
+pythonnative/native_views/__init__.py,sha256=0weXhCaDT79sez9Q1JibXSgouRVB1tjucFibhbPQeYc,2984
+pythonnative/native_views/android.py,sha256=59_VzpGlADHFrY2cG8llVn4sDmPkUSGyUVKbyvfkKiU,32686
+pythonnative/native_views/base.py,sha256=IS4_AQd4WsHgn8fka8np9zpaKdAOn1q0Zo09a8wYOtE,4229
+pythonnative/native_views/ios.py,sha256=G5bQz57v5WSw5-wNmpcrcdX3rb7isb126la7UlveZLA,30087
 pythonnative/templates/android_template/build.gradle,sha256=4gE6CRS6RuBu9kp-_e_uYYU9mBgHVZrqQg9caSxgyuc,352
 pythonnative/templates/android_template/gradle.properties,sha256=REPaKLRfQiiVfIV8wYmgwzPWvF1f3bhh_kAMV9p4HME,1358
 pythonnative/templates/android_template/gradlew,sha256=YxNShxF6Hm0SyEWA8fScYdG6AiGOzShmBgXpf5dufWU,5766
@@ -66,9 +70,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=l2Pwa50F_rv-qPu2go6e4bQernM6PTQJeNPFl_c4ivY,1387
 pythonnative/templates/ios_template/ios_templateUITests/ios_templateUITestsLaunchTests.swift,sha256=f5JrG0uVtLMeJQy26Yyz7Om-JUkT220osqcbeIVkj2g,815
-pythonnative-0.7.0.dist-info/licenses/LICENSE,sha256=A69iG7TIAe6KkGQf6xoVHkc5JSZtOr5eRSvC5iuivnI,1067
-pythonnative-0.7.0.dist-info/METADATA,sha256=aa5sabkb9mMAcl_PSvvkIeFfHKlkpOnxJZRkMLTc3gE,6692
-pythonnative-0.7.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-pythonnative-0.7.0.dist-info/entry_points.txt,sha256=iUtDawWSAJAEyWTycpZxDuYz73ol31butpzDIEAgPO0,48
-pythonnative-0.7.0.dist-info/top_level.txt,sha256=kT4SEATY2ywzrZ2Pgea6_zxyym44Q_PbOsUoOYjJLFE,13
-pythonnative-0.7.0.dist-info/RECORD,,
+pythonnative-0.8.0.dist-info/licenses/LICENSE,sha256=A69iG7TIAe6KkGQf6xoVHkc5JSZtOr5eRSvC5iuivnI,1067
+pythonnative-0.8.0.dist-info/METADATA,sha256=FZB-auwBCmhEBCt3nKpY7ZSNN3mF6_kbDLjVNWwfBMw,6692
+pythonnative-0.8.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pythonnative-0.8.0.dist-info/entry_points.txt,sha256=iUtDawWSAJAEyWTycpZxDuYz73ol31butpzDIEAgPO0,48
+pythonnative-0.8.0.dist-info/top_level.txt,sha256=kT4SEATY2ywzrZ2Pgea6_zxyym44Q_PbOsUoOYjJLFE,13
+pythonnative-0.8.0.dist-info/RECORD,,