flet 0.70.0.dev6491__tar.gz → 0.70.0.dev6516__tar.gz

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.70.0.dev6491
+Version: 0.70.0.dev6516
 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.dev6491 → flet-0.70.0.dev6516}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flet"
-version = "0.70.0.dev6491"
+version = "0.70.0.dev6516"
 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.dev6491 → flet-0.70.0.dev6516}/src/flet/__init__.py

@@ -311,7 +311,6 @@ from flet.controls.material.navigation_bar import (
 from flet.controls.material.navigation_drawer import (
     NavigationDrawer,
     NavigationDrawerDestination,
-    NavigationDrawerPosition,
 )
 from flet.controls.material.navigation_rail import (
     NavigationRail,
@@ -778,7 +777,6 @@ __all__ = [
     "NavigationBarTheme",
     "NavigationDrawer",
     "NavigationDrawerDestination",
-    "NavigationDrawerPosition",
     "NavigationDrawerTheme",
     "NavigationRail",
     "NavigationRailDestination",

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/base_page.py

@@ -372,6 +372,36 @@ class BasePage(AdaptiveControl):
         dialog.update()
         return dialog
 
+    async def show_drawer(self):
+        """
+        Show the drawer.
+
+        Raises:
+            ValueError: If no [`drawer`][(c).] is defined.
+        """
+        await self.__default_view().show_drawer()
+
+    async def close_drawer(self):
+        """
+        Close the drawer.
+        """
+        await self.__default_view().close_drawer()
+
+    async def show_end_drawer(self):
+        """
+        Show the end drawer.
+
+        Raises:
+            ValueError: If no [`end_drawer`][(c).] is defined.
+        """
+        await self.__default_view().show_end_drawer()
+
+    async def close_end_drawer(self):
+        """
+        Close the end drawer.
+        """
+        await self.__default_view().close_end_drawer()
+
     async def take_screenshot(
         self,
         pixel_ratio: Optional[Number] = None,

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/core/pagelet.py

@@ -107,27 +107,36 @@ class Pagelet(LayoutControl, AdaptiveControl):
         if not self.content.visible:
             raise ValueError("content must be visible")
 
-    # todo: deprecate show_* in favor of a open/close methods, or page.open/close
-    # Drawer
-    #
-    def show_drawer(self, drawer: NavigationDrawer):
-        self.drawer = drawer
-        self.drawer.open = True
-        self.update()
-
-    def close_drawer(self):
-        if self.drawer is not None:
-            self.drawer.open = False
-            self.update()
-
-    # End_drawer
-    #
-    def show_end_drawer(self, end_drawer: NavigationDrawer):
-        self.end_drawer = end_drawer
-        self.end_drawer.open = True
-        self.update()
-
-    def close_end_drawer(self):
-        if self.end_drawer is not None:
-            self.end_drawer.open = False
-            self.update()
+    async def show_drawer(self):
+        """
+        Show the drawer.
+
+        Raises:
+            ValueError: If no [`drawer`][(c).] is defined.
+        """
+        if self.drawer is None:
+            raise ValueError("No drawer defined")
+        await self._invoke_method("show_drawer")
+
+    async def close_drawer(self):
+        """
+        Close the drawer.
+        """
+        await self._invoke_method("close_drawer")
+
+    async def show_end_drawer(self):
+        """
+        Show the end drawer.
+
+        Raises:
+            ValueError: If no [`end_drawer`][(c).] is defined.
+        """
+        if self.end_drawer is None:
+            raise ValueError("No end_drawer defined")
+        await self._invoke_method("show_end_drawer")
+
+    async def close_end_drawer(self):
+        """
+        Close the end drawer.
+        """
+        await self._invoke_method("close_end_drawer")

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/core/shader_mask.py

@@ -17,6 +17,22 @@ class ShaderMask(LayoutControl):
 
     For example, it can be used to gradually fade out the edge of a control by
     using a [`LinearGradient`][flet.] mask.
+
+    ```python
+    ft.ShaderMask(
+        blend_mode=ft.BlendMode.MULTIPLY,
+        shader=ft.LinearGradient(
+            begin=ft.Alignment.CENTER_LEFT,
+            end=ft.Alignment.CENTER_RIGHT,
+            colors=[ft.Colors.WHITE, ft.Colors.BLACK],
+            tile_mode=ft.GradientTileMode.CLAMP,
+        ),
+        content=ft.Image(
+            src="https://picsum.photos/id/288/300/300",
+            height=300,
+            fit=ft.BoxFit.FILL,
+        )
+    ```
     """
 
     shader: Gradient

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/core/view.py

@@ -158,9 +158,6 @@ class View(ScrollableControl, LayoutControl):
     can_pop: bool = True
     on_confirm_pop: Optional[ControlEventHandler["View"]] = None
 
-    async def confirm_pop(self, should_pop: bool) -> None:
-        await self._invoke_method("confirm_pop", {"should_pop": should_pop})
-
     def init(self):
         super().init()
         self._internals["host_expanded"] = True
@@ -168,3 +165,40 @@ class View(ScrollableControl, LayoutControl):
     # Magic methods
     def __contains__(self, item: Control) -> bool:
         return item in self.controls
+
+    async def confirm_pop(self, should_pop: bool) -> None:
+        await self._invoke_method("confirm_pop", {"should_pop": should_pop})
+
+    async def show_drawer(self):
+        """
+        Show the drawer.
+
+        Raises:
+            ValueError: If no [`drawer`][(c).] is defined.
+        """
+        if self.drawer is None:
+            raise ValueError("No drawer defined")
+        await self._invoke_method("show_drawer")
+
+    async def close_drawer(self):
+        """
+        Close the drawer.
+        """
+        await self._invoke_method("close_drawer")
+
+    async def show_end_drawer(self):
+        """
+        Show the end drawer.
+
+        Raises:
+            ValueError: If no [`end_drawer`][(c).] is defined.
+        """
+        if self.end_drawer is None:
+            raise ValueError("No end_drawer defined")
+        await self._invoke_method("show_end_drawer")
+
+    async def close_end_drawer(self):
+        """
+        Close the end drawer.
+        """
+        await self._invoke_method("close_end_drawer")

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/material/dropdown.py

@@ -220,7 +220,7 @@ class Dropdown(LayoutControl):
     Called when the selected item of this dropdown has changed.
     """
 
-    on_change: Optional[ControlEventHandler["Dropdown"]] = None
+    on_text_change: Optional[ControlEventHandler["Dropdown"]] = None
     """
     Called when the text input of this dropdown has changed.
     """

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/material/navigation_drawer.py

@@ -1,12 +1,11 @@
 from dataclasses import field
-from enum import Enum
 from typing import Optional
 
+from flet.controls.adaptive_control import AdaptiveControl
 from flet.controls.base_control import control
 from flet.controls.buttons import OutlinedBorder
 from flet.controls.control import Control
 from flet.controls.control_event import ControlEventHandler
-from flet.controls.dialog_control import DialogControl
 from flet.controls.padding import PaddingValue
 from flet.controls.types import (
     ColorValue,
@@ -17,7 +16,6 @@ from flet.controls.types import (
 __all__ = [
     "NavigationDrawer",
     "NavigationDrawerDestination",
-    "NavigationDrawerPosition",
 ]
 
 
@@ -74,13 +72,8 @@ class NavigationDrawerDestination(Control):
     """
 
 
-class NavigationDrawerPosition(Enum):
-    START = "start"
-    END = "end"
-
-
 @control("NavigationDrawer")
-class NavigationDrawer(DialogControl):
+class NavigationDrawer(AdaptiveControl):
     """
     Material Design Navigation Drawer component.
 
@@ -138,12 +131,12 @@ class NavigationDrawer(DialogControl):
     Defines the padding for `destination` controls.
     """
 
-    position: NavigationDrawerPosition = NavigationDrawerPosition.START
+    on_change: Optional[ControlEventHandler["NavigationDrawer"]] = None
     """
-    The position of this drawer.
+    Called when selected destination changed.
     """
 
-    on_change: Optional[ControlEventHandler["NavigationDrawer"]] = None
+    on_dismiss: Optional[ControlEventHandler["NavigationDrawer"]] = None
     """
-    Called when selected destination changed.
+    Called when the drawer is dismissed.
     """

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/material/slider.py

@@ -32,6 +32,11 @@ class Slider(LayoutControl, AdaptiveControl):
     Use a slider when you want people to set defined values (such as volume or
     brightness), or when people would benefit from instant feedback on the effect
     of setting changes.
+
+    ```python
+    ft.Slider(label="Slider", value=0.3)
+    ```
+
     """
 
     value: Optional[Number] = None

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/material/snack_bar.py

@@ -47,6 +47,8 @@ class SnackBarAction(Control):
             action, avoid including it in the snack bar in the first place.
         -  Snack bar actions can will only respond to first click.
             Subsequent clicks/presses are ignored.
+
+
     """
 
     label: str
@@ -93,6 +95,11 @@ class SnackBar(DialogControl):
     """
     A lightweight message with an optional action which briefly displays at the
     bottom of the screen.
+
+    ```python
+    page.show_dialog(ft.SnackBar(ft.Text("Opened snack bar")))
+    ```
+
     """
 
     content: StrOrControl

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/controls/material/vertical_divider.py

@@ -14,6 +14,29 @@ class VerticalDivider(Control):
     A thin vertical line, with padding on either side.
 
     In the material design language, this represents a divider.
+
+    ```python
+    ft.Row(
+            width=120,
+            height=60,
+            expand=True,
+            spacing=0,
+            controls=[
+                ft.Container(
+                    bgcolor=ft.Colors.BLUE_GREY_200,
+                    alignment=ft.Alignment.CENTER,
+                    expand=True,
+                ),
+                ft.VerticalDivider(),
+                ft.Container(
+                    bgcolor=ft.Colors.GREY_500,
+                    alignment=ft.Alignment.CENTER,
+                    expand=True,
+                ),
+            ],
+        )
+    ```
+
     """
 
     width: Optional[Number] = None

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet/testing/flet_test_app.py

@@ -261,7 +261,24 @@ class FletTestApp:
                     print("Force killing Flutter test process...")
                     self.__flutter_process.kill()
 
-    async def wrap_page_controls_in_screenshot(self, margin=10):
+    async def resize_page(self, width: int, height: int):
+        """
+        Resizes the page window to the specified width and height.
+        """
+        if self.page.window.width is None or self.page.window.height is None:
+            return
+
+        chrome_width = self.page.window.width - self.page.width
+        chrome_height = self.page.window.height - self.page.height
+        self.page.window.width = width + chrome_width
+        self.page.window.height = height + chrome_height
+
+    async def wrap_page_controls_in_screenshot(
+        self,
+        margin=10,
+        pump_times: int = 0,
+        pump_duration: Optional[ft.DurationValue] = None,
+    ) -> ft.Screenshot:
         """
         Wraps provided controls in a Screenshot control.
         """
@@ -273,16 +290,22 @@ class FletTestApp:
         ]  # type: ignore
         self.page.update()
         await self.tester.pump_and_settle()
+        for _ in range(0, pump_times):
+            await self.tester.pump(duration=pump_duration)
         return scr
 
     async def take_page_controls_screenshot(
         self,
         pixel_ratio: Optional[float] = None,
-    ):
+        pump_times: int = 0,
+        pump_duration: Optional[ft.DurationValue] = None,
+    ) -> bytes:
         """
         Takes a screenshot of all controls on the current page.
         """
-        scr = await self.wrap_page_controls_in_screenshot()
+        scr = await self.wrap_page_controls_in_screenshot(
+            pump_times=pump_times, pump_duration=pump_duration
+        )
         return await scr.capture(
             pixel_ratio=pixel_ratio or self.screenshots_pixel_ratio
         )
@@ -371,7 +394,8 @@ class FletTestApp:
                 with open(actual_image_path, "bw") as f:
                     f.write(screenshot)
             assert similarity > similarity_threshold, (
-                f"{name} screenshots are not identical"
+                f"{name} screenshots are not identical "
+                f"(similarity: {similarity}% <= {similarity_threshold}%)"
             )
 
     def _load_image_from_file(self, file_name):

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/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.dev6491"
+version = "0.70.0.dev6516"
 
 
 def update_version():

{flet-0.70.0.dev6491 → flet-0.70.0.dev6516}/src/flet.egg-info/PKG-INFO

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