runtimepy 5.10.2__py3-none-any.whl → 5.11.1__py3-none-any.whl

runtimepy/__init__.py

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

runtimepy/channel/environment/array.py

@@ -95,10 +95,10 @@ class ArrayChannelEnvironment(_BaseChannelEnvironment):
 
             # Begin handling a new bit-fields primitive.
             if curr_fields is None:
-                fields = self.fields.get_fields(name)
-                assert fields is not None, f"Unknown bit-field '{name}'!"
-                result.array.add(fields.raw)
-                available_field_names = set(fields.names)
+                curr_fields = self.fields.get_fields(name)
+                assert curr_fields is not None, f"Unknown bit-field '{name}'!"
+                result.array.add(curr_fields.raw)
+                available_field_names = set(curr_fields.names)
 
             # Keep track of field names processed in the current bit-fields
             # primitive.

runtimepy/channel/environment/telemetry.py

@@ -99,7 +99,7 @@ class TelemetryChannelEnvironment(_BaseChannelEnvironment):
                 cast(int, channels.event_header["timestamp"]),
                 kind.decode(
                     data,
-                    byte_order=channels.event_header.array.byte_order,
+                    byte_order=channels.event_header.byte_order,
                 ),
             )
 
@@ -120,7 +120,7 @@ class TelemetryChannelEnvironment(_BaseChannelEnvironment):
                 cast(int, self.channels.event_header["timestamp"]),
                 kind.decode(
                     data,
-                    byte_order=self.channels.event_header.array.byte_order,
+                    byte_order=self.channels.event_header.byte_order,
                 ),
             )
 
@@ -146,7 +146,7 @@ class TelemetryChannelEnvironment(_BaseChannelEnvironment):
                 read_size = channels.event_header.size
                 data = channels.event_fifo.pop(read_size)
                 if data is not None:
-                    channels.event_header.array.update(data)
+                    channels.event_header.update(data)
 
                     # Update local variables.
                     ident = cast(int, channels.event_header["identifier"])

runtimepy/channel/event/__init__.py

@@ -90,7 +90,7 @@ class PrimitiveEvent:
             self.header["timestamp"] = curr_ns
 
             # Write header then value.
-            array = self.header.array
+            array = self.header
             written += array.to_stream(stream)
             written += raw.to_stream(stream, byte_order=array.byte_order)
             if flush:

runtimepy/codec/protocol/__init__.py

@@ -4,7 +4,6 @@ A module implementing an interface to build communication protocols.
 
 # built-in
 from abc import ABC, abstractmethod
-from copy import copy
 from typing import Optional
 
 # internal
@@ -40,10 +39,12 @@ class ProtocolFactory(ABC):
 
         # We only need to run the routine that populates the protocol once.
         if not cls.initialized:
+            if not cls.protocol.alias:
+                cls.protocol.alias = cls.__name__
             cls.initialize(cls.protocol)
             cls.initialized = True
 
-        return copy(cls.protocol)
+        return cls.protocol.copy()
 
     @classmethod
     def singleton(cls) -> Protocol:

runtimepy/codec/protocol/base.py

