flet 0.70.0.dev6326__tar.gz → 0.70.0.dev6348__tar.gz

{flet-0.70.0.dev6326 → flet-0.70.0.dev6348}/PKG-INFO

@@ -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 → flet-0.70.0.dev6348}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flet"
-version = "0.70.0.dev6326"
+version = "0.70.0.dev6348"
 description = "Flet for Python - easily build interactive multi-platform apps in Python"
 authors = [{name = "Appveyor Systems Inc.", email = "hello@flet.dev"}]
 license = "Apache-2.0"

{flet-0.70.0.dev6326 → flet-0.70.0.dev6348}/src/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-0.70.0.dev6326 → flet-0.70.0.dev6348}/src/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-0.70.0.dev6326 → flet-0.70.0.dev6348}/src/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-0.70.0.dev6326 → flet-0.70.0.dev6348}/src/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-0.70.0.dev6326 → flet-0.70.0.dev6348}/src/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-0.70.0.dev6326 → flet-0.70.0.dev6348}/src/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-0.70.0.dev6326 → flet-0.70.0.dev6348}/src/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-0.70.0.dev6326 → flet-0.70.0.dev6348}/src/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 → flet-0.70.0.dev6348}/src/flet.egg-info/PKG-INFO

@@ -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