flet 0.82.3.dev7863__tar.gz → 0.82.3.dev7877__tar.gz

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7863
+Version: 0.82.3.dev7877
 Summary: Flet for Python - easily build interactive multi-platform apps in Python
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -9,23 +9,23 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://docs.flet.dev/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7877; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7877; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Pyodide"
 Requires-Dist: httpx>=0.28.1; platform_system != "Pyodide"
 Requires-Dist: repath>=0.9.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: typing-extensions; python_version < "3.11"
 Provides-Extra: all
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7863; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7877; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7877; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7877; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7877; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7863; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7877; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7877; extra == "web"
 
 <p align="center">
   <a href="https://flet.dev"><img src="https://raw.githubusercontent.com/flet-dev/flet/refs/heads/main/media/logo/flet-logo.svg" height="150" alt="Flet logo"></a>

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "0.82.3.dev7863"
+version = "0.82.3.dev7877"
 description = "Flet for Python - easily build interactive multi-platform apps in Python"
 authors = [{name = "Appveyor Systems Inc.", email = "hello@flet.dev"}]
 license = "Apache-2.0"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "flet-cli==0.82.3.dev7863; extra == 'cli'",
-    "flet-web==0.82.3.dev7863; extra == 'web'",
+    "flet-cli==0.82.3.dev7877; extra == 'cli'",
+    "flet-web==0.82.3.dev7877; extra == 'web'",
     "oauthlib >=3.2.2; platform_system != 'Pyodide'",
     "httpx >=0.28.1; platform_system != 'Pyodide'",
     "repath >=0.9.0",
@@ -23,15 +23,15 @@ Documentation = "https://docs.flet.dev/"
 
 [project.optional-dependencies]
 all = [
-    "flet-cli==0.82.3.dev7863",
-    "flet-web==0.82.3.dev7863",
-    "flet-desktop==0.82.3.dev7863",
+    "flet-cli==0.82.3.dev7877",
+    "flet-web==0.82.3.dev7877",
+    "flet-desktop==0.82.3.dev7877",
 ]
-cli = ["flet-cli==0.82.3.dev7863"]
+cli = ["flet-cli==0.82.3.dev7877"]
 desktop = [
-    "flet-desktop==0.82.3.dev7863",
+    "flet-desktop==0.82.3.dev7877",
 ]
-web = ["flet-web==0.82.3.dev7863"]
+web = ["flet-web==0.82.3.dev7877"]
 
 [project.scripts]
 flet = "flet.cli:main"

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/src/flet/controls/context.py

@@ -110,6 +110,27 @@ class Context:
         """
         return self.__components_mode
 
+    def mark_update_called(self):
+        """
+        Marks that `.update()` was explicitly called during the current handler.
+        """
+        _update_behavior_context_var.get()._update_called = True
+
+    def was_update_called(self) -> bool:
+        """
+        Returns whether `.update()` was explicitly called during the current handler.
+
+        Returns:
+            `True` if `.update()` was called, `False` otherwise.
+        """
+        return _update_behavior_context_var.get()._update_called
+
+    def reset_update_called(self):
+        """
+        Resets the update-called flag for the current context.
+        """
+        _update_behavior_context_var.get()._update_called = False
+
     def auto_update_enabled(self) -> bool:
         """
         Returns whether auto-update is enabled in the current context.
@@ -143,6 +164,7 @@ class UpdateBehavior:
     """
 
     _auto_update_enabled: bool = True
+    _update_called: bool = False
 
 
 _context_page = ContextVar("flet_session_page", default=None)

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/src/flet/controls/material/reorderable_list_view.py

@@ -14,15 +14,26 @@ from flet.controls.types import MouseCursor, Number
 @dataclass
 class OnReorderEvent(Event["ReorderableListView"]):
     """
-    Represents an event triggered during the reordering of items in a \
-    [`ReorderableListView`][flet.].
+    Payload for [`ReorderableListView`][flet.] events related to item reordering.
     """
 
-    new_index: Optional[int]
-    """The new position of the item after reordering."""
+    new_index: Optional[int] = None
+    """
+    The new position of the item after the reordering, if available.
+
+    Will be non-`None` only for the following events:
+    [`ReorderableListView.on_reorder`][flet.],
+    [`ReorderableListView.on_reorder_end`][flet.].
+    """
 
-    old_index: Optional[int]
-    """The original/previous position of the item before reordering."""
+    old_index: Optional[int] = None
+    """
+    The previous position of the item before the reordering, if available.
+
+    Will be non-`None` only for the following events:
+    [`ReorderableListView.on_reorder`][flet.],
+    [`ReorderableListView.on_reorder_start`][flet.].
+    """
 
 
 @control("ReorderableListView")
@@ -53,7 +64,13 @@ class ReorderableListView(ListView):
 
     controls: list[Control] = field(default_factory=list)
     """
