docs: show live examples in favor of static images

.github/workflows/docs.yml

@@ -0,0 +1,20 @@
+name: Build docs
+
+on:
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Build docs
+        working-directory: sdk/python/packages/flet
+        run: |
+          uv run --group docs mkdocs build

client/pubspec.lock

@@ -385,10 +385,10 @@ packages:
     dependency: "direct dev"
     description:
       name: flutter_lints
-      sha256: b543301ad291598523947dc534aaddc5aaad597b709d2426d3a0e0d44c5cb493
+      sha256: "3105dc8492f6183fb076ccf1f351ac3d60564bff92e20bfc4af9cc1651f4e7e1"
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.4"
+    version: "6.0.0"
   flutter_localizations:
     dependency: transitive
     description: flutter
@@ -626,10 +626,10 @@ packages:
     dependency: transitive
     description:
       name: lints
-      sha256: a2c3d198cb5ea2e179926622d433331d8b58374ab8f29cdda6e863bd62fd369c
+      sha256: a5e2b223cb7c9c8efdc663ef484fdd95bb243bff242ef5b13e26883547fce9a0
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.1"
+    version: "6.0.0"
   lists:
     dependency: transitive
     description:

client/pubspec.yaml

@@ -18,7 +18,7 @@ publish_to: "none" # Remove this line if you wish to publish to pub.dev
 version: 1.0.0+1
 
 environment:
-  sdk: '>=3.0.0 <4.0.0'
+  sdk: ">=3.8.0 <4.0.0"
 
 # Dependencies specify other packages that your package needs in order to work.
 # To automatically upgrade your package dependencies to the latest versions
@@ -92,7 +92,7 @@ dev_dependencies:
   # activated in the `analysis_options.yaml` file located at the root of your
   # package. See that file for information about deactivating specific lint
   # rules and activating additional ones.
-  flutter_lints: ^1.0.0
+  flutter_lints: ^6.0.0
 
   # Docs: https://pub.dev/packages/flutter_launcher_icons
   flutter_launcher_icons: "^0.14.4"

packages/flet/pubspec.yaml

@@ -14,7 +14,7 @@ platforms:
   windows:
 
 environment:
-  sdk: '>=3.0.0 <4.0.0'
+  sdk: ">=3.8.0 <4.0.0"
 
 dependencies:
   flutter:
@@ -49,7 +49,7 @@ dependencies:
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  flutter_lints: ^3.0.1
+  flutter_lints: ^6.0.0
 
 flutter:
 

sdk/python/examples/controls/ads/example_1.py

@@ -1,6 +1,5 @@
-import flet_ads as fta
-
 import flet as ft
+import flet_ads as fta
 
 
 def main(page: ft.Page):
@@ -77,4 +76,5 @@ def get_new_banner_ad() -> ft.Container:
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/animated_switcher/image_switch.py

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

sdk/python/examples/controls/animated_switcher/image_switch_buffered.py

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

sdk/python/examples/controls/animated_switcher/scale_effect.py

@@ -48,4 +48,5 @@ def rotate(e):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/app_bar/theme_and_material_mode_toggles.py

@@ -108,4 +108,5 @@ def toggle_material(e: ft.Event[ft.IconButton]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/audio/declarative_1.py

@@ -40,4 +40,5 @@ async def resume():
     ]
 
 
-ft.run(lambda page: page.render(App))
+if __name__ == "__main__":
+    ft.run(lambda page: page.render(App))

sdk/python/examples/controls/audio/example_1.py

@@ -1,10 +1,13 @@
-import flet_audio as fta
-
 import flet as ft
+import flet_audio as fta
 
 
 def main(page: ft.Page):
-    url = "https://github.com/mdn/webaudio-examples/blob/main/audio-analyser/viper.mp3?raw=true"
+    url = "https://luan.xyz/files/audio/ambient_c_motion.mp3"
+
+    def log(message: str):
+        page.show_dialog(ft.SnackBar(content=message))
+        print(message)
 
     async def play():
         await audio.play()
@@ -20,6 +23,7 @@ async def release():
 
     def set_volume(value: float):
         audio.volume += value
+        log(f"Volume: {audio.volume}")
 
     def set_balance(value: float):
         audio.balance += value
@@ -29,22 +33,22 @@ async def seek_2s():
 
     async def get_duration():
         duration = await audio.get_duration()
-        print("Duration:", duration)
+        log(f"Duration: {duration}")
 
     async def on_get_current_position():
         position = await audio.get_current_position()
