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

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

@@ -0,0 +1,24 @@
+import itertools
+import threading
+from typing import Optional
+
+from flet.utils.locks import NopeLock
+from flet.utils.platform_utils import is_pyodide
+
+
+class IdCounter:
+    def __init__(
+        self, start: int = 1, step: int = 1, lock: Optional[threading.Lock] = None
+    ):
+        self._counter = itertools.count(start, step)
+        self._lock = lock or (NopeLock() if is_pyodide() else threading.Lock())
+
+    def next(self) -> int:
+        with self._lock:
+            return next(self._counter)
+
+    def __call__(self) -> int:  # for dataclass default_factory
+        return self.next()
+
+
+ControlId = IdCounter(start=3)

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

flet/controls/material/datatable.py

@@ -36,7 +36,7 @@ class DataColumn(Control):
     Column configuration for a [`DataTable`][flet.].
 
     Raises:
-        AssertionError: If the [`label`][(c).] is neither a string nor
+        ValueError: If the [`label`][(c).] is neither a string nor
             a visible control.
     """
 
@@ -82,9 +82,11 @@ class DataColumn(Control):
 
     def before_update(self):
         super().before_update()
-        assert isinstance(self.label, str) or (
-            isinstance(self.label, Control) and self.label.visible
-        ), "label must a string or a visible control"
+        if not (
+            isinstance(self.label, str)
+            or (isinstance(self.label, Control) and self.label.visible)
+        ):
+            raise ValueError("label must a string or a visible control")
 
 
 @control("DataCell")
@@ -93,7 +95,7 @@ class DataCell(Control):
     The data for a cell of a [`DataTable`][flet.].
 
     Raises:
-        AssertionError: If the [`content`][(c).] is neither a string nor a visible
+        ValueError: If the [`content`][(c).] is neither a string nor a visible
             control.
     """
 
@@ -185,8 +187,8 @@ class DataCell(Control):
 
     def before_update(self):
         super().before_update()
-        if isinstance(self.content, Control):
-            assert self.content.visible, "content must be visible"
+        if isinstance(self.content, Control) and not self.content.visible:
+            raise ValueError("content must be visible")
 
 
 @control("DataRow")
@@ -197,6 +199,9 @@ 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)
@@ -267,9 +272,8 @@ class DataRow(Control):
 
     def before_update(self):
         super().before_update()
-        assert any(cell.visible for cell in self.cells), (
-            "cells must contain at minimum one visible DataCell"
-        )
+        if not any(cell.visible for cell in self.cells):
+            raise ValueError("cells must contain at minimum one visible DataCell")
 
 
 @control("DataTable")
@@ -278,13 +282,13 @@ class DataTable(LayoutControl):
     A Material Design data table.
 
     Raises:
-        AssertionError: If there are no visible [`columns`][(c).].
-        AssertionError: If any visible row does not contain exactly as many visible
+        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).].
-        AssertionError: If [`data_row_min_height`][(c).] is greater than
+        ValueError: If [`data_row_min_height`][(c).] is greater than
             [`data_row_max_height`][(c).].
