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

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/row.py

@@ -68,6 +68,11 @@ class Row(LayoutControl, ScrollableControl, AdaptiveControl):
     How the runs should be placed in the cross-axis when `wrap=True`.
     """
 
+    intrinsic_height: bool = False
+    """
+    If `True`, the Row will be as tall as the tallest child control.
+    """
+
     def init(self):
         super().init()
         self._internals["host_expanded"] = True

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/view.py

@@ -37,12 +37,6 @@ class View(ScrollableControl, LayoutControl):
     control, so it has a similar behavior and shares same properties.
     """
 
-    route: Optional[str] = None
-    """
-    View's route - not currently used by Flet framework, but can be used in a user
-    program to update [`Page.route`][flet.] when a view popped.
-    """
-
     controls: list[BaseControl] = field(default_factory=list)
     """
     A list of controls to display.
@@ -71,6 +65,12 @@ class View(ScrollableControl, LayoutControl):
     ///
     """
 
+    route: Optional[str] = field(default_factory=lambda: "/")
+    """
+    View's route - not currently used by Flet framework, but can be used in a user
+    program to update [`Page.route`][flet.Page.route] when a view popped.
+    """
+
     appbar: Optional[Union[AppBar, CupertinoAppBar]] = None
     """
     An [`AppBar`][flet.] control to display at the top of

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")

flet/controls/cupertino/cupertino_navigation_bar.py

@@ -23,7 +23,7 @@ class CupertinoNavigationBar(LayoutControl):
     destinations in an app.
 
     Raises:
-        AssertionError: If [`destinations`][(c).] does not contain at least two visible
+        ValueError: If [`destinations`][(c).] does not contain at least two visible
             [`NavigationBarDestination`][flet.]s.
         IndexError: If [`selected_index`][(c).] is out of range.
     """
@@ -80,10 +80,11 @@ class CupertinoNavigationBar(LayoutControl):
     def before_update(self):
         super().before_update()
         visible_destinations_count = len([d for d in self.destinations if d.visible])