-    The controls to be reordered.
+    The controls displayed by this [`ReorderableListView`][(c)].
+
+    Note:
+        When an item of this list gets reordered, [`on_reorder`][(c).] event gets
+        fired, but it doesn't reorder the `controls` list automatically. So, to keep
+        `controls` list in sync with the UI, reorder this list inside your
+        [`on_reorder`][(c).] event handler. ([example][(c).on_reorder])
     """
 
     anchor: Number = 0.0
@@ -89,13 +106,12 @@ class ReorderableListView(ListView):
 
     The default desktop drag handle is just an `Icons.DRAG_HANDLE`
     wrapped by a [`ReorderableDragHandle`][flet.]. On mobile platforms, the entire
-    item is wrapped with a [`ReorderableDelayedDragStartListener`].
+    item is wrapped with a [`ReorderableDragHandle`][flet.].
 
     To customize the appearance or layout of drag handles, wrap each
     [`controls`][(c).] item, or a control within each of them, with a
-    [`ReorderableDragHandle`][flet.], [`ReorderableDelayedDragStartListener`],
-    or your own subclass of [`ReorderableDragHandle`][flet.]. For full control
-    over the drag handles, you might want to set `show_default_drag_handles` to `False`.
+    [`ReorderableDragHandle`][flet.]. For full control over the drag handles,
+    you might want to set `show_default_drag_handles` to `False`.
 
     Example:
         ```python
@@ -122,9 +138,23 @@ class ReorderableListView(ListView):
 
     on_reorder: Optional[EventHandler[OnReorderEvent]] = None
     """
-    Called when a [`controls`][(c).] item has been dragged to a new location/position \
-    and the order of the items gets updated.
-    """
+    Called when a [`controls`][(c).] item has been dragged to a new location/position.
+
+    Note:
+        This event does not reorder [`controls`][(c).] automatically. So, to keep
+        [`controls`][(c).] list in sync with the UI, reorder it accordingly inside
+        your `on_reorder` event handler.
+
+        /// admonition | Example
+        ```python
+            def handle_reorder(e: ft.OnReorderEvent):
+                rlv = e.control
+                moved_item = rlv.controls.pop(e.old_index)  # Remove the reordered item from its old position
+                rlv.controls.insert(e.new_index, moved_item)  # Insert the reordered item into its new position
+                rlv.update()
+        ```
+        ///
+    """  # noqa: E501
 
     on_reorder_start: Optional[EventHandler[OnReorderEvent]] = None
     """

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/src/flet/controls/page.py

@@ -660,6 +660,7 @@ class Page(BasePage):
             *controls: Specific controls to patch. When omitted, patches the
                 whole page state.
         """
+        context.mark_update_called()
 
         if len(controls) == 0:
             self.__update(self)

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/src/flet/messaging/session.py

@@ -435,8 +435,9 @@ class Session:
             control: Control that handled the event, or `None`.
         """
         # call auto-update
-        if context.auto_update_enabled():
+        if context.auto_update_enabled() and not context.was_update_called():
             await self.__auto_update(control)
+        context.reset_update_called()
 
         # unregister unreferenced services
         self.page._services.unregister_services()

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/src/flet/version.py

@@ -16,7 +16,7 @@ __all__ = [
 ]
 
 # set by CI
-flet_version = "0.82.3.dev7863"
+flet_version = "0.82.3.dev7877"
 """
 The Flet version in use.
 

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/src/flet.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7863
+Version: 0.82.3.dev7877
 Summary: Flet for Python - easily build interactive multi-platform apps in Python
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -9,23 +9,23 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://docs.flet.dev/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7877; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7877; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Pyodide"
 Requires-Dist: httpx>=0.28.1; platform_system != "Pyodide"
 Requires-Dist: repath>=0.9.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: typing-extensions; python_version < "3.11"
 Provides-Extra: all
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7863; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7877; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7877; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7877; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7877; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7863; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7877; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7877; extra == "web"
 
 <p align="center">
   <a href="https://flet.dev"><img src="https://raw.githubusercontent.com/flet-dev/flet/refs/heads/main/media/logo/flet-logo.svg" height="150" alt="Flet logo"></a>

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/src/flet.egg-info/SOURCES.txt

@@ -294,4 +294,5 @@ tests/test_object_diff_memory_churn.py
 tests/test_object_diff_performance.py
 tests/test_observable.py
 tests/test_patch_dataclass.py
-tests/test_session_disconnect_buffering.py
+tests/test_session_disconnect_buffering.py
+tests/test_skip_double_update.py

{flet-0.82.3.dev7863 → flet-0.82.3.dev7877}/src/flet.egg-info/requires.txt

@@ -2,10 +2,10 @@ repath>=0.9.0
 msgpack>=1.1.0
 
 [:extra == "cli"]
-flet-cli==0.82.3.dev7863
+flet-cli==0.82.3.dev7877
 
 [:extra == "web"]
