flet 0.70.0.dev6326__py3-none-any.whl → 0.70.0.dev6348__py3-none-any.whl

flet/controls/border.py

@@ -86,34 +86,37 @@ class BorderSide:
     """
     The style of this side of the border.
 
-    To omit a side, set `style` to `BorderStyle.NONE`.
-    This skips painting the border, but the border still has a `width`.
+    Tip:
+        To omit a side, set `style` to [`BorderStyle.NONE`][flet.]. This skips
+        painting the border, but the border still has a `width`.
     """
 
     def __post_init__(self):
-        assert self.width >= 0.0, (
-            f"width must be greater than or equal to 0.0, got {self.width}"
-        )
+        if self.width < 0.0:
+            raise ValueError(
+                f"width must be greater than or equal to 0.0, got {self.width}"
+            )
 
     # Properties
 
     @property
     def stroke_inset(self):
         """
-        The amount of the stroke width that lies inside of the `BorderSide`.
+        The amount of the stroke width that lies inside this `BorderSide`.
 
-        For example, this will return the `width` for a `stroke_align` of -1, half
-        the `width` for a `stroke_align` of 0, and 0 for a `stroke_align` of 1.
+        For example, this will return the `width` for a `stroke_align` of `-`1, half
+        the `width` for a `stroke_align` of `0`, and `0` for a `stroke_align` of `1`.
         """
         return self.width * (1 - (1 + self.stroke_align) / 2)
 
     @property
     def stroke_outset(self):
         """
-        The amount of the stroke width that lies outside of the [BorderSide].
+        The amount of the stroke width that lies outside this `BorderSide`.
 
-        For example, this will return 0 for a `stroke_align` of -1, half the
-        `width` for a `stroke_align` of 0, and the `width` for a `stroke_align` of 1.
+        For example, this will return `0` for a `stroke_align` of `-1`, half the
+        `width` for a `stroke_align` of `0`, and the `width` for a
+        `stroke_align` of `1`.
         """
         return self.width * (1 + self.stroke_align) / 2
 
@@ -163,12 +166,6 @@ class Border:
 
     Each side of the border is an instance of
     [`BorderSide`][flet.].
-
-    Example:
-        ```python
-        container_1.border = ft.Border.all(10, ft.Colors.PINK_600)
-        container_1.border = ft.Border.only(bottom=ft.BorderSide(1, "black"))
-        ```
     """
 
     top: BorderSide = field(default_factory=lambda: BorderSide.none())

flet/controls/core/canvas/canvas.py

@@ -29,6 +29,34 @@ class Canvas(LayoutControl):
     """
     Canvas is a control for drawing arbitrary graphics using a set of primitives or
     "shapes" such as line, arc, path and text.
+
+    ```python
+    cv.Canvas(
+        width=160,
+        height=160,
+        shapes=[
+            cv.Rect(
+                0,
+                0,
+                160,
+                160,
+                paint=ft.Paint(
+                    color=ft.Colors.BLUE_100,
+                    style=ft.PaintingStyle.FILL,
+                ),
+            ),
+            cv.Circle(
+                80,
+                80,
+                50,
+                paint=ft.Paint(
+                    color=ft.Colors.BLUE_400,
+                    style=ft.PaintingStyle.FILL,
+                ),
+            ),
+        ],
+    )
+    ```
     """
 
     shapes: list[Shape] = field(default_factory=list)

flet/controls/cupertino/cupertino_action_sheet.py

@@ -15,6 +15,21 @@ class CupertinoActionSheet(LayoutControl):
 
     Action sheets are generally used to give the user a choice between
     two or more choices for the current context.
+
+    ```python
+    sheet = ft.CupertinoActionSheet(
+        title=ft.Text("Choose an option"),
+        message=ft.Text("Select what you would like to do"),
+        actions=[
+            ft.CupertinoActionSheetAction(content=ft.Text("Save")),
+            ft.CupertinoActionSheetAction(
+                content=ft.Text("Delete"), destructive=True
+            ),
+        ],
+        cancel=ft.CupertinoActionSheetAction(content=ft.Text("Cancel")),
+    )
+    page.show_dialog(ft.CupertinoBottomSheet(sheet))
+    ```
     """
 
     title: Optional[StrOrControl] = None

flet/controls/cupertino/cupertino_activity_indicator.py

