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

flet/controls/material/expansion_tile.py

@@ -33,6 +33,9 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
     """
     A single-line ListTile with an expansion arrow icon that expands or collapses the
     tile to reveal or hide its controls.
+
+    Raises:
+        ValueError: If [`title`][(c).] is neither a string nor a visible Control.
     """
 
     title: StrOrControl
@@ -108,28 +111,22 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
     initially_expanded: bool = False
     """
     A boolean value which defines whether the tile is initially expanded or collapsed.
-
-    Defaults to `False`.
     """
 
     maintain_state: bool = False
     """
     A boolean value which defines whether the state of the `controls` is maintained
     when the tile expands and collapses.
-
-    Defaults to `False`.
     """
 
     text_color: Optional[ColorValue] = None
     """
-    The color of the tile's titles when the
-    sublist is expanded.
+    The color of the tile's titles when the sublist is expanded.
     """
 
     icon_color: Optional[ColorValue] = None
     """
-    The icon color of tile's expansion arrow
-    icon when the sublist is expanded.
+    The icon color of tile's expansion arrow icon when the sublist is expanded.
     """
 
     shape: Optional[OutlinedBorder] = None
@@ -139,26 +136,22 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
 
     bgcolor: Optional[ColorValue] = None
     """
-    The  color to display behind the sublist
-    when expanded.
+    The  color to display behind the sublist when expanded.
     """
 
     collapsed_bgcolor: Optional[ColorValue] = None
     """
-    Defines the background color of tile when
-    the sublist is collapsed.
+    Defines the background color of tile when the sublist is collapsed.
     """
 
     collapsed_icon_color: Optional[ColorValue] = None
     """
-    The icon color of tile's expansion arrow
-    icon when the sublist is collapsed.
+    The icon color of tile's expansion arrow icon when the sublist is collapsed.
     """
 
     collapsed_text_color: Optional[ColorValue] = None
     """
-    The color of the tile's titles when the
-    sublist is collapsed.
+    The color of the tile's titles when the sublist is collapsed.
     """
 
     collapsed_shape: Optional[OutlinedBorder] = None
@@ -179,16 +172,12 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
     Whether detected gestures should provide acoustic and/or haptic feedback. For
     example, on Android a tap will produce a clicking sound and a long-press will
     produce a short vibration, when feedback is enabled.
-
-    Defaults to `True`.
     """
 
     show_trailing_icon: bool = True
     """
     Whether to show the trailing icon (be it the default icon or the custom `trailing`,
     if specified and visible).