-flet-web==0.82.3.dev7863
+flet-web==0.82.3.dev7877
 
 [:platform_system != "Pyodide"]
 oauthlib>=3.2.2
@@ -15,15 +15,15 @@ httpx>=0.28.1
 typing-extensions
 
 [all]
-flet-cli==0.82.3.dev7863
-flet-web==0.82.3.dev7863
-flet-desktop==0.82.3.dev7863
+flet-cli==0.82.3.dev7877
+flet-web==0.82.3.dev7877
+flet-desktop==0.82.3.dev7877
 
 [cli]
-flet-cli==0.82.3.dev7863
+flet-cli==0.82.3.dev7877
 
 [desktop]
-flet-desktop==0.82.3.dev7863
+flet-desktop==0.82.3.dev7877
 
 [web]
-flet-web==0.82.3.dev7863
+flet-web==0.82.3.dev7877

flet-0.82.3.dev7877/tests/test_skip_double_update.py

@@ -0,0 +1,137 @@
+"""Tests for skipping auto-update when .update() was already called."""
+
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from flet.controls.context import UpdateBehavior, _update_behavior_context_var, context
+from flet.messaging.connection import Connection
+from flet.messaging.session import Session
+from flet.pubsub.pubsub_hub import PubSubHub
+
+
+@pytest.fixture(autouse=True)
+def _fresh_update_behavior():
+    """Ensure each test starts with a clean UpdateBehavior."""
+    token = _update_behavior_context_var.set(UpdateBehavior())
+    yield
+    _update_behavior_context_var.reset(token)
+
+
+def _make_session():
+    conn = Connection()
+    conn.pubsubhub = PubSubHub()
+    return Session(conn)
+
+
+# --- Context flag unit tests ---
+
+
+def test_update_called_flag_defaults_to_false():
+    assert context.was_update_called() is False
+
+
+def test_mark_update_called_sets_flag():
+    context.mark_update_called()
+    assert context.was_update_called() is True
+
+
+def test_reset_update_called_clears_flag():
+    context.mark_update_called()
+    context.reset_update_called()
+    assert context.was_update_called() is False
+
+
+def test_reset_auto_update_starts_with_clean_flag():
+    context.mark_update_called()
+    context.reset_auto_update()
+    assert context.was_update_called() is False
+
+
+# --- after_event integration tests ---
+
+
+@pytest.mark.asyncio
+async def test_after_event_skips_auto_update_when_update_was_called():
+    session = _make_session()
+    context.mark_update_called()
+
+    with patch.object(
+        session, "_Session__auto_update", new_callable=AsyncMock
+    ) as mock_auto:
+        await session.after_event(session.page)
+        mock_auto.assert_not_called()
+
+
+@pytest.mark.asyncio
+async def test_after_event_runs_auto_update_when_update_was_not_called():
+    session = _make_session()
+
+    with patch.object(
+        session, "_Session__auto_update", new_callable=AsyncMock
+    ) as mock_auto:
+        await session.after_event(session.page)
+        mock_auto.assert_called_once_with(session.page)
+
+
+@pytest.mark.asyncio
+async def test_after_event_resets_flag_after_check():
+    session = _make_session()
+    context.mark_update_called()
+
+    with patch.object(session, "_Session__auto_update", new_callable=AsyncMock):
+        await session.after_event(session.page)
+
+    assert context.was_update_called() is False
+
+
+@pytest.mark.asyncio
+async def test_after_event_resets_flag_even_when_auto_update_disabled():
+    session = _make_session()
+    context.mark_update_called()
+    context.disable_auto_update()
+
+    with patch.object(session, "_Session__auto_update", new_callable=AsyncMock):
+        await session.after_event(session.page)
+
+    assert context.was_update_called() is False
+
+
+# --- Generator handler simulation ---
+
+
+@pytest.mark.asyncio
+async def test_generator_handler_flag_resets_between_yields():
+    """Simulate a generator handler where after_event is called after each yield.
+
+    First yield: .update() was called -> skip auto-update
+    Second yield: no .update() called  -> auto-update fires
+    """
+    session = _make_session()
+
+    with patch.object(
+        session, "_Session__auto_update", new_callable=AsyncMock
+    ) as mock_auto:
+        # First yield segment: user called .update()
+        context.mark_update_called()
+        await session.after_event(session.page)
+        assert mock_auto.call_count == 0
+
+        # Second yield segment: no .update() called
+        await session.after_event(session.page)
+        assert mock_auto.call_count == 1
+
+
+# --- Page.update() marks the flag ---
+
+
+def test_page_update_marks_flag():
+    session = _make_session()
+    page = session.page
+
+    # Page.update() internally calls patch_control which needs a real connection,
+    # so we mock __update to isolate the flag-setting behavior.
+    with patch.object(page, "_Page__update"):
+        page.update()
+
+    assert context.was_update_called() is True