Add Checkbox integration tests and update docs (#5680)

Introduced integration tests and golden images for Checkbox control, updated documentation to include new example images and improved formatting. Also refactored example scripts to use __main__ guard and enhanced screenshot handling in FletTestApp for intrinsic width support.

Author: InesaFitsner

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

@@ -14,4 +14,5 @@ def handle_checkbox_change(e: ft.Event[ft.Checkbox]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/checkbox/handling_events.py

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

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

@@ -1,3 +1,11 @@
+---
+class_name: flet.Checkbox
+examples: ../../examples/controls/checkbox
+example_images: ../test-images/examples/material/golden/macos/checkbox
+---
+
+{{ class_summary(class_name, example_images + "/image_for_docs.png", image_caption="Basic checkboxes") }}
+
 ## Examples
 
 [Live example](https://flet-controls-gallery.fly.dev/input/checkbox)
@@ -8,11 +16,10 @@
 --8<-- "../../examples/controls/checkbox/basic.py"
 ```
 
-![basic](../examples/controls/checkbox/media/basic.gif){width="80%"}
+![Basic checkbox]({{ example_images }}/basic.png){width="50%"}
 /// caption
 ///
 
-
 ### Handling events
 
 ```python
@@ -29,4 +36,8 @@
 --8<-- "../../examples/controls/checkbox/styled.py"
 ```
 
-::: flet.Checkbox
+![Styled checkboxes]({{ example_images }}/styled_checkboxes.png){width="50%"}
+/// caption
+///
+
+{{ class_members(class_name) }}

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

@@ -0,0 +1,50 @@
+import pytest
+
+import flet as ft
+import flet.testing as ftt
+from examples.controls.checkbox import (
+    basic,
+    styled,
+)
+
+
+@pytest.mark.asyncio(loop_scope="module")
+async def test_image_for_docs(flet_app: ftt.FletTestApp, request):
+    flet_app.page.theme_mode = ft.ThemeMode.LIGHT
+    await flet_app.assert_control_screenshot(
+        request.node.name,
+        ft.Column(
+            intrinsic_width=True,
+            controls=[
+                ft.Checkbox(),
+                ft.Checkbox(label="Checked", value=True),
+                ft.Checkbox(label="Disabled", disabled=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.assert_screenshot(
+        "basic",
+        await flet_app_function.take_page_controls_screenshot(),
+    )
+
+
+@pytest.mark.parametrize(
+    "flet_app_function",
+    [{"flet_app_main": styled.main}],
+    indirect=True,
+)
+@pytest.mark.asyncio(loop_scope="function")
+async def test_custom_content(flet_app_function: ftt.FletTestApp):
+    flet_app_function.assert_screenshot(
+        "styled_checkboxes",
+        await flet_app_function.take_page_controls_screenshot(),
+    )

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

@@ -262,7 +262,11 @@ async def wrap_page_controls_in_screenshot(self, margin=10):
         Wraps provided controls in a Screenshot control.
         """
         controls = list(self.page.controls)
-        self.page.controls = [scr := ft.Screenshot(ft.Column(controls, margin=margin))]
+        self.page.controls = [
+            scr := ft.Screenshot(
+                ft.Column(controls, margin=margin, intrinsic_width=True)
+            )
+        ]  # type: ignore
         self.page.update()
         await self.tester.pump_and_settle()
         return scr