runtimepy 5.13.1__py3-none-any.whl → 5.13.2__py3-none-any.whl

runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.2.3
-# hash=25280d90363095aa6b5717f2105ff685
+# hash=6693eae62108cbcdfbccdb9de6b57fa8
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "5.13.1"
+VERSION = "5.13.2"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

runtimepy/data/base.yaml

@@ -0,0 +1,19 @@
+---
+includes:
+  - package://runtimepy/factories.yaml
+
+init:
+  - runtimepy.net.arbiter.housekeeping.init
+
+config:
+  # Default redirects.
+  http_redirects:
+    "/": "/index.html"
+    "/index.html": "/app.html"
+
+  # Serve these applications by default at these paths.
+  http_app_paths: ["/app.html"]
+
+# Handles config["http_app_prefixes"].
+config_builders:
+  - runtimepy.net.html.arbiter.web_app_paths

runtimepy/data/server_base.yaml

@@ -1,6 +1,6 @@
 ---
 includes:
-  - package://runtimepy/factories.yaml
+  - package://runtimepy/base.yaml
 
 ports:
   - {name: runtimepy_http_server, type: tcp}
@@ -10,22 +10,6 @@ ports:
 structs:
   - {name: ui, factory: ui_state}
 
-init:
-  - runtimepy.net.arbiter.housekeeping.init
-
-config:
-  # Default redirects.
-  http_redirects:
-    "/": "/index.html"
-    "/index.html": "/app.html"
-
-  # Serve these applications by default at these paths.
-  http_app_paths: ["/app.html"]
-
-# Handles config["http_app_prefixes"].
-config_builders:
-  - runtimepy.net.html.arbiter.web_app_paths
-
 servers:
   - factory: runtimepy_http
     kwargs: {port: "$runtimepy_http_server"}

runtimepy/net/server/__init__.py

@@ -55,6 +55,12 @@ class RuntimepyServerConnection(HttpConnection):
     class_paths: list[Pathlike] = [Path(), package_data_dir()]
     class_redirect_paths: dict[Path, Union[str, Path]] = {}
 
+    # Set these to control meta attributes.
+    metadata: dict[str, Optional[str]] = {
+        "title": HttpConnection.identity,
+        "description": None,
+    }
+
     def add_path(self, path: Pathlike, front: bool = False) -> None:
         """Add a path."""
 
@@ -145,7 +151,16 @@ class RuntimepyServerConnection(HttpConnection):
     ) -> bytes:
         """Return rendered markdown content."""
 
-        document = get_html()
+        meta: dict[str, str] = type(self).metadata.copy()  # type: ignore
+
+        meta.setdefault("description", "")
+        meta["description"] += (
+            " This page was rendered from "
+            f"Markdown by {HttpConnection.identity}."
+        )
+
+        document = get_html(**meta)
+
         with IndentedFileWriter.string() as writer:
             writer.write_markdown(content, **kwargs)
             full_markdown_page(
@@ -336,6 +351,7 @@ class RuntimepyServerConnection(HttpConnection):
                         response,
                         request_data,
                         default_app=type(self).default_app,
+                        **type(self).metadata,
                     )
 
                 if populated:

runtimepy/net/server/app/__init__.py

@@ -68,6 +68,8 @@ async def setup(app: AppInfo) -> int:
         )
     )
 
+    RuntimepyServerConnection.metadata.update(app.config_param("html", {}))
+
     # Default application (environment tabs).
     html_app = create_app(app, getattr(_import_module(module), method))
     target: str

runtimepy/net/server/html.py

@@ -24,19 +24,32 @@ HtmlApps = dict[str, HtmlApp]
 def get_html(
     title: str = HttpConnection.identity,
     cache_control: str = "public",
+    description: str = None,
     **kwargs,
 ) -> Html:
     """Get a default HTML document."""
 
     elem = Html(title, **kwargs)
 
