Refactor calculator examples and update integration tests

Added __init__.py to chip examples and updated main entry points to use '__name__ == "__main__"' guard. Improved calculator tutorial documentation for clarity. Enhanced integration tests for calculator examples, added golden screenshots for macOS, and expanded test coverage to include calc2 and calc3.

Author: InesaFitsner

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

@@ -34,4 +34,5 @@ async def handle_chip2_click(e: ft.Event[ft.Chip]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/chip/assist_chips.py

@@ -29,4 +29,5 @@ def handle_amenity_selection(e: ft.Event[ft.Chip]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/chip/filter_chips.py

@@ -80,4 +80,5 @@ class ExtraActionButton(CalcButton):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/tutorials/calculator/calc3.py

@@ -262,12 +262,14 @@ Below is `on_click` event handler that will reset the Text value when "AC" butto
 
 ```python
 def button_clicked(self, e):
-    if e.control.data == "AC":
+    data = e.control.content
+    print(f"Button clicked with data = {data}")
+    if data == "AC":
         self.result.value = "0"
 ```
 
 With similar approach, `button_click` method will handle different calculator actions
-depending on `data` property for each button.
+depending on `content` property for each button.
 Copy the entire code for this step from
 [here](https://github.com/flet-dev/flet/blob/main/sdk/python/examples/tutorials/calc/calc.py).
 

sdk/python/packages/flet/docs/tutorials/calculator.md

@@ -1,24 +1,8 @@
 import pytest
 
+import flet as ft
 import flet.testing as ftt
-
-# from examples.controls.checkbox import basic, handling_events, styled
-from examples.tutorials.calculator import calc1
-
-# @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.Column(
-#             intrinsic_width=True,
-#             controls=[
-#                 ft.Checkbox(),
-#                 ft.Checkbox(label="Checked", value=True),
-#                 ft.Checkbox(label="Disabled", disabled=True),
-#             ],
-#         ),
-#     )
+from examples.tutorials.calculator import calc1, calc2, calc3
 
 
 @pytest.mark.parametrize(
@@ -27,47 +11,55 @@
     indirect=True,
 )
 @pytest.mark.asyncio(loop_scope="function")
-async def test_basic(flet_app_function: ftt.FletTestApp):
-    # button = await flet_app_function.tester.find_by_text("Submit")
-    # await flet_app_function.tester.tap(button)
+async def test_calc1(flet_app_function: ftt.FletTestApp):
+    flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+    flet_app_function.page.enable_screenshots = True
+    flet_app_function.resize_page(350, 850)
+    flet_app_function.page.update()
     await flet_app_function.tester.pump_and_settle()
     flet_app_function.assert_screenshot(
         "calc1",
-        await flet_app_function.take_page_controls_screenshot(),
+        await flet_app_function.page.take_screenshot(
+            pixel_ratio=flet_app_function.screenshots_pixel_ratio
+        ),
     )
 
 
-# @pytest.mark.parametrize(
-#     "flet_app_function",
-#     [{"flet_app_main": handling_events.main}],
-#     indirect=True,
-# )
-# @pytest.mark.asyncio(loop_scope="function")
-# async def test_handling_events(flet_app_function: ftt.FletTestApp):
-#     checkbox = await flet_app_function.tester.find_by_text(
-#         "Checkbox with 'change' event"
-#     )
-#     await flet_app_function.tester.tap(checkbox)
-#     await flet_app_function.tester.pump_and_settle()
-#     await flet_app_function.tester.tap(checkbox)
-#     await flet_app_function.tester.pump_and_settle()
-#     await flet_app_function.tester.tap(checkbox)
-#     await flet_app_function.tester.pump_and_settle()
-#     scr = await flet_app_function.wrap_page_controls_in_screenshot()
-#     flet_app_function.assert_screenshot(
-#         "handling_events",
-#         await scr.capture(pixel_ratio=flet_app_function.screenshots_pixel_ratio),
-#     )
+@pytest.mark.parametrize(
+    "flet_app_function",
+    [{"flet_app_main": calc2.main}],
+    indirect=True,
+)
+@pytest.mark.asyncio(loop_scope="function")
+async def test_calc2(flet_app_function: ftt.FletTestApp):
+    flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+    flet_app_function.page.enable_screenshots = True
+    flet_app_function.resize_page(350, 350)
+    flet_app_function.page.update()
+    await flet_app_function.tester.pump_and_settle()
+    flet_app_function.assert_screenshot(
+        "calc2",
+        await flet_app_function.page.take_screenshot(
+            pixel_ratio=flet_app_function.screenshots_pixel_ratio
+        ),
+    )
 
 
-# @pytest.mark.parametrize(
-#     "flet_app_function",
-#     [{"flet_app_main": styled.main}],
-#     indirect=True,
-# )
-# @pytest.mark.asyncio(loop_scope="function")
-# async def test_styled(flet_app_function: ftt.FletTestApp):
-#     flet_app_function.assert_screenshot(
-#         "styled_checkboxes",
-#         await flet_app_function.take_page_controls_screenshot(),
-#     )
+@pytest.mark.parametrize(
+    "flet_app_function",
+    [{"flet_app_main": calc3.main}],
+    indirect=True,
+)
+@pytest.mark.asyncio(loop_scope="function")
+async def test_calc3(flet_app_function: ftt.FletTestApp):
+    flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+    flet_app_function.page.enable_screenshots = True
+    flet_app_function.resize_page(400, 350)
+    flet_app_function.page.update()
+    await flet_app_function.tester.pump_and_settle()
+    flet_app_function.assert_screenshot(
+        "calc3",
+        await flet_app_function.page.take_screenshot(
+            pixel_ratio=flet_app_function.screenshots_pixel_ratio
+        ),
+    )