-
-    Defaults to `True`.
     """
 
     min_tile_height: Optional[Number] = None
@@ -208,5 +197,5 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        if isinstance(self.title, Control):
-            assert self.title.visible, "title must be visible"
+        if isinstance(self.title, Control) and not self.title.visible:
+            raise ValueError("title must be visible")

flet/controls/material/floating_action_button.py

@@ -27,9 +27,9 @@ class FloatingActionButton(LayoutControl):
     place on a page.
 
     Raises:
-        AssertionError: If neither [`icon`][(c).] nor a valid [`content`][(c).]
+        ValueError: If neither [`icon`][(c).] nor a valid [`content`][(c).]
             (string or visible Control) is provided.
-        AssertionError: If [`elevation`][(c).],
+        ValueError: If [`elevation`][(c).],
             [`disabled_elevation`][(c).], [`focus_elevation`][(c).],
             [`highlight_elevation`][(c).], or [`hover_elevation`][(c).]
             is negative.
@@ -161,27 +161,36 @@ class FloatingActionButton(LayoutControl):
 
     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 minimum, icon or a content (string or visible Control) must be provided"
-        assert self.elevation is None or self.elevation >= 0, (
-            f"elevation must be greater than or equal to 0, got {self.elevation}"
-        )
-        assert self.disabled_elevation is None or self.disabled_elevation >= 0, (
-            "disabled_elevation must be greater than or equal to 0, "
-            f"got {self.disabled_elevation}"
-        )
-        assert self.focus_elevation is None or self.focus_elevation >= 0, (
-            "focus_elevation must be greater than or equal to 0, "
-            f"got {self.focus_elevation}"
-        )
-        assert self.highlight_elevation is None or self.highlight_elevation >= 0, (
-            "highlight_elevation must be greater than or equal to 0, "
-            f"got {self.highlight_elevation}"
-        )
-        assert self.hover_elevation is None or self.hover_elevation >= 0, (
-            "hover_elevation must be greater than or equal to 0, "
-            f"got {self.hover_elevation}"
-        )
+        ):
+            raise ValueError(
+                "at minimum, icon or a content (string or visible Control) "
+                "must be provided"
+            )
+        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.disabled_elevation is not None and self.disabled_elevation < 0:
+            raise ValueError(
+                "disabled_elevation must be greater than or equal to 0, "
+                f"got {self.disabled_elevation}"
+            )
+        if self.focus_elevation is not None and self.focus_elevation < 0:
+            raise ValueError(
+                "focus_elevation must be greater than or equal to 0, "
+                f"got {self.focus_elevation}"
+            )
+        if self.highlight_elevation is not None and self.highlight_elevation < 0:
+            raise ValueError(
+                "highlight_elevation must be greater than or equal to 0, "
+                f"got {self.highlight_elevation}"
+            )
+        if self.hover_elevation is not None and self.hover_elevation < 0:
+            raise ValueError(
+                "hover_elevation must be greater than or equal to 0, "
+                f"got {self.hover_elevation}"
+            )

flet/controls/material/icon_button.py

@@ -34,6 +34,9 @@ class IconButton(LayoutControl, AdaptiveControl):
 
     Icon buttons are commonly used in the toolbars, but they can be used in many other
     places as well.
+
+    Raises:
+        ValueError: If [`splash_radius`][(c).] is not greater than `0`.
     """
 
     icon: Optional[IconDataOrControl] = None