-    elem.children.append(
+    elem.head.children.append(
         Element(
             tag="meta",
             attrib={"http-equiv": "Cache-Control", "content": cache_control},
         )
     )
 
+    elem.head.children.append(
+        Element(tag="link", rel="icon", href="/favicon.ico")
+    )
+
+    if description:
+        elem.head.children.append(
+            Element(
+                tag="meta",
+                attrib={"name": "description", "content": description},
+            )
+        )
+
     return elem
 
 
@@ -47,6 +60,7 @@ async def html_handler(
     response: ResponseHeader,
     request_data: Optional[bytes],
     default_app: HtmlApp = None,
+    **kwargs,
 ) -> bool:
     """Render an HTML document in response to an HTTP request."""
 
@@ -56,6 +70,8 @@ async def html_handler(
     # Create the application.
     app = apps.get(request.target.path, default_app)
     if app is not None:
-        (await app(get_html(), request, response, request_data)).render(stream)
+        (
+            await app(get_html(**kwargs), request, response, request_data)
+        ).render(stream)
 
     return app is not None

runtimepy/net/tcp/http/__init__.py

@@ -52,10 +52,13 @@ def to_json(response: HttpResponse) -> Any:
     )
 
 
+IDENTITY = f"{PKG_NAME}/{VERSION}"
+
+
 class HttpConnection(_TcpConnection):
     """A class implementing a basic HTTP interface."""
 
-    identity = f"{PKG_NAME}/{VERSION}"
+    identity = IDENTITY
 
     expecting_response: bool
 

runtimepy/requirements.txt

@@ -1,5 +1,5 @@
 aiofiles
-vcorelib>=3.5.1
+vcorelib>=3.5.8
 svgen>=0.7.12
 websockets
 psutil

{runtimepy-5.13.1.dist-info → runtimepy-5.13.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.13.1
+Version: 5.13.2
 Summary: A framework for implementing Python services.
 Home-page: https://github.com/libre-embedded/runtimepy
 Author: Libre Embedded
@@ -18,10 +18,10 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiofiles
-Requires-Dist: websockets
-Requires-Dist: vcorelib>=3.5.1
-Requires-Dist: svgen>=0.7.12
+Requires-Dist: vcorelib>=3.5.8
 Requires-Dist: psutil
+Requires-Dist: svgen>=0.7.12
+Requires-Dist: websockets
 Provides-Extra: test
 Requires-Dist: pylint; extra == "test"
 Requires-Dist: flake8; extra == "test"
@@ -51,11 +51,11 @@ Dynamic: requires-python
     =====================================
     generator=datazen
     version=3.2.3
-    hash=69775d79c8c13f44e0ac000acdeb93e2
+    hash=f3bcab8765e649f1b80ad504e5debde9
     =====================================
 -->
 
-# runtimepy ([5.13.1](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.13.2](https://pypi.org/project/runtimepy/))
 
 [![python](https://img.shields.io/pypi/pyversions/runtimepy.svg)](https://pypi.org/project/runtimepy/)
 ![Build Status](https://github.com/libre-embedded/runtimepy/workflows/Python%20Package/badge.svg)

{runtimepy-5.13.1.dist-info → runtimepy-5.13.2.dist-info}/RECORD

@@ -1,11 +1,11 @@
-runtimepy/__init__.py,sha256=VPZ8WIQEUlyrEvvx7lZX4lLKZya3zWUCRU_k28pfybs,391
+runtimepy/__init__.py,sha256=SS-yzin_UgsO_Yr3uFKIDgmWSOp6OCzrOj3rb2DZ0Qo,391
 runtimepy/__main__.py,sha256=IKioH2xOtsXwrwb9zABDQEJvuAX--Lnh84TeSz0XSs0,332
 runtimepy/app.py,sha256=Er1ZKKrG9U0FV0gQg_GYF9xDb89HgYnVzS5SjxGa2Tg,970
 runtimepy/dev_requirements.txt,sha256=VZhW6bJ5YbwaoN4d_XxZFuN5BbDLaG7ngKrGnugVPRw,245
 runtimepy/entry.py,sha256=DGHLv_SmTMImRcWjbVa2dKiWkhvAbxZwuvtvWLbx5U4,1954
 runtimepy/mapping.py,sha256=VQK1vzmQVvYYKI85_II37-hIEbvgL3PzNy-WI6TTo80,5091
 runtimepy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-runtimepy/requirements.txt,sha256=-yAmlSgsSmAprzeYuyO4l8uUxlDj_XnFA0F8yyw5dBw,125
+runtimepy/requirements.txt,sha256=uc8eW9HzoBsDmspEvyDKIs-xGrWs_UUltwAQCk072PU,125
 runtimepy/schemas.py,sha256=zTgxPm9DHZ0R_bmmOjNQMTXdtM_Hb1bE-Fog40jDCgg,839
 runtimepy/util.py,sha256=ZHSucNi-gbrcajoCv2dNjQs48dJPC3mTM_wZHx7AW1U,1719
 runtimepy/channel/__init__.py,sha256=pf0RJ5g37_FVV8xoUNgzFGuIfbZEYSBA_cQlJSDTPDo,4774
@@ -42,13 +42,14 @@ runtimepy/control/source.py,sha256=nW3Q2D-LcekII7K5XKbxXCcR-9jYQyvv0UypeNy1Dnw,1
 runtimepy/control/step.py,sha256=2LdZTpMHLwHLdpPVinpC2qByTs5I5LTDt-xONn_6Fc8,5491
 runtimepy/control/env/__init__.py,sha256=RHJqysY7Pv4VDs2SGk0X-qc5xp_SrQ_oxb5Deug8HEM,1339
 runtimepy/data/404.html,sha256=D_nhuj1AfO5EaIVsajknfaeZ5cVDKCNRPtUY4MHg1Xc,5326
+runtimepy/data/base.yaml,sha256=WGy2nPiRZk5_wBU7BlWaFfCnzRprJBp-m8onOPUoLAo,399
 runtimepy/data/browser.yaml,sha256=oc5KEV1C1uAJ4MkhNo4hyVVfJtZvHelRNqzNvD313Ow,79
 runtimepy/data/dummy_load.yaml,sha256=PfKRXXgZnENRMSd68eznSMTV8xanVH5JY4FmoZRPFGY,1985
 runtimepy/data/factories.yaml,sha256=esuoouMre8w7siZfBoZKqC-5myghJ_WwOOCDIq135zg,1899
 runtimepy/data/favicon.ico,sha256=boxAGaHbUjMFrOO2TZpsO0nIRC-LUgwHVQYOiG1YQnM,362870
 runtimepy/data/sample_telemetry.yaml,sha256=OpdFurkvtWJGaNl9LMlU2rKo15AaVVr-U_hoZfsbp-Y,695
 runtimepy/data/server.yaml,sha256=wS_Ceiu2TpkfPurpqoYoPlgzc9DAWtUd24MW7t-S5rU,97
-runtimepy/data/server_base.yaml,sha256=R_varVgGPGV4nxWYYwKUnHC9ufINi4V92YVhxCCC5wg,875
+runtimepy/data/server_base.yaml,sha256=Fiqz9C_ikxtYYFO8q17XzgaY5b3H9RuyqJr-QoTk-qg,524
 runtimepy/data/server_dev.yaml,sha256=nQsPh7LuQig3pzHfdg_aD3yOUiCj1sKKfI-WwW3hXmQ,523
 runtimepy/data/tftp_server.yaml,sha256=-bFOWJSagI-fEQQcT8k7eDMJVfSPm2XAxLVG3dqUTa4,204
 runtimepy/data/css/bootstrap_extra.css,sha256=kJLOp8j-vRxnWzQOf_eOz4kL8Mbrwxuwk3YNh90HgWM,1907
@@ -193,11 +194,11 @@ runtimepy/net/http/request_target.py,sha256=EE1aI5VSARw1h93jyZvP56ir5O5fjd6orYK-
 runtimepy/net/http/response.py,sha256=y33KLUJNE7zx6biUMwTkUfQ1bXiKV6pjrcxuh8U3WCE,3216
 runtimepy/net/http/state.py,sha256=qCMN8aWfCRfU9XP-cIhSOo2RqfljTjbQRCflfcy2bfY,1626
 runtimepy/net/http/version.py,sha256=mp6rgIM7-VUVKLCA0Uw96CmBkL0ET860lDVVEewpZ7w,1098
-runtimepy/net/server/__init__.py,sha256=FRwHGxga52NXoaKBkjfWoVpDW5hkQaQzOrx0-gCvkos,10861
-runtimepy/net/server/html.py,sha256=Z0WwAgncx-BTdT9Nm5L6KuambJIjuyw7wVvzI4dMxTg,1514
+runtimepy/net/server/__init__.py,sha256=LqN4NSkk_B0sv-i1PMv98kzkMGCCVbAPTxst1Xgjq6Y,11340
+runtimepy/net/server/html.py,sha256=TZ2ZSPTxgA6KAKS26tNrSUpxFUrdk92K5zP2ybcSYqs,1892
 runtimepy/net/server/json.py,sha256=a7vM5yfq2er4DexzFqEMnxoMGDeuywKkVH4-uNJBAik,2522
 runtimepy/net/server/markdown.py,sha256=3kLQR3fsGFU8dUiDuMbUiLv7XKx9s4zXy9SZsJDDc9Y,1507
-runtimepy/net/server/app/__init__.py,sha256=beU67t7zoKGlO7aldjQMUwYLm9mSlc78eMQazri-otw,3012
+runtimepy/net/server/app/__init__.py,sha256=_Hmbhu2TvO1aUrxfExbOi5qW9LNVTti8-ndwLpYrhjA,3089
 runtimepy/net/server/app/base.py,sha256=46aOqZwRss_nh_WfEH1cMJ9GUVoLJjERd7cTRFu6mXE,1878
 runtimepy/net/server/app/create.py,sha256=eRT8qxubht5A7149Xol3Z8rkdYd_pjNLqrlyMnXk-Zg,2660
 runtimepy/net/server/app/elements.py,sha256=KJt9vWqkfvniJMiLOJN467JjPPrEqJYZXmDuY1JoY1g,455
@@ -227,7 +228,7 @@ runtimepy/net/tcp/__init__.py,sha256=OOWohegpoioSTf8M7uDf-4EV1IDungz7-U19L_2yW4I
 runtimepy/net/tcp/connection.py,sha256=sYWj2aDiAHQf70zfRJM24cHraFd_TuzTD4fRWeSQZXE,8811
 runtimepy/net/tcp/create.py,sha256=zZsRs5KYpO3bNGh-DwEOEzjUDE4ixj-UBHYgZ0GvC7c,2013
 runtimepy/net/tcp/protocol.py,sha256=vEnIX3gUX2nrw9ofT_e4KYU4VY2k4WP0WuOi4eE_OOQ,1444
-runtimepy/net/tcp/http/__init__.py,sha256=lxEQsc8Mv5Qs0F9W-t8XBb2JPQQLpMqHYJM8NMXm-Dc,6206
+runtimepy/net/tcp/http/__init__.py,sha256=nXgUoC7jKlR7Ay7cTkomU2u_TcTsoO38uastZSBGa9k,6228
 runtimepy/net/tcp/scpi/__init__.py,sha256=aWCWQfdeyfoU9bpOnOtyIQbT1swl4ergXLFn5kXAH28,2105
 runtimepy/net/tcp/telnet/__init__.py,sha256=96eJFb301I3H2ivDtGMQtDDw09Xm5NRvM9VEC-wjt8c,4768
 runtimepy/net/tcp/telnet/codes.py,sha256=1-yyRe-Kz_W7d6B0P3iT1AaSNR3_Twmn-MUjKCJJknY,3518
@@ -300,9 +301,9 @@ runtimepy/tui/task.py,sha256=nUZo9fuOC-k1Wpqdzkv9v1tQirCI28fZVgcC13Ijvus,1093
 runtimepy/tui/channels/__init__.py,sha256=evDaiIn-YS9uGhdo8ZGtP9VK1ek6sr_P1nJ9JuSET0o,4536
 runtimepy/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 runtimepy/ui/controls.py,sha256=yvT7h3thbYaitsakcIAJ90EwKzJ4b-jnc6p3UuVf_XE,1241
-runtimepy-5.13.1.dist-info/licenses/LICENSE,sha256=yKBRwbO-cOPBrlpsZmJkkSa33DfY31aE8t7lZ0DwlUo,1071
-runtimepy-5.13.1.dist-info/METADATA,sha256=5e7rbi_qozv3poWPC2SoeRRE74fdJYM0CK57kb4BBKY,9269
-runtimepy-5.13.1.dist-info/WHEEL,sha256=GHB6lJx2juba1wDgXDNlMTyM13ckjBMKf-OnwgKOCtA,91
-runtimepy-5.13.1.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
-runtimepy-5.13.1.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
-runtimepy-5.13.1.dist-info/RECORD,,
+runtimepy-5.13.2.dist-info/licenses/LICENSE,sha256=yKBRwbO-cOPBrlpsZmJkkSa33DfY31aE8t7lZ0DwlUo,1071
+runtimepy-5.13.2.dist-info/METADATA,sha256=_GkgF9xsxR9UGBpUSeJ0of9xjc783dgtAMH8GltwoRs,9269
+runtimepy-5.13.2.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+runtimepy-5.13.2.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
+runtimepy-5.13.2.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
+runtimepy-5.13.2.dist-info/RECORD,,

{runtimepy-5.13.1.dist-info → runtimepy-5.13.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.3.0)
+Generator: setuptools (80.3.1)
 Root-Is-Purelib: true
 Tag: py3-none-any