add progress ring example tests and imgaes

Author: OwenMcDonnell

sdk/python/examples/controls/progress_ring/__init__.py

@@ -35,4 +35,5 @@ async def main(page: ft.Page):
         page.update()
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/progress_ring/determinate_and_indeterminate.py

@@ -14,4 +14,5 @@ def main(page: ft.Page):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/progress_ring/gauge_with_progress.py

@@ -1,10 +1,11 @@
 ---
 class_name: flet.ProgressRing
 examples: ../../examples/controls/progress_ring
-example_images: ../examples/controls/progress_ring/media
+example_images: ../test-images/examples/material/golden/macos/progress_ring
+example_media: ../examples/controls/progress_ring/media
 ---
 
-{{ class_summary(class_name) }}
+{{ class_summary(class_name, example_images + "/image_for_docs.png", image_caption="Fixed progress ring") }}
 
 ## Examples
 
@@ -16,7 +17,7 @@ example_images: ../examples/controls/progress_ring/media
 --8<-- "{{ examples }}/determinate_and_indeterminate.py"
 ```
 
-{{ image(example_images + "/determinate_and_indeterminate.gif", alt="determinate-and-indeterminate", width="80%") }}
+{{ image(example_media + "/determinate_and_indeterminate.gif", alt="determinate-and-indeterminate", width="80%") }}
 
 
 ### Gauge with progress
@@ -25,4 +26,6 @@ example_images: ../examples/controls/progress_ring/media
 --8<-- "{{ examples }}/gauge_with_progress.py"
 ```
 
+{{ image(example_images + "/gauge_with_progress.png", alt="determinate-and-indeterminate", width="80%") }}
+
 {{ class_members(class_name) }}

sdk/python/packages/flet/docs/controls/progressring.md

@@ -0,0 +1,50 @@
+import pytest
+
+import flet as ft
+import flet.testing as ftt
+
+from examples.controls.progress_ring import (
+    gauge_with_progress,
+    determinate_and_indeterminate,
+)
+
+
+@pytest.mark.asyncio(loop_scope="function")
+async def test_image_for_docs(flet_app_function: ftt.FletTestApp, request):
+    flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+    await flet_app_function.assert_control_screenshot(
+        request.node.name,
+        ft.ProgressRing(value=0.4, padding=ft.Padding.all(10)),
+    )
+
+
+@pytest.mark.parametrize(
+    "flet_app_function",
+    [{"flet_app_main": gauge_with_progress.main}],
+    indirect=True,
+)
+@pytest.mark.asyncio(loop_scope="function")
+async def test_gauge_with_progress(flet_app_function: ftt.FletTestApp):
+    flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+    flet_app_function.assert_screenshot(
+        "gauge_with_progress",
+        await flet_app_function.take_page_controls_screenshot(),
+    )
+
+
+@pytest.mark.skip(reason="Test runs asynchronously")
+@pytest.mark.parametrize(
+    "flet_app_function",
+    [{"flet_app_main": determinate_and_indeterminate.main}],
+    indirect=True,
+)
+@pytest.mark.asyncio(loop_scope="function")
+async def test_determinate_and_indeterminate(flet_app_function: ftt.FletTestApp):
+    flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+    flet_app_function.page.enable_screenshots = True
+    flet_app_function.page.update()
+
+    flet_app_function.assert_screenshot(
+        "determinate_and_indeterminate",
+        await flet_app_function.page.take_screenshot(delay=ft.Duration(seconds=15)),
+    )

sdk/python/packages/flet/integration_tests/examples/material/golden/macos/progress_ring/gauge_with_progress.png

@@ -3,7 +3,7 @@
 import flet as ft
 import flet.testing as ftt
 
-from examples.controls.radio import basic, handling_selection_changes, styled
+from examples.controls.radio import basic, handling_selection_changes
 
 
 @pytest.mark.asyncio(loop_scope="function")

sdk/python/packages/flet/integration_tests/examples/material/golden/macos/progress_ring/image_for_docs.png

@@ -16,6 +16,11 @@ class ProgressRing(LayoutControl):
     application is busy.
 
     A control that shows progress along a circle.
+
+    ```python
+    ft.ProgressRing(value=0.4, padding=ft.Padding.all(10))
+    ```
+
     """
 
     value: Optional[Number] = None