-        print("Current position:", position)
+        log(f"Current position: {position}")
 
     audio = fta.Audio(
         src=url,
         autoplay=False,
         volume=1,
         balance=0,
-        on_loaded=lambda _: print("Loaded"),
-        on_duration_change=lambda e: print("Duration changed:", e.duration),
-        on_position_change=lambda e: print("Position changed:", e.position),
-        on_state_change=lambda e: print("State changed:", e.state),
-        on_seek_complete=lambda _: print("Seek complete"),
+        on_loaded=lambda _: log("Loaded"),
+        on_duration_change=lambda e: print(f"Duration changed: {e.duration}"),
+        on_position_change=lambda e: print(f"Position changed: {e.position}"),
+        on_state_change=lambda e: log(f"State changed: {e.state}"),
+        on_seek_complete=lambda _: log("Seek complete"),
     )
 
     page.add(
@@ -70,4 +74,5 @@ async def on_get_current_position():
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/audio_recorder/example_1.py

@@ -1,10 +1,5 @@
-import logging
-
-import flet_audio_recorder as far
-
 import flet as ft
-
-logging.basicConfig(level=logging.DEBUG)
+import flet_audio_recorder as far
 
 
 def main(page: ft.Page):
@@ -43,7 +38,7 @@ async def handle_pause(e: ft.Event[ft.Button]):
             await recorder.pause_recording()
 
     async def handle_resume(e: ft.Event[ft.Button]):
-        print(f"isPaused: {await recorder.is_paused()}")
+        print(f"is_paused: {await recorder.is_paused()}")
         if await recorder.is_paused():
             await recorder.resume_recording()
 
@@ -69,4 +64,5 @@ async def handle_audio_encoder_test(e: ft.Event[ft.Button]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

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

@@ -43,4 +43,5 @@ def handle_select(e: ft.AutoCompleteSelectEvent):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

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

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

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

@@ -42,4 +42,5 @@ def handle_banner_close(e: ft.Event[ft.TextButton]):
     page.add(ft.Button("Show Banner", on_click=lambda e: page.show_dialog(banner)))
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/bursting_flet.py

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

sdk/python/examples/controls/canvas/bezier_curves.py

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

sdk/python/examples/controls/canvas/brush.py

@@ -88,4 +88,5 @@ async def save_image():
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/canvas/brush_on_image.py

@@ -57,4 +57,5 @@ def handle_pan_update(e: ft.DragUpdateEvent):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/canvas/dash_strokes.py

@@ -110,4 +110,5 @@ def App():
     )
 
 
-ft.run(lambda page: page.render(App))
+if __name__ == "__main__":
+    ft.run(lambda page: page.render(App))

sdk/python/examples/controls/canvas/flet_logo.py

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

sdk/python/examples/controls/canvas/gradients.py

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

sdk/python/examples/controls/canvas/resize.py

@@ -29,4 +29,5 @@ def paint_resize(e: cv.CanvasResizeEvent):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/canvas/smiling_face.py

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

sdk/python/examples/controls/canvas/text.py

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

sdk/python/examples/controls/canvas/triangles.py

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

sdk/python/examples/controls/charts/bar_chart/example_1.py

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

sdk/python/examples/controls/charts/bar_chart/example_2.py

@@ -1,6 +1,5 @@
-import flet_charts as fch
-
 import flet as ft
+import flet_charts as fch
 
 
 class CustomRod(fch.BarChartRod):
@@ -70,4 +69,5 @@ def on_chart_event(e: fch.BarChartEvent):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/charts/candlestick_chart/example_1.py

@@ -124,4 +124,5 @@ def handle_event(e: fch.CandlestickChartEvent):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/charts/line_chart/dashboard_declarative.py

@@ -134,4 +134,5 @@ def App():
     )
 
 
-ft.run(lambda page: page.render(App))
+if __name__ == "__main__":
+    ft.run(lambda page: page.render(App))

sdk/python/examples/controls/charts/line_chart/example_1.py

@@ -1,6 +1,5 @@
-import flet_charts as fch
-
 import flet as ft
+import flet_charts as fch
 
 
 class State:
@@ -203,4 +202,5 @@ def toggle_data(e: ft.Event[ft.IconButton]):
     page.add(ft.IconButton(ft.Icons.REFRESH, on_click=toggle_data), chart)
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/charts/line_chart/example_2.py

@@ -136,4 +136,5 @@ def toggle_data(e: ft.Event[ft.ElevatedButton]):
     page.add(ft.Button("avg", on_click=toggle_data), chart)
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/charts/matplotlib_chart/3d.py

@@ -1,13 +1,9 @@
-import logging
-
 import matplotlib.pyplot as plt
 import numpy as np
 
 import flet as ft
 import flet_charts
 
-logging.basicConfig(level=logging.INFO)
-
 
 def main(page: ft.Page):
     plt.style.use("_mpl-gallery")
@@ -33,4 +29,5 @@ def main(page: ft.Page):
     page.add(flet_charts.MatplotlibChartWithToolbar(figure=fig))
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)