add radio example tests and images

Author: OwenMcDonnell

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

@@ -22,4 +22,5 @@ def handle_button_click(e: ft.Event[ft.Button]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/radio/basic.py

@@ -22,4 +22,5 @@ def handle_selection_change(e: ft.Event[ft.RadioGroup]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/radio/handling_selection_changes.py

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

sdk/python/examples/controls/radio/styled.py

@@ -1,10 +1,10 @@
 ---
 class_name: flet.Radio
 examples: ../../examples/controls/radio
-example_images: ../examples/controls/radio/media
+example_images: ../test-images/examples/material/golden/macos/radio
 ---
 
-{{ class_summary(class_name) }}
+{{ class_summary(class_name, example_images + "/image_for_docs.png", image_caption="Simple radio buttons") }}
 
 ## Examples
 
@@ -16,7 +16,7 @@ example_images: ../examples/controls/radio/media
 --8<-- "{{ examples }}/basic.py"
 ```
 
-{{ image(example_images + "/basic.gif", alt="basic", width="80%") }}
+{{ image(example_images + "/basic.png", alt="basic", width="80%") }}
 
 
 
@@ -26,7 +26,7 @@ example_images: ../examples/controls/radio/media
 --8<-- "{{ examples }}/handling_selection_changes.py"
 ```
 
-{{ image(example_images + "/handling_selection_changes.gif", alt="handling-selection-changes", width="80%") }}
+{{ image(example_images + "/handling_selection_changes.png", alt="handling-selection-changes", width="80%") }}
 
 
 ### Styled radio buttons

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

@@ -0,0 +1,65 @@
+import pytest
+
+import flet as ft
+import flet.testing as ftt
+
+from examples.controls.radio import basic, handling_selection_changes, styled
+
+
+@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.RadioGroup(
+            content=ft.Row(
+                controls=[ft.Radio(label=f"{i}") for i in range(1, 4)],
+                alignment=ft.MainAxisAlignment.CENTER,
+                expand=True,
+            ),
+            expand=True,
+        ),
+    )
+
+
+# @pytest.mark.parametrize(
+#     "flet_app_function",
+#     [{"flet_app_main": basic.main}],
+#     indirect=True,
+# )
+# @pytest.mark.asyncio(loop_scope="function")
+# async def test_basic(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()
+#     red = await flet_app_function.tester.find_by_text("Red")
+#     await flet_app_function.tester.tap(red)
+#     await flet_app_function.tester.pump_and_settle()
+#     submit = await flet_app_function.tester.find_by_text("Submit")
+#     await flet_app_function.tester.tap(submit)
+#     await flet_app_function.tester.pump_and_settle()
+#     flet_app_function.assert_screenshot(
+#         "basic",
+#         await flet_app_function.take_page_controls_screenshot(),
+#     )
+
+
+# @pytest.mark.parametrize(
+#     "flet_app_function",
+#     [{"flet_app_main": handling_selection_changes.main}],
+#     indirect=True,
+# )
+# @pytest.mark.asyncio(loop_scope="function")
+# async def test_handling_selection_changes(flet_app_function: ftt.FletTestApp):
+#     flet_app_function.page.enable_screenshots = True
+#     flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+#     flet_app_function.page.update()
+#     blue = await flet_app_function.tester.find_by_text("Blue")
+#     await flet_app_function.tester.tap(blue)
+#     await flet_app_function.tester.pump_and_settle()
+#     flet_app_function.assert_screenshot(
+#         "handling_selection_changes",
+#         await flet_app_function.take_page_controls_screenshot(
+#             pixel_ratio=flet_app_function.screenshots_pixel_ratio
+#         ),
+#     )

sdk/python/packages/flet/integration_tests/examples/material/golden/macos/radio/basic.png

@@ -21,6 +21,16 @@
 class Radio(LayoutControl, AdaptiveControl):
     """
     Radio buttons let people select a single option from two or more choices.
+
+    ```python
+    ft.RadioGroup(
+        content=ft.Row(
+            controls=[ft.Radio(label=f"{i}") for i in range(1, 4)],
+            alignment=ft.MainAxisAlignment.CENTER,
+        )
+    )
+    ```
+
     """
 
     label: str = ""