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

flet/controls/material/floating_action_button.py

@@ -25,19 +25,15 @@ class FloatingActionButton(LayoutControl):
     promote a primary action in the application. Floating action button is usually set
     to `page.floating_action_button`, but can also be added as a regular control at any
     place on a page.
-
-    Raises:
-        ValueError: If neither [`icon`][(c).] nor a valid [`content`][(c).]
-            (string or visible Control) is provided.
-        ValueError: If [`elevation`][(c).],
-            [`disabled_elevation`][(c).], [`focus_elevation`][(c).],
-            [`highlight_elevation`][(c).], or [`hover_elevation`][(c).]
-            is negative.
     """
 
     content: Optional[StrOrControl] = None
     """
     The content of this button.
+
+    Raises:
+        ValueError: If neither [`icon`][(c).] nor a valid [`content`][(c).]
+            (string or visible Control) is provided.
     """
 
     icon: Optional[IconDataOrControl] = None
@@ -93,6 +89,9 @@ class FloatingActionButton(LayoutControl):
     The elevation of this button.
 
     Defaults to `6`.
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     disabled_elevation: Optional[Number] = None
@@ -100,6 +99,9 @@ class FloatingActionButton(LayoutControl):
     The elevation of this button when disabled.
 
     Defaults to the same value as `elevation`.
+
+    Raises:
+        ValueError: If [`disabled_elevation`][(c).] is negative.
     """
 
     focus_elevation: Optional[Number] = None
@@ -107,6 +109,9 @@ class FloatingActionButton(LayoutControl):
     The elevation of this button when it has input focus.
 
     Defaults to `8`.
+
+    Raises:
+        ValueError: If [`focus_elevation`][(c).] is negative.
     """
 
     highlight_elevation: Optional[Number] = None
@@ -114,6 +119,9 @@ class FloatingActionButton(LayoutControl):
     The elevation of this button when it is highlighted.
 
     Defaults to `12`.
+
+    Raises:
+        ValueError: If [`highlight_elevation`][(c).] is negative.
     """
 
     hover_elevation: Optional[Number] = None
@@ -121,6 +129,9 @@ class FloatingActionButton(LayoutControl):
     The elevation of this button it is enabled and being hovered over.
 
     Defaults to `8`.
+
+    Raises:
+        ValueError: If [`hover_elevation`][(c).] is negative.
     """
 
     hover_color: Optional[ColorValue] = None

flet/controls/material/icon_button.py

@@ -34,9 +34,6 @@ 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
@@ -136,6 +133,9 @@ class IconButton(LayoutControl, AdaptiveControl):
     Note:
         This value is honoured only when in Material 2
         ([`Theme.use_material3`][flet.] is `False`).
+
+    Raises:
+        ValueError: If [`splash_radius`][(c).] is not greater than `0`.
     """
 
     alignment: Optional[Alignment] = None

flet/controls/material/navigation_rail.py

@@ -81,11 +81,6 @@ 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)
@@ -101,6 +96,9 @@ class NavigationRail(LayoutControl):
     Controls the size of the shadow below the NavigationRail.
 
     Defaults to `0.0`.
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     selected_index: Optional[int] = None
@@ -180,6 +178,9 @@ class NavigationRail(LayoutControl):
     This value also defines the min width and min height of the destinations.
 
     To make a compact rail, set this to `56` and use `label_type='none'`.
+
+    Raises:
+        ValueError: If [`min_width`][(c).] is negative.
     """
 
     min_extended_width: Optional[Number] = None
@@ -187,6 +188,9 @@ class NavigationRail(LayoutControl):
     The final width when the animation is complete for setting `extended` to `True`.
 
     Defaults to `256`.
+
+    Raises:
+        ValueError: If [`min_extended_width`][(c).] is negative.
     """
 
     group_alignment: Optional[Number] = None

flet/controls/material/outlined_button.py

@@ -23,14 +23,14 @@ 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
     filled buttons to indicate an alternative, secondary action.