@@ -3,8 +3,9 @@ A module implementing an interface to build communication protocols.
 """
 
 # built-in
-from contextlib import contextmanager
+from contextlib import contextmanager, suppress
 from copy import copy as _copy
+from io import StringIO
 from typing import Iterator as _Iterator
 from typing import NamedTuple
 from typing import Optional as _Optional
@@ -57,9 +58,10 @@ class FieldSpec(NamedTuple):
 
 
 T = _TypeVar("T", bound="ProtocolBase")
+ProtocolBuild = list[_Union[int, FieldSpec, tuple[str, int]]]
 
 
-class ProtocolBase:
+class ProtocolBase(PrimitiveArray):
     """A class for defining runtime communication protocols."""
 
     def __init__(
@@ -67,14 +69,16 @@ class ProtocolBase:
         enum_registry: _EnumRegistry,
         names: _NameRegistry = None,
         fields: BitFieldsManager = None,
-        build: list[_Union[int, FieldSpec, str]] = None,
+        build: ProtocolBuild = None,
         identifier: int = 1,
         byte_order: _Union[_ByteOrder, _RegistryKey] = _DEFAULT_BYTE_ORDER,
         serializables: SerializableMap = None,
+        alias: str = None,
     ) -> None:
         """Initialize this protocol."""
 
         self.id = identifier
+        self.alias = alias
 
         # Register the byte-order enumeration if it's not present.
         self._enum_registry = enum_registry
@@ -86,7 +90,8 @@ class ProtocolBase:
             byte_order = _ByteOrder(
                 self._enum_registry["ByteOrder"].get_int(byte_order)
             )
-        self.array = PrimitiveArray(byte_order=byte_order)
+
+        super().__init__(byte_order=byte_order)
 
         if names is None:
             names = _NameRegistry()
@@ -96,11 +101,11 @@ class ProtocolBase:
             fields = BitFieldsManager(self.names, self._enum_registry)
         self._fields = fields
 
-        self._regular_fields: dict[str, _AnyPrimitive] = {}
+        self._regular_fields: dict[str, list[_AnyPrimitive]] = {}
         self._enum_fields: dict[str, _RuntimeEnum] = {}
 
         # Keep track of the order that the protocol was created.
-        self._build: list[_Union[int, FieldSpec, str]] = []
+        self._build: ProtocolBuild = []
 
         # Keep track of named serializables.
         self.serializables: SerializableMap = {}
@@ -110,24 +115,28 @@ class ProtocolBase:
             build = []
         for item in build:
             if isinstance(item, int):
-                self._add_bit_fields(self._fields.fields[item], track=False)
-            elif isinstance(item, str):
-                assert serializables, (item, serializables)
-                self.add_field(item, serializable=serializables[item])
-                del serializables[item]
-            else:
+                self._add_bit_fields(self._fields.fields[item])
+            elif isinstance(item, FieldSpec):
                 self.add_field(
                     item.name,
                     item.kind,
                     enum=item.enum,
-                    track=False,
                     array_length=item.array_length,
                 )
+            else:
+                assert serializables, (item, serializables)
+                name = item[0]
+                self.add_serializable(
+                    name,
+                    serializables[name][0],
+                    array_length=None if item[1] == 1 else item[1],
+                )
+                del serializables[name]
 
         # Ensure all serializables were handled via build.
         assert not serializables, serializables
 
-    def __copy__(self: T) -> T:
+    def _copy_impl(self: T) -> T:
         """Create another protocol instance from this one."""
 
         return self.__class__(
@@ -135,11 +144,12 @@ class ProtocolBase:
             names=self.names,
             fields=_copy(self._fields),
             build=self._build,
-            byte_order=self.array.byte_order,
+            byte_order=self.byte_order,
             serializables={
-                key: val.copy_without_chain()
+                key: [val[0].copy_without_chain()]
                 for key, val in self.serializables.items()
             },
+            alias=self.alias,
         )
 
     def register_name(self, name: str) -> int:
@@ -151,13 +161,14 @@ class ProtocolBase:
 
     def add_serializable(
         self, name: str, serializable: Serializable, array_length: int = None
-    ) -> int:
+    ) -> None:
         """Add a serializable instance."""
 
         self.register_name(name)
-        self.serializables[name] = serializable
-        self._build.append(name)
-        return self.array.add_to_end(serializable, array_length=array_length)
+
+        instances = self.add_to_end(serializable, array_length=array_length)
+        self._build.append((name, len(instances)))
+        self.serializables[name] = instances
 
     def add_field(
         self,
@@ -165,17 +176,17 @@ class ProtocolBase:
         kind: _Primitivelike = None,
         enum: _RegistryKey = None,
         serializable: Serializable = None,
-        track: bool = True,
         array_length: int = None,
-    ) -> int:
+    ) -> None:
         """Add a new field to the protocol."""
 
         # Add the serializable to the end of this protocol.
         if serializable is not None:
             assert kind is None and enum is None
-            return self.add_serializable(
+            self.add_serializable(
                 name, serializable, array_length=array_length
             )
+            return
 
         self.register_name(name)
 
@@ -189,25 +200,20 @@ class ProtocolBase:
                 kind = runtime_enum.primitive
 
         assert kind is not None
-        new = _create(kind)
-
-        result = self.array.add(new, array_length=array_length)
-        self._regular_fields[name] = new
 
-        if track:
-            self._build.append(
-                FieldSpec(name, kind, enum, array_length=array_length)
-            )
+        self._regular_fields[name] = self.add(
+            _create(kind), array_length=array_length
+        )
 
-        return result
+        self._build.append(
+            FieldSpec(name, kind, enum, array_length=array_length)
+        )
 
-    def _add_bit_fields(self, fields: _BitFields, track: bool = True) -> None:
+    def _add_bit_fields(self, fields: _BitFields) -> None:
         """Add a bit-fields instance."""
 
-        idx = self._fields.add(fields)
-        self.array.add(fields.raw)
-        if track:
-            self._build.append(idx)
+        self._build.append(self._fields.add(fields))
+        self.add(fields.raw)
 
     @contextmanager
     def add_bit_fields(
@@ -219,55 +225,92 @@ class ProtocolBase:
         yield new
         self._add_bit_fields(new)
 
-    def value(self, name: str, resolve_enum: bool = True) -> ProtocolPrimitive:
+    def value(
+        self, name: str, resolve_enum: bool = True, index: int = 0
+    ) -> ProtocolPrimitive:
         """Get the value of a field belonging to the protocol."""
 
         val: ProtocolPrimitive = 0
 
         if name in self._regular_fields:
-            val = self._regular_fields[name].value
+            val = self._regular_fields[name][index].value
 
             # Resolve the enum value.
             if resolve_enum and name in self._enum_fields:
-                val = self._enum_fields[name].get_str(val)  # type: ignore
+                with suppress(KeyError):
+                    val = self._enum_fields[name].get_str(val)  # type: ignore
 
             return val
 
         return self._fields.get(name, resolve_enum=resolve_enum)
 
-    @property
-    def size(self) -> int:
-        """Get this protocol's size in bytes."""
-        return self.array.length()
-
     def trace_size(self, logger: LoggerType) -> None:
         """Log a size trace."""
-        logger.info("%s: %s", self, self.array.length_trace())
+        logger.info("%s: %s", self, self.length_trace(alias=self.alias))
 
     def __str__(self) -> str:
         """Get this instance as a string."""
 
