runtimepy 5.7.2__tar.gz → 5.7.4__tar.gz

{runtimepy-5.7.2/runtimepy.egg-info → runtimepy-5.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runtimepy
-Version: 5.7.2
+Version: 5.7.4
 Summary: A framework for implementing Python services.
 Home-page: https://github.com/vkottler/runtimepy
 Author: Vaughn Kottler
@@ -17,11 +17,11 @@ Classifier: License :: OSI Approved :: MIT License
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: psutil
+Requires-Dist: vcorelib>=3.4.2
 Requires-Dist: svgen>=0.6.8
 Requires-Dist: websockets
-Requires-Dist: vcorelib>=3.4.2
 Requires-Dist: aiofiles
+Requires-Dist: psutil
 Provides-Extra: test
 Requires-Dist: pylint; extra == "test"
 Requires-Dist: flake8; extra == "test"
@@ -45,11 +45,11 @@ Requires-Dist: uvloop; (sys_platform != "win32" and sys_platform != "cygwin") an
     =====================================
     generator=datazen
     version=3.1.4
-    hash=618546df79dd7f387faa6f84f9a58c79
+    hash=fbb71900eae64b008d2a2df1b7dde92b
     =====================================
 -->
 
-# runtimepy ([5.7.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.7.4](https://pypi.org/project/runtimepy/))
 
 [![python](https://img.shields.io/pypi/pyversions/runtimepy.svg)](https://pypi.org/project/runtimepy/)
 ![Build Status](https://github.com/vkottler/runtimepy/workflows/Python%20Package/badge.svg)

{runtimepy-5.7.2 → runtimepy-5.7.4}/README.md

@@ -2,11 +2,11 @@
     =====================================
     generator=datazen
     version=3.1.4
-    hash=618546df79dd7f387faa6f84f9a58c79
+    hash=fbb71900eae64b008d2a2df1b7dde92b
     =====================================
 -->
 
-# runtimepy ([5.7.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.7.4](https://pypi.org/project/runtimepy/))
 
 [![python](https://img.shields.io/pypi/pyversions/runtimepy.svg)](https://pypi.org/project/runtimepy/)
 ![Build Status](https://github.com/vkottler/runtimepy/workflows/Python%20Package/badge.svg)

{runtimepy-5.7.2 → runtimepy-5.7.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta:__legacy__"
 
 [project]
 name = "runtimepy"
-version = "5.7.2"
+version = "5.7.4"
 description = "A framework for implementing Python services."
 readme = "README.md"
 requires-python = ">=3.11"

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.1.4
-# hash=0a0c607a8f78dc35cf48427539c9bafa
+# hash=cb3ed2d01203d78ad794d39500d706f9
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "5.7.2"
+VERSION = "5.7.4"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

runtimepy-5.7.4/runtimepy/data/js/markdown_page.js

@@ -0,0 +1,24 @@
+/* Dark is hard-coded initial state (in HTML). */
+let lightMode = false;
+
+function lightDarkClick(event) {
+  lightMode = !lightMode;
+
+  document.getElementById("runtimepy")
+      .setAttribute("data-bs-theme", lightMode ? "light" : "dark");
+
+  window.location.hash = lightMode ? "#light-mode" : "";
+}
+
+let lightDarkButton = document.getElementById("theme-button");
+if (lightDarkButton) {
+  lightDarkButton.addEventListener("click", lightDarkClick);
+}
+
+if (window.location.hash) {
+  let parts = window.location.hash.slice(1).split(",");
+
+  if (parts.includes("light-mode")) {
+    lightDarkButton.click();
+  }
+}

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/mixins/logging.py

@@ -10,7 +10,7 @@ from typing import Any, Iterable
 
 # third-party
 import aiofiles
-from vcorelib.logging import LoggerMixin, LoggerType
+from vcorelib.logging import ListLogger, LoggerMixin, LoggerType
 from vcorelib.paths import Pathlike, normalize
 
 # internal
@@ -66,6 +66,25 @@ class LoggerMixinLevelControl(LoggerMixin):
 
 
 LogPaths = Iterable[tuple[LogLevellike, Pathlike]]
+EXT_LOG_EXTRA = {"external": True}
+
+
+def handle_safe_log(
+    logger: LoggerType, level: int, data: str, safe_to_log: bool
+) -> None:
+    """handle a log filtering scenario."""
+
+    if safe_to_log:
+        logger.log(level, data, extra=EXT_LOG_EXTRA)
+    else:
+        record = logging.LogRecord(
+            logger.name, level, __file__, -1, data, (), None
+        )
+        record.external = True
+
+        for handler in logger.handlers:  # type: ignore
+            if isinstance(handler, ListLogger):
+                handler.emit(record)
 
 
 class LogCaptureMixin:
@@ -76,7 +95,10 @@ class LogCaptureMixin:
     # Open aiofiles handles.
     streams: list[tuple[int, Any]]
 
-    ext_log_extra = {"external": True}
+    # Set false to only forward to ListLogger handlers. Required for when the
+    # system log / process-management logs are being forwarded (otherwise also
+    # logging would lead to infinite spam).
+    safe_to_log = True
 
     async def init_log_capture(
         self, stack: AsyncExitStack, log_paths: LogPaths
@@ -98,7 +120,8 @@ class LogCaptureMixin:
 
     def log_line(self, level: int, data: str) -> None:
         """Log a line for output."""
-        self.logger.log(level, data, extra=self.ext_log_extra)
+
+        handle_safe_log(self.logger, level, data, self.safe_to_log)
 
     async def dispatch_log_capture(self) -> None:
         """Get the next line from this log stream."""

runtimepy-5.7.2/runtimepy/net/server/app/files.py → runtimepy-5.7.4/runtimepy/net/html/__init__.py

@@ -1,5 +1,5 @@
 """
-A module implementing interfaces for working with file contents.
+A module implementing HTML-related interfaces.
 """
 
 # built-in
@@ -8,12 +8,88 @@ from typing import Optional
 
 # third-party
 from svgen.element import Element
+from svgen.element.html import Html, div
 from vcorelib import DEFAULT_ENCODING
 from vcorelib.io import IndentedFileWriter
 from vcorelib.paths import find_file
 
 # internal
 from runtimepy import PKG_NAME
+from runtimepy.net.html.bootstrap import (
+    add_bootstrap_css,
+    add_bootstrap_js,
+    icon_str,
+)
+from runtimepy.net.html.bootstrap.elements import (
+    bootstrap_button,
+    centered_markdown,
+)
+
+
+def create_app_shell(parent: Element, **kwargs) -> tuple[Element, Element]:
+    """Create a bootstrap-based application shell."""
+
+    container = div(parent=parent, **kwargs)
+    container.add_class("d-flex", "align-items-start", "bg-body")
+
+    # Dark theme.
+    container["data-bs-theme"] = "dark"
+
+    # Buttons.
+    button_column = div(parent=container)
+    button_column.add_class("d-flex", "flex-column", "h-100", "bg-dark-subtle")
+
+    # Dark/light theme switch button.
+    bootstrap_button(
+        icon_str("lightbulb"),
+        tooltip=" Toggle light/dark.",
+        id="theme-button",
+        parent=button_column,
+    )
+
+    return container, button_column
+
+
+def markdown_page(parent: Element, markdown: str, **kwargs) -> None:
+    """Compose a landing page."""
+
+    container = centered_markdown(
+        create_app_shell(parent, **kwargs)[0], markdown, "h-100", "text-body"
+    )
+    container.add_class("overflow-y-auto")
+
+
+def common_css(document: Html) -> None:
+    """Add common CSS to an HTML document."""
+
+    append_kind(document.head, "font", kind="css", tag="style")
+    add_bootstrap_css(document.head)
+    append_kind(
+        document.head, "main", "bootstrap_extra", kind="css", tag="style"
+    )
+
+
+def full_markdown_page(document: Html, markdown: str) -> None:
+    """Render a full markdown HTML app."""
+
+    common_css(document)
+    markdown_page(document.body, markdown, id=PKG_NAME)
+
+    # JavaScript.
+    append_kind(document.body, "markdown_page")
+    add_bootstrap_js(document.body)
+
+
+def handle_worker(writer: IndentedFileWriter) -> int:
+    """Boilerplate contents for worker thread block."""
+
+    # Not currently used.
+    # return write_found_file(
+    #     writer, kind_url("js", "webgl-debug", subdir="third-party")
+    # )
+    del writer
+
+    return 0
 
 
 def write_found_file(writer: IndentedFileWriter, *args, **kwargs) -> bool:
@@ -32,19 +108,6 @@ def write_found_file(writer: IndentedFileWriter, *args, **kwargs) -> bool:
     return result
 
 
-def set_text_to_file(element: Element, *args, **kwargs) -> bool:
-    """Set an element's text to the contents of a file."""
-
-    with StringIO() as stream:
-        result = write_found_file(
-            IndentedFileWriter(stream, per_indent=2), *args, **kwargs
-        )
-        if result:
-            element.text = stream.getvalue()
-
-    return result
-
-
 def kind_url(
     kind: str, name: str, subdir: str = None, package: str = PKG_NAME
 ) -> str:
@@ -60,35 +123,9 @@ def kind_url(
     return f"package://{package}/{path}.{kind}"
 
 
-def set_text_to_kind(
-    element: Element,
-    kind: str,
-    name: str,
-    package: str = PKG_NAME,
-    subdir: str = None,
-) -> bool:
-    """Set text to HTML-file contents at a predictable path."""
-
-    return set_text_to_file(
-        element, kind_url(kind, name, subdir=subdir, package=package)
-    )
-
-
 WORKER_TYPE = "text/js-worker"
 
 
-def handle_worker(writer: IndentedFileWriter) -> int:
-    """Boilerplate contents for worker thread block."""
-
-    # Not currently used.
-    # return write_found_file(
-    #     writer, kind_url("js", "webgl-debug", subdir="third-party")
-    # )
-    del writer
-
-    return 0
-
-
 def append_kind(
     element: Element,
     *names: str,

{runtimepy-5.7.2/runtimepy/net/server/app → runtimepy-5.7.4/runtimepy/net/html}/bootstrap/elements.py

@@ -12,7 +12,7 @@ from svgen.element.html import div
 from vcorelib.io.file_writer import IndentedFileWriter
 
 # internal
-from runtimepy.net.server.app.bootstrap import icon_str
+from runtimepy.net.html.bootstrap import icon_str
 
 TEXT = "font-monospace"
 BOOTSTRAP_BUTTON = f"rounded-0 {TEXT} button-bodge text-nowrap"
@@ -167,7 +167,7 @@ def slider(
 
 def centered_markdown(
     parent: Element, markdown: str, *container_classes: str
-) -> None:
+) -> Element:
     """Add centered markdown."""
 
     container = div(parent=parent)
@@ -198,3 +198,5 @@ def centered_markdown(
     div(parent=horiz_container)
 
     div(parent=container)
+
+    return container

{runtimepy-5.7.2/runtimepy/net/server/app → runtimepy-5.7.4/runtimepy/net/html}/bootstrap/tabs.py

@@ -8,10 +8,9 @@ from svgen.element.html import div
 
 # internal
 from runtimepy import PKG_NAME
-from runtimepy.net.server.app.bootstrap import icon_str
-from runtimepy.net.server.app.bootstrap.elements import (
+from runtimepy.net.html import create_app_shell
+from runtimepy.net.html.bootstrap.elements import (
     BOOTSTRAP_BUTTON,
-    bootstrap_button,
     collapse_button,
     flex,
     toggle_button,
@@ -84,27 +83,7 @@ class TabbedContent:
         """Initialize this instance."""
 
         self.name = name
-
-        # Create application container.
-        self.container = div(parent=parent, id=name)
-        self.container.add_class("d-flex", "align-items-start", "bg-body")
-
-        # Dark theme.
-        self.container["data-bs-theme"] = "dark"
-
-        # Buttons.
-        self.button_column = div(parent=self.container)
-        self.button_column.add_class(
-            "d-flex", "flex-column", "h-100", "bg-dark-subtle"
-        )
-
-        # Dark/light theme switch button.
-        bootstrap_button(
-            icon_str("lightbulb"),
-            tooltip=" Toggle light/dark.",
-            id="theme-button",
-            parent=self.button_column,
-        )
+        self.container, self.button_column = create_app_shell(parent, id=name)
 
         # Toggle tabs button.
         self.add_button("Toggle tabs", f"#{PKG_NAME}-tabs", id="tabs-button")

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/__init__.py

@@ -11,16 +11,19 @@ from pathlib import Path
 from typing import Any, Optional, TextIO, Union
 
 # third-party
-from vcorelib.io import JsonObject
+import aiofiles
+from vcorelib import DEFAULT_ENCODING
+from vcorelib.io import IndentedFileWriter, JsonObject
 from vcorelib.paths import Pathlike, find_file, normalize
 
 # internal
 from runtimepy import DEFAULT_EXT, PKG_NAME
 from runtimepy.channel.environment.command import GLOBAL
+from runtimepy.net.html import full_markdown_page
 from runtimepy.net.http.header import RequestHeader
 from runtimepy.net.http.request_target import PathMaybeQuery
 from runtimepy.net.http.response import ResponseHeader
-from runtimepy.net.server.html import HtmlApp, HtmlApps, html_handler
+from runtimepy.net.server.html import HtmlApp, HtmlApps, get_html, html_handler
 from runtimepy.net.server.json import encode_json, json_handler
 from runtimepy.net.tcp.http import HttpConnection
 from runtimepy.util import normalize_root, path_has_part
@@ -106,7 +109,7 @@ class RuntimepyServerConnection(HttpConnection):
                 with favicon.open("rb") as favicon_fd:
                     type(self).favicon_data = favicon_fd.read()
 
-    def try_redirect(
+    async def try_redirect(
         self, path: PathMaybeQuery, response: ResponseHeader
     ) -> Optional[bytes]:
         """Try handling any HTTP redirect rules."""
@@ -123,7 +126,26 @@ class RuntimepyServerConnection(HttpConnection):
 
         return result
 
-    def try_file(
+    async def render_markdown(
+        self, path: Path, response: ResponseHeader, **kwargs
+    ) -> bytes:
+        """Render a markdown file as HTML and return the result."""
+
+        document = get_html()
+
+        async with aiofiles.open(path, mode="r") as path_fd:
+            with IndentedFileWriter.string() as writer:
+                writer.write_markdown(await path_fd.read(), **kwargs)
+                full_markdown_page(
+                    document,
+                    writer.stream.getvalue(),  # type: ignore
+                )
+
+        response["Content-Type"] = f"text/html; charset={DEFAULT_ENCODING}"
+
+        return document.encode_str().encode()
+
+    async def try_file(
         self, path: PathMaybeQuery, response: ResponseHeader
     ) -> Optional[bytes]:
         """Try serving this path as a file directly from the file-system."""
@@ -133,6 +155,12 @@ class RuntimepyServerConnection(HttpConnection):
         # Try serving the path as a file.
         for search in self.paths:
             candidate = search.joinpath(path[0][1:])
+
+            # Handle markdown sources.
+            md_candidate = candidate.with_suffix(".md")
+            if md_candidate.is_file():
+                return await self.render_markdown(md_candidate, response)
+
             if candidate.is_file():
                 mime, encoding = mimetypes.guess_type(candidate, strict=False)
 
@@ -146,8 +174,8 @@ class RuntimepyServerConnection(HttpConnection):
                 self.logger.info("Serving '%s' (MIME: %s)", candidate, mime)
 
                 # Return the file data.
-                with candidate.open("rb") as path_fd:
-                    result = path_fd.read()
+                async with aiofiles.open(candidate, mode="rb") as path_fd:
+                    result = await path_fd.read()
 
                 break
 
@@ -223,7 +251,9 @@ class RuntimepyServerConnection(HttpConnection):
 
                 # Try serving a file and handling redirects.
                 for handler in [self.try_redirect, self.try_file]:
-                    result = handler(request.target.origin_form, response)
+                    result = await handler(
+                        request.target.origin_form, response
+                    )
                     if result is not None:
                         return result
 

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/base.py

@@ -11,12 +11,9 @@ from svgen.element.html import Html
 # internal
 from runtimepy import PKG_NAME
 from runtimepy.net.arbiter.info import AppInfo
-from runtimepy.net.server.app.bootstrap import (
-    add_bootstrap_css,
-    add_bootstrap_js,
-)
-from runtimepy.net.server.app.bootstrap.tabs import TabbedContent
-from runtimepy.net.server.app.files import append_kind
+from runtimepy.net.html import append_kind, common_css
+from runtimepy.net.html.bootstrap import add_bootstrap_js
+from runtimepy.net.html.bootstrap.tabs import TabbedContent
 
 TabPopulater = Callable[[TabbedContent], None]
 
@@ -53,11 +50,7 @@ class WebApplication:
         """Populate the body element with the application."""
 
         # CSS.
-        append_kind(document.head, "font", kind="css", tag="style")
-        add_bootstrap_css(document.head)
-        append_kind(
-            document.head, "main", "bootstrap_extra", kind="css", tag="style"
-        )
+        common_css(document)
 
         # Worker code.
         append_kind(

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/create.py

@@ -11,10 +11,10 @@ from vcorelib.logging import LoggerMixin
 
 # internal
 from runtimepy.net.arbiter.info import AppInfo
+from runtimepy.net.html.bootstrap.tabs import TabbedContent
 from runtimepy.net.http.header import RequestHeader
 from runtimepy.net.http.response import ResponseHeader
 from runtimepy.net.server.app.base import WebApplication
-from runtimepy.net.server.app.bootstrap.tabs import TabbedContent
 from runtimepy.net.server.html import HtmlApp
 
 DOCUMENTS: dict[str, Html] = {}

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/env/__init__.py

@@ -8,11 +8,8 @@ from svgen.element.html import div
 # internal
 from runtimepy import PKG_NAME
 from runtimepy.net.arbiter.info import AppInfo
-from runtimepy.net.server.app.bootstrap.elements import (
-    centered_markdown,
-    input_box,
-)
-from runtimepy.net.server.app.bootstrap.tabs import TabbedContent
+from runtimepy.net.html.bootstrap.elements import centered_markdown, input_box
+from runtimepy.net.html.bootstrap.tabs import TabbedContent
 from runtimepy.net.server.app.env.modal import Modal
 from runtimepy.net.server.app.env.settings import plot_settings
 from runtimepy.net.server.app.env.tab import ChannelEnvironmentTab

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/env/modal.py

@@ -7,8 +7,8 @@ from svgen.element.html import div
 
 # internal
 from runtimepy import PKG_NAME
-from runtimepy.net.server.app.bootstrap.elements import TEXT
-from runtimepy.net.server.app.bootstrap.tabs import TabbedContent
+from runtimepy.net.html.bootstrap.elements import TEXT
+from runtimepy.net.html.bootstrap.tabs import TabbedContent
 
 
 class Modal:

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/env/settings.py

@@ -6,8 +6,8 @@ A module implementing an application-settings modal.
 from svgen.element.html import div
 
 # internal
-from runtimepy.net.server.app.bootstrap.elements import flex, slider
-from runtimepy.net.server.app.bootstrap.tabs import TabbedContent
+from runtimepy.net.html.bootstrap.elements import flex, slider
+from runtimepy.net.html.bootstrap.tabs import TabbedContent
 from runtimepy.net.server.app.env.modal import Modal
 from runtimepy.net.server.app.placeholder import under_construction
 

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/env/tab/base.py

@@ -13,7 +13,7 @@ from runtimepy.channel.environment.command.processor import (
     ChannelCommandProcessor,
 )
 from runtimepy.net.arbiter.info import AppInfo
-from runtimepy.net.server.app.bootstrap.tabs import TabbedContent
+from runtimepy.net.html.bootstrap.tabs import TabbedContent
 from runtimepy.net.server.app.tab import Tab
 
 

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/env/tab/controls.py

@@ -13,7 +13,7 @@ from svgen.element.html import div
 from runtimepy.channel import AnyChannel
 from runtimepy.channel.environment import ChannelEnvironment
 from runtimepy.enum import RuntimeEnum
-from runtimepy.net.server.app.bootstrap.elements import slider, toggle_button
+from runtimepy.net.html.bootstrap.elements import slider, toggle_button
 from runtimepy.net.server.app.env.tab.base import ChannelEnvironmentTabBase
 from runtimepy.net.server.app.env.widgets import (
     TABLE_BUTTON_CLASSES,

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/env/tab/html.py

@@ -12,7 +12,7 @@ from svgen.element.html import div
 # internal
 from runtimepy.channel import AnyChannel
 from runtimepy.enum import RuntimeEnum
-from runtimepy.net.server.app.bootstrap.elements import (
+from runtimepy.net.html.bootstrap.elements import (
     TEXT,
     centered_markdown,
     flex,
@@ -241,7 +241,9 @@ class ChannelEnvironmentTabHtml(ChannelEnvironmentTabControls):
         logs = div(
             tag="textarea",
             parent=div(parent=vert_container, class_str="form-floating"),
-            class_str=(f"form-control rounded-0 {TEXT} text-logs"),
+            class_str=(
+                f"form-control rounded-0 {TEXT} text-body-emphasis text-logs"
+            ),
             id=self.get_id("logs"),
             title=f"Text logs for {self.name}.",
         )

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/env/widgets.py

@@ -14,7 +14,7 @@ from runtimepy.channel.environment.command.processor import (
     ChannelCommandProcessor,
 )
 from runtimepy.enum import RuntimeEnum
-from runtimepy.net.server.app.bootstrap.elements import (
+from runtimepy.net.html.bootstrap.elements import (
     flex,
     input_box,
     set_tooltip,

runtimepy-5.7.4/runtimepy/net/server/app/files.py

@@ -0,0 +1,41 @@
+"""
+A module implementing interfaces for working with file contents.
+"""
+
+# built-in
+from io import StringIO
+
+# third-party
+from svgen.element import Element
+from vcorelib.io import IndentedFileWriter
+
+# internal
+from runtimepy import PKG_NAME
+from runtimepy.net.html import kind_url, write_found_file
+
+
+def set_text_to_file(element: Element, *args, **kwargs) -> bool:
+    """Set an element's text to the contents of a file."""
+
+    with StringIO() as stream:
+        result = write_found_file(
+            IndentedFileWriter(stream, per_indent=2), *args, **kwargs
+        )
+        if result:
+            element.text = stream.getvalue()
+
+    return result
+
+
+def set_text_to_kind(
+    element: Element,
+    kind: str,
+    name: str,
+    package: str = PKG_NAME,
+    subdir: str = None,
+) -> bool:
+    """Set text to HTML-file contents at a predictable path."""
+
+    return set_text_to_file(
+        element, kind_url(kind, name, subdir=subdir, package=package)
+    )

{runtimepy-5.7.2 → runtimepy-5.7.4}/runtimepy/net/server/app/landing_page.py

@@ -10,6 +10,7 @@ from svgen.element.html import Html
 
 # internal
 from runtimepy.net.arbiter.info import AppInfo
+from runtimepy.net.html import full_markdown_page
 from runtimepy.net.http.header import RequestHeader
 from runtimepy.net.http.response import ResponseHeader
 
@@ -28,6 +29,11 @@ def landing_page(
     del response
     del request_data
 
-    print(app)
+    full_markdown_page(
+        document,
+        app.config_param("landing_page", {}, strict=True).get(  # type: ignore
+            "markdown", "no data"
+        ),
+    )
 
     return document