runtimepy 5.4.2__py3-none-any.whl → 5.4.4__py3-none-any.whl

runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.1.4
-# hash=e6970089f5f2935c496cb3e9bb06b774
+# hash=5a37b52aedb2af82fb174fbea8ce0c1f
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "5.4.2"
+VERSION = "5.4.4"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

runtimepy/commands/tftp.py

@@ -8,13 +8,12 @@ import asyncio
 from pathlib import Path
 from socket import getaddrinfo
 
-from vcorelib.args import CommandFunction
-
 # third-party
+from vcorelib.args import CommandFunction
 from vcorelib.asyncio import run_handle_stop
 
 # internal
-from runtimepy.net.udp.tftp import tftp_read, tftp_write
+from runtimepy.net.udp.tftp import TFTP_PORT, tftp_read, tftp_write
 from runtimepy.net.udp.tftp.base import DEFAULT_TIMEOUT_S, REEMIT_PERIOD_S
 from runtimepy.net.udp.tftp.enums import DEFAULT_MODE
 
@@ -53,7 +52,7 @@ def add_tftp_cmd(parser: argparse.ArgumentParser) -> CommandFunction:
         "-p",
         "--port",
         type=int,
-        default=69,
+        default=TFTP_PORT,
         help="port to message (default: %(default)s)",
     )
 

runtimepy/data/css/bootstrap_extra.css

@@ -40,6 +40,10 @@
   width: auto;
 }
 
