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

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

flet/controls/material/textfield.py

@@ -133,6 +133,12 @@ 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 = ""
@@ -420,20 +426,22 @@ class TextField(FormFieldControl, AdaptiveControl):
 
     def before_update(self):
         super().before_update()
-        assert self.min_lines is None or self.min_lines > 0, (
-            "min_lines must be greater than 0"
-        )
-        assert self.max_lines is None or self.max_lines > 0, (
-            "min_lines must be greater than 0"
-        )
-        assert (
-            self.max_lines is None
-            or self.min_lines is None
-            or self.min_lines <= self.max_lines
-        ), "min_lines can't be greater than max_lines"
-        assert (
-            self.max_length is None or self.max_length == -1 or self.max_length > 0
-        ), "max_length must be either equal to -1 or greater than 0"
+        if self.min_lines is not None and self.min_lines <= 0:
+            raise ValueError("min_lines must be greater than 0")
+        if self.max_lines is not None and self.max_lines <= 0:
+            raise ValueError("max_lines must be greater than 0")
+        if (
+            self.max_lines is not None
+            and self.min_lines is not None
+            and self.min_lines > self.max_lines
+        ):
+            raise ValueError("min_lines can't be greater than max_lines")
+        if (
+            self.max_length is not None
+            and self.max_length != -1
+            and self.max_length <= 0
+        ):
+            raise ValueError("max_length must be either equal to -1 or greater than 0")
         if (
             self.bgcolor is not None
             or self.fill_color is not None

flet/controls/material/vertical_divider.py

@@ -13,6 +13,12 @@ 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
@@ -63,15 +69,11 @@ class VerticalDivider(Control):
 
     def before_update(self):
         super().before_update()
-        assert self.width is None or self.width >= 0, (
-            "width must be greater than or equal to 0"
-        )
-        assert self.thickness is None or self.thickness >= 0, (
-            "thickness must be greater than or equal to 0"
-        )
-        assert self.leading_indent is None or self.leading_indent >= 0, (
-            "leading_indent must be greater than or equal to 0"
-        )
-        assert self.trailing_indent is None or self.trailing_indent >= 0, (
-            "trailing_indent must be greater than or equal to 0"
-        )
+        if self.width is not None and self.width < 0:
+            raise ValueError("width must be greater than or equal to 0")
+        if self.thickness is not None and self.thickness < 0:
+            raise ValueError("thickness must be greater than or equal to 0")
+        if self.leading_indent is not None and self.leading_indent < 0:
+            raise ValueError("leading_indent must be greater than or equal to 0")
+        if self.trailing_indent is not None and self.trailing_indent < 0:
+            raise ValueError("trailing_indent must be greater than or equal to 0")

flet/controls/page.py

@@ -487,7 +487,8 @@ class Page(BasePage):
         current page.
         """
         _context_page.set(self)
-        assert asyncio.iscoroutinefunction(handler)
+        if not asyncio.iscoroutinefunction(handler):
+            raise TypeError("handler must be a coroutine function")
 
         future = asyncio.run_coroutine_threadsafe(
             handler(*args, **kwargs), self.get_session().connection.loop

flet/testing/finder.py

@@ -1,5 +1,7 @@
 from dataclasses import dataclass
 
+__all__ = ["Finder"]
+
 
 @dataclass
 class Finder:

flet/testing/flet_test_app.py

@@ -17,6 +17,8 @@ from flet.testing.tester import Tester
 from flet.utils.network import get_free_tcp_port
 from flet.utils.platform_utils import get_bool_env_var
 
+__all__ = ["FletTestApp"]
+
 
 class FletTestApp:
     """

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.dev5771"
+version = "0.70.0.dev5776"
 
 
 def update_version():

{flet-0.70.0.dev5771.dist-info → flet-0.70.0.dev5776.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.70.0.dev5771
+Version: 0.70.0.dev5776
 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
@@ -9,10 +9,10 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://docs.flet.dev/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.70.0.dev5771; extra == "cli"
-Requires-Dist: flet-desktop==0.70.0.dev5771; extra == "desktop" and (platform_system == "Darwin" or platform_system == "Windows")
-Requires-Dist: flet-desktop-light==0.70.0.dev5771; platform_system == "Linux" and (extra == "all" or extra == "desktop")
-Requires-Dist: flet-web==0.70.0.dev5771; extra == "web"
+Requires-Dist: flet-cli==0.70.0.dev5776; extra == "cli"
+Requires-Dist: flet-desktop==0.70.0.dev5776; extra == "desktop" and (platform_system == "Darwin" or platform_system == "Windows")
+Requires-Dist: flet-desktop-light==0.70.0.dev5776; platform_system == "Linux" and (extra == "all" or extra == "desktop")
+Requires-Dist: flet-web==0.70.0.dev5776; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Pyodide"
 Requires-Dist: httpx>=0.28.1; platform_system != "Pyodide"
 Requires-Dist: repath>=0.9.0