Get docs building

Author: cpsievert

shiny/_docstring.py

@@ -295,7 +295,11 @@ def app_choose_core_or_express(
 
 def get_decorated_source_directory(func: FuncType) -> str:
     if hasattr(func, "__module__"):
-        path = os.path.abspath(str(sys.modules[func.__module__].__file__))
+        m = func.__module__
+        # If function/object is defined in shiny, we use the module's file path.
+        # Otherwise, we use the file path of the main shiny module.
+        m2 = m if m.startswith("shiny.") else "shiny"
+        path = os.path.abspath(str(sys.modules[m2].__file__))
     else:
         path = os.path.abspath(func.__code__.co_filename)
 

shiny/ui/_chat.py

@@ -2,9 +2,26 @@
 from shinychat.express import Chat as ChatExpress
 from shinychat.types import ChatMessageDict
 
+from .._docstring import add_example
+
 __all__ = (
     "Chat",
     "ChatExpress",
     "chat_ui",
     "ChatMessageDict",
 )
+
+Chat = add_example(
+    app_file="app-core.py",
+    ex_dir="../shiny/api-examples/Chat",
+)(Chat)
+
+ChatExpress = add_example(
+    app_file="app-express.py",
+    ex_dir="../shiny/api-examples/Chat",
+)(ChatExpress)
+
+chat_ui = add_example(
+    app_file="app-core.py",
+    ex_dir="../shiny/api-examples/Chat",
+)(chat_ui)

shiny/ui/_markdown_stream.py

@@ -1,8 +1,25 @@
 from shinychat import MarkdownStream, output_markdown_stream
 from shinychat.express import MarkdownStream as ExpressMarkdownStream
 
+from .._docstring import add_example
+
 __all__ = (
     "output_markdown_stream",
     "MarkdownStream",
     "ExpressMarkdownStream",
 )
+
+MarkdownStream = add_example(
+    app_file="app-core.py",
+    ex_dir="../shiny/api-examples/MarkdownStream",
+)(MarkdownStream)
+
+ExpressMarkdownStream = add_example(
+    app_file="app-express.py",
+    ex_dir="../shiny/api-examples/MarkdownStream",
+)(ExpressMarkdownStream)
+
+output_markdown_stream = add_example(
+    app_file="app-core.py",
+    ex_dir="../shiny/api-examples/MarkdownStream",
+)(output_markdown_stream)