-        return f"({self.size}) " + " ".join(
-            f"{name}={self[name]}" for name in self.names.registered_order
-        )
+        with StringIO() as stream:
+            stream.write(
+                "{"
+                + f"{self.resolve_alias(alias=self.alias)}({self.length()}): "
+            )
+
+            parts = []
+            for name in self.names.registered_order:
+                part = name
+                count = 1
+
+                if name in self.serializables:
+                    count = len(self.serializables[name])
+                    part += f"<{self.serializables[name][0].resolve_alias()}>"
+                elif name in self._regular_fields:
+                    count = len(self._regular_fields[name])
+
+                    part += f"<{self._regular_fields[name][0].kind}>"
+
+                if count > 1:
+                    part += f"[{count}] = ["
+                    if name in self._regular_fields:
+                        part += ", ".join(
+                            str(x.value) for x in self._regular_fields[name]
+                        )
+                    else:
+                        part += ", ".join("..." for _ in range(count))
+                    part += "]"
+                else:
+                    part += f" = {self[name]}"
+
+                parts.append(part)
 
-    def __getitem__(self, name: str) -> ProtocolPrimitive:
+            stream.write(", ".join(parts))
+
+            stream.write("}")
+
+            return stream.getvalue()
+
+    def __getitem__(self, name: str) -> ProtocolPrimitive:  # type: ignore
         """Get the value of a protocol field."""
 
         if name in self.serializables:
-            return str(self.serializables[name])
+            return str(self.serializables[name][0])
 
         return self.value(name)
 
-    def __setitem__(self, name: str, val: ProtocolPrimitive) -> None:
+    def set(self, name: str, val: ProtocolPrimitive, index: int = 0) -> None:
         """Set a value of a field belonging to the protocol."""
 
         if name in self._regular_fields:
             # Resolve an enum value.
             if isinstance(val, str):
                 val = self._enum_fields[name].get_int(val)
-            self._regular_fields[name].value = val
+            self._regular_fields[name][index].value = val
         elif name in self.serializables and isinstance(val, str):
-            self.serializables[name].update_str(val)
+            self.serializables[name][index].update_str(val)
         else:
             self._fields.set(name, val)  # type: ignore
+
+    def __setitem__(self, name: str, val: ProtocolPrimitive) -> None:
+        """Set a value of a field belonging to the protocol."""
+        self.set(name, val)

runtimepy/codec/protocol/json.py

@@ -14,7 +14,11 @@ from vcorelib.io.types import JsonObject as _JsonObject
 from vcorelib.io.types import JsonValue as _JsonValue
 
 # internal
-from runtimepy.codec.protocol.base import FieldSpec, ProtocolBase
+from runtimepy.codec.protocol.base import (
+    FieldSpec,
+    ProtocolBase,
+    ProtocolBuild,
+)
 from runtimepy.primitives.field.manager import (
     ENUMS_KEY,
     NAMES_KEY,
@@ -46,9 +50,11 @@ class JsonProtocol(ProtocolBase):
         """Export this protocol's data to JSON."""
 
         data = self._fields.export_json(resolve_enum=resolve_enum)
+
         data[META_KEY] = {
             "id": self.id,
-            "byte_order": self.array.byte_order.name.lower(),
+            "byte_order": self.byte_order.name.lower(),
+            "alias": self.alias,
         }
 
         # Export regular-field names.
@@ -72,12 +78,12 @@ class JsonProtocol(ProtocolBase):
         )
 
         # Export the build specification.
-        build: list[_Union[int, _JsonObject, str]] = []
+        build: list[_Union[int, _JsonObject, str, tuple[str, int]]] = []
         for item in self._build:
-            if isinstance(item, (int, str)):
-                build.append(item)
-            else:
+            if isinstance(item, FieldSpec):
                 build.append(item.asdict())
+            else:
+                build.append(item)
         data[BUILD_KEY] = _cast(_JsonObject, build)
 
         # Export regular-field values.
@@ -101,18 +107,16 @@ class JsonProtocol(ProtocolBase):
         fields = BitFieldsManager.import_json(data)
 
         # Create the build specification.
-        build: list[_Union[int, FieldSpec, str]] = []
+        build: ProtocolBuild = []
         for item in data[BUILD_KEY]:
-            if isinstance(item, int):
-                build.append(item)
-            else:
+            if isinstance(item, dict):
                 build.append(
                     FieldSpec(
-                        item["name"],  # type: ignore
-                        item["kind"],  # type: ignore
-                        enum=item.get("enum"),  # type: ignore
+                        item["name"], item["kind"], enum=item.get("enum")
                     )
                 )
+            else:
+                build.append(item)  # type: ignore
 
         result = cls(
             fields.enums,
@@ -121,6 +125,7 @@ class JsonProtocol(ProtocolBase):
             build=build,
             identifier=_cast(int, data[META_KEY]["id"]),
             byte_order=_cast(str, data[META_KEY]["byte_order"]),
+            alias=data[META_KEY]["alias"],  # type: ignore
         )
 
         # Set values.

runtimepy/codec/system/__init__.py

@@ -101,10 +101,9 @@ class TypeSystem(LoggerMixin):
     def register(self, name: str, *namespace: str) -> Protocol:
         """Register a custom type."""
 
