add DisposalMode enum and parameter to create_gif function

Author: OwenMcDonnell

sdk/python/packages/flet/integration_tests/examples/core/test_responsive_row.py

@@ -23,8 +23,8 @@ async def test_image_for_docs(flet_app_function: ftt.FletTestApp, request):
                     },
                 )
                 for i in range(1, 6)
-            ], 
-        )
+            ],
+        ),
     )
 
 
@@ -44,7 +44,7 @@ async def test_basic(flet_app_function: ftt.FletTestApp):
         "responsive1",
         await flet_app_function.page.take_screenshot(
             pixel_ratio=flet_app_function.screenshots_pixel_ratio,
-            delay=ft.Duration(seconds=1)
+            delay=ft.Duration(seconds=1),
         ),
     )
     flet_app_function.resize_page(800, 500)
@@ -55,8 +55,8 @@ async def test_basic(flet_app_function: ftt.FletTestApp):
         "responsive2",
         await flet_app_function.page.take_screenshot(
             pixel_ratio=flet_app_function.screenshots_pixel_ratio,
-            delay=ft.Duration(seconds=1)
-        )
+            delay=ft.Duration(seconds=1),
+        ),
     )
     flet_app_function.resize_page(200, 500)
     flet_app_function.page.update()
@@ -66,13 +66,14 @@ async def test_basic(flet_app_function: ftt.FletTestApp):
         "responsive3",
         await flet_app_function.page.take_screenshot(
             pixel_ratio=flet_app_function.screenshots_pixel_ratio,
-            delay=ft.Duration(seconds=1)
+            delay=ft.Duration(seconds=1),
         ),
     )
     flet_app_function.create_gif(
         ["responsive1", "responsive2", "responsive3"],
         "responsive_row_basic",
         duration=1600,
+        disposal=ftt.DisposalMode.BACKGROUND,
     )
 
 
@@ -118,4 +119,5 @@ async def test_custom_breakpoint(flet_app_function: ftt.FletTestApp):
         ["responsive_custom_1", "responsive_custom_2", "responsive_custom_3"],
         "responsive_row_custom_breakpoint",
         duration=1600,
-    )
+        disposal=ftt.DisposalMode.BACKGROUND,
+    )

sdk/python/packages/flet/src/flet/testing/__init__.py

@@ -1,5 +1,6 @@
 from flet.testing.finder import Finder
 from flet.testing.flet_test_app import FletTestApp
+from flet.testing.flet_test_app import DisposalMode
 from flet.testing.tester import Tester
 
-__all__ = ["Finder", "FletTestApp", "Tester"]
+__all__ = ["Finder", "FletTestApp", "DisposalMode", "Tester"]

sdk/python/packages/flet/src/flet/testing/flet_test_app.py

@@ -7,6 +7,7 @@
 from io import BytesIO
 from pathlib import Path
 from typing import Any, Optional
+from enum import Enum
 
 import numpy as np
 from PIL import Image
@@ -21,6 +22,32 @@
 __all__ = ["FletTestApp"]
 
 
+class DisposalMode(Enum):
+    """
+    Indicates the way in which a frame is treated after being displayed.
+    """
+
+    DEFAULT = 0
+    """
+    No disposal method specified
+    """
+
+    NONE = 1
+    """
+    Do not dispose
+    """
+
+    BACKGROUND = 2
+    """
+    Restore to background color.
+    """
+
+    PREVIOUS = 3
+    """
+    Restore to previous content.
+    """
+
+
 class FletTestApp:
     """
     Flet app test controller coordinates running a Python-based
@@ -425,7 +452,7 @@ def create_gif(
         *,
         duration: int = 1000,
         loop: int = 0,
-        disposal: int = 0
+        disposal: DisposalMode = 0,
     ) -> Path:
         """Create an animated GIF from a sequence of image files.
 
@@ -490,7 +517,7 @@ def create_gif(
                 duration=duration,
                 loop=loop,
                 optimize=True,
-                disposal=2
+                disposal=disposal.value,
             )
         finally:
             for frame in frames: