flet 0.70.0.dev5774__py3-none-any.whl → 0.70.0.dev5776__py3-none-any.whl

flet/controls/control.py

@@ -15,6 +15,10 @@ class Control(BaseControl):
     Base class for controls.
 
     Not meant to be used directly.
+
+    Raises:
+        ValueError: If [`opacity`][(c).] is not between `0.0` and `1.0` inclusive.
+        ValueError: If [`expand`][(c).] is not None and not of type `bool` or `int`.
     """
 
     expand: Optional[Union[bool, int]] = None
@@ -132,12 +136,14 @@ class Control(BaseControl):
 
     def before_update(self):
         super().before_update()
-        assert 0.0 <= self.opacity <= 1.0, (
-            f"opacity must be between 0.0 and 1.0 inclusive, got {self.opacity}"
-        )
-        assert self.expand is None or isinstance(self.expand, (bool, int)), (
-            f"expand must be of type bool or int, got {type(self.expand)}"
-        )
+        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)}"
+            )
 
     def clean(self) -> None:
         raise Exception("Deprecated!")

flet/controls/core/animated_switcher.py

@@ -22,7 +22,7 @@ class AnimatedSwitcher(LayoutControl):
     Used to switch between controls with an animation.
 
     Raises:
-        AssertionError: The [`content`][(c).] must be provided and visible.
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     content: Control
@@ -60,4 +60,5 @@ class AnimatedSwitcher(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
+        if not self.content.visible:
+            raise ValueError("content must be visible")

flet/controls/core/autofill_group.py

@@ -3,7 +3,7 @@ from enum import Enum
 from flet.controls.base_control import control
 from flet.controls.control import Control
 
-__all__ = ["AutofillGroup", "AutofillHint", "AutofillGroupDisposeAction"]
+__all__ = ["AutofillGroup", "AutofillGroupDisposeAction", "AutofillHint"]
 
 
 class AutofillHint(Enum):
@@ -84,6 +84,9 @@ class AutofillGroupDisposeAction(Enum):
 class AutofillGroup(Control):
     """
     Used to group autofill controls together.
+
+    Raises:
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     content: Control
@@ -99,4 +102,5 @@ class AutofillGroup(Control):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
+        if not self.content.visible:
+            raise ValueError("content must be visible")

flet/controls/core/dismissible.py

@@ -46,9 +46,9 @@ class Dismissible(LayoutControl, AdaptiveControl):
     over the specified [`resize_duration`][(c).].
 
     Raises:
-        AssertionError: If the [`content`][(c).] is not visible.
-        AssertionError: If the [`secondary_background`][(c).] is specified but the
-            [`background`][(c).] is not specified/visible.
+        ValueError: If the [`content`][(c).] is not visible.
+        ValueError: If the [`secondary_background`][(c).] is provided and visible
+            but the [`background`][(c).] is not provided and visible.
     """
 
     content: Control
@@ -155,13 +155,15 @@ class Dismissible(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
-        assert not (
-            self.secondary_background and self.secondary_background.visible
-        ) or (self.background and self.background.visible), (
-            "secondary_background can only be specified if background is also "
-            "specified/visible"
-        )
+        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
+        ):
+            raise ValueError(
+                "secondary_background can only be specified if background is also "
+                "specified/visible"
+            )
 
     async def confirm_dismiss(self, dismiss: bool):
         await self._invoke_method("confirm_dismiss", {"dismiss": dismiss})

flet/controls/core/drag_target.py

@@ -50,7 +50,7 @@ class DragTarget(Control):
     asked to accept the `Draggable`'s data.
 
     Raises:
-        AssertionError: If [`content`][(c).] is not visible.
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     content: Control
@@ -92,4 +92,5 @@ class DragTarget(Control):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
+        if not self.content.visible:
+            raise ValueError("content must be visible")

flet/controls/core/draggable.py

@@ -19,8 +19,8 @@ class Draggable(Control):
     given the opportunity to complete drag-and-drop flow.
 
     Raises:
-        AssertionError: If [`content`][(c).] is not visible.
-        AssertionError: If [`max_simultaneous_drags`][(c).] is set to a negative value.
+        ValueError: If [`content`][(c).] is not visible.
+        ValueError: If [`max_simultaneous_drags`][(c).] is set to a negative value.
     """
 
     content: Control
@@ -101,10 +101,10 @@ class Draggable(Control):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
-        assert self.max_simultaneous_drags is None or (
-            self.max_simultaneous_drags >= 0
-        ), (
-            f"max_simultaneous_drags must be greater than or equal to 0, "
-            f"got {self.max_simultaneous_drags}"
-        )
+        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/controls/core/icon.py

@@ -17,9 +17,9 @@ class Icon(LayoutControl):
     parameters such as stroke weight, fill level, and shadows.
 
     Raises:
-        AssertionError: If [`fill`][(c).] is less than `0.0` or greater than `1.0`.
-        AssertionError: If [`weight`][(c).] is less than or equal to `0.0`.
-        AssertionError: If [`optical_size`][(c).] is less than or equal to `0.0`.
+        ValueError: If [`fill`][(c).] is less than `0.0` or greater than `1.0`.
+        ValueError: If [`weight`][(c).] is less than or equal to `0.0`.
+        ValueError: If [`optical_size`][(c).] is less than or equal to `0.0`.
     """
 
     icon: IconData
@@ -110,12 +110,16 @@ class Icon(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.fill is None or (0.0 <= self.fill <= 1.0), (
-            f"fill must be between 0.0 and 1.0 inclusive, got {self.fill}"
-        )
-        assert self.weight is None or (self.weight > 0.0), (
-            f"weight must be strictly greater than 0.0, got {self.weight}"
-        )
-        assert self.optical_size is None or (self.optical_size > 0.0), (
-            f"optical_size must be strictly greater than 0.0, got {self.optical_size}"
-        )
+        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}"
+            )

flet/controls/core/interactive_viewer.py

@@ -23,11 +23,11 @@ class InteractiveViewer(LayoutControl):
     Allows you to pan, zoom, and rotate its [`content`][(c).].
 
     Raises:
-        AssertionError: If [`content`][(c).] is not visible.
-        AssertionError: If [`min_scale`][(c).] is not greater than `0`.
-        AssertionError: If [`max_scale`][(c).] is not greater than `0`.
-        AssertionError: If [`max_scale`][(c).] is less than `min_scale`.
-        AssertionError: If [`interaction_end_friction_coefficient`][(c).] is not
+        ValueError: If [`content`][(c).] is not visible.
+        ValueError: If [`min_scale`][(c).] is not greater than `0`.
+        ValueError: If [`max_scale`][(c).] is not greater than `0`.
+        ValueError: If [`max_scale`][(c).] is less than `min_scale`.
+        ValueError: If [`interaction_end_friction_coefficient`][(c).] is not
             greater than `0`.
     """
 