-
-    Raises:
-        ValueError: If neither [`icon`][(c).] nor [`content`][(c).] is provided.
     """
 
     content: Optional[StrOrControl] = None
     """
     A Control representing custom button content.
+
+    Raises:
+        ValueError: If neither [`icon`][(c).] nor [`content`][(c).] is provided.
     """
 
     icon: Optional[IconDataOrControl] = None

flet/controls/material/progress_bar.py

@@ -14,11 +14,6 @@ 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
@@ -31,11 +26,17 @@ class ProgressBar(LayoutControl):
     Defaults to `None`, meaning that this progress indicator is indeterminate -
     displays a predetermined animation that does not indicate how much actual progress
     is being made.
+
+    Raises:
+        ValueError: If [`value`][(c).] is negative.
     """
 
     bar_height: Optional[Number] = None
     """
     The minimum height of the line used to draw the linear indicator.
+
+    Raises:
+        ValueError: If [`bar_height`][(c).] is negative.
     """
 
     color: Optional[ColorValue] = None
@@ -63,6 +64,9 @@ class ProgressBar(LayoutControl):
     semantics_value: Optional[Number] = None
     """
     The semantics label for this progress indicator.
+
+    Raises:
+        ValueError: If [`semantics_value`][(c).] is negative.
     """
 
     stop_indicator_color: Optional[ColorValue] = None

flet/controls/material/radio_group.py

@@ -11,9 +11,6 @@ __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
@@ -22,6 +19,9 @@ class RadioGroup(Control):
 
     Typically a list of `Radio` controls nested in a container control, e.g. `Column`,
     `Row`.
+
+    Raises:
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     value: Optional[str] = None

flet/controls/material/range_slider.py

@@ -20,18 +20,17 @@ 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
     """
     The currently selected start value for the slider.
 
-    The slider's left thumb is drawn at a position that corresponds to this value.
+   The slider's left thumb is drawn at a position that corresponds to this value.
+
+    Raises:
+        ValueError: If [`start_value`][(c).] is less than [`min`][(c).] or greater
+            than [`end_value`][(c).].
     """
 
     end_value: Number
@@ -39,6 +38,10 @@ class RangeSlider(LayoutControl):
     The currently selected end value for the slider.
 
     The slider's right thumb is drawn at a position that corresponds to this value.
+
+    Raises:
+        ValueError: If [`end_value`][(c).] is greater than [`max`][(c).] or less than
+            [`start_value`][(c).].
     """
 
     label: Optional[str] = None
@@ -57,6 +60,9 @@ class RangeSlider(LayoutControl):
     Defaults to `0.0`. Must be less than or equal to `max`.
 
     If the `max` is equal to the `min`, then the slider is disabled.
+
+    Raises:
+        ValueError: If [`min`][(c).] is greater than [`max`][(c).].
     """
 
     max: Optional[Number] = None
@@ -66,6 +72,9 @@ class RangeSlider(LayoutControl):
     If the `max` is equal to the `min`, then the slider is disabled.
 
     Defaults to `1.0`.
+
+    Raises:
+        ValueError: If [`max`][(c).] is less than [`min`][(c).].
     """
 
     divisions: Optional[int] = None

flet/controls/material/segmented_button.py

@@ -21,9 +21,6 @@ __all__ = ["Segment", "SegmentedButton"]
 class Segment(Control):
     """
     A segment for a [`SegmentedButton`][flet.].
-
-    Raises:
-        ValueError: If neither [`icon`][(c).] nor [`label`][(c).] is set.
     """
 
     value: str
@@ -41,6 +38,9 @@ class Segment(Control):
     """
     The label (usually a [`Text`][flet.]) to be
     displayed in the segment.
+
+    Raises:
+        ValueError: If neither [`icon`][(c).] nor [`label`][(c).] is set.
     """
 
     def before_update(self):
@@ -58,19 +58,15 @@ class Segment(Control):
 class SegmentedButton(LayoutControl):
     """
     A segmented button control.
