flet 0.82.3.dev7921__tar.gz → 0.82.3.dev7922__tar.gz

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/PKG-INFO

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

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "0.82.3.dev7921"
+version = "0.82.3.dev7922"
 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.dev7921; extra == 'cli'",
-    "flet-web==0.82.3.dev7921; extra == 'web'",
+    "flet-cli==0.82.3.dev7922; extra == 'cli'",
+    "flet-web==0.82.3.dev7922; 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.dev7921",
-    "flet-web==0.82.3.dev7921",
-    "flet-desktop==0.82.3.dev7921",
+    "flet-cli==0.82.3.dev7922",
+    "flet-web==0.82.3.dev7922",
+    "flet-desktop==0.82.3.dev7922",
 ]
-cli = ["flet-cli==0.82.3.dev7921"]
+cli = ["flet-cli==0.82.3.dev7922"]
 desktop = [
-    "flet-desktop==0.82.3.dev7921",
+    "flet-desktop==0.82.3.dev7922",
 ]
-web = ["flet-web==0.82.3.dev7921"]
+web = ["flet-web==0.82.3.dev7922"]
 
 [project.scripts]
 flet = "flet.cli:main"
@@ -87,7 +87,6 @@ docs = [
     "mkdocs-glightbox >=0.5.1",
     "mkdocs-open-in-new-tab >=1.0.8",
     "mkdocs-section-index >=0.3.10",
-    "griffe-warnings-deprecated >=1.1.0",
     "pygments >=2.16",
     "markdown-exec[ansi] >=1.11.0",
     "pydocstyle >=6.3.0",

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/__init__.py

@@ -105,7 +105,7 @@ from flet.controls.core.draggable import Draggable
 from flet.controls.core.flet_app import FletApp
 from flet.controls.core.gesture_detector import GestureDetector
 from flet.controls.core.grid_view import GridView
-from flet.controls.core.hero import Hero, HeroTag
+from flet.controls.core.hero import Hero
 from flet.controls.core.icon import Icon
 from flet.controls.core.image import Image
 from flet.controls.core.interactive_viewer import InteractiveViewer
@@ -815,7 +815,6 @@ __all__ = [
     "GyroscopeReadingEvent",
     "HapticFeedback",
     "Hero",
-    "HeroTag",
     "HoverEvent",
     "Icon",
     "IconButton",

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/auth/authorization_service.py

@@ -165,7 +165,7 @@ class AuthorizationService(Authorization):
                     self.__token.access_token
                 )
 
-    def __convert_token(self, t: Mapping[str, Any]):
+    def __convert_token(self, t: Mapping[str, Any]) -> OAuthToken:
         """
         Convert oauthlib token mapping to [`OAuthToken`][(p).oauth_token.].
 
@@ -231,7 +231,7 @@ class AuthorizationService(Authorization):
                     t["refresh_token"] = self.__token.refresh_token
                 self.__token = self.__convert_token(t)
 
-    async def __get_user(self):
+    async def __get_user(self) -> User:
         """
         Fetch user profile from provider `user_endpoint`.
 
@@ -256,7 +256,7 @@ class AuthorizationService(Authorization):
             uj = json.loads(user_resp.text)
             return User(uj, str(self.provider.user_id_fn(uj)))
 
-    def __get_default_headers(self):
+    def __get_default_headers(self) -> dict[str, str]:
         """
         Build default HTTP headers for OAuth-related requests.
 

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/auth/providers/github_oauth_provider.py

@@ -99,7 +99,7 @@ class GitHubOAuthProvider(OAuthProvider):
                     break
             return User(uj, id=str(uj["id"]))
 
-    def __get_client_headers(self, access_token):
+    def __get_client_headers(self, access_token: str) -> dict[str, str]:
         """
         Builds common GitHub API request headers.
 

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/base_control.py

@@ -11,6 +11,7 @@ from flet.controls.ref import Ref
 from flet.controls.value_types import Prop, Value, _install_props, value
 from flet.utils.from_dict import from_dict
 from flet.utils.object_model import get_param_count
+from flet.utils.validation import validate
 
 logger = logging.getLogger("flet")
 controls_log = logging.getLogger("flet_controls")
@@ -327,6 +328,7 @@ class BaseControl:
             del self._frozen
 
         self.before_update()
+        validate(self, suppress_repeated_errors=True)
 
         if frozen is not None:
             self._frozen = frozen

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/border.py

@@ -79,7 +79,7 @@ class BorderSide:
         to [`BorderStyle.NONE`][flet.].
 
     Raises:
-        ValueError: If it is less than zero.
+        ValueError: If it is not greater than or equal to `0`.
     """
 
     color: ColorValue = Colors.BLACK

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/control.py

@@ -1,10 +1,11 @@
 from dataclasses import dataclass
-from typing import Optional, Union
+from typing import Annotated, Optional, Union
 
 from flet.controls.base_control import BaseControl
 from flet.controls.material.badge import BadgeValue
 from flet.controls.material.tooltip import TooltipValue
 from flet.controls.types import Number, ResponsiveNumber
+from flet.utils.validation import V
 
 __all__ = ["Control"]
 
@@ -17,7 +18,10 @@ class Control(BaseControl):
     Not meant to be used directly.
     """
 
-    expand: Optional[Union[bool, int]] = None
+    expand: Annotated[
+        Optional[Union[bool, int]],
+        V.instance_of((bool, int)),
+    ] = None
     """
     Specifies whether/how this control should expand to fill available space in its \
     parent layout.
@@ -31,7 +35,7 @@ class Control(BaseControl):
         [`View`][flet.], [`Page`][flet.].
 
     Raises:
-        ValueError: If [`expand`][(c).] is not `None` and not of type `bool` or `int`.
+        ValueError: If it is not of type `bool` or `int`.
     """
 
     expand_loose: bool = False
@@ -75,7 +79,10 @@ class Control(BaseControl):
     ///
     """
 
-    opacity: Number = 1.0
+    opacity: Annotated[
+        Number,
+        V.between(0.0, 1.0),
+    ] = 1.0
     """
     Defines the transparency of the control.
 
@@ -83,7 +90,7 @@ class Control(BaseControl):
     without any transparency).
 
     Raises:
