flet 0.70.0.dev6232__tar.gz → 0.70.0.dev6268__tar.gz

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/PKG-INFO

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

@@ -1,6 +1,6 @@
 [project]
 name = "flet"
-version = "0.70.0.dev6232"
+version = "0.70.0.dev6268"
 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.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/core/column.py

@@ -13,8 +13,21 @@ __all__ = ["Column"]
 @control("Column")
 class Column(LayoutControl, ScrollableControl, AdaptiveControl):
     """
-    Container allows to decorate a control with background color and border and
-    position it with padding, margin and alignment.
+    Arranges child controls vertically, optionally aligning and spacing them within
+    the available space.
+
+    ```python
+    ft.Column(
+        width=220,
+        height=120,
+        spacing=12,
+        controls=[
+            ft.Text("Daily planning", size=20, weight=ft.FontWeight.W_600),
+            ft.Text("Review pull requests"),
+            ft.Text("Ship release"),
+        ],
+    )
+    ```
     """
 
     controls: list[Control] = field(default_factory=list)

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/core/grid_view.py

@@ -20,6 +20,28 @@ class GridView(LayoutControl, ScrollableControl, AdaptiveControl):
     It is very effective for large lists (thousands of items).
     Prefer it over wrapping [`Column`][flet.]s or
     [`Row`][flet.]s for smooth scrolling.
+
+    ```python
+    ft.GridView(
+        width=180,
+        runs_count=2,
+        spacing=8,
+        controls=[
+            ft.Container(
+                width=50, height=50, bgcolor=ft.Colors.PRIMARY, border_radius=8
+            ),
+            ft.Container(
+                width=50, height=50, bgcolor=ft.Colors.SECONDARY, border_radius=8
+            ),
+            ft.Container(
+                width=50, height=50, bgcolor=ft.Colors.TERTIARY, border_radius=8
+            ),
+            ft.Container(
+                width=50, height=50, bgcolor=ft.Colors.ERROR, border_radius=8
+            ),
+        ],
+    )
+    ```
     """
 
     controls: list[Control] = field(default_factory=list)

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/core/icon.py

@@ -15,6 +15,10 @@ class Icon(LayoutControl):
 
     Icons can be customized in color, size, and visual style using various
     parameters such as stroke weight, fill level, and shadows.
+
+    ```python
+    ft.Icon(ft.Icons.FAVORITE, color=ft.Colors.PRIMARY, size=40)
+    ```
     """
 
     icon: IconData

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/core/image.py

@@ -26,6 +26,15 @@ class Image(LayoutControl):
     - [`src_bytes`][(c).]
     - [`src_base64`][(c).]
     - [`src`][(c).]
+
+    ```python
+    ft.Image(
+        src="https://picsum.photos/seed/picsum/100/100",
+        width=100,
+        height=100,
+        fit=ft.BoxFit.CONTAIN,
+    )
+    ```
     """
 
     src: Optional[str] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/core/text.py

@@ -178,6 +178,10 @@ class Text(LayoutControl):
 
     It consists of two sources combined to produce the final text:
     [`value`][(c).] and [`spans`][(c).].
+
+    ```python
+    ft.Text("Hello from Flet!", size=24, weight=ft.FontWeight.W_600)
+    ```
     """
 
     value: str = ""

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_button.py

@@ -31,6 +31,10 @@ class CupertinoButtonSize(Enum):
 class CupertinoButton(LayoutControl):
     """
     An iOS-style button.
+
+    ```python
+    ft.CupertinoButton("Tap me")
+    ```
     """
 
     content: Optional[StrOrControl] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_checkbox.py

@@ -23,6 +23,17 @@ class CupertinoCheckbox(LayoutControl):
 
     Checkbox allows to select one or more items from a group,
     or switch between two mutually exclusive options (checked or unchecked, on or off).
+
+    ```python
+    ft.Column(
+        intrinsic_width=True,
+        controls=[
+            ft.CupertinoCheckbox(),
+            ft.CupertinoCheckbox(label="Checked", value=True),
+            ft.CupertinoCheckbox(label="Disabled", disabled=True),
+        ],
+    )
+    ```
     """
 
     label: Optional[str] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_filled_button.py

@@ -8,4 +8,8 @@ __all__ = ["CupertinoFilledButton"]
 class CupertinoFilledButton(CupertinoButton):
     """
     An iOS-style button filled with default background color.
+
+    ```python
+    ft.CupertinoFilledButton("Tap me")
+    ```
     """

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_list_tile.py

@@ -20,7 +20,18 @@ class CupertinoListTile(LayoutControl):
     """
     An iOS-style list tile.
 