-
-    Raises:
-        ValueError: If [`segments`][(c).] is empty or does not have at
-            least one visible `Segment`.
-        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]
     """
     The segments of this button.
+
+    Raises:
+        ValueError: If [`segments`][(c).] is empty or does not have at least one
+            visible `Segment`.
     """
 
     style: Optional[ButtonStyle] = None
@@ -88,6 +84,10 @@ class SegmentedButton(LayoutControl):
     If `False` (the default), there must be at least one segment selected. If the user
     taps on the only selected segment it will not be deselected, and `on_change` will
     not be called.
+
+    Raises:
+        ValueError: If [`selected`][(c).] is empty while
+            [`allow_empty_selection`][(c).] is `False`.
     """
 
     allow_multiple_selection: bool = False
@@ -100,12 +100,21 @@ class SegmentedButton(LayoutControl):
 
     If `False` (the default), only one segment may be selected at a time. When a segment
     is selected, any previously selected segment will be unselected.
+
+    Raises:
+        ValueError: If [`selected`][(c).] has more than one item while
+            [`allow_multiple_selection`][(c).] is `False`.
     """
 
     selected: list[str] = field(default_factory=list)
     """
     A set of `Segment.value`s that indicate which segments are selected. It is updated
     when the user (un)selects a segment.
+
+    Raises:
+        ValueError: If [`selected`][(c).] violates the constraints defined by
+            [`allow_empty_selection`][(c).] or
+            [`allow_multiple_selection`][(c).].
     """
 
     selected_icon: Optional[IconDataOrControl] = None

flet/controls/material/selection_area.py

@@ -12,9 +12,6 @@ class SelectionArea(Control):
     """
     Flet controls are not selectable by default. SelectionArea is used to enable
     selection for its child control.
-
-    Raises:
-        ValueError: If [`content`][(c).] is not visible
     """
 
     content: Control
@@ -24,6 +21,9 @@ class SelectionArea(Control):
     If you need to have multiple selectable controls, use container-like controls
     like [`Row`][flet.] or [`Column`][flet.], which have a `controls` property
     for this purpose.
+
+    Raises:
+        ValueError: If [`content`][(c).] is not visible.
     """
 
     on_change: Optional[ControlEventHandler["SelectionArea"]] = None

flet/controls/material/slider.py

@@ -32,11 +32,6 @@ class Slider(LayoutControl, AdaptiveControl):
     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
@@ -46,6 +41,10 @@ class Slider(LayoutControl, AdaptiveControl):
     The slider's thumb is drawn at a position that corresponds to this value.
 
     Defaults to value of [`min`][(c).].
+
+    Raises:
+        ValueError: If [`value`][(c).] is less than [`min`][(c).] or greater than
+            [`max`][(c).].
     """
 
     label: Optional[str] = None
@@ -68,6 +67,9 @@ class Slider(LayoutControl, AdaptiveControl):
         - 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
@@ -78,6 +80,9 @@ class Slider(LayoutControl, AdaptiveControl):
         - 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/material/snack_bar.py

@@ -93,11 +93,6 @@ 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
@@ -105,6 +100,9 @@ class SnackBar(DialogControl):
     The primary content of the snack bar.
 
     Typically a [`Text`][flet.] control.
+
+    Raises:
+        ValueError: If [`content`][(c).] is not a string or visible control.
     """
 
     behavior: Optional[SnackBarBehavior] = None
@@ -195,6 +193,9 @@ class SnackBar(DialogControl):
     """
     The z-coordinate at which to place the snack bar. This controls the size of the
     shadow below the snack bar.
+
+    Raises:
+        ValueError: If [`elevation`][(c).] is negative.
     """
 
     shape: Optional[OutlinedBorder] = None
@@ -220,6 +221,9 @@ class SnackBar(DialogControl):
 
     Note:
         Must be between `0.0` and `1.0` inclusive.
+
+    Raises:
+        ValueError: If [`action_overflow_threshold`][(c).] is not between `0` and `1`.
     """
 
     on_action: Optional[ControlEventHandler["SnackBar"]] = None

