docs: modernize guides

Author: jourdain

examples/core_features/dynamic_layout.py

@@ -1,44 +1,45 @@
-from trame.app import get_server
+#!/usr/bin/env -S uv run --script
+#
+# /// script
+# requires-python = ">=3.10"
+# dependencies = [
+#     "trame",
+# ]
+# ///
+from trame.app import TrameApp
 from trame.ui.html import DivLayout
 from trame.widgets import html
 
-# -----------------------------------------------------------------------------
-# Trame app
-# -----------------------------------------------------------------------------
 
-server = get_server()
+class DynamicLayout(TrameApp):
+    def __init__(self, server=None):
+        super().__init__(server)
+        self.line_count = 1
+        self._build_ui()
 
-# -----------------------------------------------------------------------------
-# UI setup
-# -----------------------------------------------------------------------------
+    def add_line(self):
+        with self.ui:
+            html.Div(f"Line: {self.line_count}")
+        self.line_count += 1
 
-line_count = 1
+    def update_first_line(self):
+        with self.server.ui.first_line:
+            self.server.ui.first_line.clear()
+            html.Div(f"First line: {self.line_count}")
+            self.line_count += 1
 
+    def _build_ui(self):
+        with DivLayout(self.server) as self.ui:
+            self.server.ui.first_line(self.ui)  # Insert place holder
 
-def update_first_line():
-    global line_count
-    with server.ui.first_line:
-        server.ui.first_line.clear()
-        html.Div(f"First line: {line_count}")
-    line_count += 1
+            html.Button("Add line", click=self.add_line)
+            html.Button("Update first line", click=self.update_first_line)
 
 
-# Start with some UI to control a
-with DivLayout(server) as layout:
-    server.ui.first_line(layout)  # Insert place holder
+def main():
+    app = DynamicLayout()
+    app.server.start()
 
-    def add_line():
-        global line_count
-        with layout:
-            html.Div(f"Line: {line_count}")
-        line_count += 1
-
-    html.Button("Add line", click=add_line)
-    html.Button("Update first line", click=update_first_line)
-
-# -----------------------------------------------------------------------------
-# start server
-# -----------------------------------------------------------------------------
 
 if __name__ == "__main__":
-    server.start()
+    main()

examples/core_features/multi_layout.py

@@ -1,31 +1,38 @@
-from trame.app import get_server
+#!/usr/bin/env -S uv run --script
+#
+# /// script
+# requires-python = ">=3.10"
+# dependencies = [
+#     "trame",
+# ]
+# ///
+from trame.app import TrameApp
 from trame.ui.html import DivLayout
 from trame.widgets import html
 
-# -----------------------------------------------------------------------------
-# Trame app
-# -----------------------------------------------------------------------------
 
-server = get_server()
+class MultiLayout(TrameApp):
+    def __init__(self, server=None):
+        super().__init__(server)
+        self._build_ui()
 
-# -----------------------------------------------------------------------------
-# UI setup
-# -----------------------------------------------------------------------------
+    def _build_ui(self):
+        with DivLayout(self.server) as self.ui:
+            html.A("Open UI(a)", href="/?ui=a", target="_blank")
+            html.Br()
+            html.A("Open UI(b)", href="/?ui=b", target="_blank")
 
-with DivLayout(server):
-    html.A("Open UI(a)", href="/?ui=a", target="_blank")
-    html.Br()
-    html.A("Open UI(b)", href="/?ui=b", target="_blank")
+        with DivLayout(self.server, "a"):
+            html.Div("UI for A")
 
-with DivLayout(server, "a"):
-    html.Div("UI for A")
+        with DivLayout(self.server, "b"):
+            html.Div("UI for B")
 
-with DivLayout(server, "b"):
-    html.Div("UI for B")
 
-# -----------------------------------------------------------------------------
-# start server
-# -----------------------------------------------------------------------------
+def main():
+    app = MultiLayout()
+    app.server.start()
+
 
 if __name__ == "__main__":
-    server.start()
+    main()