-        ValueError: If [`opacity`][(c).] is not between `0.0` and `1.0` inclusive.
+        ValueError: If it is not between `0.0` and `1.0`, inclusive.
     """
 
     tooltip: Optional[TooltipValue] = None
@@ -114,35 +121,22 @@ class Control(BaseControl):
         The value of this property will be propagated down to all children controls
         recursively.
 
-    /// details | Example
-        type: example
-    For example, if you have a form with multiple entry controls you can disable them
-    all together by disabling container:
-
-    ```python
-    ft.Column(
-        disabled = True,
-        controls=[
-            ft.TextField(),
-            ft.TextField()
-        ]
-    )
-    ```
-    ///
+    Example:
+        For example, if you have a form with multiple entry controls you can
+        disable them all together by disabling container:
+
+        ```python
+        ft.Column(
+            disabled = True,
+            controls=[
+                ft.TextField(),
+                ft.TextField()
+            ]
+        )
+        ```
     """
 
     rtl: bool = False
     """
     Whether the text direction of the control should be right-to-left (RTL).
     """
-
-    def before_update(self):
-        super().before_update()
-        if not (0.0 <= self.opacity <= 1.0):
-            raise ValueError(
-                f"opacity must be between 0.0 and 1.0 inclusive, got {self.opacity}"
-            )
-        if self.expand is not None and not isinstance(self.expand, (bool, int)):
-            raise ValueError(
-                f"expand must be of type bool or int, got {type(self.expand)}"
-            )

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/core/animated_switcher.py

@@ -1,11 +1,13 @@
 from dataclasses import field
 from enum import Enum
+from typing import Annotated
 
 from flet.controls.animation import AnimationCurve
 from flet.controls.base_control import control
 from flet.controls.control import Control
 from flet.controls.duration import Duration, DurationValue
 from flet.controls.layout_control import LayoutControl
+from flet.utils.validation import V
 
 __all__ = ["AnimatedSwitcher", "AnimatedSwitcherTransition"]
 
