move, edit, add examples for core module.py docs (with express example)

Author: chendaniely

shiny/api-examples/Module/app-core.py

@@ -9,7 +9,7 @@ def counter_ui(label: str = "Increment counter") -> ui.TagChild:
     return ui.card(
         ui.h2("This is " + label),
         ui.input_action_button(id="button", label=label),
-        ui.output_text_verbatim(id="out"),
+        ui.output_text(id="out"),
     )
 
 

shiny/api-examples/Module/app-express.py

@@ -0,0 +1,31 @@
+from shiny import reactive
+from shiny.express import module, render, ui
+
+
+# ============================================================
+# Counter module
+# ============================================================
+@module
+def counter(input, output, session, label, starting_value: int = 0):
+    count = reactive.value(starting_value)
+    with ui.card():
+        ui.h2(f"This is {label}")
+        ui.input_action_button("button", f"{label}")
+
+        with ui.div():
+            @render.text
+            def out():
+                return f"Click count is {count()}"
+
+    @reactive.effect
+    @reactive.event(input.button)
+    def _():
+        count.set(count() + 1)
+
+
+# =============================================================================
+# App that uses module
+# =============================================================================
+counter("counter1", "Counter 1", starting_value=0)
+ui.hr()
+counter("counter2", "Counter 2", starting_value=0)

shiny/module.py

@@ -47,51 +47,6 @@ def ui(fn: Callable[P, R]) -> Callable[Concatenate[str, P], R]:
         parameters accepted by `fn`. When called, it returns UI elements with input/output
         IDs automatically namespaced using the provided module `id`.
 
-
-    Example
-    -------
-
-    ```python
-    from shiny import App, module, reactive, render, ui
-
-
-    @module.ui
-    def counter_ui(label: str = "Increment counter") -> ui.TagChild:
-        return ui.card(
-            ui.h2("This is " + label),
-            ui.input_action_button(id="button", label=label),
-            ui.output_code(id="out"),
-        )
-
-
-    @module.server
-    def counter_server(input, output, session, starting_value: int = 0):
-        count: reactive.value[int] = reactive.value(starting_value)
-
-        @reactive.effect
-        @reactive.event(input.button)
-        def _():
-            count.set(count() + 1)
-
-        @render.code
-        def out() -> str:
-            return f"Click count is {count()}"
-
-
-    app_ui = ui.page_fluid(
-        counter_ui("counter1", "Counter 1"),
-        counter_ui("counter2", "Counter 2"),
-    )
-
-
-    def server(input, output, session):
-        counter_server("counter1")
-        counter_server("counter2")
-
-
-    app = App(app_ui, server)
-    ```
-
     See Also
     --------
     * Shiny Modules documentation: https://shiny.posit.co/py/docs/modules.html
@@ -131,50 +86,6 @@ def server(
         followed by any arguments expected by `fn`. When called, it will register
         the module's server logic in a namespaced context.
 
-    Example
-    -------
-
-    ```python
-    from shiny import App, module, reactive, render, ui
-
-
-    @module.ui
-    def counter_ui(label: str = "Increment counter") -> ui.TagChild:
-        return ui.card(
-            ui.h2("This is " + label),
-            ui.input_action_button(id="button", label=label),
-            ui.output_code(id="out"),
-        )
-
-
-    @module.server
-    def counter_server(input, output, session, starting_value: int = 0):
-        count: reactive.value[int] = reactive.value(starting_value)
-
-        @reactive.effect
-        @reactive.event(input.button)
-        def _():
-            count.set(count() + 1)
-
-        @render.code
-        def out() -> str:
-            return f"Click count is {count()}"
-
-
-    app_ui = ui.page_fluid(
-        counter_ui("counter1", "Counter 1"),
-        counter_ui("counter2", "Counter 2"),
-    )
-
-
-    def server(input, output, session):
-        counter_server("counter1")
-        counter_server("counter2")
-
-
-    app = App(app_ui, server)
-    ```
-
     See Also
     --------
     * Shiny Modules documentation: https://shiny.posit.co/py/docs/modules.html