-    Can also serve as a cupertino equivalent of the Material [`ListTile`][flet.].
+    The CupertinoListTile is a Cupertino equivalent of the Material [`ListTile`][flet.].
+
+    ```python
+    ft.CupertinoListTile(
+        title="Notifications",
+        subtitle="Enabled",
+        width=400,
+        leading=ft.Icon(ft.Icons.NOTIFICATIONS_OUTLINED),
+        trailing=ft.Icon(ft.Icons.CHEVRON_RIGHT),
+        bgcolor=ft.Colors.SURFACE_CONTAINER_LOW,
+    )
+    ```
     """
 
     title: StrOrControl

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_radio.py

@@ -18,6 +18,20 @@ class CupertinoRadio(LayoutControl):
     """
     A macOS-styled radio button, allowing the user to select a single option from two
     or more choices.
+
+    ```python
+    ft.RadioGroup(
+        value="option_2",
+        content=ft.Column(
+            intrinsic_width=True,
+            controls=[
+                ft.CupertinoRadio(value="option_1", label="Option 1"),
+                ft.CupertinoRadio(value="option_2", label="Option 2"),
+                ft.CupertinoRadio(value="option_3", label="Option 3"),
+            ],
+        ),
+    )
+    ```
     """
 
     label: Optional[str] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_segmented_button.py

@@ -14,6 +14,17 @@ __all__ = ["CupertinoSegmentedButton"]
 class CupertinoSegmentedButton(LayoutControl):
     """
     An iOS-style segmented button.
+
+    ```python
+    ft.CupertinoSegmentedButton(
+        controls=[
+            ft.Text("One"),
+            ft.Text("Two"),
+            ft.Text("Three"),
+        ],
+        selected_index=1,
+    )
+    ```
     """
 
     controls: list[Control]

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_slider.py

@@ -22,6 +22,10 @@ class CupertinoSlider(LayoutControl):
     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.CupertinoSlider(value=0.6)
+    ```
     """
 
     value: Optional[Number] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_sliding_segmented_button.py

@@ -18,6 +18,17 @@ __all__ = ["CupertinoSlidingSegmentedButton"]
 class CupertinoSlidingSegmentedButton(LayoutControl):
     """
     A cupertino sliding segmented button.
+
+    ```python
+    ft.CupertinoSlidingSegmentedButton(
+        controls=[
+            ft.Text("One"),
+            ft.Text("Two"),
+            ft.Text("Three"),
+        ],
+        selected_index=1,
+    )
+    ```
     """
 
     controls: list[Control]

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_switch.py

@@ -20,6 +20,10 @@ class CupertinoSwitch(LayoutControl):
     An iOS-style switch.
 
     Used to toggle the on/off state of a single setting.
+
+    ```python
+    ft.CupertinoSwitch(value=True)
+    ```
     """
 
     label: Optional[str] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_textfield.py

@@ -24,6 +24,10 @@ class OverlayVisibilityMode(Enum):
 class CupertinoTextField(TextField):
     """
     An iOS-style text field.
+
+    ```python
+    ft.CupertinoTextField(placeholder_text="Search")
+    ```
     """
 
     placeholder_text: Optional[str] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/cupertino/cupertino_tinted_button.py

@@ -8,4 +8,8 @@ __all__ = ["CupertinoTintedButton"]
 class CupertinoTintedButton(CupertinoButton):
     """
     An iOS-style button filled with default background color.
+
+    ```python
+    ft.CupertinoTintedButton("Tap me")
+    ```
     """

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/card.py

@@ -22,6 +22,21 @@ class Card(LayoutControl, AdaptiveControl):
     """
     A material design card: a panel with slightly rounded corners and an elevation
     shadow.
+
+    ```python
+    ft.Card(
+        shadow_color=ft.Colors.ON_SURFACE_VARIANT,
+        content=ft.Container(
+            width=400,
+            padding=10,
+            content=ft.ListTile(
+                bgcolor=ft.Colors.GREY_400,
+                leading=ft.Icon(ft.Icons.FOREST),
+                title=ft.Text("Card Name"),
+            ),
+        ),
+    )
+    ```
     """
 
     content: Optional[Control] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/checkbox.py

@@ -25,6 +25,12 @@ class Checkbox(LayoutControl, AdaptiveControl):
     """
     Checkbox allows to select one or more items from a group, or switch between two
     mutually exclusive options (checked or unchecked, on or off).
