runtimepy 5.14.0__tar.gz → 5.14.1__tar.gz

{runtimepy-5.14.0/runtimepy.egg-info → runtimepy-5.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.14.0
+Version: 5.14.1
 Summary: A framework for implementing Python services.
 Home-page: https://github.com/libre-embedded/runtimepy
 Author: Libre Embedded
@@ -17,11 +17,11 @@ Classifier: Development Status :: 5 - Production/Stable
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: psutil
-Requires-Dist: svgen>=0.7.12
+Requires-Dist: aiofiles
 Requires-Dist: vcorelib>=3.5.8
+Requires-Dist: psutil
 Requires-Dist: websockets
-Requires-Dist: aiofiles
+Requires-Dist: svgen>=0.7.12
 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=f46a9eb2c8979cc9ff0a3444077956ec
+    hash=06a038e989fda153238ee650b2f26604
     =====================================
 -->
 
-# runtimepy ([5.14.0](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.14.1](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.14.0 → runtimepy-5.14.1}/README.md

@@ -2,11 +2,11 @@
     =====================================
     generator=datazen
     version=3.2.3
-    hash=f46a9eb2c8979cc9ff0a3444077956ec
+    hash=06a038e989fda153238ee650b2f26604
     =====================================
 -->
 
-# runtimepy ([5.14.0](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.14.1](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.14.0 → runtimepy-5.14.1}/pyproject.toml

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

{runtimepy-5.14.0 → runtimepy-5.14.1}/runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.2.3
-# hash=c6b2bd8ab0196f119c02bcdf6807ecab
+# hash=49d1cdab220096c364c12f39a37de0aa
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "5.14.0"
+VERSION = "5.14.1"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

{runtimepy-5.14.0 → runtimepy-5.14.1}/runtimepy/codec/protocol/receiver.py

@@ -5,7 +5,7 @@ A module implementing an interface for receiving struct messages.
 # built-in
 from io import BytesIO
 import os
-from typing import Callable
+from typing import Callable, Optional
 
 # third-party
 from vcorelib.logging import LoggerMixin
@@ -16,11 +16,15 @@ from runtimepy.primitives.byte_order import ByteOrder
 from runtimepy.primitives.int import UnsignedInt
 
 StructHandler = Callable[[Protocol], None]
+NonStructHandler = Callable[[BytesIO], bool]
+
+NON_STRUCT_ID = 0
 
 
 class StructReceiver(LoggerMixin):
     """A class for sending and receiving struct messages."""
 
+    non_struct_message_prefix: bytes
     id_primitive: UnsignedInt
     byte_order: ByteOrder
 
@@ -29,15 +33,22 @@ class StructReceiver(LoggerMixin):
 
         super().__init__()
 
+        self.non_struct_handler: Optional[NonStructHandler] = None
         self.handlers: dict[int, StructHandler] = {}
         self.instances: dict[int, Protocol] = {}
         for factory in factories:
             self.register(factory)
 
+    def add_non_struct_handler(self, handler: NonStructHandler) -> None:
+        """Set the non-struct handler for this instance."""
+        assert self.non_struct_handler is None
+        self.non_struct_handler = handler
+
     def add_handler(self, identifier: int, handler: StructHandler) -> None:
         """Add a struct message handler."""
 
         assert identifier not in self.handlers
+        assert identifier != NON_STRUCT_ID
         self.handlers[identifier] = handler
 
     def register(self, factory: type[ProtocolFactory]) -> None:
@@ -45,9 +56,14 @@ class StructReceiver(LoggerMixin):
 
         inst = factory.singleton()
 
+        assert inst.id != NON_STRUCT_ID
+
         if not hasattr(self, "id_primitive"):
             self.id_primitive = inst.id_primitive.copy()  # type: ignore
             self.byte_order = inst.byte_order
+            self.non_struct_message_prefix = self.id_primitive.kind.encode(
+                NON_STRUCT_ID, byte_order=self.byte_order
+            )
         else:
             assert self.id_primitive.kind == inst.id_primitive.kind
             assert self.byte_order == inst.byte_order
@@ -67,7 +83,23 @@ class StructReceiver(LoggerMixin):
                 ident = self.id_primitive.from_stream(
                     stream, byte_order=self.byte_order
                 )
-                if ident in self.instances:
+
+                # Handle non-struct messages.
+                if ident == NON_STRUCT_ID:
+                    if self.non_struct_handler is not None:
+                        if not self.non_struct_handler(stream):
+                            self.logger.error(
+                                "Parsing non-struct message failed."
+                            )
+                            stream.seek(0, os.SEEK_END)
+                    else:
+                        self.logger.error(
+                            "No handler for non-struct messages."
+                        )
+                        stream.seek(0, os.SEEK_END)
+
+                # Handle struct messages.
+                elif ident in self.instances:
                     inst = self.instances[ident]
                     inst.from_stream(stream)
                     if ident in self.handlers:
@@ -81,11 +113,5 @@ class StructReceiver(LoggerMixin):
 
                 # Can't continue reading if we don't know this identifier.
                 else:
-                    self.logger.error(
-                        "Unknown struct identifier '%d' "
-                        "@%d/%d of stream (aborting).",
-                        ident,
-                        stream.tell(),
-                        end_pos,
-                    )
+                    self.logger.error("Unknown struct identifier '%d'.", ident)
                     stream.seek(0, os.SEEK_END)

{runtimepy-5.14.0 → runtimepy-5.14.1}/runtimepy/primitives/base.py

@@ -93,7 +93,12 @@ class Primitive(_Generic[T]):
 
     def __copy__(self) -> "Primitive[T]":
         """Make a copy of this primitive."""
-        return type(self)(value=self.value)
+
+        return type(self)(
+            value=self.value,
+            scaling=self.scaling,
+            time_source=self.time_source,
+        )
 
     def copy(self) -> "Primitive[T]":
         """A simple wrapper for copy."""

{runtimepy-5.14.0 → runtimepy-5.14.1/runtimepy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.14.0
+Version: 5.14.1
 Summary: A framework for implementing Python services.
 Home-page: https://github.com/libre-embedded/runtimepy
 Author: Libre Embedded
@@ -17,11 +17,11 @@ Classifier: Development Status :: 5 - Production/Stable
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: psutil
-Requires-Dist: svgen>=0.7.12
+Requires-Dist: aiofiles
 Requires-Dist: vcorelib>=3.5.8
+Requires-Dist: psutil
 Requires-Dist: websockets
-Requires-Dist: aiofiles
+Requires-Dist: svgen>=0.7.12
 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=f46a9eb2c8979cc9ff0a3444077956ec
+    hash=06a038e989fda153238ee650b2f26604
     =====================================
 -->
 
-# runtimepy ([5.14.0](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.14.1](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)