Update project description and enhance demo route handling

Author: ndonkoHenri

sdk/python/packages/flet-web/src/flet_web/__init__.py

@@ -13,4 +13,9 @@ def get_package_web_dir():
     return web_root_dir or str(Path(__file__).parent.joinpath("web"))
 
 
-__all__ = ["patch_font_manifest_json", "patch_index_html", "patch_manifest_json"]
+__all__ = [
+    "patch_font_manifest_json",
+    "patch_index_html",
+    "patch_manifest_json",
+    "get_package_web_dir",
+]

sdk/python/packages/flet/docs/apps/examples-gallery/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "examples-gallery"
 version = "0.1.0"
-description = ""
+description = "Live demo of Flet examples."
 readme = "README.md"
 requires-python = ">=3.10"
 authors = [

sdk/python/packages/flet/docs/extras/macros/__init__.py

@@ -158,15 +158,33 @@ def iframe(
 
     @env.macro
     def demo(
-        route: str,
+        route_or_path: str,
         *,
         width: str = "100%",
         height: str = "350",
         title: Optional[str] = None,
     ):
         """
         Embed an examples gallery route as a centered demo iframe.
+
+        `route_or_path` may be:
+        - a gallery route, e.g. "slider/basic"
+        - or a file path like "../../examples/controls/slider/basic.py"
         """
+        route = route_or_path
+
+        # Strip known prefixes
+        for prefix in ("../../examples/controls/",):
+            if route.startswith(prefix):
+                route = route.removeprefix(prefix)
+                break
+
+        # Strip known suffixes
+        for suffix in (".py", "/"):
+            if route.endswith(suffix):
+                route = route.removesuffix(suffix)
+                break
+
         return render_iframe(
             route=route,
             base="/apps/examples-gallery/dist/index.html#/",

sdk/python/packages/flet/mkdocs.yml

@@ -163,7 +163,7 @@ plugins:
           target_url_path: test-images
           include_exts: [".png", ".gif", ".svg"]
   - examples_gallery:
-      src: apps/examples-gallery/src/main.py
+      src: apps/examples-gallery/src
       dist: apps/examples-gallery/dist
       base_url: apps/examples-gallery/dist