runtimepy 4.3.2__tar.gz → 4.3.4__tar.gz

{runtimepy-4.3.2/runtimepy.egg-info → runtimepy-4.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runtimepy
-Version: 4.3.2
+Version: 4.3.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: psutil
-Requires-Dist: svgen>=0.6.6
 Requires-Dist: vcorelib>=3.2.4
+Requires-Dist: svgen>=0.6.6
+Requires-Dist: psutil
 Requires-Dist: websockets
 Provides-Extra: test
 Requires-Dist: pylint; extra == "test"
@@ -44,11 +44,11 @@ Requires-Dist: uvloop; (sys_platform != "win32" and sys_platform != "cygwin") an
     =====================================
     generator=datazen
     version=3.1.4
-    hash=8ff56133d99744aa32cb4ab0d35d6e3b
+    hash=8493c89e5bc292ec916531e976a8ef4b
     =====================================
 -->
 
-# runtimepy ([4.3.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([4.3.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-4.3.2 → runtimepy-4.3.4}/README.md

@@ -2,11 +2,11 @@
     =====================================
     generator=datazen
     version=3.1.4
-    hash=8ff56133d99744aa32cb4ab0d35d6e3b
+    hash=8493c89e5bc292ec916531e976a8ef4b
     =====================================
 -->
 
-# runtimepy ([4.3.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([4.3.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-4.3.2 → runtimepy-4.3.4}/pyproject.toml

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

{runtimepy-4.3.2 → runtimepy-4.3.4}/runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.1.4
-# hash=6ec64992e5ab710e4c5fd007b9455747
+# hash=4b36271c7cf8f3a37607064170703e42
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "4.3.2"
+VERSION = "4.3.4"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

{runtimepy-4.3.2 → runtimepy-4.3.4}/runtimepy/data/factories.yaml

@@ -6,6 +6,9 @@ factories:
   - {name: runtimepy.net.factories.UdpJson}
   - {name: runtimepy.net.factories.WebsocketJson}
 
+  # Queue wrappers.
+  - {name: runtimepy.net.factories.UdpQueue}
+
   # Echo and null connections (useful for testing and debugging).
   - {name: runtimepy.net.factories.TcpEcho, namespaces: [tcp, echo]}
   - {name: runtimepy.net.factories.UdpEcho, namespaces: [udp, echo]}

{runtimepy-4.3.2 → runtimepy-4.3.4}/runtimepy/net/factories/__init__.py

@@ -31,6 +31,7 @@ from runtimepy.net.tcp.http import HttpConnection
 from runtimepy.net.udp import (
     EchoUdpConnection,
     NullUdpConnection,
+    QueueUdpConnection,
     UdpConnection,
 )
 from runtimepy.net.websocket import (
@@ -93,6 +94,12 @@ class UdpJson(UdpConnectionFactory[UdpJsonMessageConnection]):
     kind = UdpJsonMessageConnection
 
 
+class UdpQueue(UdpConnectionFactory[QueueUdpConnection]):
+    """UDP queue-connection factory."""
+
+    kind = QueueUdpConnection
+
+
 class TcpEcho(TcpConnectionFactory[EchoTcpConnection]):
     """TCP echo-connection factory."""
 

{runtimepy-4.3.2 → runtimepy-4.3.4}/runtimepy/net/udp/__init__.py

@@ -8,5 +8,11 @@ from runtimepy.net.udp.connection import (
     NullUdpConnection,
     UdpConnection,
 )
+from runtimepy.net.udp.queue import QueueUdpConnection
 
-__all__ = ["UdpConnection", "EchoUdpConnection", "NullUdpConnection"]
+__all__ = [
+    "UdpConnection",
+    "EchoUdpConnection",
+    "NullUdpConnection",
+    "QueueUdpConnection",
+]

{runtimepy-4.3.2 → runtimepy-4.3.4}/runtimepy/net/udp/connection.py

@@ -9,6 +9,7 @@ from contextlib import suppress as _suppress
 from logging import getLogger as _getLogger
 import socket as _socket
 from typing import Any as _Any
+from typing import Optional as _Optional
 from typing import TypeVar as _TypeVar
 from typing import Union as _Union
 
@@ -37,6 +38,9 @@ class UdpConnection(_Connection, _TransportMixin):
     uses_text_tx_queue = False
     uses_binary_tx_queue = False
 
+    # Simplify talkback implementations.
+    latest_rx_address: _Optional[tuple[str, int]]
+
     def __init__(
         self, transport: _DatagramTransport, protocol: UdpQueueProtocol
     ) -> None:
@@ -54,6 +58,7 @@ class UdpConnection(_Connection, _TransportMixin):
 
         # Store connection-instantiation arguments.
         self._conn_kwargs: dict[str, _Any] = {}
+        self.latest_rx_address = None
 
     def _set_protocol(self, protocol: UdpQueueProtocol) -> None:
         """Set a protocol instance for this connection."""
@@ -188,6 +193,7 @@ class UdpConnection(_Connection, _TransportMixin):
 
                 if message is not None:
                     data = message[0]
+                    self.latest_rx_address = message[1]
                     result = await self.process_datagram(data, message[1])
                     self.metrics.rx.increment(len(data))
 

runtimepy-4.3.4/runtimepy/net/udp/queue.py

@@ -0,0 +1,28 @@
+"""
+A module implementing a simple queue-based UDP interface.
+"""
+
+# built-in
+from asyncio import Queue
+
+# internal
+from runtimepy.net.udp.connection import UdpConnection
+
+DatagramQueue = Queue[tuple[bytes, tuple[str, int]]]
+
+
+class QueueUdpConnection(UdpConnection):
+    """An echo connection for UDP."""
+
+    datagrams: DatagramQueue
+
+    def init(self) -> None:
+        """Initialize this instance."""
+        self.datagrams = Queue()
+
+    async def process_datagram(
+        self, data: bytes, addr: tuple[str, int]
+    ) -> bool:
+        """Process a datagram."""
+        self.datagrams.put_nowait((data, addr))
+        return True

{runtimepy-4.3.2 → runtimepy-4.3.4/runtimepy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runtimepy
-Version: 4.3.2
+Version: 4.3.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: psutil
-Requires-Dist: svgen>=0.6.6
 Requires-Dist: vcorelib>=3.2.4
+Requires-Dist: svgen>=0.6.6
+Requires-Dist: psutil
 Requires-Dist: websockets
 Provides-Extra: test
 Requires-Dist: pylint; extra == "test"
@@ -44,11 +44,11 @@ Requires-Dist: uvloop; (sys_platform != "win32" and sys_platform != "cygwin") an
     =====================================
     generator=datazen
     version=3.1.4
-    hash=8ff56133d99744aa32cb4ab0d35d6e3b
+    hash=8493c89e5bc292ec916531e976a8ef4b
     =====================================
 -->
 
-# runtimepy ([4.3.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([4.3.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-4.3.2 → runtimepy-4.3.4}/runtimepy.egg-info/SOURCES.txt

@@ -184,6 +184,7 @@ runtimepy/net/udp/__init__.py
 runtimepy/net/udp/connection.py
 runtimepy/net/udp/create.py
 runtimepy/net/udp/protocol.py
+runtimepy/net/udp/queue.py
 runtimepy/net/websocket/__init__.py
 runtimepy/net/websocket/connection.py
 runtimepy/primitives/__init__.py