flet 0.82.3.dev7876__tar.gz → 0.82.3.dev7882__tar.gz

{flet-0.82.3.dev7876 → flet-0.82.3.dev7882}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7876
+Version: 0.82.3.dev7882
 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.dev7876; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7876; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7882; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7882; 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.dev7876; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7876; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7876; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7882; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7882; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7882; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7876; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7882; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7876; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7882; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7876; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7882; 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.dev7876 → flet-0.82.3.dev7882}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "0.82.3.dev7876"
+version = "0.82.3.dev7882"
 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.dev7876; extra == 'cli'",
-    "flet-web==0.82.3.dev7876; extra == 'web'",
+    "flet-cli==0.82.3.dev7882; extra == 'cli'",
+    "flet-web==0.82.3.dev7882; 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.dev7876",
-    "flet-web==0.82.3.dev7876",
-    "flet-desktop==0.82.3.dev7876",
+    "flet-cli==0.82.3.dev7882",
+    "flet-web==0.82.3.dev7882",
+    "flet-desktop==0.82.3.dev7882",
 ]
-cli = ["flet-cli==0.82.3.dev7876"]
+cli = ["flet-cli==0.82.3.dev7882"]
 desktop = [
-    "flet-desktop==0.82.3.dev7876",
+    "flet-desktop==0.82.3.dev7882",
 ]
-web = ["flet-web==0.82.3.dev7876"]
+web = ["flet-web==0.82.3.dev7882"]
 
 [project.scripts]
 flet = "flet.cli:main"

{flet-0.82.3.dev7876 → flet-0.82.3.dev7882}/src/flet/auth/authorization_service.py

@@ -72,7 +72,7 @@ class AuthorizationService(Authorization):
         await self.__refresh_token()
         await self.__fetch_user_and_groups()
 