@@ -130,24 +130,25 @@ class InteractiveViewer(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
-        assert self.min_scale > 0, (
-            f"min_scale must be greater than 0, got {self.min_scale}"
-        )
-        assert self.max_scale > 0, (
-            f"max_scale must be greater than 0, got {self.max_scale}"
-        )
-        assert self.max_scale >= self.min_scale, (
-            "max_scale must be greater than or equal to min_scale, "
-            f"got max_scale={self.max_scale}, min_scale={self.min_scale}"
-        )
-        assert (
-            self.interaction_end_friction_coefficient is None
-            or self.interaction_end_friction_coefficient > 0
-        ), (
-            "interaction_end_friction_coefficient must be greater than 0, "
-            f"got {self.interaction_end_friction_coefficient}"
-        )
+        if not self.content.visible:
+            raise ValueError("content must be visible")
+        if self.min_scale <= 0:
+            raise ValueError(f"min_scale must be greater than 0, got {self.min_scale}")
+        if self.max_scale <= 0:
+            raise ValueError(f"max_scale must be greater than 0, got {self.max_scale}")
+        if self.max_scale < self.min_scale:
+            raise ValueError(
+                "max_scale must be greater than or equal to min_scale, "
+                f"got max_scale={self.max_scale}, min_scale={self.min_scale}"
+            )
+        if (
+            self.interaction_end_friction_coefficient is not None
+            and self.interaction_end_friction_coefficient <= 0
+        ):
+            raise ValueError(
+                "interaction_end_friction_coefficient must be greater than 0, "
+                f"got {self.interaction_end_friction_coefficient}"
+            )
 
     async def reset(self, animation_duration: Optional[DurationValue] = None):
         await self._invoke_method(

flet/controls/core/pagelet.py

@@ -26,7 +26,7 @@ class Pagelet(LayoutControl, AdaptiveControl):
     such as demos and galleries.
 
     Raises:
-        AssertionError: If [`content`][(c).] is not visible.
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     content: Control
@@ -104,7 +104,8 @@ class Pagelet(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
+        if not self.content.visible:
+            raise ValueError("content must be visible")
 
     # todo: deprecate show_* in favor of a open/close methods, or page.open/close
     # Drawer

flet/controls/core/reorderable_draggable.py

@@ -13,7 +13,7 @@ class ReorderableDraggable(LayoutControl, AdaptiveControl):
     event over the given [`content`][(c).] control.
 
     Raises:
-        AssertionError: If [`content`][(c).] is not visible.
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     index: int
@@ -29,4 +29,5 @@ class ReorderableDraggable(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
+        if not self.content.visible:
+            raise ValueError("content must be visible")

flet/controls/core/safe_area.py

@@ -23,7 +23,7 @@ class SafeArea(LayoutControl, AdaptiveControl):
     or the safe area padding will be applied.
 
     Raises:
-        AssertionError: If [`content`][(c).] is not visible.
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     content: Control
@@ -71,4 +71,5 @@ class SafeArea(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
+        if not self.content.visible:
+            raise ValueError("content must be visible")

flet/controls/core/text_span.py

@@ -18,6 +18,9 @@ class TextSpan(Control):
 
     For the object to be useful, at least one of [`text`][(c).] or
     [`spans`][(c).] should be set.
+
+    Raises:
+        ValueError: If [`semantics_label`][(c).] is set when [`text`][(c).] is `None`.
     """
 
     text: Optional[str] = None
@@ -94,6 +97,5 @@ class TextSpan(Control):
 
     def before_update(self):
         super().before_update()
-        assert not (self.text is None and self.semantics_label is not None), (
-            "semantics_label can be set only when text is not None"
-        )
+        if self.text is None and self.semantics_label is not None:
+            raise ValueError("semantics_label can be set only when text is not None")

flet/controls/core/window_drag_area.py

@@ -15,7 +15,7 @@ class WindowDragArea(LayoutControl):
     title bar on the [`content`][(c).] control.
 
     Raises:
-        AssertionError: If [`content`][(c).] is not visible.
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     content: Control
@@ -54,4 +54,5 @@ class WindowDragArea(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
+        if not self.content.visible:
+            raise ValueError("content must be visible")

flet/controls/cupertino/cupertino_action_sheet.py

@@ -15,6 +15,10 @@ class CupertinoActionSheet(LayoutControl):
 
     Action sheets are generally used to give the user a choice between
     two or more choices for the current context.
+
+    Raises:
+        ValueError: If none of [`actions`][(c).], [`title`][(c).], [`message`][(c).],
+            or [`cancel`][(c).] are provided.
     """
 
     title: Optional[StrOrControl] = None
@@ -48,12 +52,13 @@ class CupertinoActionSheet(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert (
+        if not (
             self.actions is not None
             or self.title is not None
             or self.message is not None
             or self.cancel is not None
-        ), (
-            "This action sheet must have a non-None value for at least one of the "
-            "following arguments: `actions`, `title`, `message`, or `cancel`"
-        )
+        ):
+            raise ValueError(
+                "This action sheet must have a non-None value for at least one of the "
+                "following arguments: `actions`, `title`, `message`, or `cancel`"
+            )

flet/controls/cupertino/cupertino_action_sheet_action.py

@@ -14,7 +14,7 @@ class CupertinoActionSheetAction(LayoutControl):
     An action button typically used in a CupertinoActionSheet.
 
     Raises:
-        AssertionError: If [`content`][(c).] is neither a string nor a visible Control.
+        ValueError: If [`content`][(c).] is neither a string nor a visible Control.
     """
 
     content: StrOrControl
@@ -44,6 +44,5 @@ class CupertinoActionSheetAction(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert isinstance(self.content, str) or self.content.visible, (
-            "content must be a string or a visible Control"
-        )
+        if not (isinstance(self.content, str) or self.content.visible):
+            raise ValueError("content must be a string or a visible Control")

flet/controls/cupertino/cupertino_activity_indicator.py

@@ -36,6 +36,7 @@ class CupertinoActivityIndicator(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.radius > 0.0, (
-            f"radius must be strictly greater than 0.0, got {self.radius}"
-        )
+        if self.radius <= 0.0:
+            raise ValueError(
+                f"radius must be strictly greater than 0.0, got {self.radius}"
+            )

flet/controls/cupertino/cupertino_alert_dialog.py

@@ -60,9 +60,12 @@ class CupertinoAlertDialog(DialogControl):
 
     def before_update(self):
         super().before_update()
-        assert (
+        if not (
             (isinstance(self.title, str) or self.title.visible)
             or (self.content and self.content.visible)
             or any(a.visible for a in self.actions)
-        ), "AlertDialog has nothing to display. Provide at minimum one of the "
-        "following: title, content, actions"
+        ):
+            raise ValueError(
+                "AlertDialog has nothing to display. Provide at minimum one of the "
+                "following: title, content, actions"
+            )

flet/controls/cupertino/cupertino_button.py

@@ -33,7 +33,7 @@ class CupertinoButton(LayoutControl):
     An iOS-style button.
 
     Raises:
-        AssertionError: If [`opacity_on_click`][(c).] is not between `0.0`
+        ValueError: If [`opacity_on_click`][(c).] is not between `0.0`
             and `1.0` inclusive.
     """
 
@@ -158,10 +158,11 @@ class CupertinoButton(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert 0 <= self.opacity_on_click <= 1, (
-            "opacity_on_click must be between 0 and 1 inclusive, "
-            f"got {self.opacity_on_click}"
-        )
+        if not (0 <= self.opacity_on_click <= 1):
+            raise ValueError(
+                "opacity_on_click must be between 0 and 1 inclusive, "
+                f"got {self.opacity_on_click}"
+            )
 
     async def focus(self):
         await self._invoke_method("focus")

flet/controls/cupertino/cupertino_context_menu.py

@@ -9,6 +9,10 @@ __all__ = ["CupertinoContextMenu"]
 class CupertinoContextMenu(AdaptiveControl):
     """
     A full-screen modal route that opens up when the [`content`][(c).] is long-pressed.
+
+    Raises:
+        ValueError: If [`content`][(c).] is not visible.
+        ValueError: If [`actions`][(c).] does not contain at least one visible action.
     """
 
     content: Control
@@ -38,7 +42,7 @@ class CupertinoContextMenu(AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
-        assert any(a.visible for a in self.actions), (
-            "at least one action must be visible"
-        )
+        if not self.content.visible:
+            raise ValueError("content must be visible")
+        if not any(a.visible for a in self.actions):
+            raise ValueError("at least one action must be visible")

flet/controls/cupertino/cupertino_context_menu_action.py

@@ -16,7 +16,7 @@ class CupertinoContextMenuAction(AdaptiveControl):
     Typically used as a child of [`CupertinoContextMenu.actions`][flet.].
 
     Raises:
-        AssertionError: If [`content`][(c).] is neither a string nor a visible Control.
+        ValueError: If [`content`][(c).] is neither a string nor a visible Control.
     """
 
     content: StrOrControl
@@ -46,6 +46,5 @@ class CupertinoContextMenuAction(AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert isinstance(self.content, str) or self.content.visible, (
-            "content must be a string or a visible Control"
-        )
+        if not (isinstance(self.content, str) or self.content.visible):
+            raise ValueError("content must be a string or a visible Control")

flet/controls/cupertino/cupertino_date_picker.py

@@ -34,6 +34,15 @@ class CupertinoDatePickerDateOrder(Enum):
 class CupertinoDatePicker(LayoutControl):
     """
     An iOS-styled date picker.
+
+    Raises:
+        ValueError: If [`item_extent`][(c).] is not strictly greater than `0`.
+        ValueError: If [`minute_interval`][(c).] is not a positive integer
+            factor of `60`.
+        ValueError: If [`value`][(c).] is before [`first_date`][(c).] or
+            after [`last_date`][(c).].
+        ValueError: If [`value`][(c).] year is less than [`minimum_year`][(c).] or
+            greater than [`maximum_year`][(c).].
     """
 
     value: DateTimeValue = field(default_factory=lambda: datetime.now())
@@ -159,21 +168,23 @@ class CupertinoDatePicker(LayoutControl):
         else:
             value = self.value
 
-        assert self.item_extent > 0, (
-            f"item_extent must be strictly greater than 0, got {self.item_extent}"
-        )
-        assert self.minute_interval > 0 and 60 % self.minute_interval == 0, (
-            f"minute_interval must be a positive integer factor of 60, "
-            f"got {self.minute_interval}"
-        )
+        if self.item_extent <= 0:
+            raise ValueError(
+                f"item_extent must be strictly greater than 0, got {self.item_extent}"
+            )
+        if not (self.minute_interval > 0 and 60 % self.minute_interval == 0):
+            raise ValueError(
+                f"minute_interval must be a positive integer factor of 60, "
+                f"got {self.minute_interval}"
+            )
 
         if self.date_picker_mode == CupertinoDatePickerMode.DATE_AND_TIME:
-            if self.first_date:
-                assert value >= self.first_date, (
+            if self.first_date and value < self.first_date:
+                raise ValueError(
                     f"value ({value}) can't be before first_date ({self.first_date})"
                 )
-            if self.last_date:
-                assert value <= self.last_date, (
+            if self.last_date and value > self.last_date:
+                raise ValueError(
                     f"value ({value}) can't be after last_date ({self.last_date})"
                 )
 
@@ -181,34 +192,39 @@ class CupertinoDatePicker(LayoutControl):
             CupertinoDatePickerMode.DATE,
             CupertinoDatePickerMode.MONTH_YEAR,
         ]:
-            assert 1 <= self.minimum_year <= value.year, (
-                f"value.year ({value.year}) can't be less than minimum_year "
-            )
-            f"({self.minimum_year})"
+            if not (1 <= self.minimum_year <= value.year):
+                raise ValueError(
+                    f"value.year ({value.year}) can't be less than minimum_year "
+                    f"({self.minimum_year})"
+                )
 
-            if self.maximum_year:
-                assert value.year <= self.maximum_year, (
+            if self.maximum_year and value.year > self.maximum_year:
+                raise ValueError(
                     f"value.year ({value.year}) can't be greater than maximum_year "
+                    f"({self.maximum_year})"
                 )
-                f"({self.maximum_year})"
 
-            if self.first_date:
-                assert value >= self.first_date, (
+            if self.first_date and value < self.first_date:
+                raise ValueError(
                     f"value ({value}) can't be before first_date ({self.first_date})"
                 )
 
-            if self.last_date:
-                assert value <= self.last_date, (
+            if self.last_date and value > self.last_date:
+                raise ValueError(
                     f"value ({value}) can't be after last_date ({self.last_date})"
                 )
 
-        if self.date_picker_mode != CupertinoDatePickerMode.DATE:
-            assert not self.show_day_of_week, (
+        if (
+            self.date_picker_mode != CupertinoDatePickerMode.DATE
+            and self.show_day_of_week
+        ):
+            raise ValueError(
                 "show_day_of_week is only supported when date_picker_mode is "
                 "CupertinoDatePickerMode.DATE"
             )
 
-        assert value.minute % self.minute_interval == 0, (
-            f"value.minute ({value.minute}) must be divisible by minute_interval "
-        )
-        f"({self.minute_interval})"
+        if value.minute % self.minute_interval != 0:
+            raise ValueError(
+                f"value.minute ({value.minute}) must be divisible by minute_interval "
+                f"({self.minute_interval})"
+            )

flet/controls/cupertino/cupertino_dialog_action.py

@@ -17,7 +17,7 @@ class CupertinoDialogAction(Control):
     Typically used as a child of [`CupertinoAlertDialog.actions`][flet.].
 
     Raises:
-        AssertionError: If [`content`][(c).] is neither a string nor a visible Control.
+        ValueError: If [`content`][(c).] is neither a string nor a visible Control.
     """
 
     content: StrOrControl
@@ -57,6 +57,5 @@ class CupertinoDialogAction(Control):
 
     def before_update(self):
         super().before_update()
-        assert isinstance(self.content, str) or self.content.visible, (
-            "content must be a string or a visible Control"
-        )
+        if not (isinstance(self.content, str) or self.content.visible):
+            raise ValueError("content must be a string or a visible Control")

flet/controls/cupertino/cupertino_list_tile.py

@@ -23,7 +23,7 @@ class CupertinoListTile(LayoutControl):
     Can also serve as a cupertino equivalent of the Material [`ListTile`][flet.].
 
     Raises:
-        AssertionError: If [`title`][(c).] is neither a string nor a visible Control.
+        ValueError: If [`title`][(c).] is neither a string nor a visible Control.
     """
 
     title: StrOrControl
@@ -120,6 +120,5 @@ class CupertinoListTile(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert isinstance(self.title, str) or self.title.visible, (
-            "title must be a string or a visible Control"
-        )
+        if not (isinstance(self.title, str) or self.title.visible):
+            raise ValueError("title must be a string or a visible Control")