runtimepy 5.7.6__tar.gz → 5.7.7__tar.gz

{runtimepy-5.7.6/runtimepy.egg-info → runtimepy-5.7.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runtimepy
-Version: 5.7.6
+Version: 5.7.7
 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: vcorelib>=3.4.2
+Requires-Dist: svgen>=0.6.8
 Requires-Dist: aiofiles
 Requires-Dist: websockets
 Requires-Dist: psutil
-Requires-Dist: vcorelib>=3.4.2
-Requires-Dist: svgen>=0.6.8
 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=41ff8742602f69f2831092a4b666cddc
+    hash=0bf47d2ff3fb0ed78ed013f4fcbc59e2
     =====================================
 -->
 
-# runtimepy ([5.7.6](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.7.7](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.6 → runtimepy-5.7.7}/README.md

@@ -2,11 +2,11 @@
     =====================================
     generator=datazen
     version=3.1.4
-    hash=41ff8742602f69f2831092a4b666cddc
+    hash=0bf47d2ff3fb0ed78ed013f4fcbc59e2
     =====================================
 -->
 
-# runtimepy ([5.7.6](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.7.7](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.6 → runtimepy-5.7.7}/pyproject.toml

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

{runtimepy-5.7.6 → runtimepy-5.7.7}/runtimepy/__init__.py

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

{runtimepy-5.7.6 → runtimepy-5.7.7}/runtimepy/metrics/channel.py

@@ -43,7 +43,7 @@ class ChannelMetrics:
     def __str__(self) -> str:
         """Get metrics as a string."""
 
-        return "\t".join(
+        return " | ".join(
             [
                 f"messages={self.messages.value}",
                 f"message_rate={self.message_rate.value:.2f}",

{runtimepy-5.7.6 → runtimepy-5.7.7}/runtimepy/net/arbiter/housekeeping/__init__.py

@@ -52,7 +52,11 @@ class ConnectionMetricsPoller(_ArbiterTask):
 
         # Handle any incoming commands.
         processors: list[Awaitable[None]] = []
-        for mapping in self.app.connections.values(), self.app.tasks.values():
+        for mapping in (
+            self.app.connections.values(),
+            self.app.tasks.values(),
+            self.app.structs.values(),
+        ):
             for item in mapping:
                 if isinstance(item, AsyncCommandProcessingMixin):
                     processors.append(item.process_command_queue())

{runtimepy-5.7.6 → runtimepy-5.7.7}/runtimepy/net/arbiter/info.py

@@ -6,6 +6,7 @@ A module implementing an application information interface.
 from abc import ABC as _ABC
 import asyncio as _asyncio
 from contextlib import AsyncExitStack as _AsyncExitStack
+from contextlib import contextmanager
 from dataclasses import dataclass
 from logging import getLogger as _getLogger
 from re import compile as _compile
@@ -57,13 +58,29 @@ class RuntimeStruct(RuntimeStructBase, _ABC):
 
     byte_order: ByteOrder = DEFAULT_BYTE_ORDER
 
+    # Set this for structs to automatically be polled when the application is
+    # going down.
+    final_poll = False
+
     def init_env(self) -> None:
         """Initialize this sample environment."""
 
+    @contextmanager
+    def _final_poll(self) -> _Iterator[None]:
+        """Poll when the context ends."""
+
+        try:
+            yield
+        finally:
+            self.poll()
+
     async def build(self, app: "AppInfo", **kwargs) -> None:
         """Build a struct instance's channel environment."""
 
         self.app = app
+        if self.final_poll:
+            self.app.stack.enter_context(self._final_poll())
+
         self.init_env()
         self.update_byte_order(self.byte_order, **kwargs)
 
@@ -102,6 +119,9 @@ class TrigStruct(RuntimeStruct, TrigMixin):
 class SampleStruct(TrigStruct):
     """A sample runtime structure."""
 
+    # For fun.
+    final_poll = True
+
     def init_env(self) -> None:
         """Initialize this sample environment."""
         super().init_env()

{runtimepy-5.7.6 → runtimepy-5.7.7}/runtimepy/struct/__init__.py

@@ -3,7 +3,10 @@ A module implementing a runtime structure base.
 """
 
 # built-in
+from argparse import Namespace
+import asyncio
 from logging import getLogger as _getLogger
+from typing import Optional
 
 # third-party
 from vcorelib.io import MarkdownMixin
@@ -11,15 +14,20 @@ from vcorelib.io.types import JsonObject as _JsonObject
 
 # internal
 from runtimepy import PKG_NAME
+from runtimepy.channel.environment.command import FieldOrChannel
 from runtimepy.channel.environment.command.processor import (
     ChannelCommandProcessor,
 )
+from runtimepy.mixins.async_command import AsyncCommandProcessingMixin
 from runtimepy.mixins.environment import ChannelEnvironmentMixin
 from runtimepy.mixins.logging import LoggerMixinLevelControl
 
 
 class RuntimeStructBase(
-    LoggerMixinLevelControl, ChannelEnvironmentMixin, MarkdownMixin
+    LoggerMixinLevelControl,
+    ChannelEnvironmentMixin,
+    AsyncCommandProcessingMixin,
+    MarkdownMixin,
 ):
     """A base runtime structure."""
 
@@ -42,6 +50,23 @@ class RuntimeStructBase(
         self.command = ChannelCommandProcessor(self.env, self.logger)
         self.config = config
 
+        async def poll(args: Namespace, __: Optional[FieldOrChannel]) -> None:
+            """Handle a test command."""
+
+            count = 1
+            delay = 0.0
+
+            if args.extra:
+                count = int(args.extra[0])
+                if len(args.extra) > 1:
+                    delay = float(args.extra[1])
+
+            for _ in range(count):
+                self.poll()
+                await asyncio.sleep(delay)
+
+        self._setup_async_commands(poll)
+
     def poll(self) -> None:
         """
         A method that other runtime entities can call to perform canonical

{runtimepy-5.7.6 → runtimepy-5.7.7/runtimepy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runtimepy
-Version: 5.7.6
+Version: 5.7.7
 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: vcorelib>=3.4.2
+Requires-Dist: svgen>=0.6.8
 Requires-Dist: aiofiles
 Requires-Dist: websockets
 Requires-Dist: psutil
-Requires-Dist: vcorelib>=3.4.2
-Requires-Dist: svgen>=0.6.8
 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=41ff8742602f69f2831092a4b666cddc
+    hash=0bf47d2ff3fb0ed78ed013f4fcbc59e2
     =====================================
 -->
 
-# runtimepy ([5.7.6](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.7.7](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)