+
+    ```python
+    ft.Checkbox()
+    ft.Checkbox(label="Checked", value=True)
+    ft.Checkbox(label="Disabled", disabled=True)
+    ```
     """
 
     label: Optional[StrOrControl] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/chip.py

@@ -26,6 +26,13 @@ __all__ = ["Chip"]
 class Chip(LayoutControl):
     """
     Chips are compact elements that represent an attribute, text, entity, or action.
+
+    ```python
+    ft.Chip(
+        label="Explore topics",
+        leading=ft.Icon(ft.Icons.EXPLORE_OUTLINED),
+    )
+    ```
     """
 
     label: StrOrControl

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/circle_avatar.py

@@ -19,6 +19,14 @@ class CircleAvatar(LayoutControl):
 
     If [`foreground_image_src`][(c).] fails then [`background_image_src`][(c).] is used,
     and if this also fails, then [`bgcolor`][(c).] is used.
+
+    ```python
+    ft.CircleAvatar(
+        content=ft.Text("AB"),
+        bgcolor=ft.Colors.PRIMARY,
+        color=ft.Colors.ON_PRIMARY,
+    )
+    ```
     """
 
     content: Optional[StrOrControl] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/datatable.py

@@ -281,6 +281,29 @@ class DataRow(Control):
 class DataTable(LayoutControl):
     """
     A Material Design data table.
+
+    ```python
+    ft.DataTable(
+        columns=[
+            ft.DataColumn(label=ft.Text("Name")),
+            ft.DataColumn(label=ft.Text("Role")),
+        ],
+        rows=[
+            ft.DataRow(
+                cells=[
+                    ft.DataCell(ft.Text("Alice")),
+                    ft.DataCell(ft.Text("Engineer")),
+                ]
+            ),
+            ft.DataRow(
+                cells=[
+                    ft.DataCell(ft.Text("Bob")),
+                    ft.DataCell(ft.Text("Designer")),
+                ]
+            ),
+        ],
+    )
+    ```
     """
 
     columns: list[DataColumn]

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/divider.py

@@ -12,6 +12,18 @@ __all__ = ["Divider"]
 class Divider(Control):
     """
     A thin horizontal line (divider), with padding on either side.
+
+    ```python
+    ft.Column(
+        width=240,
+        spacing=10,
+        controls=[
+            ft.Text("Section A", weight=ft.FontWeight.W_600),
+            ft.Divider(),
+            ft.Text("Section B"),
+        ],
+    )
+    ```
     """
 
     color: Optional[ColorValue] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/dropdown.py

@@ -81,6 +81,17 @@ class Dropdown(LayoutControl):
     """
     A dropdown control that allows users to select a single option from a list of
     options.
+
+    ```python
+    ft.Dropdown(
+        width=220,
+        value="alice",
+        options=[
+            ft.dropdown.Option(key="alice", text="Alice"),
+            ft.dropdown.Option(key="bob", text="Bob"),
+        ],
+    )
+    ```
     """
 
     value: Optional[str] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/dropdownm2.py

@@ -69,6 +69,17 @@ class DropdownM2(FormFieldControl):
     A dropdown lets the user select from a number of items. The dropdown shows the
     currently selected item as well as an arrow that opens a menu for selecting another
     item.
+
+    ```python
+    ft.DropdownM2(
+        width=220,
+        value="Alice",
+        options=[
+            ft.dropdownm2.Option(key="Alice", text="Alice"),
+            ft.dropdownm2.Option(key="Bob", text="Bob"),
+        ],
+    )
+    ```
     """
 
     value: Optional[str] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/expansion_panel.py

@@ -20,6 +20,23 @@ class ExpansionPanel(LayoutControl, AdaptiveControl):
     """
     A material expansion panel. It can either be expanded or collapsed. Its body is
     only visible when it is expanded.
+
+    ```python
+    ft.ExpansionPanelList(
+        width=400,
+        controls=[
+            ft.ExpansionPanel(
+                header=ft.Text("Shipping address"),
+                content=ft.Text("123 Market Street, Springfield"),
+                expanded=True,
+            ),
+            ft.ExpansionPanel(
+                header=ft.Text("Billing address"),
+                content=ft.Text("Same as shipping"),
+            ),
+        ],
+    )
+    ```
     """
 
     header: Optional[Control] = None
@@ -71,6 +88,23 @@ class ExpansionPanel(LayoutControl, AdaptiveControl):
 class ExpansionPanelList(LayoutControl):
     """
     A material expansion panel list that lays out its children and animates expansions.
