flet 0.82.3.dev7863__tar.gz → 0.82.3.dev7876__tar.gz

{flet-0.82.3.dev7863 → flet-0.82.3.dev7876}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7863
+Version: 0.82.3.dev7876
 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
@@ -9,23 +9,23 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://docs.flet.dev/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7876; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7876; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Pyodide"
 Requires-Dist: httpx>=0.28.1; platform_system != "Pyodide"
 Requires-Dist: repath>=0.9.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: typing-extensions; python_version < "3.11"
 Provides-Extra: all
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7863; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7876; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7876; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7876; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7876; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7863; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7876; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7876; extra == "web"
 
 <p align="center">
   <a href="https://flet.dev"><img src="https://raw.githubusercontent.com/flet-dev/flet/refs/heads/main/media/logo/flet-logo.svg" height="150" alt="Flet logo"></a>

{flet-0.82.3.dev7863 → flet-0.82.3.dev7876}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "0.82.3.dev7863"
+version = "0.82.3.dev7876"
 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"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "flet-cli==0.82.3.dev7863; extra == 'cli'",
-    "flet-web==0.82.3.dev7863; extra == 'web'",
+    "flet-cli==0.82.3.dev7876; extra == 'cli'",
+    "flet-web==0.82.3.dev7876; extra == 'web'",
     "oauthlib >=3.2.2; platform_system != 'Pyodide'",
     "httpx >=0.28.1; platform_system != 'Pyodide'",
     "repath >=0.9.0",
@@ -23,15 +23,15 @@ Documentation = "https://docs.flet.dev/"
 
 [project.optional-dependencies]
 all = [
-    "flet-cli==0.82.3.dev7863",
-    "flet-web==0.82.3.dev7863",
-    "flet-desktop==0.82.3.dev7863",
+    "flet-cli==0.82.3.dev7876",
+    "flet-web==0.82.3.dev7876",
+    "flet-desktop==0.82.3.dev7876",
 ]
-cli = ["flet-cli==0.82.3.dev7863"]
+cli = ["flet-cli==0.82.3.dev7876"]
 desktop = [
-    "flet-desktop==0.82.3.dev7863",
+    "flet-desktop==0.82.3.dev7876",
 ]
-web = ["flet-web==0.82.3.dev7863"]
+web = ["flet-web==0.82.3.dev7876"]
 
 [project.scripts]
 flet = "flet.cli:main"

{flet-0.82.3.dev7863 → flet-0.82.3.dev7876}/src/flet/controls/material/reorderable_list_view.py

@@ -14,15 +14,26 @@ from flet.controls.types import MouseCursor, Number
 @dataclass
 class OnReorderEvent(Event["ReorderableListView"]):
     """
-    Represents an event triggered during the reordering of items in a \
-    [`ReorderableListView`][flet.].
+    Payload for [`ReorderableListView`][flet.] events related to item reordering.
     """
 
-    new_index: Optional[int]
-    """The new position of the item after reordering."""
+    new_index: Optional[int] = None
+    """
+    The new position of the item after the reordering, if available.
+
+    Will be non-`None` only for the following events:
+    [`ReorderableListView.on_reorder`][flet.],
+    [`ReorderableListView.on_reorder_end`][flet.].
+    """
 
-    old_index: Optional[int]
-    """The original/previous position of the item before reordering."""
+    old_index: Optional[int] = None
+    """
+    The previous position of the item before the reordering, if available.
+
+    Will be non-`None` only for the following events:
+    [`ReorderableListView.on_reorder`][flet.],
+    [`ReorderableListView.on_reorder_start`][flet.].
+    """
 
 
 @control("ReorderableListView")
@@ -53,7 +64,13 @@ class ReorderableListView(ListView):
 
     controls: list[Control] = field(default_factory=list)
     """
-    The controls to be reordered.
+    The controls displayed by this [`ReorderableListView`][(c)].
+
+    Note:
+        When an item of this list gets reordered, [`on_reorder`][(c).] event gets
+        fired, but it doesn't reorder the `controls` list automatically. So, to keep
+        `controls` list in sync with the UI, reorder this list inside your
+        [`on_reorder`][(c).] event handler. ([example][(c).on_reorder])
     """
 
     anchor: Number = 0.0
