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

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

flet/controls/cupertino/cupertino_timer_picker.py

@@ -27,17 +27,17 @@ class CupertinoTimerPicker(LayoutControl):
     duration is bound between `0` and `23` hours `59` minutes `59` seconds.
 
     Raises:
-        AssertionError: If [`value`][(c).] is negative.
-        AssertionError: If [`value`][(c).] is 24 hours or more.
-        AssertionError: If [`minute_interval`][(c).] is not a positive integer
+        ValueError: If [`value`][(c).] is negative.
+        ValueError: If [`value`][(c).] is 24 hours or more.
+        ValueError: If [`minute_interval`][(c).] is not a positive integer
             factor of `60`.
-        AssertionError: If [`second_interval`][(c).] is not a positive integer
+        ValueError: If [`second_interval`][(c).] is not a positive integer
             factor of `60`.
-        AssertionError: If [`value`][(c).] is not a multiple
+        ValueError: If [`value`][(c).] is not a multiple
             of [`minute_interval`][(c).].
-        AssertionError: If [`value`][(c).] is not a multiple
+        ValueError: If [`value`][(c).] is not a multiple
             of [`second_interval`][(c).].
-        AssertionError: If [`item_extent`][(c).] is not strictly greater than `0.0`.
+        ValueError: If [`item_extent`][(c).] is not strictly greater than `0.0`.
     """
 
     value: DurationValue = field(default_factory=lambda: Duration())
@@ -95,32 +95,39 @@ class CupertinoTimerPicker(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        # normalize for use in below assertion checks
+        # normalize for use in below validation checks
         value = (
             self.value
             if isinstance(self.value, Duration)
             else Duration(seconds=self.value)
         )
-        assert value >= Duration(), "value must be a non-negative duration"
-        assert value < Duration(hours=24), (
-            f"value must be strictly less than 24 hours, got {value.in_hours} hours"
-        )
-        assert self.minute_interval > 0 and 60 % self.minute_interval == 0, (
-            f"minute_interval ({self.minute_interval}) must be a positive "
-            "integer factor of 60"
-        )
-        assert self.second_interval > 0 and 60 % self.second_interval == 0, (
-            f"second_interval ({self.second_interval}) must be a positive "
-            "integer factor of 60"
-        )
-        assert value.in_minutes % self.minute_interval == 0, (
-            f"value ({value.in_minutes} minutes) must be a multiple "
-            f"of minute_interval ({self.minute_interval})"
-        )
-        assert value.in_seconds % self.second_interval == 0, (
-            f"value ({value.in_seconds} seconds) must be a multiple "
-            f"of second_interval ({self.second_interval})"
-        )
-        assert self.item_extent > 0, (
-            f"item_extent must be strictly greater than 0.0, got {self.item_extent}"
-        )
+        if value < Duration():
+            raise ValueError("value must be a non-negative duration")
+        if value >= Duration(hours=24):
+            raise ValueError(
+                f"value must be strictly less than 24 hours, got {value.in_hours} hours"
+            )
+        if not (self.minute_interval > 0 and 60 % self.minute_interval == 0):
+            raise ValueError(
+                f"minute_interval ({self.minute_interval}) must be a positive "
+                "integer factor of 60"
+            )
+        if not (self.second_interval > 0 and 60 % self.second_interval == 0):
+            raise ValueError(
+                f"second_interval ({self.second_interval}) must be a positive "
+                "integer factor of 60"
+            )
+        if value.in_minutes % self.minute_interval != 0:
+            raise ValueError(
+                f"value ({value.in_minutes} minutes) must be a multiple "
+                f"of minute_interval ({self.minute_interval})"
+            )
+        if value.in_seconds % self.second_interval != 0:
+            raise ValueError(
+                f"value ({value.in_seconds} seconds) must be a multiple "
+                f"of second_interval ({self.second_interval})"
+            )
+        if self.item_extent <= 0:
+            raise ValueError(
+                f"item_extent must be strictly greater than 0.0, got {self.item_extent}"
+            )

flet/controls/material/alert_dialog.py

@@ -29,7 +29,7 @@ class AlertDialog(DialogControl):
     below the `content`.
 
     Raises:
-        AssertionError: If none of [`title`][(c).], [`content`][(c).], or
+        ValueError: If none of [`title`][(c).], [`content`][(c).], or
             [`actions`][(c).] are provided, as the dialog would have nothing to display.
     """
 
@@ -230,7 +230,8 @@ class AlertDialog(DialogControl):
 
     def before_update(self):
         super().before_update()