-        assert visible_destinations_count >= 2, (
-            f"destinations must contain at minimum two visible controls, "
-            f"got {visible_destinations_count}"
-        )
+        if visible_destinations_count < 2:
+            raise ValueError(
+                f"destinations must contain at minimum two visible controls, "
+                f"got {visible_destinations_count}"
+            )
         if not (0 <= self.selected_index < visible_destinations_count):
             raise IndexError(
                 f"selected_index ({self.selected_index}) is out of range. "

flet/controls/cupertino/cupertino_picker.py

@@ -20,7 +20,7 @@ class CupertinoPicker(LayoutControl):
     An iOS-styled picker.
 
     Raises:
-        AssertionError: If [`item_extent`][(c).], [`squeeze`][(c).],
+        ValueError: If [`item_extent`][(c).], [`squeeze`][(c).],
             or [`magnification`][(c).] is not strictly greater than `0.0`.
     """
 
@@ -104,12 +104,16 @@ class CupertinoPicker(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.squeeze > 0.0, (
-            f"squeeze must be strictly greater than 0.0, got {self.squeeze}"
-        )
-        assert self.magnification > 0.0, (
-            f"magnification must be strictly greater than 0.0, got {self.magnification}"
-        )
-        assert self.item_extent > 0.0, (
-            f"item_extent must be strictly greater than 0.0, got {self.item_extent}"
-        )
+        if self.squeeze <= 0.0:
+            raise ValueError(
+                f"squeeze must be strictly greater than 0.0, got {self.squeeze}"
+            )
+        if self.magnification <= 0.0:
+            raise ValueError(
+                f"magnification must be strictly greater than 0.0, "
+                f"got {self.magnification}"
+            )
+        if self.item_extent <= 0.0:
+            raise ValueError(
+                f"item_extent must be strictly greater than 0.0, got {self.item_extent}"
+            )

flet/controls/cupertino/cupertino_segmented_button.py

@@ -16,7 +16,7 @@ class CupertinoSegmentedButton(LayoutControl):
     An iOS-style segmented button.
 
     Raises:
-        AssertionError: If [`controls`][(c).] does not contain at least two visible
+        ValueError: If [`controls`][(c).] does not contain at least two visible
             controls.
         IndexError: If [`selected_index`][(c).] is out of range.
     """
@@ -88,10 +88,11 @@ class CupertinoSegmentedButton(LayoutControl):
     def before_update(self):
         super().before_update()
         visible_controls_count = len([c for c in self.controls if c.visible])
-        assert visible_controls_count >= 2, (
-            f"controls must contain at minimum two visible Controls, "
-            f"got {visible_controls_count}"
-        )
+        if visible_controls_count < 2:
+            raise ValueError(
+                f"controls must contain at minimum two visible Controls, "
+                f"got {visible_controls_count}"
+            )
         if not (0 <= self.selected_index < visible_controls_count):
             raise IndexError(
                 f"selected_index ({self.selected_index}) is out of range. "

flet/controls/cupertino/cupertino_slider.py

@@ -24,9 +24,9 @@ class CupertinoSlider(LayoutControl):
     setting changes.
 
     Raises:
-        AssertionError: If [`min`][(c).] is greater than or equal to [`max`][(c).].
-        AssertionError: If [`min`][(c).] is greater than or equal to [`value`][(c).].
-        AssertionError: If [`max`][(c).] is less than or equal to [`value`][(c).].
+        ValueError: If [`min`][(c).] is greater than [`max`][(c).].
+        ValueError: If [`value`][(c).] is less than [`min`][(c).].
+        ValueError: If [`value`][(c).] is greater than [`max`][(c).].
     """
 
     value: Optional[Number] = None
@@ -102,12 +102,16 @@ class CupertinoSlider(LayoutControl):
     def before_update(self):
         super().before_update()
         self.value = self.value if self.value is not None else self.min
-        assert self.min <= self.max, (
-            f"min ({self.min}) must be less than or equal to max ({self.max})"
-        )
-        assert self.value is None or (self.value >= self.min), (
-            f"value ({self.value}) must be greater than or equal to min ({self.min})"
-        )
-        assert self.value is None or (self.value <= self.max), (
-            f"value ({self.value}) must be less than or equal to max ({self.max})"
-        )
+        if self.min > self.max:
+            raise ValueError(
+                f"min ({self.min}) must be less than or equal to max ({self.max})"
+            )
+        if self.value is not None and self.value < self.min:
+            raise ValueError(
+                f"value ({self.value}) must be greater than or "
+                f"equal to min ({self.min})"
+            )
+        if self.value is not None and self.value > self.max:
+            raise ValueError(
+                f"value ({self.value}) must be less than or equal to max ({self.max})"
+            )

flet/controls/cupertino/cupertino_sliding_segmented_button.py

@@ -20,7 +20,7 @@ class CupertinoSlidingSegmentedButton(LayoutControl):
     A cupertino sliding segmented button.
 
     Raises:
-        AssertionError: If [`controls`][(c).] does not contain at least two
+        ValueError: If [`controls`][(c).] does not contain at least two
             visible controls.
         IndexError: If [`selected_index`][(c).] is out of range.
     """
@@ -78,10 +78,11 @@ class CupertinoSlidingSegmentedButton(LayoutControl):
     def before_update(self):
         super().before_update()
         visible_controls_count = len([c for c in self.controls if c.visible])
-        assert visible_controls_count >= 2, (
-            f"controls must contain at minimum two visible Controls, "
-            f"got {visible_controls_count}"
-        )
+        if visible_controls_count < 2:
+            raise ValueError(
+                f"controls must contain at minimum two visible Controls, "
+                f"got {visible_controls_count}"
+            )
         if not (0 <= self.selected_index < visible_controls_count):
             raise IndexError(
                 f"selected_index ({self.selected_index}) is out of range. "