@@ -39,7 +41,10 @@ class AnimatedSwitcher(LayoutControl):
     Used to switch between controls with an animation.
     """
 
-    content: Control
+    content: Annotated[
+        Control,
+        V.visible_control(),
+    ]
     """
     The content to display.
 
@@ -47,7 +52,7 @@ class AnimatedSwitcher(LayoutControl):
     `content` to the new one.
 
     Raises:
-        ValueError: If [`content`][(c).] is not visible.
+        ValueError: If it is not visible.
     """
 
     duration: DurationValue = field(default_factory=lambda: Duration(seconds=1))
@@ -74,8 +79,3 @@ class AnimatedSwitcher(LayoutControl):
     """
     An animation type to transition between new and old [`content`][(c).].
     """
-
-    def before_update(self):
-        super().before_update()
-        if not self.content.visible:
-            raise ValueError("content must be visible")

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/core/autofill_group.py

@@ -1,7 +1,9 @@
 from enum import Enum
+from typing import Annotated
 
 from flet.controls.base_control import control
 from flet.controls.control import Control
+from flet.utils.validation import V
 
 __all__ = ["AutofillGroup", "AutofillGroupDisposeAction", "AutofillHint"]
 
@@ -775,14 +777,15 @@ class AutofillGroup(Control):
     Used to group autofill controls together.
     """
 
-    content: Control
+    content: Annotated[
+        Control,
+        V.visible_control(),
+    ]
     """
     The content of this group.
 
-    Must be visible.
-
     Raises:
-        ValueError: If [`content`][(c).] is not visible.
+        ValueError: If it is not visible.
     """
 
     dispose_action: AutofillGroupDisposeAction = AutofillGroupDisposeAction.COMMIT
@@ -790,8 +793,3 @@ class AutofillGroup(Control):
     The action to be run when this group is the topmost and it's being disposed, in \
     order to clean up the current autofill context.
     """
-
-    def before_update(self):
-        super().before_update()
-        if not self.content.visible:
-            raise ValueError("content must be visible")

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/core/dismissible.py

@@ -1,5 +1,5 @@
 from dataclasses import dataclass, field
-from typing import Optional
+from typing import Annotated, Optional
 
 from flet.controls.adaptive_control import AdaptiveControl
 from flet.controls.base_control import control
@@ -15,6 +15,7 @@ from flet.controls.material.snack_bar import DismissDirection
 from flet.controls.types import (
     Number,
 )
+from flet.utils.validation import V
 
 __all__ = ["Dismissible", "DismissibleDismissEvent", "DismissibleUpdateEvent"]
 
@@ -75,14 +76,15 @@ class Dismissible(LayoutControl, AdaptiveControl):
     over the specified [`resize_duration`][(c).].
     """
 
-    content: Control
+    content: Annotated[
+        Control,
+        V.visible_control(),
+    ]
     """
     The control that is being dismissed.
 
-    Must be visible.
-
     Raises:
-        ValueError: If the [`content`][(c).] is not visible.
+        ValueError: If it is not visible.
     """
 
     background: Optional[Control] = None
