flet 0.70.0.dev6145__py3-none-any.whl → 0.70.0.dev6176__py3-none-any.whl

flet/__init__.py

@@ -276,7 +276,7 @@ from flet.controls.material.expansion_tile import ExpansionTile, TileAffinity
 from flet.controls.material.filled_button import FilledButton
 from flet.controls.material.filled_tonal_button import FilledTonalButton
 from flet.controls.material.floating_action_button import FloatingActionButton
-from flet.controls.material.form_field_control import InputBorder
+from flet.controls.material.form_field_control import FormFieldControl, InputBorder
 from flet.controls.material.icon_button import (
     FilledIconButton,
     FilledTonalIconButton,
@@ -693,6 +693,7 @@ __all__ = [
     "FloatingActionButtonLocation",
     "FloatingActionButtonTheme",
     "FontWeight",
+    "FormFieldControl",
     "GestureDetector",
     "Gradient",
     "GradientTileMode",

flet/controls/cupertino/cupertino_textfield.py

@@ -46,7 +46,9 @@ class CupertinoTextField(TextField):
 
     blend_mode: Optional[BlendMode] = None
     """
-    The blend mode applied to the [`bgcolor`][(c).] or [`gradient`][(c).] background.
+    The blend mode applied to the
+    [`bgcolor`][flet.FormFieldControl.]
+    or [`gradient`][(c).] background.
     """
 
     shadows: Optional[BoxShadowValue] = None
@@ -56,27 +58,35 @@ class CupertinoTextField(TextField):
 
     prefix_visibility_mode: OverlayVisibilityMode = OverlayVisibilityMode.ALWAYS
     """
-    Defines the visibility of the [`prefix`][(c).] control
-    based on the state of text entry.
+    Defines the visibility of the
+    [`prefix`][flet.FormFieldControl.]
+    control based on the state of text entry.
 
     Note:
-        Has no effect if [`prefix`][(c).] is not specified.
+        Has no effect if
+        [`prefix`][flet.FormFieldControl.]
+        is not specified.
     """
 
     suffix_visibility_mode: OverlayVisibilityMode = OverlayVisibilityMode.ALWAYS
     """
-    Defines the visibility of the [`suffix`][(c).] control
-    based on the state of text entry.
+    Defines the visibility of the
+    [`suffix`][flet.FormFieldControl.]
+    control based on the state of text entry.
 
     Note:
-        Has no effect if [`suffix`][(c).] is not specified.
+        Has no effect if
+        [`suffix`][flet.FormFieldControl.]
+        is not specified.
     """
 
     clear_button_visibility_mode: OverlayVisibilityMode = OverlayVisibilityMode.NEVER
     """
     Defines the visibility of the clear button based on the state of text entry.
 
-    Will appear only if no [`suffix`][(c).] is provided.
+    Will appear only if no
+    [`suffix`][flet.FormFieldControl.]
+    is provided.
     """
 
     clear_button_semantics_label: Optional[str] = "Clear"
@@ -88,12 +98,16 @@ class CupertinoTextField(TextField):
 
     image: Optional[DecorationImage] = None
     """
-    An image to paint above the [`bgcolor`][(c).] or [`gradient`][(c).] background.
+    An image to paint above the
+    [`bgcolor`][flet.FormFieldControl.]
+    or [`gradient`][(c).] background.
     """
 
     padding: PaddingValue = field(default_factory=lambda: Padding.all(7))
     """
-    The padding around the text entry area between the [`prefix`][(c).]
-    and [`suffix`][(c).] or the clear button when [`clear_button_visibility_mode`][(c).]
+    The padding around the text entry area between the
+    [`prefix`][flet.FormFieldControl.]
+    and [`suffix`][flet.FormFieldControl.]
+    or the clear button when [`clear_button_visibility_mode`][(c).]
     is not [`OverlayVisibilityMode.NEVER`][flet.].
     """

flet/controls/material/button.py

@@ -27,26 +27,101 @@ class Button(LayoutControl, AdaptiveControl):
     It supports various styles, colors, event handlers for user interaction,
     and can be used to display text, icons, etc.
 
+    ```python
+    ft.Button(content="Enabled button")
+    ft.Button(content="Disabled button", disabled=True)
+    ```
+    """
+
+    content: Optional[StrOrControl] = None
+    """
+    The button's label.
+    Typically a [`Text`][flet.] control or a string.
+    If a string is provided, it will be wrapped in a [`Text`][flet.] control.
+
     Raises:
         ValueError: If neither [`icon`][(c).] nor [`content`][(c).]
             (string or visible control) is provided.
     """
 
-    content: Optional[StrOrControl] = None
     icon: Optional[IconDataOrControl] = None
+    """
+    The icon to display inside the button.
+    Typically an [`Icon`][flet.] control or an `IconData`.
+    If an `IconData` is provided, it will be wrapped in an [`Icon`][flet.] control.
+
+    Raises:
+        ValueError: If neither [`icon`][(c).] nor [`content`][(c).]
+            (string or visible control) is provided.
+    """
     icon_color: Optional[ColorValue] = None
+    """
+    The color of the icon.
+    If not specified, defaults to the current foreground color.
+    """
+
     color: Optional[ColorValue] = field(default=None, metadata={"skip": True})
+    """
+    The button's foreground color.
+    If not specified, defaults to the theme's primary color.
+    """
+
     bgcolor: Optional[ColorValue] = field(default=None, metadata={"skip": True})
+    """
+    The button's background color.
+    If not specified, defaults to the theme's primary color.
+    """
+
     elevation: Number = field(default=1, metadata={"skip": True})
+    """
+    The button's elevation.
+    If not specified, defaults to `1`.
+    """
+
     style: Optional[ButtonStyle] = field(default=None, metadata={"skip": True})
+    """
+    The button's style.
+    """
+
     autofocus: Optional[bool] = None
+    """
+    Whether this button should be focused initially.
+    """
+
     clip_behavior: Optional[ClipBehavior] = None
+    """
+    The button's clip behavior.
+    """
+
     url: Optional[Union[str, Url]] = None
+    """
+    The URL to open when the button is clicked.
+    """
+
     on_click: Optional[ControlEventHandler["Button"]] = None
+    """
+    Called when the button is clicked.
+    """
+
     on_long_press: Optional[ControlEventHandler["Button"]] = None
+    """
+    Called when the button is long-pressed.
+    """
+
     on_hover: Optional[ControlEventHandler["Button"]] = None
+    """
+    Called when the button is hovered.
+    """
+
     on_focus: Optional[ControlEventHandler["Button"]] = None
+    """
+    Called when the button is focused.
+    """
+
     on_blur: Optional[ControlEventHandler["Button"]] = None
+    """
+    Called when the button loses focus.
+    """
 
     def before_update(self):
         super().before_update()
@@ -72,4 +147,7 @@ class Button(LayoutControl, AdaptiveControl):
             )
 
     async def focus(self):
+        """
+        Focus the button.
+        """
         await self._invoke_method("focus")

flet/controls/material/card.py

@@ -52,9 +52,7 @@ class Card(LayoutControl, AdaptiveControl):
     """
     The color to paint the shadow below this card.
 
-    Defaults to [`CardTheme.shadow_color`][flet.],
-    or if that is `None`, falls back to [`Theme.shadow_color`][flet.]
-    (which defaults to `Colors.BLACK`).
+    Defaults to [`CardTheme.shadow_color`][flet.]
     """
 
     shape: Optional[OutlinedBorder] = None

flet/controls/material/vertical_divider.py

@@ -49,7 +49,6 @@ class VerticalDivider(Control):
     line.
 
     If `None`, [`DividerTheme.color`][flet.] is used.
-    If that's is also `None`, defaults to [`Theme.divider_color`][flet.].
     """
 
     leading_indent: Optional[Number] = None

flet/controls/page.py

@@ -588,9 +588,9 @@ class Page(BasePage):
         finally calls `page.update()`.
         """
 
-        self.push_route(route, **kwargs)
+        asyncio.create_task(self.push_route(route, **kwargs))
 
-    def push_route(self, route: str, **kwargs: Any) -> None:
+    async def push_route(self, route: str, **kwargs: Any) -> None:
         """
         Pushes a new navigation route to the browser history stack.
         Changing route will fire [`page.on_route_change`](#on_route_change) event
@@ -600,6 +600,7 @@ class Page(BasePage):
 
         ```python
         import flet as ft
+        import asyncio
 
 
         def main(page: ft.Page):
@@ -614,7 +615,9 @@ class Page(BasePage):
                             ft.AppBar(title=ft.Text("Flet app")),
                             ft.ElevatedButton(
                                 "Visit Store",
-                                on_click=lambda _: page.push_route("/store"),
+                                on_click=lambda _: asyncio.create_task(
+                                    page.push_route("/store")
+                                ),
                             ),
                         ],
                     )
@@ -627,16 +630,19 @@ class Page(BasePage):
                             controls=[
                                 ft.AppBar(title=ft.Text("Store")),
                                 ft.ElevatedButton(
-                                    "Go Home", on_click=lambda _: page.push_route("/")
+                                    "Go Home",
+                                    on_click=lambda _: asyncio.create_task(
+                                        page.push_route("/")
+                                    ),
                                 ),
                             ],
                         )
                     )
 
-            def view_pop(e):
+            async def view_pop(e):
                 page.views.pop()
                 top_view = page.views[-1]
-                page.push_route(top_view.route)
+                await page.push_route(top_view.route)
 
             page.on_route_change = route_change
             page.on_view_pop = view_pop
@@ -651,11 +657,9 @@ class Page(BasePage):
         """
 
         new_route = route if not kwargs else route + self.query.post(kwargs)
-        asyncio.create_task(
-            self._invoke_method(
-                "push_route",
-                arguments={"route": new_route},
-            )
+        await self._invoke_method(
+            "push_route",
+            arguments={"route": new_route},
         )
 
     def get_upload_url(self, file_name: str, expires: int) -> str:

flet/testing/flet_test_app.py

@@ -257,6 +257,28 @@ class FletTestApp:
                     print("Force killing Flutter test process...")
                     self.__flutter_process.kill()
 
+    async def wrap_page_controls_in_screenshot(self, margin=10):
+        """
+        Wraps provided controls in a Screenshot control.
+        """
+        controls = list(self.page.controls)
+        self.page.controls = [scr := ft.Screenshot(ft.Column(controls, margin=margin))]
+        self.page.update()
+        await self.tester.pump_and_settle()
+        return scr
+
+    async def take_page_controls_screenshot(
+        self,
+        pixel_ratio: Optional[float] = None,
+    ):
+        """
+        Takes a screenshot of all controls on the current page.
+        """
+        scr = await self.wrap_page_controls_in_screenshot()
+        return await scr.capture(
+            pixel_ratio=pixel_ratio or self.screenshots_pixel_ratio
+        )
+
     async def assert_control_screenshot(
         self,
         name: str,
@@ -289,7 +311,9 @@ class FletTestApp:
             await screenshot.capture(pixel_ratio=self.screenshots_pixel_ratio),
         )
 
-    def assert_screenshot(self, name: str, screenshot: bytes):
+    def assert_screenshot(
+        self, name: str, screenshot: bytes, similarity_threshold: float = 0
+    ):
         """
         Compares provided screenshot with a golden copy or takes golden screenshot
         if `FLET_TEST_GOLDEN=1` environment variable is set.
@@ -324,14 +348,16 @@ class FletTestApp:
             img = self._load_image_from_bytes(screenshot)
             similarity = self._compare_images_rgb(golden_img, img)
             print(f"Similarity for {name}: {similarity}%")
-            if similarity <= self.screenshots_similarity_threshold:
+            if similarity_threshold == 0:
+                similarity_threshold = self.screenshots_similarity_threshold
+            if similarity <= similarity_threshold:
                 actual_image_path = (
                     golden_image_path.parent
                     / f"{golden_image_path.parent.stem}_{golden_image_path.stem}_actual.png"  # noqa: E501
                 )
                 with open(actual_image_path, "bw") as f:
                     f.write(screenshot)
-            assert similarity > self.screenshots_similarity_threshold, (
+            assert similarity > similarity_threshold, (
                 f"{name} screenshots are not identical"
             )
 

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

{flet-0.70.0.dev6145.dist-info → flet-0.70.0.dev6176.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.70.0.dev6145
+Version: 0.70.0.dev6176
 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

{flet-0.70.0.dev6145.dist-info → flet-0.70.0.dev6176.dist-info}/RECORD

@@ -1,7 +1,7 @@
-flet/__init__.py,sha256=Lv9YmVVMQHTiO5E089OW9ES1CnGyoJadzi4IFk0bhmI,25642
+flet/__init__.py,sha256=n5qVCP3EFldZdmB22hoO751d9fB5U9-AN6uMU-55IPA,25684
 flet/app.py,sha256=HSws0Zm4ZO0-Hp2P9h7xirCVnRkKCVXhuekyAXT_9Fo,11883
 flet/cli.py,sha256=IUM25fY_sqMtl0hlQGhlMQaBb1oNyO0VZeeBgRodhuA,204
-flet/version.py,sha256=_CNaE85ZzAmgu7gd9GDOEkaeLybv9TcXH7YjoG9hWqU,2512
+flet/version.py,sha256=OOXW9v5bFD449k3IMfq3V3RcnBQc0NkTYV1ezhwJh_Y,2512
 flet/auth/__init__.py,sha256=eDqmi0Ki8Resd198S7XxgYa2R14wnNqIXnYhBLPl8fQ,289
 flet/auth/authorization.py,sha256=hP_36RiRPtSwmK_Yp6MMzAjQdDxbBiEcZ2yFNqyNiRs,357
 flet/auth/authorization_service.py,sha256=6N2LvisSt7KI_VgfyCH0OaJ6jTcmXCkAldN1yYlakzQ,6410
@@ -61,7 +61,7 @@ flet/controls/margin.py,sha256=ni5FwkchO1LPKPTKV0Cimvh2YzABi-t5DhOqTS25eIQ,2305
 flet/controls/multi_view.py,sha256=7RbM1nt8t75qgTKyfemsV06XQ04Mer0Op409Nu9q9Vs,304
 flet/controls/object_patch.py,sha256=0OE8TswTyYH_l1yEqJPIf-Z6kLnOCCQCYiV-gNUvuSA,44111
 flet/controls/padding.py,sha256=AdxAZ5dbg1-Bo8aKeJ7AptUdyjaX7VWBIJto5mBT9Pk,2485
-flet/controls/page.py,sha256=_1FGO52-hWj7Z99Q9mEynQwWLqnmdxJZKcp6L4tPnJ4,26383
+flet/controls/page.py,sha256=OerVhgInFcr2C53LwvG8s5ksZ7TI9uw7WF5VL6-hTCg,26623
 flet/controls/painting.py,sha256=GCEycacejiCAdA4eZBQlTgxmE2ccXyad4Gy7VsjIwn0,12108
 flet/controls/query_string.py,sha256=NDrf1P0cxSWuJd4Rqz1qYld_JKDJpHY7mKcP52-70DI,3575
 flet/controls/ref.py,sha256=Lde_Nlly6NEtJX_LYv_DxIDkao6w4Buo7Nus4XUPQDA,580
@@ -143,7 +143,7 @@ flet/controls/cupertino/cupertino_segmented_button.py,sha256=DEntfRb7D1HZWTfa5GP
 flet/controls/cupertino/cupertino_slider.py,sha256=hOdSrWy_sKBLqP5n6E0DWf3J0fhT6Xcovg1CI7YBgns,3467
 flet/controls/cupertino/cupertino_sliding_segmented_button.py,sha256=h9D8L6m-jqyht_96wJlfypP7wqVipGtvmNW8hF1zcJQ,3045
 flet/controls/cupertino/cupertino_switch.py,sha256=0UtGp1fhCGlYVf2w8xXic0MfcEds-uNqF7WQi84Ld8w,4201
-flet/controls/cupertino/cupertino_textfield.py,sha256=rQmJrP-fo5m8HYGDhtBWPmhg0JywXDn5GFapYM6wZgY,2897
+flet/controls/cupertino/cupertino_textfield.py,sha256=yqwTdXLvu7IKwX-4GjtJWCjUeX2rB2wuN5akgrBM5V4,3131
 flet/controls/cupertino/cupertino_timer_picker.py,sha256=YNMAeazkm6nGEwF2X-r9WuB25aqam6PYORuq1yoptBk,4509
 flet/controls/cupertino/cupertino_tinted_button.py,sha256=rU1bW9qfu2GGkma3zlTTMZOhBlqBtj4bYxqJMrwJBF8,313
 flet/controls/material/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -154,8 +154,8 @@ flet/controls/material/badge.py,sha256=xtyG18lElGMjKtvZg6OX4nRney8sAlC7TNTe2dUDj
 flet/controls/material/banner.py,sha256=1QXFji-E7bOUh8d0iRL_byyE8kTMyepA24rWVx178pA,4159
 flet/controls/material/bottom_app_bar.py,sha256=I5DO0wdbYsYe1_EatIU-jLGHFA8WT670sCrGUj6IM50,2083
 flet/controls/material/bottom_sheet.py,sha256=o7y8a80HSeJWwI4Q3JNFeJ-6kvziuuj3t9f9gadGrhw,2791
-flet/controls/material/button.py,sha256=14QzipCjIQpfLRoV4XBMTAxeR_EJNNvUcni7f2JLnL0,2584
-flet/controls/material/card.py,sha256=vNPL9Dv8rBg5v-0E7whgI-dV9jVRR6Z3oPctPQ8v7FU,2616
+flet/controls/material/button.py,sha256=8_CLLvjPO9ZXsaGkJhO1a3cVbG2Abe-40cEQcT9BPpY,4189
+flet/controls/material/card.py,sha256=95ONA-QHR7By54X5Q4SWvdRIHJVJ_0schDybZcR_rW8,2505
 flet/controls/material/checkbox.py,sha256=4F2OcbvBJ4BJXVD2F-U7YdI17elmwgMe3NhWIsFgA7o,5716
 flet/controls/material/chip.py,sha256=nGRGylhipV0wNj4w8v_qfKOqQkFSfubTBw2Nn4dcnJ0,7809
 flet/controls/material/circle_avatar.py,sha256=dVhGnrvnc5uieeFTCJZ8FHDZbwVkBDFzzk-EEEugWWc,4014
@@ -201,7 +201,7 @@ flet/controls/material/text_button.py,sha256=Mkvz4LIl0yH1-e0ekOjPD6z8CZ5ZUIyE00z
 flet/controls/material/textfield.py,sha256=tFxtWIk7JCXeq7oL_2Ltmbw5bqmY4125PIBd07Qur3Y,11668
 flet/controls/material/time_picker.py,sha256=_gUTaQi4N-mo1Oj_yJEsti8ToM0WhwhofbCjP5v2gzA,3070
 flet/controls/material/tooltip.py,sha256=PTqJiiE95z4WCTlvCx7i3vA-gGwphUT7w_2oXMiiVtY,5636
-flet/controls/material/vertical_divider.py,sha256=5-yjdV-sDXotSZFg_ApP_rtzBHlai4WkyeCOEoJhK34,2787
+flet/controls/material/vertical_divider.py,sha256=pxGH9BqW_quWhSHe8_CHw9wUWsqPN29_AufTm0JnNp0,2713
 flet/controls/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 flet/controls/services/browser_context_menu.py,sha256=iLb160q7wPicdiVPXLZLzzQ4MCGxl2e-mOV4y4d2xQg,721
 flet/controls/services/clipboard.py,sha256=Linpoz32r5i-K5vpafFwNKaWwByZ6cVFhJZ0p87M_UE,987
@@ -226,7 +226,7 @@ flet/pubsub/pubsub_hub.py,sha256=1loRKhFYq23E89EYPaK4RMCbFdOW2qVeTQk8JqnbNp8,651
 flet/security/__init__.py,sha256=LcBftVee6pXMB2MiDsc0PPUXnTlR2CT53VAPiPadaHI,2189
 flet/testing/__init__.py,sha256=Yb9e6h11b2hV7O3TuqsJ7zwFAgNcbB7tY7Gp2ssxtN4,176
 flet/testing/finder.py,sha256=G9iW6VBAOGGdOF4i2_Ax26Lrl9ujiJaqk57ESHgP018,347
-flet/testing/flet_test_app.py,sha256=c5L7ypkuMYe9trnYcI_-31RcggPFWyBXcOwxZOwzieI,12928
+flet/testing/flet_test_app.py,sha256=6aeqU6r0OQfBoqWukov6Z8ZZ7i5tIG2mthILx4Wo-Cw,13801
 flet/testing/tester.py,sha256=_DSRFQQoGISve5JR2nq3AdSbUf18E6FfG3ytRD5tAfo,4946
 flet/utils/__init__.py,sha256=LVgyCBf1VNqGXkdtf1JCP20Rx2oaPITF4nAGw2zquVI,1739
 flet/utils/browser.py,sha256=Z2PomJjClBXRRiPvGP7WRzbguvXQ8W2HQAzd_A5cmvE,157
@@ -245,8 +245,8 @@ flet/utils/platform_utils.py,sha256=U4cqV3EPi5QNYjbhfZmtk41-KMtI_P7KvVdnZzMOgJA,
 flet/utils/slugify.py,sha256=e-lsoDc2_dk5jQnySaHCU83AA4O6mguEgCEdk2smW2Y,466
 flet/utils/strings.py,sha256=R63_i7PdSAStCDPJ-O_WHBt3H02JQ14GSbnjLIpPTUc,178
 flet/utils/vector.py,sha256=pYZzjldBWCZbSeSkZ8VmujwcZC7VBWk1NLBPA-2th3U,3207
-flet-0.70.0.dev6145.dist-info/METADATA,sha256=f5e499ulUzxdsJHlScS1eOfieofZX8FeRM6p4JKPSrM,6051
-flet-0.70.0.dev6145.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-flet-0.70.0.dev6145.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
-flet-0.70.0.dev6145.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
-flet-0.70.0.dev6145.dist-info/RECORD,,
+flet-0.70.0.dev6176.dist-info/METADATA,sha256=dbegGXkovTUQPhsOkyr_2moO0StiTRMY-ME27Z9e8BQ,6051
+flet-0.70.0.dev6176.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flet-0.70.0.dev6176.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
+flet-0.70.0.dev6176.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
+flet-0.70.0.dev6176.dist-info/RECORD,,