+.table-container {
+  overflow-x: scroll;
+}
+
 .channel-column {
   overflow-y: scroll;
   overflow-x: hidden;

runtimepy/net/server/app/env/tab/html.py

@@ -134,7 +134,9 @@ class ChannelEnvironmentTabHtml(ChannelEnvironmentTabControls):
     def channel_table(self, parent: Element) -> None:
         """Create the channel table."""
 
-        table = div(tag="table", parent=parent)
+        table = div(
+            tag="table", parent=div(parent=parent, class_str="table-container")
+        )
         table.add_class("table", TEXT)
 
         header = div(tag="thead", parent=table)
@@ -248,7 +250,7 @@ class ChannelEnvironmentTabHtml(ChannelEnvironmentTabControls):
         # table doesn't take up full vertical space, few channels).
         under_construction(
             vert_container,
-            class_str="border-start border-end",
+            class_str="border-start border-top border-end",
             note="unused space",
         )
 

runtimepy/net/udp/tftp/__init__.py

@@ -21,6 +21,7 @@ from runtimepy.net.udp.tftp.base import (
     DEFAULT_TIMEOUT_S,
     REEMIT_PERIOD_S,
     BaseTftpConnection,
+    TftpErrorHandler,
 )
 from runtimepy.net.udp.tftp.enums import DEFAULT_MODE
 from runtimepy.util import PossiblePath, as_path
@@ -194,6 +195,9 @@ class TftpConnection(BaseTftpConnection):
         return result
 
 
+TFTP_PORT = 69
+
+
 @asynccontextmanager
 async def tftp(
     addr: Union[IpHost, tuple[str, int]],
@@ -201,6 +205,7 @@ async def tftp(
     connection_kwargs: dict[str, Any] = None,
     timeout_s: float = DEFAULT_TIMEOUT_S,
     reemit_period_s: float = REEMIT_PERIOD_S,
+    error_handler: TftpErrorHandler = None,
 ) -> AsyncIterator[TftpConnection]:
     """Use a tftp connection as a managed context."""
 
@@ -215,6 +220,11 @@ async def tftp(
     conn = await TftpConnection.create_connection(
         remote_addr=(addr.name, addr.port), **connection_kwargs
     )
+
+    # Add error handlers.
+    if error_handler is not None:
+        conn.error_handlers.append(error_handler)
+
     async with conn.process_then_disable(**process_kwargs):
         # Set parameters.
         conn.endpoint_timeout.value = timeout_s
@@ -232,6 +242,7 @@ async def tftp_write(
     connection_kwargs: dict[str, Any] = None,
     timeout_s: float = DEFAULT_TIMEOUT_S,
     reemit_period_s: float = REEMIT_PERIOD_S,
+    error_handler: TftpErrorHandler = None,
 ) -> bool:
     """Attempt to perform a tftp write."""
 
@@ -241,6 +252,7 @@ async def tftp_write(
         connection_kwargs=connection_kwargs,
         timeout_s=timeout_s,
         reemit_period_s=reemit_period_s,
+        error_handler=error_handler,
     ) as conn:
         # Perform tftp interaction.
         result = await conn.request_write(
@@ -259,6 +271,7 @@ async def tftp_read(
     connection_kwargs: dict[str, Any] = None,
     timeout_s: float = DEFAULT_TIMEOUT_S,
     reemit_period_s: float = REEMIT_PERIOD_S,
+    error_handler: TftpErrorHandler = None,
 ) -> bool:
     """Attempt to perform a tftp read."""
 
@@ -268,6 +281,7 @@ async def tftp_read(
         connection_kwargs=connection_kwargs,
         timeout_s=timeout_s,
         reemit_period_s=reemit_period_s,
+        error_handler=error_handler,
     ) as conn:
         result = await conn.request_read(
             destination, filename, mode=mode, addr=addr

runtimepy/net/udp/tftp/base.py

@@ -8,7 +8,7 @@ from contextlib import AsyncExitStack
 from io import BytesIO
 import logging
 from pathlib import Path
-from typing import BinaryIO, Union
+from typing import BinaryIO, Callable, Union
 
 # third-party
 from vcorelib.math import metrics_time_ns
@@ -30,6 +30,8 @@ from runtimepy.primitives import Double, Uint16
 REEMIT_PERIOD_S = 0.20
 DEFAULT_TIMEOUT_S = 1.0
 
+TftpErrorHandler = Callable[[TftpErrorCode, str, tuple[str, int]], None]
+
 
 class BaseTftpConnection(UdpConnection):
     """A class implementing a basic tftp interface."""
@@ -73,6 +75,7 @@ class BaseTftpConnection(UdpConnection):
 
         self.error_code = Uint16(time_source=metrics_time_ns)
         self.env.channel("error_code", self.error_code, enum="TftpErrorCode")
+        self.error_handlers: list[TftpErrorHandler] = []
 
         self.endpoint_period = Double(value=REEMIT_PERIOD_S)
         self.env.channel(
@@ -346,10 +349,14 @@ class BaseTftpConnection(UdpConnection):
         """Handle an error message."""
 
         # Update underlying primitive.
-        error_code = self.error_code.from_stream(stream)
-        self.endpoint(addr).handle_error(
-            TftpErrorCode(error_code), stream.read().decode()
-        )
+        error_code = TftpErrorCode(self.error_code.from_stream(stream))
+        message = stream.read().decode()
+
+        # Call extra error handlers.
+        for handler in self.error_handlers:
+            handler(error_code, message, addr)
+
+        self.endpoint(addr).handle_error(error_code, message)
 
     async def process_datagram(
         self, data: bytes, addr: tuple[str, int]

{runtimepy-5.4.2.dist-info → runtimepy-5.4.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runtimepy
-Version: 5.4.2
+Version: 5.4.4
 Summary: A framework for implementing Python services.
 Home-page: https://github.com/vkottler/runtimepy
 Author: Vaughn Kottler
@@ -17,9 +17,9 @@ Classifier: License :: OSI Approved :: MIT License
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: svgen >=0.6.8
-Requires-Dist: vcorelib >=3.3.1
 Requires-Dist: websockets
+Requires-Dist: vcorelib >=3.3.1
+Requires-Dist: svgen >=0.6.8
 Requires-Dist: psutil
 Provides-Extra: test
 Requires-Dist: pylint ; extra == 'test'
@@ -44,11 +44,11 @@ Requires-Dist: uvloop ; (sys_platform != "win32" and sys_platform != "cygwin") a
     =====================================
     generator=datazen
     version=3.1.4
-    hash=4f8a71a6066638ed1a90f375188f0578
+    hash=dbac0e58214ea7e4abbe7161a3c64749
     =====================================
 -->
 
-# runtimepy ([5.4.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.4.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.4.2.dist-info → runtimepy-5.4.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-runtimepy/__init__.py,sha256=ojyvRCtIcczCpJWeruS4_U9LFJ6NMGfeWnb-MKrQ3pU,390
+runtimepy/__init__.py,sha256=baR2RhS2-y7ZXgCnsPoi2qZNQvYUTMTNIsSR2qKnRNg,390
 runtimepy/__main__.py,sha256=OPAed6hggoQdw-6QAR62mqLC-rCkdDhOq0wyeS2vDRI,332
 runtimepy/app.py,sha256=sTvatbsGZ2Hdel36Si_WUbNMtg9CzsJyExr5xjIcxDE,970
 runtimepy/dev_requirements.txt,sha256=j0dh11ztJAzfaUL0iFheGjaZj9ppDzmTkclTT8YKO8c,230
@@ -34,7 +34,7 @@ runtimepy/commands/arbiter.py,sha256=CtTMRYpqCAN3vWHkkr9jqWpoF7JGNXafKIBFmkarAfc
 runtimepy/commands/common.py,sha256=NvZdeIFBHAF52c1n7vqD59DW6ywc-rG5iC5MpuhGf-c,2449
 runtimepy/commands/server.py,sha256=T5IwBeqwJPpg35Ms_Vmz6xS1T-8U3fcgiRU6mAFlkEU,3767
 runtimepy/commands/task.py,sha256=6xRVlRwpEZVhrcY18sQcfdWEOxeQZLeOF-6UrUURtO4,1435
-runtimepy/commands/tftp.py,sha256=5dsrYSWbAY-ZAdvfukLOynkrJBtR4J1zEOZey4FerF4,2308
+runtimepy/commands/tftp.py,sha256=97Ev0bg0zI9WL_-BYWAyKWe3mC9xKsZ-gL1637ExdvE,2325
 runtimepy/commands/tui.py,sha256=9hWA3_YATibUUDTVQr7UnKzPTDVJ7WxWKTYYQpLoyrE,1869
 runtimepy/control/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 runtimepy/control/source.py,sha256=nW3Q2D-LcekII7K5XKbxXCcR-9jYQyvv0UypeNy1Dnw,1695
@@ -48,7 +48,7 @@ runtimepy/data/server.yaml,sha256=wS_Ceiu2TpkfPurpqoYoPlgzc9DAWtUd24MW7t-S5rU,97
 runtimepy/data/server_base.yaml,sha256=QkF1xcHyMEViUhOc5rKFbFXjbRDDDHbX5LXvSQJRS58,615
 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=UyGXyv7nULrJ0UHsXTSM2IIrJ4X2XIEbPjmmU87yQno,1334
+runtimepy/data/css/bootstrap_extra.css,sha256=w1Y527gWUnfC40zfodA8AM49BwGQVsOOYOFUX657IF4,1378
 runtimepy/data/css/main.css,sha256=h1iKkxg6-t7wTwNQvxDiD9mjpWrqq_FmgT6yXP7UANQ,688
 runtimepy/data/js/DataConnection.js,sha256=DnX8FMehjJXqmI62UMYXSvl_XdfQMzq3XUDFbLu2GgI,98
 runtimepy/data/js/JsonConnection.js,sha256=rclZrbmWc_zSs6I_JhOgxnVPFIyPMo5WdjAe8alyZ3o,2729
@@ -171,7 +171,7 @@ runtimepy/net/server/app/env/widgets.py,sha256=_kNvPl7MXnZOiwTjoZiU2hfuSjkLnRUrO
 runtimepy/net/server/app/env/tab/__init__.py,sha256=stTVKyHljLQWnnhxkWPwa7bLdZtjhiMFbiVFgbiYaFI,647
 runtimepy/net/server/app/env/tab/base.py,sha256=uBPpOeqI23341IezIQcGvJciPfIL2P5qQgbZ74aQRKA,991
 runtimepy/net/server/app/env/tab/controls.py,sha256=hsj0ErywfmOBtJLNZbMISrE2ELJEfyXvtCtpsDbXlYg,4734
-runtimepy/net/server/app/env/tab/html.py,sha256=pynwnRyD_jjME20psO7LK5mABqZudeWs3oDZCVHWRUs,7188
+runtimepy/net/server/app/env/tab/html.py,sha256=ElAPyLczQVdja8OTWibKwgB0Sn2dklrc7DkqBFZxm_Y,7262
 runtimepy/net/server/app/env/tab/message.py,sha256=3LLaEIJgr2hhZH2-v-Sq-OKfKkfRgP-RDU8EpKLYb74,3709
 runtimepy/net/server/struct/__init__.py,sha256=z62I3DUoOnCcTv7C9X3sA6jOBKAJQ_uSOQA7uNwyrj4,1839
 runtimepy/net/server/websocket/__init__.py,sha256=KISuFUUQwNn6BXo8BOMuMOXyoVqE7Jw94ZQiSCQuRQE,5279
@@ -194,8 +194,8 @@ runtimepy/net/udp/connection.py,sha256=YtLty6iveVH6PQRODKriwR5Q6lFi0Ed4k0o5r0bgA
 runtimepy/net/udp/create.py,sha256=84YDfJbNBlN0ZwbNpvh6Dl7ZPecbZfmpjMNRRWcvJDk,2005
 runtimepy/net/udp/protocol.py,sha256=A4SRHf0CgcL2zDs1nAsGDqz0RxKBy1soS8wtNdS5S0I,1492
 runtimepy/net/udp/queue.py,sha256=DF-YscxQcGbGCYQLz_l_BMaSRfraZOhRwieTEdXLMds,637
-runtimepy/net/udp/tftp/__init__.py,sha256=SJGkizBqV73XfQ9HIRAcFE8Xy9JXJHptr_WtbFswZgc,8724
-runtimepy/net/udp/tftp/base.py,sha256=FCrtpLdUFkQU4nkn5vJc6Gn5EsZauCf8eLhxx1r_vG8,11276
+runtimepy/net/udp/tftp/__init__.py,sha256=C4YI06y-xwHphYBc68jXL35CrLVNzds3-tIhxTp1PWk,9081
+runtimepy/net/udp/tftp/base.py,sha256=7nEgxv3j6ehqP8q2p769NjnkkMBOw3smt1XDqFBmdN4,11551
 runtimepy/net/udp/tftp/endpoint.py,sha256=so60LdPTG66N5tdhHhiX7j_TBHvNOTi4JIgLcg2MAm0,10890
 runtimepy/net/udp/tftp/enums.py,sha256=06juMd__pJZsyL8zO8p3hRucnOratt1qtz9zcxzMg4s,1579
 runtimepy/net/udp/tftp/io.py,sha256=w6cnUt-T-Ma6Vg8BWoRbsNnIWUv0HTY4am6bcLWxNJs,803
@@ -255,9 +255,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.4.2.dist-info/LICENSE,sha256=okYCYhGsx_BlzvFdoNVBVpw_Cfb4SOqHA_VAARml4Hc,1071
-runtimepy-5.4.2.dist-info/METADATA,sha256=HuPnRnjp8IDWbQUxSwohDtt4GvNFQJYvZ8rgY_NfyoQ,8152
-runtimepy-5.4.2.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
-runtimepy-5.4.2.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
-runtimepy-5.4.2.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
-runtimepy-5.4.2.dist-info/RECORD,,
+runtimepy-5.4.4.dist-info/LICENSE,sha256=okYCYhGsx_BlzvFdoNVBVpw_Cfb4SOqHA_VAARml4Hc,1071
+runtimepy-5.4.4.dist-info/METADATA,sha256=QwSQWMUYIK5S4grh2n898qjjXI_7gHHMFtU10gqAX7c,8152
+runtimepy-5.4.4.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
+runtimepy-5.4.4.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
+runtimepy-5.4.4.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
+runtimepy-5.4.4.dist-info/RECORD,,

{runtimepy-5.4.2.dist-info → runtimepy-5.4.4.dist-info}/WHEEL

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