@@ -184,8 +186,6 @@ class Dismissible(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        if not self.content.visible:
-            raise ValueError("content must be visible")
         if (self.secondary_background and self.secondary_background.visible) and not (
             self.background and self.background.visible
         ):

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/core/drag_target.py

@@ -1,11 +1,12 @@
 from dataclasses import dataclass, field
-from typing import Optional, cast
+from typing import Annotated, Optional, cast
 
 from flet.controls.base_control import control
 from flet.controls.control import Control
 from flet.controls.control_event import Event, EventHandler
 from flet.controls.core.draggable import Draggable
 from flet.controls.transform import Offset
+from flet.utils.validation import V
 
 __all__ = [
     "DragTarget",
@@ -96,14 +97,15 @@ class DragTarget(Control):
     asked to accept the `Draggable`'s data.
     """
 
-    content: Control
+    content: Annotated[
+        Control,
+        V.visible_control(),
+    ]
     """
     The content of this control.
 
-    Must be visible.
-
     Raises:
-        ValueError: If [`content`][(c).] is not visible.
+        ValueError: If it is not visible.
     """
 
     group: str = "default"
@@ -137,8 +139,3 @@ class DragTarget(Control):
     """
     Called when a draggable moves within this target.
     """
-
-    def before_update(self):
-        super().before_update()
-        if not self.content.visible:
-            raise ValueError("content must be visible")

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/core/draggable.py

@@ -1,9 +1,10 @@
-from typing import Optional
+from typing import Annotated, Optional
 
 from flet.controls.alignment import Axis
 from flet.controls.base_control import control
 from flet.controls.control import Control
 from flet.controls.control_event import ControlEventHandler
+from flet.utils.validation import V
 
 __all__ = ["Draggable"]
 
@@ -19,7 +20,10 @@ class Draggable(Control):
     given the opportunity to complete drag-and-drop flow.
     """
 
-    content: Control
+    content: Annotated[
+        Control,
+        V.visible_control(),
+    ]
     """
     The control to display when the draggable is not being dragged.
 
@@ -27,7 +31,7 @@ class Draggable(Control):
     [`content_when_dragging`][(c).] is displayed instead.
 
     Raises:
-        ValueError: If [`content`][(c).] is not visible.
+        ValueError: If it is not visible.
     """
 
     group: str = "default"
@@ -75,7 +79,10 @@ class Draggable(Control):
         with other gestures in that direction.
     """
 
-    max_simultaneous_drags: Optional[int] = None
+    max_simultaneous_drags: Annotated[
+        Optional[int],
+        V.ge(0),
+    ] = None
     """
     Specifies how many simultaneous drag operations are allowed for this draggable.
 
@@ -84,11 +91,11 @@ class Draggable(Control):
         For a better user experience, you may want to provide an "empty" widget for
         [`content_when_dragging`][(c).]
         to visually indicate the item is being moved.
-    - Set to any positive integer to allow that many concurrent drags.
-    - If `None`, there is no limit on the number of simultaneous drags.
+    - any other positive integer -  allows that many concurrent drags.
+    - `None` - no limit on the number of simultaneous drags.
 
     Raises:
-        ValueError: If [`max_simultaneous_drags`][(c).] is set to a negative value.
+        ValueError: If it is not greater than or equal to `0`.
     """
 
     on_drag_start: Optional[ControlEventHandler["Draggable"]] = None
@@ -100,13 +107,3 @@ class Draggable(Control):
     """
     Called when this draggable is dropped and accepted by a [`DragTarget`][flet.].
     """
-
-    def before_update(self):
-        super().before_update()
-        if not self.content.visible:
-            raise ValueError("content must be visible")
-        if self.max_simultaneous_drags is not None and self.max_simultaneous_drags < 0:
-            raise ValueError(
-                f"max_simultaneous_drags must be greater than or equal to 0, "
-                f"got {self.max_simultaneous_drags}"
-            )

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/core/hero.py

@@ -1,17 +1,11 @@
-from typing import Union
+from typing import Annotated
 
 from flet.controls.base_control import control
 from flet.controls.control import Control
 from flet.controls.layout_control import LayoutControl
+from flet.utils.validation import V
 
-__all__ = ["Hero", "HeroTag"]
-
-HeroTag = Union[str, int, float, bool]
-"""Type alias for Hero tag values.
-
-Represents an identifier used to match source and destination [`Hero`][flet.]
-controls during route transitions.
-"""
+__all__ = ["Hero"]
 
 
 @control("Hero")
@@ -23,15 +17,21 @@ class Hero(LayoutControl):
     animate that control between routes.
     """
 
-    tag: HeroTag
+    tag: Annotated[
+        str,
+        V.instance_of(str),
+    ]
     """
     A unique identifier used to match source and destination Hero controls.
 
     Raises:
-        ValueError: If not provided or not of type `str`, `int`, `float`, or `bool`.
+        ValueError: If it is not of type `str`.
     """
 
-    content: Control
+    content: Annotated[
+        Control,
+        V.visible_control(),
+    ]
     """
     The control to display and animate.
 
@@ -44,14 +44,3 @@ class Hero(LayoutControl):
     Whether to animate when the route is transitioned by a \
     user gesture (for example, iOS back swipe).
     """
-
-    def before_update(self):
-        super().before_update()
-        if self.tag is None:
-            raise ValueError("tag must be provided")
-        if not isinstance(self.tag, (str, int, float, bool)):
-            raise ValueError(
-                f"tag must be str, int, float, or bool, got {type(self.tag)}"
-            )
-        if not self.content.visible:
-            raise ValueError("content must be visible")

{flet-0.82.3.dev7921 → flet-0.82.3.dev7922}/src/flet/controls/core/icon.py

@@ -1,9 +1,10 @@
-from typing import Optional
+from typing import Annotated, Optional
 
 from flet.controls.base_control import control
 from flet.controls.box import BoxShadowValue
 from flet.controls.layout_control import LayoutControl
 from flet.controls.types import BlendMode, ColorValue, IconData, Number
+from flet.utils.validation import V
 
 __all__ = ["Icon"]
 
@@ -16,6 +17,7 @@ class Icon(LayoutControl):
     Icons can be customized in color, size, and visual style using various
     parameters such as stroke weight, fill level, and shadows.
 
+    Example:
     ```python
     ft.Icon(ft.Icons.FAVORITE, color=ft.Colors.PRIMARY, size=40)
     ```
@@ -58,7 +60,10 @@ class Icon(LayoutControl):
     The order of shadows matters for how transparency is blended.
     """
 
-    fill: Optional[Number] = None
+    fill: Annotated[
+        Optional[Number],
+        V.between(0.0, 1.0),
+    ] = None
     """
     The fill amount of the icon, between `0.0` (outline) and `1.0` (solid).
 
@@ -66,7 +71,7 @@ class Icon(LayoutControl):
     It can be used to indicate state transitions or selection visually.
 
     Raises:
-        ValueError: If [`fill`][(c).] is less than `0.0` or greater than `1.0`.
+        ValueError: If it is not between `0.0` and `1.0`, inclusive.
     """
 
     apply_text_scaling: Optional[bool] = None
@@ -86,27 +91,31 @@ class Icon(LayoutControl):
     It allows precise visual adjustments without changing icon size.
     """
 
-    weight: Optional[Number] = None
+    weight: Annotated[
+        Optional[Number],
+        V.gt(0.0),
+    ] = None
     """
     The stroke weight (thickness) of the icon's lines.
 
     This requires the icon font to support weight variation.
-    Must be greater than `0`.
 
     Raises:
-        ValueError: If [`weight`][(c).] is less than or equal to `0.0`.
+        ValueError: If it is not strictly greater than `0.0`.
     """
 
-    optical_size: Optional[Number] = None
+    optical_size: Annotated[
+        Optional[Number],
+        V.gt(0.0),
+    ] = None
     """
     Adjusts the icon's visual style for different sizes to maintain clarity and \
     balance.
 
     This requires the icon font to support optical sizing.
-    Must be greater than `0`.
 
     Raises:
-        ValueError: If [`optical_size`][(c).] is less than or equal to `0.0`.
+        ValueError: If it is not strictly greater than `0.0`.
     """
 
     blend_mode: Optional[BlendMode] = BlendMode.SRC_OVER
@@ -114,21 +123,4 @@ class Icon(LayoutControl):
     The blend mode used when rendering the icon.
 
     Blend modes control how the icon's color interacts with the background.
-    The default is normal blending (`SRC_OVER`).
-    """
-
-    def before_update(self):
-        super().before_update()
-        if self.fill is not None and not (0.0 <= self.fill <= 1.0):
-            raise ValueError(
-                f"fill must be between 0.0 and 1.0 inclusive, got {self.fill}"
-            )
-        if self.weight is not None and self.weight <= 0.0:
-            raise ValueError(
-                f"weight must be strictly greater than 0.0, got {self.weight}"
-            )
-        if self.optical_size is not None and self.optical_size <= 0.0:
-            raise ValueError(
-                f"optical_size must be strictly greater than 0.0, "
-                f"got {self.optical_size}"
-            )
+    """