-        assert self.title or self.content or self.actions, (
-            "AlertDialog has nothing to display. Provide at minimum one of the "
-            "following: title, content, actions"
-        )
+        if not (self.title or self.content or self.actions):
+            raise ValueError(
+                "AlertDialog has nothing to display. Provide at minimum one of the "
+                "following: title, content, actions"
+            )

flet/controls/material/app_bar.py

@@ -20,9 +20,9 @@ class AppBar(AdaptiveControl):
     A material design app bar.
 
     Raises:
-        AssertionError: If [`elevation`][(c).] or [`elevation_on_scroll`][(c).]
-            is negative.
-        AssertionError: If [`toolbar_opacity`][(c).] is not between `0.0`
+        ValueError: If [`elevation`][(c).] is negative.
+        ValueError: If [`elevation_on_scroll`][(c).] is negative.
+        ValueError: If [`toolbar_opacity`][(c).] is not between `0.0`
             and `1.0` inclusive.
     """
 
@@ -193,14 +193,17 @@ class AppBar(AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.elevation is None or self.elevation >= 0, (
-            f"elevation must be greater than or equal to 0, got {self.elevation}"
-        )
-        assert self.elevation_on_scroll is None or self.elevation_on_scroll >= 0, (
-            "elevation_on_scroll must be greater than or equal to 0, "
-            f"got {self.elevation_on_scroll}"
-        )
-        assert 0 <= self.toolbar_opacity <= 1, (
-            "toolbar_opacity must be between 0.0 and 1.0 inclusive, "
-            f"got {self.toolbar_opacity}"
-        )
+        if self.elevation is not None and self.elevation < 0:
+            raise ValueError(
+                f"elevation must be greater than or equal to 0, got {self.elevation}"
+            )
+        if self.elevation_on_scroll is not None and self.elevation_on_scroll < 0:
+            raise ValueError(
+                "elevation_on_scroll must be greater than or equal to 0, "
+                f"got {self.elevation_on_scroll}"
+            )
+        if not (0 <= self.toolbar_opacity <= 1):
+            raise ValueError(
+                "toolbar_opacity must be between 0.0 and 1.0 inclusive, "
+                f"got {self.toolbar_opacity}"
+            )

flet/controls/material/banner.py

@@ -28,9 +28,9 @@ class Banner(DialogControl):
     them at any time.
 
     Raises:
-        AssertionError: if [`content`][(c).] is not visible.
-        AssertionError: if [`elevation`][(c).] is negative.
-        AssertionError: if [`actions`][(c).] does not contain at least one visible
+        ValueError: if [`content`][(c).] is not visible.
+        ValueError: if [`elevation`][(c).] is negative.
+        ValueError: if [`actions`][(c).] does not contain at least one visible
             action Control.
     """
 
@@ -128,11 +128,13 @@ class Banner(DialogControl):
 
     def before_update(self):
         super().before_update()
-        assert self.elevation is None or self.elevation >= 0, (
-            f"elevation must be greater than or equal to 0, got {self.elevation}"
-        )
-        if isinstance(self.content, Control):
-            assert self.content.visible, "content must be visible"
-        assert any(a.visible for a in self.actions), (
-            "actions must contain at minimum one visible action Control"
-        )
+        if self.elevation is not None and self.elevation < 0:
+            raise ValueError(
+                f"elevation must be greater than or equal to 0, got {self.elevation}"
+            )
+        if isinstance(self.content, Control) and not self.content.visible:
+            raise ValueError("content must be visible")
+        if not any(a.visible for a in self.actions):
+            raise ValueError(
+                "actions must contain at minimum one visible action Control"
+            )

flet/controls/material/bottom_app_bar.py

@@ -20,7 +20,7 @@ class BottomAppBar(LayoutControl):
     A material design bottom app bar.
 
     Raises:
-        AssertionError: If [`elevation`][(c).] is negative.
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     content: Optional[Control] = None
@@ -74,6 +74,7 @@ class BottomAppBar(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.elevation is None or self.elevation >= 0, (
-            f"elevation must be greater than or equal to 0, got {self.elevation}"
-        )
+        if self.elevation is not None and self.elevation < 0:
+            raise ValueError(
+                f"elevation must be greater than or equal to 0, got {self.elevation}"
+            )

flet/controls/material/bottom_sheet.py

@@ -20,7 +20,7 @@ class BottomSheet(DialogControl):
     from interacting with the rest of the app.
 
     Raises:
-        AssertionError: If [`elevation`][(c).] is negative.
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     content: Control
@@ -99,6 +99,7 @@ class BottomSheet(DialogControl):
 
     def before_update(self):
         super().before_update()
-        assert self.elevation is None or self.elevation >= 0, (
-            f"elevation must be greater than or equal to zero, got {self.elevation}"
-        )
+        if self.elevation is not None and self.elevation < 0:
+            raise ValueError(
+                f"elevation must be greater than or equal to zero, got {self.elevation}"
+            )

flet/controls/material/button.py

@@ -22,9 +22,14 @@ __all__ = ["Button"]
 @control("Button")
 class Button(LayoutControl, AdaptiveControl):
     """
-    A customizable button control that can display text, icons, or both.
+    A material button.
 
-    It supports various styles, colors, and event handlers for user interaction.
+    It supports various styles, colors, event handlers for user interaction,
+    and can be used to display text, icons, etc.
+
+    Raises:
+        ValueError: If neither [`icon`][(c).] nor [`content`][(c).]
+            (string or visible control) is provided.
     """
 
     content: Optional[StrOrControl] = None
@@ -45,11 +50,14 @@ class Button(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert (
+        if not (
             self.icon
             or isinstance(self.content, str)
             or (isinstance(self.content, Control) and self.content.visible)
-        ), "At least icon or content (string or visible Control) must be provided"
+        ):
+            raise ValueError(
+                "At least icon or content (string or visible Control) must be provided"
+            )
 
         if (
             self.style is not None

flet/controls/material/chip.py

@@ -28,9 +28,9 @@ class Chip(LayoutControl):
     Chips are compact elements that represent an attribute, text, entity, or action.
 
     Raises:
-        AssertionError: If [`elevation`][(c).] or [`elevation_on_click`][(c).] is
+        ValueError: If [`elevation`][(c).] or [`elevation_on_click`][(c).] is
             negative.
-        AssertionError: If callback for both [`on_click`][(c).] and [`on_select`][(c).]
+        ValueError: If callback for both [`on_click`][(c).] and [`on_select`][(c).]
             are specified.
     """
 
@@ -254,13 +254,14 @@ class Chip(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.on_select is None or self.on_click is None, (
-            "on_select and on_click cannot be used together"
-        )
-        assert self.elevation is None or self.elevation >= 0.0, (
-            f"elevation must be greater than or equal to 0, got {self.elevation}"
-        )
-        assert self.elevation_on_click is None or self.elevation_on_click >= 0.0, (
-            "elevation_on_click must be greater than or equal to 0, got "
-            "{self.elevation_on_click}"
-        )
+        if self.on_select is not None and self.on_click is not None:
+            raise ValueError("on_select and on_click cannot be used together")
+        if self.elevation is not None and self.elevation < 0.0:
+            raise ValueError(
+                f"elevation must be greater than or equal to 0, got {self.elevation}"
+            )
+        if self.elevation_on_click is not None and self.elevation_on_click < 0.0:
+            raise ValueError(
+                "elevation_on_click must be greater than or equal to 0, got "
+                f"{self.elevation_on_click}"
+            )

flet/controls/material/circle_avatar.py

@@ -21,9 +21,9 @@ class CircleAvatar(LayoutControl):
     and if this also fails, then [`bgcolor`][(c).] is used.
 
     Raises:
-        AssertionError: If [`radius`][(c).] or [`min_radius`][(c).]
+        ValueError: If [`radius`][(c).] or [`min_radius`][(c).]
             or [`max_radius`][(c).] is negative.
-        AssertionError: If [`radius`][(c).] is set and [`min_radius`][(c).]
+        ValueError: If [`radius`][(c).] is set and [`min_radius`][(c).]
             or [`max_radius`][(c).] is not None.
     """
 
@@ -107,15 +107,19 @@ class CircleAvatar(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.radius is None or self.radius >= 0, (
-            f"radius must be greater than or equal to 0, got {self.radius}"
-        )
-        assert self.min_radius is None or self.min_radius >= 0, (
-            f"min_radius must be greater than or equal to 0, got {self.min_radius}"
-        )
-        assert self.max_radius is None or self.max_radius >= 0, (
-            f"max_radius must be greater than or equal to 0, got {self.max_radius}"
-        )
-        assert self.radius is None or (
+        if self.radius is not None and self.radius < 0:
+            raise ValueError(
+                f"radius must be greater than or equal to 0, got {self.radius}"
+            )
+        if self.min_radius is not None and self.min_radius < 0:
+            raise ValueError(
+                f"min_radius must be greater than or equal to 0, got {self.min_radius}"
+            )
+        if self.max_radius is not None and self.max_radius < 0:
+            raise ValueError(
+                f"max_radius must be greater than or equal to 0, got {self.max_radius}"
+            )
+        if self.radius is not None and not (
             self.min_radius is None and self.max_radius is None
-        ), "If radius is set, min_radius and max_radius must be None"
+        ):
+            raise ValueError("If radius is set, min_radius and max_radius must be None")