-        new_type = Protocol(self._enums)
-        self.custom[self._name(name, *namespace, check_available=True)] = (
-            new_type
-        )
+        resolved = self._name(name, *namespace, check_available=True)
+        new_type = Protocol(self._enums, alias=resolved)
+        self.custom[resolved] = new_type
         return new_type
 
     def get_protocol(
@@ -146,7 +145,7 @@ class TypeSystem(LoggerMixin):
         if field_type_name in self.custom:
             custom.add_serializable(
                 field_name,
-                self.custom[field_type_name].array.copy(),
+                self.custom[field_type_name].copy(),
                 array_length=array_length,
             )
         else:
@@ -227,8 +226,7 @@ class TypeSystem(LoggerMixin):
         if found in self.primitives:
             return self.primitives[found].size
 
-        result = self.custom[found].size
         if trace:
             self.custom[found].trace_size(self.logger)
 
-        return result
+        return self.custom[found].length()

runtimepy/net/udp/tftp/__init__.py

@@ -50,7 +50,6 @@ class TftpConnection(BaseTftpConnection):
 
             def ack_sender() -> None:
                 """Send acks."""
-                nonlocal idx
                 endpoint.ack_sender(idx - 1, endpoint.addr)
 
             def send_rrq() -> None:

runtimepy/primitives/array/__init__.py

@@ -180,44 +180,50 @@ class PrimitiveArray(Serializable):
 
     def add_primitive(
         self, kind: _Primitivelike, array_length: int = None
-    ) -> int:
+    ) -> list[_AnyPrimitive]:
         """Add to the array by specifying the type of element to add."""
+
         return self.add(_create(kind), array_length=array_length)
 
-    def add(self, primitive: _AnyPrimitive, array_length: int = None) -> int:
+    def add(
+        self, primitive: _AnyPrimitive, array_length: int = None
+    ) -> list[_AnyPrimitive]:
         """Add another primitive to manage."""
 
+        result = []
+
         end = self.end
         if isinstance(end, PrimitiveArray):
             if end is self:
                 self._primitives.append(primitive)
                 self._format += primitive.kind.format
                 self.size += primitive.size
+                result.append(primitive)
 
                 # Handle array length.
                 if array_length is not None:
                     for _ in range(array_length - 1):
+                        inst = primitive.copy()
                         self._primitives.append(
-                            primitive.copy(),  # type: ignore
+                            inst,  # type: ignore
                         )
-                        self._format += primitive.kind.format
-                        self.size += primitive.size
+                        self._format += inst.kind.format
+                        self.size += inst.size
+                        result.append(inst)  # type: ignore
 
                 # Add tracking information for the current tail.
                 curr_idx = len(self._primitives)
                 self._bytes_to_index[self.size] = curr_idx
                 self._index_to_bytes[curr_idx] = self.size
-                result = self.size
             else:
-                result = end.add(primitive, array_length=array_length)
+                result.extend(end.add(primitive, array_length=array_length))
 
         # Add a new primitive array to the end of this chain for this
         # primitive.
         else:
             new_array = PrimitiveArray(byte_order=self.byte_order)
             end.assign(new_array)
-
-            result = new_array.add(primitive, array_length=array_length)
+            result.extend(new_array.add(primitive, array_length=array_length))
 
         return result
 
@@ -245,3 +251,16 @@ class PrimitiveArray(Serializable):
     ) -> None:
         """Update a fragment by index."""
         self._fragments[index].update(data, timestamp_ns=timestamp_ns)
+
+    def randomize(self, timestamp_ns: int = None, chain: bool = True) -> None:
+        """Randomize array contents."""
+
+        for prim in self._primitives:
+            prim.randomize(timestamp_ns=timestamp_ns)
+
+        if (
+            chain
+            and self.chain is not None
+            and isinstance(self.chain, PrimitiveArray)
+        ):
+            self.chain.randomize(timestamp_ns=timestamp_ns, chain=chain)

runtimepy/primitives/bool.py