@@ -89,13 +106,12 @@ class ReorderableListView(ListView):
 
     The default desktop drag handle is just an `Icons.DRAG_HANDLE`
     wrapped by a [`ReorderableDragHandle`][flet.]. On mobile platforms, the entire
-    item is wrapped with a [`ReorderableDelayedDragStartListener`].
+    item is wrapped with a [`ReorderableDragHandle`][flet.].
 
     To customize the appearance or layout of drag handles, wrap each
     [`controls`][(c).] item, or a control within each of them, with a
-    [`ReorderableDragHandle`][flet.], [`ReorderableDelayedDragStartListener`],
-    or your own subclass of [`ReorderableDragHandle`][flet.]. For full control
-    over the drag handles, you might want to set `show_default_drag_handles` to `False`.
+    [`ReorderableDragHandle`][flet.]. For full control over the drag handles,
+    you might want to set `show_default_drag_handles` to `False`.
 
     Example:
         ```python
@@ -122,9 +138,23 @@ class ReorderableListView(ListView):
 
     on_reorder: Optional[EventHandler[OnReorderEvent]] = None
     """
-    Called when a [`controls`][(c).] item has been dragged to a new location/position \
-    and the order of the items gets updated.
-    """
+    Called when a [`controls`][(c).] item has been dragged to a new location/position.
+
+    Note:
+        This event does not reorder [`controls`][(c).] automatically. So, to keep
+        [`controls`][(c).] list in sync with the UI, reorder it accordingly inside
+        your `on_reorder` event handler.
+
+        /// admonition | Example
+        ```python
+            def handle_reorder(e: ft.OnReorderEvent):
+                rlv = e.control
+                moved_item = rlv.controls.pop(e.old_index)  # Remove the reordered item from its old position
+                rlv.controls.insert(e.new_index, moved_item)  # Insert the reordered item into its new position
+                rlv.update()
+        ```
+        ///
+    """  # noqa: E501
 
     on_reorder_start: Optional[EventHandler[OnReorderEvent]] = None
     """

{flet-0.82.3.dev7863 → flet-0.82.3.dev7876}/src/flet/version.py

@@ -16,7 +16,7 @@ __all__ = [
 ]
 
 # set by CI
-flet_version = "0.82.3.dev7863"
+flet_version = "0.82.3.dev7876"
 """
 The Flet version in use.
 

{flet-0.82.3.dev7863 → flet-0.82.3.dev7876}/src/flet.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7863
+Version: 0.82.3.dev7876
 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
@@ -9,23 +9,23 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://docs.flet.dev/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7876; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7876; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Pyodide"
 Requires-Dist: httpx>=0.28.1; platform_system != "Pyodide"
 Requires-Dist: repath>=0.9.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: typing-extensions; python_version < "3.11"
 Provides-Extra: all
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7863; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7876; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7876; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7876; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7863; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7876; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7863; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7876; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7863; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7876; extra == "web"
 
 <p align="center">
   <a href="https://flet.dev"><img src="https://raw.githubusercontent.com/flet-dev/flet/refs/heads/main/media/logo/flet-logo.svg" height="150" alt="Flet logo"></a>

{flet-0.82.3.dev7863 → flet-0.82.3.dev7876}/src/flet.egg-info/requires.txt

@@ -2,10 +2,10 @@ repath>=0.9.0
 msgpack>=1.1.0
 
 [:extra == "cli"]
-flet-cli==0.82.3.dev7863
+flet-cli==0.82.3.dev7876
 
 [:extra == "web"]
-flet-web==0.82.3.dev7863
+flet-web==0.82.3.dev7876
 
 [:platform_system != "Pyodide"]
 oauthlib>=3.2.2
@@ -15,15 +15,15 @@ httpx>=0.28.1
 typing-extensions
 
 [all]
-flet-cli==0.82.3.dev7863
-flet-web==0.82.3.dev7863
-flet-desktop==0.82.3.dev7863
+flet-cli==0.82.3.dev7876
+flet-web==0.82.3.dev7876
+flet-desktop==0.82.3.dev7876
 
 [cli]
-flet-cli==0.82.3.dev7863
+flet-cli==0.82.3.dev7876
 
 [desktop]
-flet-desktop==0.82.3.dev7863
+flet-desktop==0.82.3.dev7876
 
 [web]
-flet-web==0.82.3.dev7863
+flet-web==0.82.3.dev7876