-    async def get_token(self):
+    async def get_token(self) -> Optional[OAuthToken]:
         """
         Return current token after applying refresh logic when required.
 

{flet-0.82.3.dev7876 → flet-0.82.3.dev7882}/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.dev7876 → flet-0.82.3.dev7882}/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.dev7882/src/flet/controls/services/shared_preferences.py

@@ -0,0 +1,104 @@
+from typing import Optional, TypeAlias, Union
+
+from flet.controls.base_control import control
+from flet.controls.services.service import Service
+
+__all__ = ["SharedPreferences", "SharedPreferencesValueType"]
+
+SharedPreferencesValueType: TypeAlias = Union[str, int, float, bool, list[str]]
+"""Supported types for [`SharedPreferences`][flet.] values."""
+
+
+@control("SharedPreferences")
+class SharedPreferences(Service):
+    """
+    Provides access to persistent key-value storage.
+    """
+
+    async def set(self, key: str, value: SharedPreferencesValueType) -> bool:
+        """
+        Sets a value for the given key.
+
+        Note:
+            Due to limitations on Android, it is not possible to set values that start
+            with any of the following: `VGhpcyBpcyB0aGUgcHJlZml4IGZvciBhIGxpc3Qu`,
+            `VGhpcyBpcyB0aGUgcHJlZml4IGZvciBCaWdJbnRlZ2Vy`, and
+            `VGhpcyBpcyB0aGUgcHJlZml4IGZvciBEb3VibGUu`.
+
+        Args:
+            key: The key to store the value under.
+            value: The value to store.
+
+        Returns:
+            `True` if the value was set successfully, `False` otherwise.
+
+        Raises:
+            ValueError: If `value` is of an unsupported type
+                (`str`, `int`, `float`, `bool`, and `list[str]`).
+        """
+        if not (
+            isinstance(value, (str, int, float, bool))
+            or (isinstance(value, list) and all(isinstance(x, str) for x in value))
+        ):
+            raise ValueError(
+                f"Unsupported value type: {type(value)}. "
+                "Supported types are: str, int, float, bool, list[str]."
+            )
+        return await self._invoke_method("set", {"key": key, "value": value})
+
+    async def get(self, key: str) -> Optional[SharedPreferencesValueType]:
+        """
+        Gets the value for the given key.
+
+        Args:
+            key: The key to retrieve the value for.
+
+        Returns:
+            The value for the given key, or `None` if the key doesn't exist.
+        """
+        return await self._invoke_method("get", {"key": key})
+
+    async def contains_key(self, key: str) -> bool:
+        """
+        Checks if the given key exists.
+
+        Args:
+            key: The key to check for existence.
+
+        Returns:
+            `True` if the key exists, `False` otherwise.
+        """
+        return await self._invoke_method("contains_key", {"key": key})
+
+    async def remove(self, key: str) -> bool:
+        """
+        Removes the value for the given key.
+
+        Args:
+            key: The key to remove.
+
+        Returns:
+            `True` if the key was removed, `False` if the key didn't exist.
+        """
+        return await self._invoke_method("remove", {"key": key})
+
+    async def get_keys(self, key_prefix: str) -> list[str]:
+        """
+        Gets all keys with the given prefix.
+
+        Args:
+            key_prefix: The prefix to filter keys by.
+
+        Returns:
+            A list of keys that start with the given prefix.
+        """
+        return await self._invoke_method("get_keys", {"key_prefix": key_prefix})
+
+    async def clear(self) -> bool:
+        """
+        Clears all keys and values.
+
+        Returns:
+            `True` if the preferences were cleared successfully, `False` otherwise.
+        """
+        return await self._invoke_method("clear")

{flet-0.82.3.dev7876 → flet-0.82.3.dev7882}/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.dev7876 → flet-0.82.3.dev7882}/src/flet/version.py

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

{flet-0.82.3.dev7876 → flet-0.82.3.dev7882}/src/flet.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7876
+Version: 0.82.3.dev7882
 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.dev7876; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7876; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7882; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7882; 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.dev7876; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7876; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7876; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7882; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7882; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7882; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7876; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7882; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7876; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7882; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7876; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7882; 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.dev7876 → flet-0.82.3.dev7882}/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.dev7876 → flet-0.82.3.dev7882}/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.dev7876
+flet-cli==0.82.3.dev7882
 
 [:extra == "web"]
-flet-web==0.82.3.dev7876
+flet-web==0.82.3.dev7882
 
 [:platform_system != "Pyodide"]
 oauthlib>=3.2.2
@@ -15,15 +15,15 @@ httpx>=0.28.1
 typing-extensions
 
 [all]
-flet-cli==0.82.3.dev7876
-flet-web==0.82.3.dev7876
-flet-desktop==0.82.3.dev7876
+flet-cli==0.82.3.dev7882
+flet-web==0.82.3.dev7882
+flet-desktop==0.82.3.dev7882
 
 [cli]
-flet-cli==0.82.3.dev7876
+flet-cli==0.82.3.dev7882
 
 [desktop]
-flet-desktop==0.82.3.dev7876
+flet-desktop==0.82.3.dev7882
 
 [web]
-flet-web==0.82.3.dev7876
+flet-web==0.82.3.dev7882

flet-0.82.3.dev7882/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

flet-0.82.3.dev7876/src/flet/controls/services/shared_preferences.py

@@ -1,51 +0,0 @@
-from typing import Any
-
-from flet.controls.base_control import control
-from flet.controls.services.service import Service
-
-__all__ = ["SharedPreferences"]
-
-
-@control("SharedPreferences")
-class SharedPreferences(Service):
-    """
-    Provides access to persistent key-value storage.
-    """
-
-    async def set(self, key: str, value: Any) -> bool:
-        """
-        Sets a value for the given key.
-        """
-        if value is None:
-            raise ValueError("value can't be None")
-        return await self._invoke_method("set", {"key": key, "value": value})
-
-    async def get(self, key: str):
-        """
-        Gets the value for the given key.
-        """
-        return await self._invoke_method("get", {"key": key})
-
-    async def contains_key(self, key: str) -> bool:
-        """
-        Checks if the given key exists.
-        """
-        return await self._invoke_method("contains_key", {"key": key})
-
-    async def remove(self, key: str) -> bool:
-        """
-        Removes the value for the given key.
-        """
-        return await self._invoke_method("remove", {"key": key})
-
-    async def get_keys(self, key_prefix: str) -> list[str]:
-        """
-        Gets all keys with the given prefix.
-        """
-        return await self._invoke_method("get_keys", {"key_prefix": key_prefix})
-
-    async def clear(self) -> bool:
-        """
-        Clears all keys and values.
-        """
-        return await self._invoke_method("clear")