flet/controls/material/switch.py

@@ -26,9 +26,6 @@ class Switch(LayoutControl, AdaptiveControl):
     two mutually exclusive options.
 
     For example, "On/Off", "Show/Hide".
-
-    Raises:
-        ValueError: If [`splash_radius`][(c).] is negative.
     """
 
     label: Optional[StrOrControl] = None
@@ -159,6 +156,9 @@ class Switch(LayoutControl, AdaptiveControl):
     splash_radius: Optional[Number] = None
     """
     The radius of the splash effect when the switch is pressed.
+
+    Raises:
+        ValueError: If [`splash_radius`][(c).] is negative.
     """
 
     overlay_color: Optional[ControlStateValue[ColorValue]] = None

flet/controls/material/tabs.py

@@ -153,11 +153,6 @@ class Tabs(LayoutControl, AdaptiveControl):
     Used for navigating frequently accessed, distinct content
     categories. Tabs allow for navigation between two or more content views and relies
     on text headers to articulate the different sections of content.
-
-    Raises:
-        ValueError: If [`length`][(c).] is negative.
-        IndexError: If [`selected_index`][(c).] is not in the range
-            `[-length, length - 1]`.
     """
 
     content: Control
@@ -175,6 +170,9 @@ class Tabs(LayoutControl, AdaptiveControl):
         Must match the length of both [`TabBar.tabs`][flet.]
         and [`TabBarView.controls`][flet.]. Don't forget to update
         it when adding/removing tabs.