@@ -200,9 +203,10 @@ class IconButton(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.splash_radius is None or self.splash_radius > 0, (
-            f"splash_radius must be greater than 0, got {self.splash_radius}"
-        )
+        if self.splash_radius is not None and self.splash_radius <= 0:
+            raise ValueError(
+                f"splash_radius must be greater than 0, got {self.splash_radius}"
+            )
         if (
             self.style is not None
             or self.bgcolor is not None

flet/controls/material/navigation_rail.py

@@ -28,7 +28,7 @@ class NavigationRailLabelType(Enum):
 @control("NavigationRailDestination")
 class NavigationRailDestination(Control):
     """
-    TBD
+    Represents a destination in a `NavigationRail`.
     """
 
     icon: Optional[IconDataOrControl] = None
@@ -81,6 +81,11 @@ class NavigationRail(LayoutControl):
     """
     A material widget that is meant to be displayed at the left or right of an app to
     navigate between a small number of views, typically between three and five.
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
+        ValueError: If [`min_width`][(c).] is negative.
+        ValueError: If [`min_extended_width`][(c).] is negative.
     """
 
     destinations: list[NavigationRailDestination] = field(default_factory=list)
@@ -130,14 +135,12 @@ class NavigationRail(LayoutControl):
 
     bgcolor: Optional[ColorValue] = None
     """
-    Sets the color of the Container that holds
-    all of the NavigationRail's contents.
+    Sets the color of the Container that holds all of the NavigationRail's contents.
     """
 
     indicator_color: Optional[ColorValue] = None
     """
-    The color of the navigation rail's
-    indicator.
+    The color of the navigation rail's indicator.
     """
 
     indicator_shape: Optional[OutlinedBorder] = None
@@ -241,9 +244,9 @@ class NavigationRail(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        if self.elevation is not None:
-            assert self.elevation >= 0, "elevation cannot be negative"
-        if self.min_width is not None:
-            assert self.min_width >= 0, "min_width cannot be negative"
-        if self.min_extended_width is not None:
-            assert self.min_extended_width >= 0, "min_extended_width cannot be negative"
+        if self.elevation is not None and self.elevation < 0:
+            raise ValueError("elevation cannot be negative")
+        if self.min_width is not None and self.min_width < 0:
+            raise ValueError("min_width cannot be negative")
+        if self.min_extended_width is not None and self.min_extended_width < 0:
+            raise ValueError("min_extended_width cannot be negative")

flet/controls/material/outlined_button.py

@@ -21,8 +21,11 @@ __all__ = ["OutlinedButton"]
 class OutlinedButton(LayoutControl, AdaptiveControl):
     """
     Outlined buttons are medium-emphasis buttons. They contain actions that are
-    important, but aren’t the primary action in an app. Outlined buttons pair well with
+    important, but aren't the primary action in an app. Outlined buttons pair well with
     filled buttons to indicate an alternative, secondary action.
+
+    Raises:
+        ValueError: If neither [`icon`][(c).] nor [`content`][(c).] is provided.
     """
 
     content: Optional[StrOrControl] = None
@@ -95,11 +98,12 @@ class OutlinedButton(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 minimum, icon or a visible content must be provided"
+        ):
+            raise ValueError("at minimum, icon or a visible content must be provided")
 
     async def focus(self):
         await self._invoke_method("focus")

flet/controls/material/progress_bar.py

@@ -14,6 +14,11 @@ class ProgressBar(LayoutControl):
     A material design linear progress indicator, also known as a progress bar.
 
     A control that shows progress along a line.
+
+    Raises:
+        ValueError: If [`value`][(c).] is negative.
+        ValueError: If [`bar_height`][(c).] is negative.
+        ValueError: If [`semantics_value`][(c).] is negative.
     """
 
     value: Optional[Number] = None
@@ -114,13 +119,16 @@ class ProgressBar(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert self.value is None or self.value >= 0, (
-            f"value must be greater than or equal to 0, got {self.value}"
-        )
-        assert self.bar_height is None or self.bar_height >= 0, (
-            f"bar_height must be greater than or equal to 0, got {self.bar_height}"
-        )
-        assert self.semantics_value is None or self.semantics_value >= 0, (
-            f"semantics_value must be greater than or equal to 0, "
-            f"got {self.semantics_value}"
-        )
+        if self.value is not None and self.value < 0:
+            raise ValueError(
+                f"value must be greater than or equal to 0, got {self.value}"
+            )
+        if self.bar_height is not None and self.bar_height < 0:
+            raise ValueError(
+                f"bar_height must be greater than or equal to 0, got {self.bar_height}"
+            )
+        if self.semantics_value is not None and self.semantics_value < 0:
+            raise ValueError(
+                f"semantics_value must be greater than or equal to 0, "
+                f"got {self.semantics_value}"
+            )

flet/controls/material/radio_group.py

@@ -11,6 +11,9 @@ __all__ = ["RadioGroup"]
 class RadioGroup(Control):
     """
     Radio buttons let people select a single option from two or more choices.
+
+    Raises:
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     content: Control
@@ -33,4 +36,5 @@ class RadioGroup(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/material/range_slider.py

@@ -20,6 +20,11 @@ class RangeSlider(LayoutControl):
     A range slider can be used to select from either a continuous or a discrete
     set of values.
     The default is to use a continuous range of values from min to max.
+
+    Raises:
+        ValueError: If [`end_value`][(c).] is greater than [`max`][(c).].
+        ValueError: If [`start_value`][(c).] is less than [`min`][(c).].
+        ValueError: If [`start_value`][(c).] is greater than [`end_value`][(c).].
     """
 
     start_value: Number
@@ -124,17 +129,12 @@ class RangeSlider(LayoutControl):
     """
 
     def before_update(self):
-        if self.max is not None:
-            assert self.end_value <= self.max, (
-                "end_value must be less than or equal to max"
-            )
-
-        if self.min is not None:
-            assert self.start_value >= self.min, (
-                "start_value must be greater than or equal to min"
-            )
-
-        assert self.start_value <= self.end_value, (
-            "start_value must be less than or equal to end_value"
-        )
+        if self.max is not None and self.end_value > self.max:
+            raise ValueError("end_value must be less than or equal to max")
+
+        if self.min is not None and self.start_value < self.min:
+            raise ValueError("start_value must be greater than or equal to min")
+
+        if self.start_value > self.end_value:
+            raise ValueError("start_value must be less than or equal to end_value")
         pass

flet/controls/material/segmented_button.py

@@ -23,7 +23,7 @@ class Segment(Control):
     A segment for a [`SegmentedButton`][flet.].
 
     Raises:
-        AssertionError: If neither [`icon`][(c).] nor [`label`][(c).] is set.
+        ValueError: If neither [`icon`][(c).] nor [`label`][(c).] is set.
     """
 
     value: str
@@ -45,12 +45,13 @@ class Segment(Control):
 
     def before_update(self):
         super().before_update()
-        assert (
+        if not (
             (isinstance(self.icon, IconData))
             or (isinstance(self.icon, Control) and self.icon.visible)
             or (isinstance(self.label, str))
             or (isinstance(self.label, Control) and self.label.visible)
-        ), "one of icon or label must be set and visible"
+        ):
+            raise ValueError("one of icon or label must be set and visible")
 
 
 @control("SegmentedButton")
@@ -59,11 +60,13 @@ class SegmentedButton(LayoutControl):
     A segmented button control.
 
     Raises:
-        AssertionError: If [`segments`][(c).] is empty or does not have at
+        ValueError: If [`segments`][(c).] is empty or does not have at
             least one visible `Segment`.
-        AssertionError: If [`selected`][(c).] is empty and [`allow_empty_selection`][(c).] is `False`.
-        AssertionError: If [`selected`][(c).] has more than one item and [`allow_multiple_selection`][(c).] is `False`.
-    """  # noqa: E501
+        ValueError: If [`selected`][(c).] is empty and
+            [`allow_empty_selection`][(c).] is `False`.
+        ValueError: If [`selected`][(c).] has more than one item and
+            [`allow_multiple_selection`][(c).] is `False`.
+    """
 
     segments: list[Segment]
     """
@@ -153,13 +156,14 @@ class SegmentedButton(LayoutControl):
 
     def before_update(self):
         super().before_update()
-        assert any(segment.visible for segment in self.segments), (
-            "segments must have at minimum one visible Segment"
-        )
-        assert len(self.selected) > 0 or self.allow_empty_selection, (
-            "allow_empty_selection must be True for selected to be empty"
-        )
-        assert len(self.selected) < 2 or self.allow_multiple_selection, (
-            "allow_multiple_selection must be True for selected "
-            "to have more than one item"
-        )
+        if not any(segment.visible for segment in self.segments):
+            raise ValueError("segments must have at minimum one visible Segment")
+        if len(self.selected) == 0 and not self.allow_empty_selection:
+            raise ValueError(
+                "allow_empty_selection must be True for selected to be empty"
+            )
+        if len(self.selected) >= 2 and not self.allow_multiple_selection:
+            raise ValueError(
+                "allow_multiple_selection must be True for selected to "
+                "have more than one item"
+            )

flet/controls/material/selection_area.py

@@ -14,7 +14,7 @@ class SelectionArea(Control):
     selection for its child control.
 
     Raises:
-        AssertionError: If [`content`][(c).] is not visible
+        ValueError: If [`content`][(c).] is not visible
     """
 
     content: Control
@@ -33,4 +33,5 @@ class SelectionArea(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/material/slider.py

@@ -34,9 +34,9 @@ class Slider(LayoutControl, AdaptiveControl):
     of 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
@@ -216,12 +216,16 @@ class Slider(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.max is None or 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.max is not None and 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/material/snack_bar.py

@@ -93,6 +93,11 @@ class SnackBar(DialogControl):
     """
     A lightweight message with an optional action which briefly displays at the
     bottom of the screen.
+
+    Raises:
+        ValueError: If [`content`][(c).] is not a string or visible control.
+        ValueError: If [`action_overflow_threshold`][(c).] is not between 0 and 1.
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     content: StrOrControl
@@ -229,13 +234,16 @@ class SnackBar(DialogControl):
 
     def before_update(self):
         super().before_update()
-        assert isinstance(self.content, str) or (
-            isinstance(self.content, Control) and self.content.visible
-        ), "content must be a string or a visible control"
-        assert (
-            self.action_overflow_threshold is None
-            or 0 <= self.action_overflow_threshold <= 1
-        ), "action_overflow_threshold must be between 0 and 1 inclusive"
-        assert self.elevation is None or self.elevation >= 0, (
-            "elevation cannot be negative"
-        )
+        if not (
+            isinstance(self.content, str)
+            or (isinstance(self.content, Control) and self.content.visible)
+        ):
+            raise ValueError("content must be a string or a visible control")
+        if self.action_overflow_threshold is not None and not (
+            0 <= self.action_overflow_threshold <= 1
+        ):
+            raise ValueError(
+                "action_overflow_threshold must be between 0 and 1 inclusive"
+            )
+        if self.elevation is not None and self.elevation < 0:
+            raise ValueError("elevation cannot be negative")

flet/controls/material/switch.py

@@ -28,7 +28,7 @@ class Switch(LayoutControl, AdaptiveControl):
     For example, "On/Off", "Show/Hide".
 
     Raises:
-        AssertionError: If [`splash_radius`][(c).] is negative.
+        ValueError: If [`splash_radius`][(c).] is negative.
     """
 
     label: Optional[StrOrControl] = None
@@ -225,7 +225,8 @@ class Switch(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.splash_radius is None or self.splash_radius >= 0, (
-            "splash_radius must be greater than or equal to 0, "
-            f"got {self.splash_radius}"
-        )
+        if self.splash_radius is not None and self.splash_radius < 0:
+            raise ValueError(
+                "splash_radius must be greater than or equal to 0, "
+                f"got {self.splash_radius}"
+            )

flet/controls/material/tabs.py

@@ -316,9 +316,9 @@ class TabBar(LayoutControl, AdaptiveControl):
     on text headers to articulate the different sections of content.
 
     Raises:
-        AssertionError: If [`indicator`][(c).] is None and
+        ValueError: If [`indicator`][(c).] is None and
             [`indicator_thickness`][(c).] is not strictly greater than 0.
-        AssertionError: If [`tab_alignment`][(c).] is not valid for
+        ValueError: If [`tab_alignment`][(c).] is not valid for
             the given [`scrollable`][(c).] state.
     """
 
@@ -538,20 +538,25 @@ class TabBar(LayoutControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.indicator is not None or self.indicator_thickness > 0.0, (
-            f"indicator_thickness must be strictly greater than zero if indicator is "
-            f"None, got {self.indicator_thickness}"
-        )
+        if self.indicator is None and self.indicator_thickness <= 0.0:
+            raise ValueError(
+                f"indicator_thickness must be strictly greater than zero if indicator "
+                f"is None, got {self.indicator_thickness}"
+            )
         valid_alignments = (
             [TabAlignment.CENTER, TabAlignment.FILL]
             if not self.scrollable
             else [TabAlignment.START, TabAlignment.START_OFFSET, TabAlignment.CENTER]
         )
 
-        assert self.tab_alignment is None or self.tab_alignment in valid_alignments, (
-            f"If scrollable is {self.scrollable}, tab_alignment must be one of: "
-            f"{', '.join(f'TabAlignment.{a.name}' for a in valid_alignments)}."
-        )
+        if (
+            self.tab_alignment is not None
+            and self.tab_alignment not in valid_alignments
+        ):
+            raise ValueError(
+                f"If scrollable is {self.scrollable}, tab_alignment must be one of: "
+                f"{', '.join(f'TabAlignment.{a.name}' for a in valid_alignments)}."
+            )
 
 
 @control("Tab")
@@ -560,7 +565,7 @@ class Tab(AdaptiveControl):
     A Material Design [`TabBar`][flet.] tab.
 
     Raises:
-        AssertionError: If both [`label`][(c).] and [`icon`][(c).] are not set.
+        ValueError: If both [`label`][(c).] and [`icon`][(c).] are not set.
     """
 
     label: Optional[StrOrControl] = None
@@ -599,6 +604,5 @@ class Tab(AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert (self.label is not None) or (self.icon is not None), (
-            "Tab must have at least label or icon property set"
-        )
+        if not ((self.label is not None) or (self.icon is not None)):
+            raise ValueError("Tab must have at least label or icon property set")