vnode 0.1.7__tar.gz → 0.1.10__tar.gz

{vnode-0.1.7 → vnode-0.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vnode
-Version: 0.1.7
+Version: 0.1.10
 Summary: Virtual Meshtastic node using mudp transport and meshdb storage.
 License-Expression: GPL-3.0-only
 License-File: LICENSE
@@ -17,7 +17,7 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: cryptography (>=43,<45)
 Requires-Dist: meshdb (>=0.1.9)
 Requires-Dist: meshtastic (>=2.7,<3.0)
-Requires-Dist: mudp (>=1.1.0)
+Requires-Dist: mudp (>=1.1.5)
 Project-URL: Homepage, https://github.com/pdxlocations/vnode
 Project-URL: Issues, https://github.com/pdxlocations/vnode/issues
 Description-Content-Type: text/markdown
@@ -106,6 +106,10 @@ Supported `VirtualNode` calls:
 - MeshInterface-compatible sends: `sendText()`, `sendAlert()`, `sendData()`, `sendPosition()`
 - Packet helpers: `is_direct_message_for_me()`, `is_text_message()`, `get_text_message()`, `reply_to_packet()`
 
+`receive(callback)` is deduplicated. Repeated multicast copies stay on `mudp`'s wire-level
+topics, while `vnode` publishes `meshtastic.receive` from `mesh.rx.unique_packet` so
+application callbacks run once per logical packet.
+
 ## Examples
 
 Use these as small runnable references for common tasks:
@@ -117,7 +121,7 @@ Use these as small runnable references for common tasks:
 - `examples/serial_or_vnode.py`: try a serial Meshtastic node first, then fall back to `VirtualNode`
 - `examples/send_dm.py`: minimal one-shot direct-message sender
 - `examples/library_embed.py`: minimal application-style embedding example using `VirtualNode` directly
-- `examples/watch_reliability.py`: watcher for ACK, NAK, retry, and retransmit-failure events
+- `examples/watch_reliability.py`: watcher for unique ACK, NAK, retry, and retransmit-failure events
 
 ```bash
 .venv/bin/python examples/autoresponder.py

{vnode-0.1.7 → vnode-0.1.10}/README.md

@@ -82,6 +82,10 @@ Supported `VirtualNode` calls:
 - MeshInterface-compatible sends: `sendText()`, `sendAlert()`, `sendData()`, `sendPosition()`
 - Packet helpers: `is_direct_message_for_me()`, `is_text_message()`, `get_text_message()`, `reply_to_packet()`
 
+`receive(callback)` is deduplicated. Repeated multicast copies stay on `mudp`'s wire-level
+topics, while `vnode` publishes `meshtastic.receive` from `mesh.rx.unique_packet` so
+application callbacks run once per logical packet.
+
 ## Examples
 
 Use these as small runnable references for common tasks:
@@ -93,7 +97,7 @@ Use these as small runnable references for common tasks:
 - `examples/serial_or_vnode.py`: try a serial Meshtastic node first, then fall back to `VirtualNode`
 - `examples/send_dm.py`: minimal one-shot direct-message sender
 - `examples/library_embed.py`: minimal application-style embedding example using `VirtualNode` directly
-- `examples/watch_reliability.py`: watcher for ACK, NAK, retry, and retransmit-failure events
+- `examples/watch_reliability.py`: watcher for unique ACK, NAK, retry, and retransmit-failure events
 
 ```bash
 .venv/bin/python examples/autoresponder.py

{vnode-0.1.7 → vnode-0.1.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vnode"
-version = "0.1.7"
+version = "0.1.10"
 description = "Virtual Meshtastic node using mudp transport and meshdb storage."
 authors = [
     {name = "Ben Lipsey",email = "ben@pdxlocations.com"}
@@ -12,7 +12,7 @@ dependencies = [
   "cryptography>=43,<45",
   "meshdb>=0.1.9",
   "meshtastic>=2.7,<3.0",
-  "mudp>=1.1.0",
+  "mudp>=1.1.5",
 ]
 
 [project.urls]

{vnode-0.1.7 → vnode-0.1.10}/vnode/vnode/runtime.py

@@ -63,7 +63,10 @@ def resolve_role(value: Union[str, int]) -> int:
 
 
 class VirtualNode:
+    RAW_PACKET_TOPIC = "mesh.rx.packet"
     PACKET_TOPIC = "mesh.rx.unique_packet"
+    ACK_TOPIC = "mesh.rx.ack"
+    NAK_TOPIC = "mesh.rx.nak"
     DUPLICATE_TOPIC = "mesh.rx.duplicate"
     RECEIVE_TOPIC = "meshtastic.receive"
 
@@ -142,11 +145,11 @@ class VirtualNode:
     def start(self) -> None:
         if self.stream is not None:
             return
-        pub.subscribe(self._handle_raw_packet, "mesh.rx.packet")
+        pub.subscribe(self._handle_raw_packet, self.RAW_PACKET_TOPIC)
         pub.subscribe(self._handle_unique_packet, self.PACKET_TOPIC)
         pub.subscribe(self._handle_compat_response_packet, self.RECEIVE_TOPIC)
-        pub.subscribe(self._handle_compat_ack, "mesh.rx.ack")
-        pub.subscribe(self._handle_compat_nak, "mesh.rx.nak")
+        pub.subscribe(self._handle_compat_ack, self.ACK_TOPIC)
+        pub.subscribe(self._handle_compat_nak, self.NAK_TOPIC)
         self.stream = UDPPacketStream(
             self.config.udp.mcast_group,
             int(self.config.udp.mcast_port),
@@ -169,7 +172,7 @@ class VirtualNode:
             self.stream.stop()
             self.stream = None
         try:
-            pub.unsubscribe(self._handle_raw_packet, "mesh.rx.packet")
+            pub.unsubscribe(self._handle_raw_packet, self.RAW_PACKET_TOPIC)
         except KeyError:
             pass
         try:
@@ -178,8 +181,8 @@ class VirtualNode:
             pass
         for topic, listener in (
             (self.RECEIVE_TOPIC, self._handle_compat_response_packet),
-            ("mesh.rx.ack", self._handle_compat_ack),
-            ("mesh.rx.nak", self._handle_compat_nak),
+            (self.ACK_TOPIC, self._handle_compat_ack),
+            (self.NAK_TOPIC, self._handle_compat_nak),
         ):
             try:
                 pub.unsubscribe(listener, topic)
@@ -364,8 +367,13 @@ class VirtualNode:
         if getattr(conn, "socket", None) is None:
             conn.setup_multicast(self.config.udp.mcast_group, int(self.config.udp.mcast_port))
 
-    def send_nodeinfo(self, destination: int = BROADCAST_NUM) -> int:
-        return self._send_nodeinfo(destination)
+    def send_nodeinfo(
+        self,
+        destination: int = BROADCAST_NUM,
+        *,
+        want_response: bool = False,
+    ) -> int:
+        return self._send_nodeinfo(destination, want_response=want_response)
 
     def _send_nodeinfo(
         self,
@@ -373,6 +381,7 @@ class VirtualNode:
         *,
         request_id: Optional[int] = None,
         want_ack: bool = False,
+        want_response: bool = False,
     ) -> int:
         user = mesh_pb2.User(
             id=self.config.node_id,
@@ -389,6 +398,7 @@ class VirtualNode:
         data.payload = user.SerializeToString()
         data.source = self.node_num
         data.dest = int(destination)
+        data.want_response = bool(want_response)
         if request_id is not None:
             data.request_id = int(request_id)
         packet_id = self._send_data(