@@ -2,6 +2,9 @@
 A module implementing a boolean-primitive interface.
 """
 
+# built-in
+from random import getrandbits
+
 # internal
 from runtimepy.primitives.base import Primitive as _Primitive
 from runtimepy.primitives.evaluation import EvalResult, evaluate
@@ -18,17 +21,21 @@ class BooleanPrimitive(_Primitive[bool]):
         """Initialize this boolean primitive."""
         super().__init__(value=value, **kwargs)
 
-    def toggle(self) -> None:
+    def randomize(self, timestamp_ns: int = None) -> None:
+        """Set this primitive to a random integer."""
+        self.set_value(bool(getrandbits(1)), timestamp_ns=timestamp_ns)
+
+    def toggle(self, timestamp_ns: int = None) -> None:
         """Toggle the underlying value."""
-        self.value = not self.raw.value
+        self.set_value(not self.raw.value, timestamp_ns=timestamp_ns)
 
-    def set(self) -> None:
+    def set(self, timestamp_ns: int = None) -> None:
         """Coerce the underlying value to true."""
-        self.value = True
+        self.set_value(True, timestamp_ns=timestamp_ns)
 
-    def clear(self) -> None:
+    def clear(self, timestamp_ns: int = None) -> None:
         """Coerce the underlying value to false."""
-        self.value = False
+        self.set_value(False, timestamp_ns=timestamp_ns)
 
     async def wait_for_state(self, state: bool, timeout: float) -> EvalResult:
         """Wait for this primitive to reach a specified state."""

runtimepy/primitives/float.py

@@ -4,6 +4,7 @@ A module implementing a floating-point primitive interface.
 
 # built-in
 import math
+from random import random
 
 # internal
 from runtimepy.primitives.evaluation import (
@@ -27,6 +28,10 @@ class BaseFloatPrimitive(PrimitiveIsCloseMixin[float]):
         """Initialize this floating-point primitive."""
         super().__init__(value=value, scaling=scaling, **kwargs)
 
+    def randomize(self, timestamp_ns: int = None) -> None:
+        """Set this primitive to a random integer."""
+        self.set_value(random(), timestamp_ns=timestamp_ns)
+
     def _check_callbacks(self, curr: float, new: float) -> None:
         """Determine if any callbacks should be serviced."""
 

runtimepy/primitives/int.py

@@ -33,6 +33,14 @@ class BaseIntPrimitive(PrimitiveIsCloseMixin[int]):
 
         super().__init__(value=value, scaling=scaling, **kwargs)
 
+    def randomize(self, timestamp_ns: int = None) -> None:
+        """Set this primitive to a random integer."""
+
+        assert self.kind.int_bounds is not None
+        self.set_value(
+            self.kind.int_bounds.random(), timestamp_ns=timestamp_ns
+        )
+
     def increment(self, amount: int = 1, timestamp_ns: int = None) -> int:
         """Increment this primitive by some amount and return the new value."""
 

runtimepy/primitives/serializable/__init__.py

@@ -7,5 +7,5 @@ from runtimepy.primitives.serializable.base import Serializable
 from runtimepy.primitives.serializable.fixed import FixedChunk
 from runtimepy.primitives.serializable.prefixed import PrefixedChunk
 
-SerializableMap = dict[str, Serializable]
+SerializableMap = dict[str, list[Serializable]]
 __all__ = ["Serializable", "SerializableMap", "FixedChunk", "PrefixedChunk"]

runtimepy/primitives/serializable/base.py

@@ -5,6 +5,7 @@ A module defining a base interface fore serializable objects.
 # built-in
 from abc import ABC, abstractmethod
 from copy import copy as _copy
+from io import BytesIO as _BytesIO
 from typing import BinaryIO as _BinaryIO
 from typing import TypeVar
 
@@ -46,10 +47,17 @@ class Serializable(ABC):
             result += self.chain.length()
         return result
 
-    def length_trace(self) -> str:
+    def resolve_alias(self, alias: str = None) -> str:
+        """Resolve a possible alias string."""
+
+        if not alias:
+            alias = getattr(self, "alias") or self.__class__.__name__
+        return alias
+
+    def length_trace(self, alias: str = None) -> str:
         """Get a length-tracing string for this instance."""
 
-        current = f"{self.__class__.__name__}({self.size})"
+        current = f"{self.resolve_alias(alias=alias)}({self.size})"
         if self.chain is not None:
             current += " -> " + self.chain.length_trace()
         return current
@@ -71,7 +79,6 @@ class Serializable(ABC):
         """A method for copying instances without chain references."""
 
         orig = self._copy_impl()
-        assert orig.chain is None
         orig.byte_order = self.byte_order
         return orig
 
@@ -80,7 +87,7 @@ class Serializable(ABC):
 
         result = self.copy_without_chain()
 
-        if self.chain is not None:
+        if self.chain is not None and result.chain is None:
             result.assign(self.chain.copy())
 
         return result
@@ -104,6 +111,27 @@ class Serializable(ABC):
 
         return result
 
+    def chain_bytes(self) -> bytes:
+        """Get the fully encoded chain."""
+        with _BytesIO() as stream:
+            self.to_stream(stream)
+            return stream.getvalue()
+
+    def __eq__(self, other) -> bool:
+        """Equivalent if full byte chains are equal."""
+
+        result = False
+        if isinstance(other, Serializable):
+            result = self.chain_bytes() == other.chain_bytes()
+        return result
+
+    def update_with(self: T, other: T, timestamp_ns: int = None) -> int:
+        """Update this instance from another of the same type."""
+
+        return self.update_chain(
+            other.chain_bytes(), timestamp_ns=timestamp_ns
+        )
+
     @abstractmethod
     def update(self, data: bytes, timestamp_ns: int = None) -> int:
         """Update this serializable from a bytes instance."""
@@ -130,32 +158,39 @@ class Serializable(ABC):
 
         return result
 
-    def assign(self, chain: T) -> int:
+    def update_chain(self, data: bytes, timestamp_ns: int = None) -> int:
+        """Update this serializable from a bytes instance."""
+
+        with _BytesIO(data) as stream:
+            return self.from_stream(stream, timestamp_ns=timestamp_ns)
+
+    def assign(self, chain: T) -> None:
         """Assign a next serializable."""
 
         assert self.chain is None, self.chain
-
         # mypy regression?
         self.chain = chain  # type: ignore
-        assert self.chain is not None
-
-        return self.chain.size
 
-    def add_to_end(self, chain: T, array_length: int = None) -> int:
+    def add_to_end(self, chain: T, array_length: int = None) -> list[T]:
         """Add a new serializable to the end of this chain."""
 
-        # Copy the chain element before it becomes part of the current chain
-        # if an array is created.
+        result = []
+
+        # Copy the chain element before it becomes part of the current chain if
+        # an array is created.
         copy_base = None
         if array_length is not None:
             copy_base = chain.copy()
 
-        size = self.end.assign(chain)
+        self.end.assign(chain)
+        result.append(chain)
 
         # Add additional array elements as copies.
         if array_length is not None:
             assert copy_base is not None
             for _ in range(array_length - 1):
-                size += self.end.assign(copy_base.copy())
+                inst = copy_base.copy()
+                self.end.assign(inst)
+                result.append(inst)
 
-        return size
+        return result

runtimepy/primitives/types/bounds.py

@@ -4,6 +4,7 @@ bounds (based on bit width).
 """
 
 # built-in