-        AssertionError: If [`divider_thickness`][(c).] is negative.
-        AssertionError: If [`sort_column_index`][(c).] is out of range.
+        ValueError: If [`divider_thickness`][(c).] is negative.
+        ValueError: If [`sort_column_index`][(c).] is out of range.
     """
 
     columns: list[DataColumn]
@@ -488,34 +492,37 @@ class DataTable(LayoutControl):
             list(filter(lambda column: column.visible, self.columns))
         )
         visible_rows = list(filter(lambda row: row.visible, self.rows))
-        assert visible_columns_count > 0, (
-            "columns must contain at minimum one visible DataColumn"
-        )
-        assert all(
+        if visible_columns_count == 0:
+            raise ValueError("columns must contain at minimum one visible DataColumn")
+        if not all(
             [
                 len([c for c in row.cells if c.visible]) == visible_columns_count
                 for row in visible_rows
             ]
-        ), (
-            f"each visible DataRow must contain exactly as many visible DataCells as "
-            f"there are visible DataColumns ({visible_columns_count})"
-        )
-        assert (
-            self.data_row_min_height is None
-            or self.data_row_max_height is None
-            or (self.data_row_min_height <= self.data_row_max_height)
-        ), (
-            f"data_row_min_height ({self.data_row_min_height}) must be less than or "
-            f"equal to data_row_max_height ({self.data_row_max_height})"
-        )
-        assert self.divider_thickness is None or self.divider_thickness >= 0, (
-            f"divider_thickness must be greater than or equal to 0, "
-            f"got {self.divider_thickness}"
-        )
-        assert self.sort_column_index is None or (
+        ):
+            raise ValueError(
+                f"each visible DataRow must contain exactly as many visible DataCells "
+                f"as there are visible DataColumns ({visible_columns_count})"
+            )
+        if (
+            self.data_row_min_height is not None
+            and self.data_row_max_height is not None
+            and self.data_row_min_height > self.data_row_max_height
+        ):
+            raise ValueError(
+                f"data_row_min_height ({self.data_row_min_height}) must be less than "
+                f"or equal to data_row_max_height ({self.data_row_max_height})"
+            )
+        if self.divider_thickness is not None and self.divider_thickness < 0:
+            raise ValueError(
+                f"divider_thickness must be greater than or equal to 0, "
+                f"got {self.divider_thickness}"
+            )
+        if self.sort_column_index is not None and not (
             0 <= self.sort_column_index < visible_columns_count
-        ), (
-            f"sort_column_index ({self.sort_column_index}) must be greater than or "
-            f"equal to 0 and less than the "
-            f"number of visible columns ({visible_columns_count})"
-        )
+        ):
+            raise ValueError(
+                f"sort_column_index ({self.sort_column_index}) must be greater than or "
+                f"equal to 0 and less than the "
+                f"number of visible columns ({visible_columns_count})"
+            )

flet/controls/material/divider.py

@@ -1,6 +1,7 @@
 from typing import Optional
 
 from flet.controls.base_control import control
+from flet.controls.border_radius import BorderRadiusValue
 from flet.controls.control import Control
 from flet.controls.types import ColorValue, Number
 
@@ -11,6 +12,12 @@ __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
@@ -56,19 +63,28 @@ class Divider(Control):
     If that is also `None`, defaults to `0.0`.
     """
 
+    radius: Optional[BorderRadiusValue] = None
+    """
+    The border radius of the divider.
+    """
+
     def before_update(self):
         super().before_update()
-        assert self.height is None or self.height >= 0, (
-            f"height must be greater than or equal to 0, got {self.height}"
-        )
-        assert self.thickness is None or self.thickness >= 0, (
-            f"thickness must be greater than or equal to 0, got {self.thickness}"
-        )
-        assert self.leading_indent is None or self.leading_indent >= 0, (
-            "leading_indent must be greater than or equal to 0, "
-            f"got {self.leading_indent}"
-        )
-        assert self.trailing_indent is None or self.trailing_indent >= 0, (
-            "trailing_indent must be greater than or equal to 0, "
-            f"got {self.trailing_indent}"
-        )
+        if self.height is not None and self.height < 0:
+            raise ValueError(
+                f"height must be greater than or equal to 0, got {self.height}"
+            )
+        if self.thickness is not None and self.thickness < 0:
+            raise ValueError(
+                f"thickness must be greater than or equal to 0, got {self.thickness}"
+            )
+        if self.leading_indent is not None and self.leading_indent < 0:
+            raise ValueError(
+                f"leading_indent must be greater than or equal to 0, "
+                f"got {self.leading_indent}"
+            )
+        if self.trailing_indent is not None and self.trailing_indent < 0:
+            raise ValueError(
+                f"trailing_indent must be greater than or equal to 0, "
+                f"got {self.trailing_indent}"
+            )

flet/controls/material/dropdown.py

@@ -30,6 +30,9 @@ 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
@@ -66,9 +69,8 @@ class DropdownOption(Control):
 
     def before_update(self):
         super().before_update()
-        assert self.key is not None or self.text is not None, (
-            "key or text must be specified"
-        )
+        if self.key is None and self.text is None:
+            raise ValueError("key or text must be specified")
 
 
 Option = DropdownOption