+
+    Raises:
+        ValueError: If [`length`][(c).] is negative.
     """
 
     selected_index: int = 0
@@ -191,6 +189,10 @@ class Tabs(LayoutControl, AdaptiveControl):
             [`AnimationCurve.EASE`][flet.] animation curve. To specify
             a different animation curve or duration for this particular change,
             use [`move_to`][(c).] directly.
+
+    Raises:
+        IndexError: If [`selected_index`][(c).] is not in the range
+            `[-length, length - 1]`.
     """
 
     animation_duration: DurationValue = field(
@@ -314,12 +316,6 @@ class TabBar(LayoutControl, AdaptiveControl):
     Used for navigating frequently accessed, distinct content
     categories. Tabs allow for navigation between two or more content views and relies
     on text headers to articulate the different sections of content.
-
-    Raises:
-        ValueError: If [`indicator`][(c).] is None and
-            [`indicator_thickness`][(c).] is not strictly greater than 0.
-        ValueError: If [`tab_alignment`][(c).] is not valid for
-            the given [`scrollable`][(c).] state.
     """
 
     tabs: list[Control]
@@ -366,6 +362,10 @@ class TabBar(LayoutControl, AdaptiveControl):
             [`TabAlignment.START`][flet.],
             [`TabAlignment.START_OFFSET`][flet.]
             or [`TabAlignment.CENTER`][flet.].
+
+    Raises:
+        ValueError: If [`tab_alignment`][(c).] is not valid for the current
+            [`scrollable`][(c).] configuration.
     """
 
     divider_color: Optional[ColorValue] = None
@@ -487,6 +487,10 @@ class TabBar(LayoutControl, AdaptiveControl):
     Note:
         Will be ignored if [`indicator`][(c).] or
         [`TabBarTheme.indicator`][flet.] is not `None`.
+
+    Raises:
+        ValueError: If [`indicator`][(c).] is `None` and
+            [`indicator_thickness`][(c).] is not strictly greater than `0`.
     """
 
     enable_feedback: Optional[bool] = None
@@ -563,14 +567,14 @@ class TabBar(LayoutControl, AdaptiveControl):
 class Tab(AdaptiveControl):
     """
     A Material Design [`TabBar`][flet.] tab.
-
-    Raises:
-        ValueError: If both [`label`][(c).] and [`icon`][(c).] are not set.
     """
 
     label: Optional[StrOrControl] = None
     """
     The tab's name. Can be either a string or a control.
+
+    Raises:
+        ValueError: If both [`label`][(c).] and [`icon`][(c).] are not set.
     """
 
     icon: Optional[IconDataOrControl] = None

flet/controls/material/textfield.py

@@ -133,12 +133,6 @@ class TextField(FormFieldControl, AdaptiveControl):
     """
     A text field lets the user enter text, either with hardware keyboard or with an
     onscreen keyboard.
-
-    Raises:
-        ValueError: If [`min_lines`][(c).] is not positive.
-        ValueError: If [`max_lines`][(c).] is not positive.
-        ValueError: If [`min_lines`][(c).] is greater than [`max_lines`][(c).].
-        ValueError: If [`max_length`][(c).] is not -1 or positive.
     """
 
     value: str = ""
@@ -164,6 +158,10 @@ class TextField(FormFieldControl, AdaptiveControl):
     that can be entered into the field.
 
     Defaults to `1`.
+
+    Raises:
+        ValueError: If [`min_lines`][(c).] is not positive or exceeds
+            [`max_lines`][(c).] when both are set.
     """
 
     max_lines: Optional[int] = None
@@ -175,11 +173,18 @@ class TextField(FormFieldControl, AdaptiveControl):
 
     If this is `1` (the default), the text will not wrap, but will scroll horizontally
     instead.
+
+    Raises:
+        ValueError: If [`max_lines`][(c).] is not positive or is less than
+            [`min_lines`][(c).].
     """
 
     max_length: Optional[int] = None
     """
     Limits a maximum number of characters that can be entered into TextField.
+
+    Raises:
+        ValueError: If [`max_length`][(c).] is neither `-1` nor a positive integer.
     """
 
     password: bool = False

flet/controls/material/vertical_divider.py

@@ -14,12 +14,6 @@ class VerticalDivider(Control):
     A thin vertical line, with padding on either side.
 
     In the material design language, this represents a divider.
-
-    Raises:
-        ValueError: If [`width`][(c).] is negative.
-        ValueError: If [`thickness`][(c).] is negative.
-        ValueError: If [`leading_indent`][(c).] is negative.
-        ValueError: If [`trailing_indent`][(c).] is negative.
     """
 
     width: Optional[Number] = None
@@ -29,6 +23,9 @@ class VerticalDivider(Control):
 
     If `None`, [`DividerTheme.space`][flet.] is used.
     If that's is also `None`, defaults to `16.0`.
+
+    Raises:
+        ValueError: If [`width`][(c).] is negative.
     """
 
     thickness: Optional[Number] = None
@@ -41,6 +38,9 @@ class VerticalDivider(Control):
 
     If `None`, [`DividerTheme.thickness`][flet.] is used.
     If that's is also `None`, defaults to `0.0`.
+
+    Raises:
+        ValueError: If [`thickness`][(c).] is negative.
     """
 
     color: Optional[ColorValue] = None
@@ -57,6 +57,9 @@ class VerticalDivider(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.
     """
 
     trailing_indent: Optional[Number] = None
@@ -65,6 +68,9 @@ class VerticalDivider(Control):
 
     If `None`, [`DividerTheme.trailing_indent`][flet.] is used.
     If that's is also `None`, defaults to `0.0`.
+
+    Raises:
+        ValueError: If [`trailing_indent`][(c).] is negative.
     """
 
     radius: Optional[BorderRadiusValue] = None

flet/version.py

@@ -10,7 +10,7 @@ from flet.utils import is_mobile, is_windows, which
 DEFAULT_VERSION = "0.1.0"
 
 # will be replaced by CI
-version = "0.70.0.dev6214"
+version = "0.70.0.dev6232"
 
 
 def update_version():

{flet-0.70.0.dev6214.dist-info → flet-0.70.0.dev6232.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.70.0.dev6214
+Version: 0.70.0.dev6232
 Summary: Flet for Python - easily build interactive multi-platform apps in Python
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0