flet 0.82.3.dev7877__tar.gz → 0.82.3.dev7883__tar.gz

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

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

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

{flet-0.82.3.dev7877 → flet-0.82.3.dev7883}/src/flet/__init__.py

@@ -304,7 +304,11 @@ from flet.controls.material.divider import Divider
 from flet.controls.material.dropdown import Dropdown, DropdownOption
 from flet.controls.material.dropdownm2 import DropdownM2
 from flet.controls.material.elevated_button import ElevatedButton
-from flet.controls.material.expansion_panel import ExpansionPanel, ExpansionPanelList
+from flet.controls.material.expansion_panel import (
+    ExpansionPanel,
+    ExpansionPanelList,
+    ExpansionPanelListChangeEvent,
+)
 from flet.controls.material.expansion_tile import ExpansionTile, TileAffinity
 from flet.controls.material.filled_button import FilledButton
 from flet.controls.material.filled_tonal_button import FilledTonalButton
@@ -775,6 +779,7 @@ __all__ = [
     "EventHandler",
     "ExpansionPanel",
     "ExpansionPanelList",
+    "ExpansionPanelListChangeEvent",
     "ExpansionTile",
     "ExpansionTileTheme",
     "FilePicker",

{flet-0.82.3.dev7877 → flet-0.82.3.dev7883}/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.dev7877 → flet-0.82.3.dev7883}/src/flet/controls/material/expansion_panel.py

@@ -1,18 +1,46 @@
-from dataclasses import field
+from dataclasses import dataclass, field
 from typing import Optional
 
 from flet.controls.adaptive_control import AdaptiveControl
 from flet.controls.base_control import control
 from flet.controls.control import Control
-from flet.controls.control_event import ControlEventHandler
+from flet.controls.control_event import (
+    Event,
+    EventHandler,
+)
 from flet.controls.layout_control import LayoutControl
 from flet.controls.padding import Padding, PaddingValue
+from flet.controls.scrollable_control import ScrollableControl
 from flet.controls.types import (
     ColorValue,
     Number,
 )
 
-__all__ = ["ExpansionPanel", "ExpansionPanelList"]
+__all__ = ["ExpansionPanel", "ExpansionPanelList", "ExpansionPanelListChangeEvent"]
+
+
+@dataclass
+class ExpansionPanelListChangeEvent(Event["ExpansionPanelList"]):
+    """
+    Payload for [`ExpansionPanelList.on_change`][flet.] event.
+    """
+
+    index: int
+    """
+    The index of the panel in [`ExpansionPanelList.controls`][flet.] that was toggled.
+
+    Panels with [`visible`][flet.Control.] set to `False` are not counted/indexed.
+    This means the value may differ from the panel's position in the original
+    [`ExpansionPanelList.controls`][flet.] list when some panels are invisible.
+    To map it back, filter [`ExpansionPanelList.controls`][flet.] to only visible
+    panels and use this index on that filtered list.
+    """
+
+    expanded: bool
+    """
+    Whether the toggled panel is expanded (`True`) or
+    collapsed (`False`) after the event.
+    """
 
 
 @control("ExpansionPanel")
@@ -21,6 +49,7 @@ class ExpansionPanel(LayoutControl, AdaptiveControl):
     A material expansion panel. It can either be expanded or collapsed. Its body is \
     only visible when it is expanded.
 
+    Example:
     ```python
     ft.ExpansionPanelList(
         width=400,
@@ -41,54 +70,75 @@ class ExpansionPanel(LayoutControl, AdaptiveControl):
 
     header: Optional[Control] = None
     """
-    The control to be found in the header of the `ExpansionPanel`. If `can_tap_header` \
-    is `True`, tapping on the header will expand or collapse the panel.
+    The control to be found in the header of this panel.
 
-    If this property is `None`, the `ExpansionPanel` will have a placeholder `Text` as
+    It is always visible, regardless of whether this panel is expanded or collapsed.
+    If [`can_tap_header`][(c).] is `True`, tapping on this `header` will expand or
+    collapse this panel.
+
+    If this property is `None`, this panel will have a placeholder `Text` as
     header.
     """
 
     content: Optional[Control] = None
     """
-    The control to be found in the body of the `ExpansionPanel`. It is displayed below \
-    the `header` when the panel is expanded.
+    The control to be found in the body of this panel.
+
+    It is displayed below the [`header`][(c).] when this panel is [`expanded`][(c).].
 
-    If this property is `None`, the `ExpansionPanel` will have a placeholder `Text` as
+    If this property is `None`, this panel will have a placeholder `Text` as
     content.
     """
 
     bgcolor: Optional[ColorValue] = None
     """
-    The background color of the panel.
+    The background color of this panel.
     """
 
     expanded: bool = False
     """
-    Whether expanded(`True`) or collapsed(`False`).
+    Whether this panel is in expanded (`True`) or collapsed (`False`) state.
     """
 
     can_tap_header: bool = False
     """
-    If `True`, tapping on the panel's `header` will expand or collapse it.
+    Whether tapping on this panel's [`header`][(c).] will expand or collapse it.
     """
 
     splash_color: Optional[ColorValue] = None
     """
-    TBD
+    Defines the splash color of this panel if [`can_tap_header`][(c).] is `True`, \
+    or the splash color of the expand/collapse `IconButton` if \
+    [`can_tap_header`][(c).] is `False`.
+
+    If [`can_tap_header`][(c).] is `False`, and [`Theme.use_material3`][flet.] is
+    `True`, this field will be ignored, as [`IconButton.splash_color`][flet.]
+    will be ignored, and you should use [`highlight_color`][(c).] instead.
+
+    If this is `None`, then the icon button will use its default splash color
+    [`Theme.splash_color`][flet.], and this panel will use its default splash color
+    [`Theme.splash_color`][flet.] (if [`can_tap_header`][(c).] is `True`).
     """
 
     highlight_color: Optional[ColorValue] = None
     """
-    TBD
+    Defines the highlight color of this panel if [`can_tap_header`][(c).] is `True`, \
+    or the highlight color of the expand/collapse `IconButton` \
+    if [`can_tap_header`][(c).] is `False`.
+
+    If this is `None`, then the icon button will use its default highlight color
+    [`Theme.highlight_color`][flet.], and this panel will use its default highlight
+    color [`Theme.highlight_color`][flet.] (if [`can_tap_header`][(c).] is `True`).
     """
 
 
 @control("ExpansionPanelList")
-class ExpansionPanelList(LayoutControl):
+class ExpansionPanelList(LayoutControl, ScrollableControl):
     """
     A material expansion panel list that lays out its children and animates \
     expansions.
 
+    Example:
     ```python
     ft.ExpansionPanelList(
         width=400,
@@ -145,12 +195,9 @@ class ExpansionPanelList(LayoutControl):
     The size of the gap between the [`controls`][(c).]s when expanded.
     """
 
-    on_change: Optional[ControlEventHandler["ExpansionPanelList"]] = None
+    on_change: Optional[EventHandler[ExpansionPanelListChangeEvent]] = None
     """
     Called when an item of [`controls`][(c).] is expanded or collapsed.
-
-    The [`data`][flet.Event.] property of the event handler argument contains the
-    index of the child panel (in [`controls`][(c).]) which triggered this event.
     """
 
     def before_update(self):

flet-0.82.3.dev7883/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.dev7877 → flet-0.82.3.dev7883}/src/flet/version.py

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

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

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

flet-0.82.3.dev7877/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")