+
+    ```python
+    ft.ExpansionPanelList(
+        width=400,
+        controls=[
+            ft.ExpansionPanel(
+                header=ft.Text("Details"),
+                content=ft.Text("More information here"),
+                expanded=True,
+            ),
+            ft.ExpansionPanel(
+                header=ft.Text("History"),
+                content=ft.Text("View previous updates"),
+            ),
+        ],
+    )
+    ```
     """
 
     controls: list[ExpansionPanel] = field(default_factory=list)

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/expansion_tile.py

@@ -33,6 +33,19 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
     """
     A single-line ListTile with an expansion arrow icon that expands or collapses the
     tile to reveal or hide its controls.
+
+    ```python
+    ft.ExpansionTile(
+        width=400,
+        title="Account",
+        subtitle="Manage profile and security",
+        controls=[
+            ft.ListTile(title=ft.Text("Profile")),
+            ft.ListTile(title=ft.Text("Security")),
+        ],
+        initially_expanded=True,
+    )
+    ```
     """
 
     title: StrOrControl

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/filled_button.py

@@ -9,6 +9,10 @@ class FilledButton(Button):
     [`FloatingActionButton`][flet.], and is typically used for
     important, final actions that complete a flow, like "Save",
     "Join now", or "Confirm".
+
+    ```python
+    ft.FilledButton(content="Tap me")
+    ```
     """
 
     pass

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/filled_tonal_button.py

@@ -9,6 +9,10 @@ class FilledTonalButton(Button):
     OutlinedButton buttons. They're useful in contexts where a lower-priority button
     requires slightly more emphasis than an outline would give, such as "Next" in an
     onboarding flow. Tonal buttons use the secondary color mapping.
+
+    ```python
+    ft.FilledTonalButton(content="Tap me")
+    ```
     """
 
     pass

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/floating_action_button.py

@@ -25,6 +25,10 @@ class FloatingActionButton(LayoutControl):
     promote a primary action in the application. Floating action button is usually set
     to `page.floating_action_button`, but can also be added as a regular control at any
     place on a page.
+
+    ```python
+    ft.FloatingActionButton(icon=ft.Icons.ADD)
+    ```
     """
 
     content: Optional[StrOrControl] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/icon_button.py

@@ -34,6 +34,10 @@ class IconButton(LayoutControl, AdaptiveControl):
 
     Icon buttons are commonly used in the toolbars, but they can be used in many other
     places as well.
+
+    ```python
+    ft.IconButton(icon=ft.Icons.FAVORITE, icon_color=ft.Colors.PRIMARY)
+    ```
     """
 
     icon: Optional[IconDataOrControl] = None
@@ -233,6 +237,10 @@ class FilledIconButton(IconButton):
 
     Filled icon buttons have higher visual impact and should be used for high emphasis
     actions, such as turning off a microphone or camera.
+
+    ```python
+    ft.FilledIconButton(icon=ft.Icons.CHECK)
+    ```
     """
 
 
@@ -245,6 +253,10 @@ class FilledTonalIconButton(IconButton):
     outlined icon buttons. They're useful in contexts where the button requires
     slightly more emphasis than an outline would give, such as a secondary action
     paired with a high emphasis action.
+
+    ```python
+    ft.FilledTonalIconButton(icon=ft.Icons.CHECK)
+    ```
     """
 
 

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/list_tile.py

@@ -47,6 +47,17 @@ class ListTile(LayoutControl, AdaptiveControl):
     """
     A single fixed-height row that typically contains some text as well as a leading or
     trailing icon.
+
+    ```python
+    ft.ListTile(
+        width=400,
+        leading=ft.Icon(ft.Icons.ACCOUNT_CIRCLE),
+        title="Jane Doe",
+        subtitle="Product Manager",
+        trailing=ft.Icon(ft.Icons.CHEVRON_RIGHT),
+        bgcolor=ft.Colors.SURFACE_CONTAINER_LOW,
+    )
+    ```
     """
 
     title: Optional[StrOrControl] = None

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/controls/material/textfield.py

@@ -133,6 +133,10 @@ class TextField(FormFieldControl, AdaptiveControl):
     """
     A text field lets the user enter text, either with hardware keyboard or with an
     onscreen keyboard.
+
+    ```python
+    ft.TextField(label="Name", hint_text="Jane Doe")
+    ```
     """
 
     value: str = ""

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet/testing/flet_test_app.py

@@ -164,6 +164,7 @@ class FletTestApp:
                 await self.__flet_app_main(page)
             elif callable(self.__flet_app_main):
                 self.__flet_app_main(page)
+            await self.__tester.pump_and_settle()
             ready.set()
 
         if not self.__tcp_port:

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

{flet-0.70.0.dev6232 → flet-0.70.0.dev6268}/src/flet.egg-info/PKG-INFO

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