@@ -11,6 +11,13 @@ __all__ = ["CupertinoActivityIndicator"]
 class CupertinoActivityIndicator(LayoutControl):
     """
     An iOS-style activity indicator that spins clockwise.
+
+    ```python
+    ft.CupertinoActivityIndicator(
+        radius=30,
+        color=ft.CupertinoColors.DARK_BACKGROUND_GRAY,
+    )
+    ```
     """
 
     radius: Number = 10

flet/controls/material/bottom_app_bar.py

@@ -18,6 +18,20 @@ __all__ = ["BottomAppBar"]
 class BottomAppBar(LayoutControl):
     """
     A material design bottom app bar.
+
+    ```python
+    ft.BottomAppBar(
+        bgcolor=ft.Colors.SURFACE_CONTAINER_LOW,
+        content=ft.Row(
+            controls=[
+                ft.IconButton(ft.Icons.MENU),
+                ft.IconButton(ft.Icons.SEARCH),
+                ft.IconButton(ft.Icons.SETTINGS),
+            ],
+            alignment=ft.MainAxisAlignment.SPACE_AROUND,
+        ),
+    )
+    ```
     """
 
     content: Optional[Control] = None

flet/controls/material/bottom_sheet.py

@@ -18,6 +18,21 @@ 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.
+
+    ```python
+    sheet = ft.BottomSheet(
+        content=ft.Column(
+            width=150,
+            alignment=ft.MainAxisAlignment.CENTER,
+            horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+            controls=[
+                ft.Text("Choose an option"),
+                ft.TextButton("Dismiss"),
+            ],
+        )
+    )
+    page.show_dialog(sheet)
+    ```
     """
 
     content: Control

flet/testing/flet_test_app.py

@@ -3,6 +3,7 @@ import logging
 import os
 import platform
 import tempfile
+from collections.abc import Iterable
 from io import BytesIO
 from pathlib import Path
 from typing import Any, Optional
@@ -381,3 +382,71 @@ class FletTestApp:
         arr2 = np.array(img2)
         similarity, _ = ssim(arr1, arr2, channel_axis=-1, full=True)
         return similarity * 100
+
+    def create_gif(
+        self,
+        image_names: Iterable[str],
+        output_name: str,
+        *,
+        duration: int = 1000,
+        loop: int = 0,
+    ) -> Path:
+        """Create an animated GIF from a sequence of image files.
+
+        Args:
+            image_names: Iterable of file name stems (without ``.png``) in the
+                order they should appear in the animation.
+            output_name: Base name for the resulting animation. The ``.gif``
+                extension is added automatically and the file is stored in the
+                same directory as the provided frames.
+            duration: Frame duration in milliseconds. Defaults to ``300``.
+            loop: Number of times the GIF should repeat (``0`` means infinite).
+
+        Returns:
+            Path to the generated GIF file.
+
+        Raises:
+            ValueError: If ``image_names`` is empty.
+            FileNotFoundError: If any referenced image file does not exist.
+        """
+
+        if not self.__test_path:
+            raise ValueError("test_path must be set to create GIF animations")
+        if not self.test_platform:
+            raise ValueError("test_platform must be set to create GIF animations")
+
+        names = list(image_names)
+        if not names:
+            raise ValueError("image_names must contain at least one entry")
+
+        stem = output_name
+        golden_dir = (
+            Path(self.__test_path).parent
+            / "golden"
+            / self.test_platform
+            / Path(self.__test_path).stem.removeprefix("test_")
+        )
+        output = golden_dir / f"{stem}.gif"
+        output.parent.mkdir(parents=True, exist_ok=True)
+
+        frames: list[Image.Image] = []
+        try:
+            for name in names:
+                path = golden_dir / f"{name}.png"
+                if not path.exists():
+                    raise FileNotFoundError(path)
+                frames.append(Image.open(path))
+
+            first, *rest = frames
+            first.save(
+                output,
+                save_all=True,
+                append_images=rest,
+                duration=duration,
+                loop=loop,
+            )
+        finally:
+            for frame in frames:
+                frame.close()
+
+        return output

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

{flet-0.70.0.dev6326.dist-info → flet-0.70.0.dev6348.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.70.0.dev6326
+Version: 0.70.0.dev6348
 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.dev6326.dist-info → flet-0.70.0.dev6348.dist-info}/RECORD

@@ -1,7 +1,7 @@
 flet/__init__.py,sha256=rj0DuM9ZNrzkM-TpQ35iIspYLzsrxOCwkVxOHRX6oiU,26152
 flet/app.py,sha256=HSws0Zm4ZO0-Hp2P9h7xirCVnRkKCVXhuekyAXT_9Fo,11883
 flet/cli.py,sha256=IUM25fY_sqMtl0hlQGhlMQaBb1oNyO0VZeeBgRodhuA,204
-flet/version.py,sha256=sWUWPbQY9PByaOtgEaglY6Zw3B-YcubEBnx4-GmQaWo,2512
+flet/version.py,sha256=62NHkDMCuuXOPOn4bH5uVv_TOt88P483IlIpVb7LeZA,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
@@ -37,7 +37,7 @@ flet/controls/animation.py,sha256=C3Sxqte4S225m3UvlQOm-DGxd1WJaqfdLpA6e10B_BM,37
 flet/controls/base_control.py,sha256=Pn9b6ez81iFuWZw_rRsEHQw7CEkZVL8XHChORXgenPc,10545
 flet/controls/base_page.py,sha256=SuuoK-XHqsTmOQZXYz84DxOibE9_43sKZulalSjIxYI,17927
 flet/controls/blur.py,sha256=taMH4qtILyAFn1qNsgBGRV3z0GSH6V7VKPV3ZSBhOL4,602
-flet/controls/border.py,sha256=O-Pt3pydzR8lZYDi83caDOhhfWurPMJHANeRyFZDIKg,8931
+flet/controls/border.py,sha256=bZS9piQD_smyHeO6r30KejYvJIThwiqcZPpAUL34Tb0,8819
 flet/controls/border_radius.py,sha256=ePfpA_uNhR6bfBSmYxy2cO0mZ3FU1r63qX_5RuHWwDM,6605
 flet/controls/box.py,sha256=f9T25pJYOk-VzmzapgYHKprucTuIPMMJRphIBinrZQ4,12606
 flet/controls/buttons.py,sha256=0mLPx4fBjQNGn-ejMuNu1wHb38_0BGU0JOggmqbUs1E,9943
@@ -107,7 +107,7 @@ flet/controls/core/window.py,sha256=7SbbEoprqCoO_xz9-tHppOMYj0m9nJwDi3tRlnuVSoo,
 flet/controls/core/window_drag_area.py,sha256=fH0fczp-LUN9n3XgL85tEsQzVH1F_OoWjYwq6gSIS1E,1834
 flet/controls/core/canvas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 flet/controls/core/canvas/arc.py,sha256=pgZ6e2yhzx2cAbb3zBnlhwtuJR_YEyVTjo_11GAra_Q,1772
-flet/controls/core/canvas/canvas.py,sha256=eOIO5k2qhkdb3bKXoM9-9MnX30ZGBEZIpF5SO-0M838,2898
+flet/controls/core/canvas/canvas.py,sha256=51zE20T3kJYU9sDTOmTL6CMyeIq-tizuxDX7RJ_0aIg,3515
 flet/controls/core/canvas/circle.py,sha256=_hGiYhvz_cWwSyrD9A7IISck7HJ4TbmZ3cbfqBA4JOs,653
 flet/controls/core/canvas/color.py,sha256=MtmBewnuOaQ97E70qCNYU94ZmeRbLtQGko2caTUjZno,610
 flet/controls/core/canvas/fill.py,sha256=aW3R-C2TUQAXL9unO3gBQSMvZlS0jeeUmAlGhDPasBs,517
@@ -121,9 +121,9 @@ flet/controls/core/canvas/shadow.py,sha256=GuUwsGD9pO55lqRtVtuoRdESYNeruzkXrOyGx
 flet/controls/core/canvas/shape.py,sha256=Usq8DgS1jbi_uKva0SROima_8koDHmS3BO9VWznfX_E,484
 flet/controls/core/canvas/text.py,sha256=KJU7XepvY_klGYaecWRXlQZc86P0ZtMsxLAC591J1EA,2008
 flet/controls/cupertino/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-flet/controls/cupertino/cupertino_action_sheet.py,sha256=TByUTXXk60O0Nf6zjzLJtB-_ntHnt9mmTKrlpAQuR_w,1865
+flet/controls/cupertino/cupertino_action_sheet.py,sha256=If2qa70TNUk6EPrt86Al5O_ZOU9m0q06fUd7SpJ0DeI,2376
 flet/controls/cupertino/cupertino_action_sheet_action.py,sha256=NtLhsoHKtCtrgr0fGo0tsE5_ttNrt9ls9ULI7isWqX4,1378
-flet/controls/cupertino/cupertino_activity_indicator.py,sha256=vSLNarHRb0Oc5lVexuqnod7GcL5R6uEplSTNVXb2nc0,1014
+flet/controls/cupertino/cupertino_activity_indicator.py,sha256=FgAgNcneStqtWNogIwqaXBgn_NEV_UabMoEd5J8m5PI,1152
 flet/controls/cupertino/cupertino_alert_dialog.py,sha256=kcACIyiv7gWN3KX27aqPfMS9BUVTPt0CPW8k2L9hC2o,2284
 flet/controls/cupertino/cupertino_app_bar.py,sha256=CxhgW5Z_tohnyn7WkGxes9aN_KBDjovzcn_mEuhRqms,5176
 flet/controls/cupertino/cupertino_bottom_sheet.py,sha256=o8154fJuBtJUSJtqJFrjE6tEBv1ylNtgDW8qn6vwSxs,938
@@ -153,8 +153,8 @@ flet/controls/material/app_bar.py,sha256=Ol2UNCcUGi8HLmIdaxGQtIr-CM5HSD2iKIPg6Za
 flet/controls/material/auto_complete.py,sha256=MVesy4fUvLvY0pw_BDQXpRB5o9ac1Ci7icTdG4nC5oM,1856
 flet/controls/material/badge.py,sha256=gWkDrqoZMIrjEreWeTaANlnzJn394Gj4vQZikuVAEIk,3365
 flet/controls/material/banner.py,sha256=gFj9oNpPMNiAMnFNWkZiUdgGcE6T72VVVw73BeIRMvU,4512
-flet/controls/material/bottom_app_bar.py,sha256=Rrx4LhiFxKkTAhyblvcuNenLuxNxc93tmlUULgKeVqo,2083
-flet/controls/material/bottom_sheet.py,sha256=fQE725QwN0mxknh_CdkWIAPC5DHV1tzW_mCT-CzX9ZY,2791
+flet/controls/material/bottom_app_bar.py,sha256=_nnAUEP7_z3seEaDQ29qO5qEn8xbBEUxL-I68i9lk5c,2456
+flet/controls/material/bottom_sheet.py,sha256=TRa6RgPiz3PLnmVHnJHXp3CW2pkZbx_RQ4ngnsuxjzc,3175
 flet/controls/material/button.py,sha256=8_CLLvjPO9ZXsaGkJhO1a3cVbG2Abe-40cEQcT9BPpY,4189
 flet/controls/material/card.py,sha256=kR87buDfX_mSTOlj4HRicq2hDfIRPyigIdLlxa5Q7Fw,2872
 flet/controls/material/checkbox.py,sha256=FUa77no8mpDI7p7wIQebiyu7ul69aMMDkychkoTxo2I,5851
@@ -227,7 +227,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=Rqv4qwjMcVx4ZYAJgZgGT2GVH5OR4ZgoQeKj5ZsFsRc,346
-flet/testing/flet_test_app.py,sha256=DNgSp1lRzJ5Wess7WdPrjScMB3RPx9jSeT9cTeiNBnM,14037
+flet/testing/flet_test_app.py,sha256=T9SZMl1swPqhyu-BXhymVckxX0WuFbOO1AjbBJ3bE-U,16342
 flet/testing/tester.py,sha256=_DSRFQQoGISve5JR2nq3AdSbUf18E6FfG3ytRD5tAfo,4946
 flet/utils/__init__.py,sha256=LVgyCBf1VNqGXkdtf1JCP20Rx2oaPITF4nAGw2zquVI,1739
 flet/utils/browser.py,sha256=Z2PomJjClBXRRiPvGP7WRzbguvXQ8W2HQAzd_A5cmvE,157
@@ -246,8 +246,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.dev6326.dist-info/METADATA,sha256=hqlcYv0ZbExcuDKzYQGHdrYWdWI8N-gWoO-OQWBmJEY,6109
-flet-0.70.0.dev6326.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-flet-0.70.0.dev6326.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
-flet-0.70.0.dev6326.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
-flet-0.70.0.dev6326.dist-info/RECORD,,
+flet-0.70.0.dev6348.dist-info/METADATA,sha256=pU5esLo0SL-Pc8IQhfQ7E7pFo5jDRJHbRzjAwpQwbEw,6109
+flet-0.70.0.dev6348.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flet-0.70.0.dev6348.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
+flet-0.70.0.dev6348.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
+flet-0.70.0.dev6348.dist-info/RECORD,,