+from random import randint
 from typing import NamedTuple
 
 
@@ -13,6 +14,10 @@ class IntegerBounds(NamedTuple):
     min: int
     max: int
 
+    def random(self) -> int:
+        """Get a random integer."""
+        return randint(self.min, self.max)
+
     def validate(self, val: int) -> bool:
         """Determine if the value is within bounds."""
         return self.min <= val <= self.max

{runtimepy-5.10.2.dist-info → runtimepy-5.11.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.10.2
+Version: 5.11.1
 Summary: A framework for implementing Python services.
 Home-page: https://github.com/vkottler/runtimepy
 Author: Vaughn Kottler
@@ -18,10 +18,10 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: psutil
-Requires-Dist: websockets
-Requires-Dist: aiofiles
 Requires-Dist: vcorelib>=3.5.1
+Requires-Dist: aiofiles
 Requires-Dist: svgen>=0.7.4
+Requires-Dist: websockets
 Provides-Extra: test
 Requires-Dist: pylint; extra == "test"
 Requires-Dist: flake8; extra == "test"
@@ -50,11 +50,11 @@ Dynamic: requires-python
     =====================================
     generator=datazen
     version=3.1.4
-    hash=887650b5b88ff596b3ab067e01de6fbd
+    hash=4ef876633bf905b103835e81db45e721
     =====================================
 -->
 
-# runtimepy ([5.10.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.11.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/vkottler/runtimepy/workflows/Python%20Package/badge.svg)

{runtimepy-5.10.2.dist-info → runtimepy-5.11.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-runtimepy/__init__.py,sha256=UgkSoIgawdI6UkjuTTg7IIFglX0-IDgjuWRujjVjW_s,391
+runtimepy/__init__.py,sha256=jnVk66eyyfxqRlrnXybadQhrpwK0h8K50mULrq-N3xg,391
 runtimepy/__main__.py,sha256=OPAed6hggoQdw-6QAR62mqLC-rCkdDhOq0wyeS2vDRI,332
 runtimepy/app.py,sha256=sTvatbsGZ2Hdel36Si_WUbNMtg9CzsJyExr5xjIcxDE,970
 runtimepy/dev_requirements.txt,sha256=j0dh11ztJAzfaUL0iFheGjaZj9ppDzmTkclTT8YKO8c,230
@@ -11,23 +11,23 @@ runtimepy/util.py,sha256=GuyIHVFGMS02OR6-O3LnlV3DqG5hj4-IUud0QM6WicA,1684
 runtimepy/channel/__init__.py,sha256=pf0RJ5g37_FVV8xoUNgzFGuIfbZEYSBA_cQlJSDTPDo,4774
 runtimepy/channel/registry.py,sha256=nk36qM_Bf6qK6AFR0plaZHR1PU7b4LZqbQ0feJqk4lc,4784
 runtimepy/channel/environment/__init__.py,sha256=0Jj8g7Y4bdDvmWtzpegB9D4milGPhsZokoYxmps5zgU,1612
-runtimepy/channel/environment/array.py,sha256=D5lm8VyPiNghkb7vdwTLTqPmSyWunYEzT8Kq9zvgwRw,3728
+runtimepy/channel/environment/array.py,sha256=f9cWaYsRXUw8qE629h6jQxbYKDpOwC2GLBo4QaMa1JM,3748
 runtimepy/channel/environment/base.py,sha256=tpD_6OHJv1bpfXmfFCNckoNo8ATOOi-XX66NQrkSNYU,14331
 runtimepy/channel/environment/create.py,sha256=DHjoNmzZsARjfB_CfutXQ1PDdxPETi6yQoRMhM0FbwA,5319
 runtimepy/channel/environment/file.py,sha256=PV05KZ3-CvftbKUM8acQmawOMeGGCcMrEESEBuymykg,6949
 runtimepy/channel/environment/sample.py,sha256=Geinp2Q_qYkzYKpUJroepv6A4JWypUnAPl57jn_r_R4,4976
-runtimepy/channel/environment/telemetry.py,sha256=tw7SLfWHTwCT8hXBzsIVvj546MDsVAtiqDgLZXhCKJ4,5356
+runtimepy/channel/environment/telemetry.py,sha256=3A7Xcp-4eHJWz_oR1SnI6rsl4o8wiSUaiMHrnK1IaQ8,5338
 runtimepy/channel/environment/command/__init__.py,sha256=mymqk5roA-7evUovXlD2dmWaprSzrPb_3ae6bA9oEZ0,8162
 runtimepy/channel/environment/command/parser.py,sha256=cMOsEsXnfFlATiWTNSxlgvc_XoICsJlcZigFJlQ47tk,1804
 runtimepy/channel/environment/command/processor.py,sha256=NiiWRdwBHOFEisjqNOW5oawprxcpR25ONNABoZpELdg,7122
 runtimepy/channel/environment/command/result.py,sha256=Ko5lK4d04Z266WuCi2sHQItbUHJFYv7qUdrDi-OVKOU,624
-runtimepy/channel/event/__init__.py,sha256=eEtubsqiqP8DqZbju3XHvG3_xHtrPIBlb8HgYyITSrk,2799
+runtimepy/channel/event/__init__.py,sha256=9LCSNa1Iiwr6Q6JkwQGELDQ7rWfU_xjAMh6qM1I-ueM,2793
 runtimepy/channel/event/header.py,sha256=eDRZgzzM5HZQ8QtV4DjyAsrAhEZyM7IfwqK6WB5ACEw,868
 runtimepy/codec/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-runtimepy/codec/protocol/__init__.py,sha256=e2tNBytsAc-hwhYhV_7UEHLyqXew1RMTcNe5DZGGFWk,1462
-runtimepy/codec/protocol/base.py,sha256=-BzSteAAG1XmKFztgUwOdMACztQ1YGSzwe_AM22V1kI,8971
-runtimepy/codec/protocol/json.py,sha256=pnj3UFmlXDjXzEa-l9jD6UhxsDA0aTnXhh8uIdBKhYg,4107
-runtimepy/codec/system/__init__.py,sha256=M9rIw0RvVGwz4JQhxbGWynUUE4H4L5HwJfXa5vI0CS8,6939
+runtimepy/codec/protocol/__init__.py,sha256=Rg7RSKGn2UBpGMpwq1aCLUBA5h4pORdh53NfR7Cjw0U,1530
+runtimepy/codec/protocol/base.py,sha256=NRLB1ld0oB2IED5QRkwDwYsnHFG8gKtg3T7OHJ9_VkQ,10432
+runtimepy/codec/protocol/json.py,sha256=oiaJLCzptJ5uajnpO8EDYET8gIspZIrVuyLjLuAC5dw,4142
+runtimepy/codec/system/__init__.py,sha256=1Yy4RkNoh8tf6MTKZO1EszlCnE6jTevN2du4LU_-vxw,6933
 runtimepy/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 runtimepy/commands/all.py,sha256=jH2dsmkqyBFe_2ZlPFpko0UCMW3fFfJsuGIbeJFbDoQ,1619
 runtimepy/commands/arbiter.py,sha256=CtTMRYpqCAN3vWHkkr9jqWpoF7JGNXafKIBFmkarAfc,1567
@@ -222,7 +222,7 @@ runtimepy/net/udp/connection.py,sha256=Hv963vT9tnglpZOx4KUFuoYTBPr2rltYQWDNV3mhY
 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=zDVUga9ZApSnvx8UwlmVUY4SDFrAHafcD9oe5Q7fGOw,9012
+runtimepy/net/udp/tftp/__init__.py,sha256=lR8_bFo8ECHMQygWsmbnNpsLqmwu6818k-cjKRE57yk,8983
 runtimepy/net/udp/tftp/base.py,sha256=vpvjitZSD8R4Ggb21eIMNIsm54VkLBbBrTgMo65gn2o,11331
 runtimepy/net/udp/tftp/endpoint.py,sha256=so60LdPTG66N5tdhHhiX7j_TBHvNOTi4JIgLcg2MAm0,10890
 runtimepy/net/udp/tftp/enums.py,sha256=06juMd__pJZsyL8zO8p3hRucnOratt1qtz9zcxzMg4s,1579
@@ -232,27 +232,27 @@ runtimepy/net/websocket/connection.py,sha256=BMR58bLpHuulCdbLGnmMdFJOF53wVxYcUe5
 runtimepy/noise/__init__.py,sha256=EJM7h3t_z74wwrn6FAFQwYE2yUcOZQ1K1IQqOb8Z0AI,384
 runtimepy/primitives/__init__.py,sha256=nwWJH1e0KN2NsVwQ3wvRtUpl9s9Ap8Q32NNZLGol0wU,2323
 runtimepy/primitives/base.py,sha256=BaGPUTeVMnLnTPcpjqnS2lzPN74Pe5C0XaQdgrTfW7A,9185
-runtimepy/primitives/bool.py,sha256=c-IRpVZ84m-pOreCHC382tOW0NFKEwSTiEeXAtlJjvk,1243
+runtimepy/primitives/bool.py,sha256=lATPgb1e62rjLn5XlJX8lP3tVYR3DlxV8RT9HpOMdT0,1640
 runtimepy/primitives/byte_order.py,sha256=80mMk1Sj_l49XvAtvrPmoYFpFYSM1HgYuwR2-P7os3Q,767
 runtimepy/primitives/evaluation.py,sha256=0N7mT8uoiJaY-coF2PeEXU2WO-FmbyN2Io9_EaghO9Q,4657
-runtimepy/primitives/float.py,sha256=aeEsj0xRJM57Hcv04OtLfT_sTBocZldbn19HpQq3Hxs,1946
-runtimepy/primitives/int.py,sha256=OSJ5_lPrzJfLMDssMQHSbB0PzuqQRvCtJSRen7G9QBc,3352
+runtimepy/primitives/float.py,sha256=6vzNKnnLzzM4vP10V4E0PHZQH6vTvIl34pId1oFtlqc,2146
+runtimepy/primitives/int.py,sha256=Ia2vtzXXfBb8fj1mgwu_PFpblrL2qzsN4Qwjvk5NhT4,3618
 runtimepy/primitives/scaling.py,sha256=Vtxp2CSBahqPp4i2-IS4wjbcC023xwf-dqZMbYWf3V4,1144
 runtimepy/primitives/string.py,sha256=ic5VKhXCSIwEOUfqIb1VUpZPwjdAcBul-cLLIihVkQI,2532
-runtimepy/primitives/array/__init__.py,sha256=qPH8SN8vqRZR-J3OZsm-46tKqfnXpGLb1lw9Jni1udI,8362
+runtimepy/primitives/array/__init__.py,sha256=ZVJt4810hTFYMdolY_R75lRRHHaNKxZ4comBvuK_69E,8956
 runtimepy/primitives/field/__init__.py,sha256=iHZSQBozMpfiv_5KE_GIX1FAvDB9unUO0xmWZHiA_Jk,4491
 runtimepy/primitives/field/fields.py,sha256=jDNi1tl2Xc3GBmt6QJuqxbhP8MtxgertGbPFmDXa7b4,7481
 runtimepy/primitives/field/manager/__init__.py,sha256=BCRi6-_5OOJ8kz78JHkiLp8cZ71KA1uiF2zq5FFe9js,2586
 runtimepy/primitives/field/manager/base.py,sha256=EyWs5D9_reKOTLkh8PuW45ySjCh31fY_qrtFIcmIOV4,6914
-runtimepy/primitives/serializable/__init__.py,sha256=mZ8KZe2aQswGL6GTjQ8-IaUQwg-6aUUBP5RXyzR6crc,393
-runtimepy/primitives/serializable/base.py,sha256=piviwBXWV6dvbppaVnH-k1fmgVbE8rHvHvZogb2jsLw,4496
+runtimepy/primitives/serializable/__init__.py,sha256=R9_derxnK1OCaYyqBZA4CCjPkXCBw6InkE8-3Zy75Uk,399
+runtimepy/primitives/serializable/base.py,sha256=EIj7Ao0sZaXCXgZari35kimjkr3SzFWGy3rNjxgsv1E,5727
 runtimepy/primitives/serializable/fixed.py,sha256=rhr6uVbo0Lvazk4fLI7iei-vVNEwP1J8-LoUjW1NaMI,1077
 runtimepy/primitives/serializable/framer.py,sha256=rsoGQz6vD7v_EMu67aqxVqbvmbs6hjytXZ8dHLBM0SQ,1815
 runtimepy/primitives/serializable/prefixed.py,sha256=oQXW0pGRovKolheL5ZL2m9aNVMCtKTAi5OlC9KW0iKI,2855
 runtimepy/primitives/types/__init__.py,sha256=JUJpDFIjDUYo-Jnx5sZnkmbGLVjIHVsRcvBjVlJ7fsA,1588
 runtimepy/primitives/types/base.py,sha256=rR1JkExMV2FJmvU-WfgnikG-UtFfsXGs_eBCIV6II1A,4879
 runtimepy/primitives/types/bool.py,sha256=J0SYdp-9eIRs337d9qnw2f7IXTPQj_F21ugMIJ8-Hy4,547
-runtimepy/primitives/types/bounds.py,sha256=zLUR-hVD_M6RfpGBnLEmhm_vajsBF04V9-sVvPUTAz8,1009
+runtimepy/primitives/types/bounds.py,sha256=Hc2GWu4qJMEAF8IiDWFA_6VCNUtrNf5RmiEbSJ76dJI,1145
 runtimepy/primitives/types/float.py,sha256=yjiU1AGzekY8PjDcLNdoXMGDsdP5aDYWjLb3_RntRpA,1388
 runtimepy/primitives/types/int.py,sha256=Gjro7RgPL1girVVXhvDErvRwxlfHclMr7tZEFYj-Uj4,3807
 runtimepy/registry/__init__.py,sha256=NpMxvdmjRtE3jCCOuYU_CPpYWqCZ5byXWhJNTB6jZUk,3425
@@ -285,9 +285,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.10.2.dist-info/licenses/LICENSE,sha256=yKBRwbO-cOPBrlpsZmJkkSa33DfY31aE8t7lZ0DwlUo,1071
-runtimepy-5.10.2.dist-info/METADATA,sha256=IOAwfPX8fSot0nOILOJsicLv4Go7fAl6DBQYl7qj-rQ,9395
-runtimepy-5.10.2.dist-info/WHEEL,sha256=DK49LOLCYiurdXXOXwGJm6U4DkHkg4lcxjhqwRa0CP4,91
-runtimepy-5.10.2.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
-runtimepy-5.10.2.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
-runtimepy-5.10.2.dist-info/RECORD,,
+runtimepy-5.11.1.dist-info/licenses/LICENSE,sha256=yKBRwbO-cOPBrlpsZmJkkSa33DfY31aE8t7lZ0DwlUo,1071
+runtimepy-5.11.1.dist-info/METADATA,sha256=nTdV1gy7arFtuBI5Y-yZvzR5mao4DJwlu2dgKv14ra4,9395
+runtimepy-5.11.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+runtimepy-5.11.1.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
+runtimepy-5.11.1.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
+runtimepy-5.11.1.dist-info/RECORD,,

{runtimepy-5.10.2.dist-info → runtimepy-5.11.1.dist-info}/WHEEL

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