flet 0.70.0.dev6214__py3-none-any.whl → 0.70.0.dev6232__py3-none-any.whl

flet/controls/cupertino/cupertino_picker.py

@@ -18,10 +18,6 @@ __all__ = ["CupertinoPicker"]
 class CupertinoPicker(LayoutControl):
     """
     An iOS-styled picker.
-
-    Raises:
-        ValueError: If [`item_extent`][(c).], [`squeeze`][(c).],
-            or [`magnification`][(c).] is not strictly greater than `0.0`.
     """
 
     controls: list[Control] = field(default_factory=list)
@@ -32,6 +28,9 @@ class CupertinoPicker(LayoutControl):
     item_extent: Number = 32.0
     """
     The uniform height of all [`controls`][(c).].
+
+    Raises:
+        ValueError: If [`item_extent`][(c).] is not strictly greater than `0.0`.
     """
 
     selected_index: int = 0
@@ -64,11 +63,17 @@ class CupertinoPicker(LayoutControl):
 
     Note:
         Has effect only if [`use_magnifier`][(c).] is `True`.
+
+    Raises:
+        ValueError: If [`magnification`][(c).] is not strictly greater than `0.0`.
     """
 
     squeeze: Number = 1.45
     """
     The angular compactness of the children on the wheel.
+
+    Raises:
+        ValueError: If [`squeeze`][(c).] is not strictly greater than `0.0`.
     """
 
     diameter_ratio: Number = 1.07

flet/controls/cupertino/cupertino_segmented_button.py

@@ -14,11 +14,6 @@ __all__ = ["CupertinoSegmentedButton"]
 class CupertinoSegmentedButton(LayoutControl):
     """
     An iOS-style segmented button.
-
-    Raises:
-        ValueError: If [`controls`][(c).] does not contain at least two visible
-            controls.
-        IndexError: If [`selected_index`][(c).] is out of range.
     """
 
     controls: list[Control]
@@ -27,12 +22,20 @@ class CupertinoSegmentedButton(LayoutControl):
 
     Note:
         Must contain at least two visible Controls.
+
+    Raises:
+        ValueError: If [`controls`][(c).] does not contain at least two visible
+            controls.
     """
 
     selected_index: int = 0
     """
     The index (starting from 0) of the selected segment in the
     [`controls`][(c).] list.
+
+    Raises:
+        IndexError: If [`selected_index`][(c).] is out of range relative to the
+            visible controls.
     """
 
     selected_color: Optional[ColorValue] = None

flet/controls/cupertino/cupertino_slider.py

@@ -22,11 +22,6 @@ class CupertinoSlider(LayoutControl):
     Use a slider when you want people to set defined values (such as volume or
     brightness), or when people would benefit from instant feedback on the effect of
     setting changes.
-
-    Raises:
-        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
@@ -34,6 +29,10 @@ class CupertinoSlider(LayoutControl):
     The currently selected value for this slider.
 
     The slider's thumb is drawn at a position that corresponds to this value.
+
+    Raises:
+        ValueError: If [`value`][(c).] is less than [`min`][(c).] or greater than
+            [`max`][(c).].
     """
 
     min: Number = 0.0
@@ -43,6 +42,9 @@ class CupertinoSlider(LayoutControl):
     Note:
         - Must be less than or equal to [`max`][(c).].
         - If the [`max`][(c).] is equal to the `min`, then this slider is disabled.
+
+    Raises:
+        ValueError: If [`min`][(c).] is greater than [`max`][(c).].
     """
 
     max: Number = 1.0
@@ -52,6 +54,9 @@ class CupertinoSlider(LayoutControl):
     Note:
         - Must be greater than or equal to [`min`][(c).].
         - If the [`min`][(c).] is equal to the `max`, then this slider is disabled.
+
+    Raises:
+        ValueError: If [`max`][(c).] is less than [`min`][(c).].
     """
 
     divisions: Optional[int] = None

flet/controls/cupertino/cupertino_sliding_segmented_button.py

@@ -18,11 +18,6 @@ __all__ = ["CupertinoSlidingSegmentedButton"]
 class CupertinoSlidingSegmentedButton(LayoutControl):
     """
     A cupertino sliding segmented button.
-
-    Raises:
-        ValueError: If [`controls`][(c).] does not contain at least two
-            visible controls.
-        IndexError: If [`selected_index`][(c).] is out of range.
     """
 
     controls: list[Control]
@@ -31,11 +26,19 @@ class CupertinoSlidingSegmentedButton(LayoutControl):
 
     Note:
         Must contain at least two visible Controls.
+
+    Raises:
+        ValueError: If [`controls`][(c).] does not contain at least two
+            visible controls.
     """
 
     selected_index: int = 0
     """
     The index (starting from 0) of the selected segment in the [`controls`][(c).] list.
+
+    Raises:
+        IndexError: If [`selected_index`][(c).] is out of range relative to the
+            visible controls.
     """
 
     bgcolor: ColorValue = CupertinoColors.TERTIARY_SYSTEM_FILL

flet/controls/cupertino/cupertino_timer_picker.py

@@ -25,19 +25,6 @@ class CupertinoTimerPicker(LayoutControl):
 
     It can show a countdown duration with hour, minute and second spinners. The
     duration is bound between `0` and `23` hours `59` minutes `59` seconds.
-
-    Raises:
-        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`.
-        ValueError: If [`second_interval`][(c).] is not a positive integer
-            factor of `60`.
-        ValueError: If [`value`][(c).] is not a multiple
-            of [`minute_interval`][(c).].
-        ValueError: If [`value`][(c).] is not a multiple
-            of [`second_interval`][(c).].
-        ValueError: If [`item_extent`][(c).] is not strictly greater than `0.0`.
     """
 
     value: DurationValue = field(default_factory=lambda: Duration())
@@ -45,6 +32,11 @@ class CupertinoTimerPicker(LayoutControl):
     The initial duration of the countdown timer.
 
     If specified as an integer, it will be assumed to be in seconds.
+
+    Raises:
+        ValueError: If [`value`][(c).] is negative or 24 hours or more.
+        ValueError: If [`value`][(c).] is not a multiple
+            of [`minute_interval`][(c).] or [`second_interval`][(c).].
     """
 
     alignment: Alignment = field(default_factory=lambda: Alignment.CENTER)
@@ -58,6 +50,10 @@ class CupertinoTimerPicker(LayoutControl):
 
     Note:
         Must be a positive integer factor of `60`.
+
+    Raises:
+        ValueError: If [`second_interval`][(c).] is not a positive integer factor of
+            `60`.
     """
 
     minute_interval: int = 1
@@ -66,6 +62,10 @@ class CupertinoTimerPicker(LayoutControl):
 
     Note:
         Must be a positive integer factor of `60`.
+
+    Raises:
+        ValueError: If [`minute_interval`][(c).] is not a positive integer factor of
+            `60`.
     """
 
     mode: CupertinoTimerPickerMode = CupertinoTimerPickerMode.HOUR_MINUTE_SECONDS
@@ -81,6 +81,9 @@ class CupertinoTimerPicker(LayoutControl):
     item_extent: Number = 32.0
     """
     The uniform height of all children.
+
+    Raises:
+        ValueError: If [`item_extent`][(c).] is not strictly greater than `0.0`.
     """
 
     on_change: Optional[ControlEventHandler["CupertinoTimerPicker"]] = None

flet/controls/material/alert_dialog.py

@@ -27,10 +27,6 @@ class AlertDialog(DialogControl):
     It has an optional [`title`][(c).] and an optional list of [`actions`][(c).] . The
     `title` is displayed above the [`content`][(c).] and the `actions` are displayed
     below the `content`.
-
-    Raises:
-        ValueError: If none of [`title`][(c).], [`content`][(c).], or
-            [`actions`][(c).] are provided, as the dialog would have nothing to display.
     """
 
     content: Optional[Control] = None
@@ -59,6 +55,10 @@ class AlertDialog(DialogControl):
     A set of actions that are displayed at the bottom of this dialog.
 
     Typically this is a list of [`TextButton`][flet.] controls.
+
+    Raises:
+        ValueError: If none of [`title`][(c).], [`content`][(c).], or
+            [`actions`][(c).] are provided, as the dialog would have nothing to display.
     """
 
     bgcolor: Optional[ColorValue] = None

flet/controls/material/app_bar.py

@@ -18,12 +18,6 @@ from flet.controls.types import (
 class AppBar(AdaptiveControl):
     """
     A material design app bar.
-
-    Raises:
-        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.
     """
 
     leading: Optional[Control] = None
@@ -95,11 +89,17 @@ class AppBar(AdaptiveControl):
     Note:
         This effect is only visible when using the Material 2 design
         (when [`Theme.use_material3`][flet.] is `False`).
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     elevation_on_scroll: Optional[Number] = None
     """
     The elevation to be used if this app bar has something scrolled underneath it.
+
+    Raises:
+        ValueError: If [`elevation_on_scroll`][(c).] is negative.
     """
 
     shadow_color: Optional[ColorValue] = None
@@ -173,6 +173,10 @@ class AppBar(AdaptiveControl):
 
     Note:
         Must be in the range `0.0` (transparent) to `1.0` (fully opaque).
+
+    Raises:
+        ValueError: If [`toolbar_opacity`][(c).] is not between `0.0`
+            and `1.0` inclusive.
     """
 
     title_text_style: Optional[TextStyle] = None

flet/controls/material/banner.py

@@ -26,12 +26,6 @@ class Banner(DialogControl):
     Banners are displayed at the top of the screen, below a top app bar. They are
     persistent and non-modal, allowing the user to either ignore them or interact with
     them at any time.
-
-    Raises:
-        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.
     """
 
     content: StrOrControl
@@ -39,6 +33,9 @@ class Banner(DialogControl):
     The content of this banner.
 
     Typically a [`Text`][flet.] control.
+
+    Raises:
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     actions: list[Control]
@@ -47,6 +44,10 @@ class Banner(DialogControl):
 
     Typically this is a list of [`TextButton`][flet.]
     controls.
+
+    Raises:
+        ValueError: If [`actions`][(c).] does not contain at least one visible
+            action Control.
     """
 
     leading: Optional[IconDataOrControl] = None
@@ -104,6 +105,9 @@ class Banner(DialogControl):
     elevation: Optional[Number] = None
     """
     The elevation of this banner.
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     margin: Optional[MarginValue] = None

flet/controls/material/bottom_app_bar.py

@@ -18,9 +18,6 @@ __all__ = ["BottomAppBar"]
 class BottomAppBar(LayoutControl):
     """
     A material design bottom app bar.
-
-    Raises:
-        ValueError: If [`elevation`][(c).] is negative.
     """
 
     content: Optional[Control] = None
@@ -70,6 +67,9 @@ class BottomAppBar(LayoutControl):
     elevation: Optional[Number] = None
     """
     This property controls the size of the shadow below this app bar.
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     def before_update(self):

flet/controls/material/bottom_sheet.py

@@ -18,9 +18,6 @@ class BottomSheet(DialogControl):
 
     A bottom sheet is an alternative to a menu or dialog and prevents the user
     from interacting with the rest of the app.
-
-    Raises:
-        ValueError: If [`elevation`][(c).] is negative.
     """
 
     content: Control
@@ -31,6 +28,9 @@ class BottomSheet(DialogControl):
     elevation: Optional[Number] = None
     """
     Defines the size of the shadow below this bottom sheet.
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     bgcolor: Optional[ColorValue] = None

flet/controls/material/chip.py

@@ -26,12 +26,6 @@ __all__ = ["Chip"]
 class Chip(LayoutControl):
     """
     Chips are compact elements that represent an attribute, text, entity, or action.
-
-    Raises:
-        ValueError: If [`elevation`][(c).] or [`elevation_on_click`][(c).] is
-            negative.
-        ValueError: If callback for both [`on_click`][(c).] and [`on_select`][(c).]
-            are specified.
     """
 
     label: StrOrControl
@@ -64,6 +58,9 @@ class Chip(LayoutControl):
     A non-negative value which defines the size of the shadow below this chip.
 
     Defaults to `0`.
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     bgcolor: Optional[ColorValue] = None
@@ -166,6 +163,9 @@ class Chip(LayoutControl):
 
     Note:
         Must be non-negative.
+
+    Raises:
+        ValueError: If [`elevation_on_click`][(c).] is negative.
     """
 
     clip_behavior: ClipBehavior = ClipBehavior.NONE
@@ -225,6 +225,10 @@ class Chip(LayoutControl):
 
     Note:
         Cannot be specified together with [`on_select`][(c).].
+
+    Raises:
+        ValueError: If both [`on_click`][(c).] and [`on_select`][(c).] callbacks
+            are provided.
     """
 
     on_delete: Optional[ControlEventHandler["Chip"]] = None

flet/controls/material/circle_avatar.py

@@ -19,12 +19,6 @@ class CircleAvatar(LayoutControl):
 
     If [`foreground_image_src`][(c).] fails then [`background_image_src`][(c).] is used,
     and if this also fails, then [`bgcolor`][(c).] is used.
-
-    Raises:
-        ValueError: If [`radius`][(c).] or [`min_radius`][(c).]
-            or [`max_radius`][(c).] is negative.
-        ValueError: If [`radius`][(c).] is set and [`min_radius`][(c).]
-            or [`max_radius`][(c).] is not None.
     """
 
     content: Optional[StrOrControl] = None
@@ -75,6 +69,11 @@ class CircleAvatar(LayoutControl):
     The size of the avatar, expressed as the radius (half the diameter). If `radius` is
     specified, then neither [`min_radius`][(c).] nor
     [`max_radius`][(c).] may be specified.
+
+    Raises:
+        ValueError: If [`radius`][(c).] is negative.
+        ValueError: If [`radius`][(c).] is set while [`min_radius`][(c).]
+            or [`max_radius`][(c).] is provided.
     """
 
     min_radius: Optional[Number] = None
@@ -83,6 +82,9 @@ class CircleAvatar(LayoutControl):
     `min_radius` is specified, then [`radius`][(c).] should not be specified.
 
     Defaults to `0.0`.
+
+    Raises:
+        ValueError: If [`min_radius`][(c).] is negative.
     """
 
     max_radius: Optional[Number] = None
@@ -93,6 +95,10 @@ class CircleAvatar(LayoutControl):
 
     Note:
         If `max_radius` is specified, then [`radius`][(c).] should not be specified.
+
+    Raises:
+        ValueError: If [`max_radius`][(c).] is negative.
+        ValueError: If [`max_radius`][(c).] is provided while [`radius`][(c).] is set.
     """
 
     on_image_error: Optional[ControlEventHandler["CircleAvatar"]] = None

flet/controls/material/datatable.py

@@ -34,10 +34,6 @@ class DataColumnSortEvent(Event["DataColumn"]):
 class DataColumn(Control):
     """
     Column configuration for a [`DataTable`][flet.].
-
-    Raises:
-        ValueError: If the [`label`][(c).] is neither a string nor
-            a visible control.
     """
 
     label: StrOrControl
@@ -47,6 +43,10 @@ class DataColumn(Control):
     Typically, this will be a [`Text`][flet.] control.
     It could also be an [`Icon`][flet.] (typically using size 18),
     or a combination of both in a [`Row`][flet.].
+
+    Raises:
+        ValueError: If the [`label`][(c).] is neither a string nor
+            a visible control.
     """
 
     numeric: bool = False
@@ -93,10 +93,6 @@ class DataColumn(Control):
 class DataCell(Control):
     """
     The data for a cell of a [`DataTable`][flet.].
-
-    Raises:
-        ValueError: If the [`content`][(c).] is neither a string nor a visible
-            control.
     """
 
     content: StrOrControl
@@ -113,6 +109,10 @@ class DataCell(Control):
         To lay out multiple children, set the [`content`][(c).] to a
         container-like control such as [`Row`][flet.], [`Column`][flet.], or
         [`Stack`][flet.], which have a `controls` property.
+
+    Raises:
+        ValueError: If the [`content`][(c).] is neither a string nor a visible
+            control.
     """
 
     placeholder: bool = False
@@ -199,9 +199,6 @@ class DataRow(Control):
     One row configuration must be provided for each row to display in the table.
 
     The data for this row of the table is provided in the [`cells`][(c).] property.
-
-    Raises:
-        ValueError: If [`cells`][(c).] does not contain at least one visible DataCell.
     """
 
     cells: list[DataCell] = field(default_factory=list)
@@ -210,6 +207,10 @@ class DataRow(Control):
 
     Note:
         There must be exactly as many cells as there are columns in the table.
+
+    Raises:
+        ValueError: If [`cells`][(c).] does not contain at least one visible
+            [`DataCell`][flet.].
     """
 
     color: Optional[ControlStateValue[ColorValue]] = None
@@ -280,25 +281,23 @@ class DataRow(Control):
 class DataTable(LayoutControl):
     """
     A Material Design data table.
-
-    Raises:
-        ValueError: If there are no visible [`columns`][(c).].
-        ValueError: If any visible row does not contain exactly as many visible
-            [`DataRow.cells`][flet.] as there are visible [`columns`][(c).].
-        ValueError: If [`data_row_min_height`][(c).] is greater than
-            [`data_row_max_height`][(c).].
-        ValueError: If [`divider_thickness`][(c).] is negative.
-        ValueError: If [`sort_column_index`][(c).] is out of range.
     """
 
     columns: list[DataColumn]
     """
     A list of [`DataColumn`][flet.] controls describing table columns.
+
+    Raises:
+        ValueError: If there are no visible [`columns`][(c).].
     """
 
     rows: list[DataRow] = field(default_factory=list)
     """
     A list of [`DataRow`][flet.] controls defining table rows.
+
+    Raises:
+        ValueError: If any visible row does not contain exactly as many visible
+            [`DataCell`][flet.]s as there are visible [`columns`][(c).].
     """
 
     sort_ascending: bool = False
@@ -336,6 +335,10 @@ class DataTable(LayoutControl):
 
     When this is `None`, it implies that the table's sort order does not correspond to
     any of the columns.
+
+    Raises:
+        ValueError: If [`sort_column_index`][(c).] is out of range relative to the
+            visible [`columns`][(c).].
     """
 
     show_bottom_border: bool = False
@@ -397,6 +400,10 @@ class DataTable(LayoutControl):
 
     Note:
         Must be less than or equal to [`data_row_max_height`][(c).].
+
+    Raises:
+        ValueError: If [`data_row_min_height`][(c).] is greater than
+            [`data_row_max_height`][(c).].
     """
 
     data_row_max_height: Optional[Number] = None
@@ -409,6 +416,10 @@ class DataTable(LayoutControl):
 
     Note:
         Must be greater than or equal to [`data_row_min_height`][(c).].
+
+    Raises:
+        ValueError: If [`data_row_max_height`][(c).] is less than
+            [`data_row_min_height`][(c).].
     """
 
     data_text_style: Optional[TextStyle] = None
@@ -432,6 +443,9 @@ class DataTable(LayoutControl):
 
     Note:
         Must be greater than or equal to zero.
+
+    Raises:
+        ValueError: If [`divider_thickness`][(c).] is negative.
     """
 
     heading_row_color: Optional[ControlStateValue[ColorValue]] = None

flet/controls/material/divider.py

@@ -12,12 +12,6 @@ __all__ = ["Divider"]
 class Divider(Control):
     """
     A thin horizontal line (divider), with padding on either side.
-
-    Raises:
-        ValueError: If [`height`][(c).] is negative.
-        ValueError: If [`thickness`][(c).] is negative.
-        ValueError: If [`leading_indent`][(c).] is negative.
-        ValueError: If [`trailing_indent`][(c).] is negative.
     """
 
     color: Optional[ColorValue] = None
@@ -34,6 +28,9 @@ class Divider(Control):
 
     If `None`, [`DividerTheme.space`][flet.] is used.
     If that's is also `None`, defaults to `16.0`.
+
+    Raises:
+        ValueError: If [`height`][(c).] is negative.
     """
 
     leading_indent: Optional[Number] = None
@@ -42,6 +39,9 @@ class Divider(Control):
 
     If `None`, [`DividerTheme.leading_indent`][flet.] is used.
     If that's is also `None`, defaults to `0.0`.
+
+    Raises:
+        ValueError: If [`leading_indent`][(c).] is negative.
     """
 
     thickness: Optional[Number] = None
@@ -53,6 +53,9 @@ class Divider(Control):
 
     If `None`, [`DividerTheme.thickness`][flet.] is used.
     If that is also `None`, defaults to `0.0`.
+
+    Raises:
+        ValueError: If [`thickness`][(c).] is negative.
     """
 
     trailing_indent: Optional[Number] = None
@@ -61,6 +64,9 @@ class Divider(Control):
 
     If `None`, [`DividerTheme.trailing_indent`][flet.] is used.
     If that is also `None`, defaults to `0.0`.
+
+    Raises:
+        ValueError: If [`trailing_indent`][(c).] is negative.
     """
 
     radius: Optional[BorderRadiusValue] = None

flet/controls/material/dropdown.py

@@ -30,9 +30,6 @@ class DropdownOption(Control):
     """
     Represents an item in a dropdown. Either `key` or `text` must be specified, else an
     `AssertionError` will be raised.
-
-    Raises:
-        ValueError: If neither [`key`][(c).] nor [`text`][(c).] are provided.
     """
 
     key: Optional[str] = None
@@ -44,6 +41,9 @@ class DropdownOption(Control):
     text: Optional[str] = None
     """
     Option's display text. If not specified `key` will be used as fallback.
+
+    Raises:
+        ValueError: If neither [`key`][(c).] nor [`text`][(c).] are provided.
     """
 
     content: Optional[Control] = None

flet/controls/material/expansion_tile.py

@@ -33,9 +33,6 @@ 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
@@ -43,6 +40,9 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
     A `Control` to display as primary content of the tile.
 
     Typically a [`Text`][flet.] control.
+
+    Raises:
+        ValueError: If [`title`][(c).] is neither a string nor a visible Control.
     """
 
     controls: Optional[list[Control]] = None