bmdwire 1.5.2__tar.gz → 1.5.4__tar.gz

{bmdwire-1.5.2/bmdwire.egg-info → bmdwire-1.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bmdwire
-Version: 1.5.2
+Version: 1.5.4
 Summary: Python libraries for Blackmagic Design broadcast devices: ATEM switchers, HyperDeck recorders, Ultimatte keyers and Videohub routers
 Author: Lucas Romanenko, Martijn Braam and the OpenAtem contributors
 License-Expression: LGPL-3.0-only AND MIT
@@ -49,7 +49,7 @@ pip install bmdwire
 | **`ultimattewire`** | Ultimatte 12 keyers: archive and restore over the native TCP protocol, Smart Remote 4 compatible zips | MIT | [ultimattewire/README.md](ultimattewire/README.md) |
 | **`videohubwire`** | Videohub routers: state snapshot, crosspoint routing, labels over TCP 9990 | MIT | [videohubwire/README.md](videohubwire/README.md) |
 
-All four are pure standard library except atemwire, whose small C extension ships prebuilt for Linux, macOS and Windows on CPython 3.10 to 3.14, so installing needs no compiler. Pin the version in a requirements file (`bmdwire==1.5.2`) so a later release cannot change your install under you.
+All four are pure standard library except atemwire, whose small C extension ships prebuilt for Linux, macOS and Windows on CPython 3.10 to 3.14, so installing needs no compiler. Pin the version in a requirements file (`bmdwire==1.5.4`) so a later release cannot change your install under you.
 
 ## atemwire stands on pyatem
 

{bmdwire-1.5.2 → bmdwire-1.5.4}/README.md

@@ -15,7 +15,7 @@ pip install bmdwire
 | **`ultimattewire`** | Ultimatte 12 keyers: archive and restore over the native TCP protocol, Smart Remote 4 compatible zips | MIT | [ultimattewire/README.md](ultimattewire/README.md) |
 | **`videohubwire`** | Videohub routers: state snapshot, crosspoint routing, labels over TCP 9990 | MIT | [videohubwire/README.md](videohubwire/README.md) |
 
-All four are pure standard library except atemwire, whose small C extension ships prebuilt for Linux, macOS and Windows on CPython 3.10 to 3.14, so installing needs no compiler. Pin the version in a requirements file (`bmdwire==1.5.2`) so a later release cannot change your install under you.
+All four are pure standard library except atemwire, whose small C extension ships prebuilt for Linux, macOS and Windows on CPython 3.10 to 3.14, so installing needs no compiler. Pin the version in a requirements file (`bmdwire==1.5.4`) so a later release cannot change your install under you.
 
 ## atemwire stands on pyatem
 

{bmdwire-1.5.2 → bmdwire-1.5.4}/atemwire/docs/SURFACE.md

@@ -1095,6 +1095,24 @@ it; item 27 was fixed after 1.5.1.
     queued at the release, and its next request goes out at once, beside another client's,
     aborting it as before. *Fixed in `1b30449`:* every per-frame release starts the wait, after an
     FTDE 6 too, and so does any client's announced release.
+28. **The UDP thread can wait on itself for good** (1.5.0). `thread_queue` is a `SocketQueue`:
+    each put writes a byte to a socketpair (278 fit on Linux) that only the UDP thread reads.
+    `drain_queue` puts a whole upload budget, up to 768 chunks, at once, and the UDP thread queued
+    its own packets too, the ACK for every reliable packet received among them. A packet arriving
+    mid-budget (another session's lock or transfer broadcast, say) left both threads waiting in
+    `SocketQueue.put` for good: the upload stops, and a caller's timeout never runs if its pump is
+    the protocol thread. *Fixed in `81955c1`:* what the UDP thread sends goes to the socket at once.
+29. **A caller's Wakeup runs the trigger in every yield** (1.5.2). `_service_yields` ran on
+    every `Wakeup`, a caller's included, and triggered each store with work queued before its
+    turn was due: two INFO lines per `Wakeup`, 100 a second under WebATEM's pump. *Fixed in
+    `81955c1`:* the trigger runs once the turn is due; before it, the protocol only wakes for the
+    due time again.
+30. **A receive buffer size the system refuses fails the connect** (1.5.3). `UdpProtocol` asked
+    for a 16 MB `SO_RCVBUF` with a bare `setsockopt`. Linux caps the request silently and Windows
+    takes it, but macOS 12 refuses anything above `kern.ipc.maxsockbuf` with errno 55
+    (`ENOBUFS`): the constructor raised, and no switcher could be connected from that system.
+    *Fixed in `c08f830`:* the request steps down 16, 8, 4, 1 MB and keeps the first size taken,
+    or the system's default if it takes none.
 
 ## Counts
 

{bmdwire-1.5.2 → bmdwire-1.5.4}/atemwire/protocol.py

@@ -992,12 +992,22 @@ class AtemProtocol:
 
     def _service_yields(self):
         """Ask for each store we left free whose yield is over; forget a
-        yield that is over with nothing waiting on it."""
+        yield that is over with nothing waiting on it. A Wakeup comes from
+        callers too (WebATEM's pump sends one every 20 ms): a yield not yet
+        over is only woken for again, its time perhaps moved by someone at
+        work, so the trigger runs once per turn, not once per tick."""
+        now = time.monotonic()
         for store in list(self._yielding):
+            due = self._yield_due(store)
             if not self.transfer_queue.get(store):
-                if time.monotonic() >= self._yield_due(store):
+                if now >= due:
                     del self._yielding[store]
-            elif not self.transfer_requested and not self.locks.get(store):
+            elif (self.transfer_requested or self.locks.get(store)
+                    or store in self._foreign_held):
+                continue                         # their release asks for us
+            elif now < due:
+                self._wake_at(due)
+            else:
                 self._transfer_trigger(store)
 
     def _transfer_trigger(self, store, retry=False):

{bmdwire-1.5.2 → bmdwire-1.5.4}/atemwire/transport.py

@@ -312,7 +312,13 @@ class UdpProtocol(BaseProtocol):
 
         self.sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
         self.sock.settimeout(self.timeout)
-        self.sock.setsockopt(socket.SOL_SOCKET, socket.SO_RCVBUF, 1024 * 1024 * 16)
+        # macOS refuses more than kern.ipc.maxsockbuf with errno 55 (ENOBUFS) instead of capping.
+        for megabytes in (16, 8, 4, 1):
+            try:
+                self.sock.setsockopt(socket.SOL_SOCKET, socket.SO_RCVBUF, 1024 * 1024 * megabytes)
+                break
+            except OSError:
+                pass
         try:
             # Room for an upload budget sent back to back (768 chunks of
             # ~1.4 KB); the system may cap it lower, which is fine.
@@ -496,27 +502,12 @@ class UdpProtocol(BaseProtocol):
                 elif queue is self.thread_queue:
                     item = queue.get()
                     if item is None:
-                        # Defensive: tolerate a stray wake sentinel on the
-                        # send queue (no current producer).
+                        # wake_at's sentinel: select() returned, so the
+                        # next one takes the new timeout.
                         continue
                     try:
-                        self._send_packet_low(item)
+                        self._send_on_udp_thread(item)
                     except OSError as e:
-                        if e.errno in TRANSIENT_SEND_ERRNOS:
-                            # A momentary network hiccup (VPN blip, ICMP
-                            # unreachable burst, full socket buffer) must
-                            # not kill the transport thread: a dead thread
-                            # leaves a zombie connection whose worker
-                            # blocks forever while is_connected stays True
-                            # and send() silently drops (2026-07-06).
-                            # Only an ACK or a handshake packet gets here:
-                            # a reliable one keeps its sequence number in
-                            # _send_packet_low and is resent. ACKs go out
-                            # again with the next packet.
-                            self.log.error(
-                                f"Transient send error (packet dropped, "
-                                f"thread stays up): {e}")
-                            continue
                         self.log.error(e)
                         # Queue a None to signal the socket died
                         self.thread_recv_queue.put(None)
@@ -525,8 +516,34 @@ class UdpProtocol(BaseProtocol):
                     self.thread_recv_queue.put(None)
                     raise RuntimeError("Unexpected result from select()")
 
+    def _send_on_udp_thread(self, packet):
+        try:
+            self._send_packet_low(packet)
+        except OSError as e:
+            if e.errno not in TRANSIENT_SEND_ERRNOS:
+                raise
+            # A momentary network hiccup (VPN blip, ICMP unreachable
+            # burst, full socket buffer) must not kill the transport
+            # thread: a dead thread leaves a zombie connection whose
+            # worker blocks forever while is_connected stays True and
+            # send() silently drops (2026-07-06). Only an ACK or a
+            # handshake packet gets here: a reliable one keeps its
+            # sequence number in _send_packet_low and is resent. ACKs go
+            # out again with the next packet.
+            self.log.error(
+                f"Transient send error (packet dropped, thread stays up): {e}")
+
     def _send_packet(self, packet):
-        self.thread_queue.put(packet)
+        if threading.current_thread() is self.thread:
+            # The UDP thread is thread_queue's only reader, and a put waits
+            # while the socketpair under it is full: a few hundred entries,
+            # fewer than an upload budget drain_queue puts at once. Its own
+            # packets (the ACK for each reliable packet received, a SYN
+            # after a timeout) queued behind a budget had it wait on itself
+            # for good, and the upload with it (2026-10-15). They go now.
+            self._send_on_udp_thread(packet)
+        else:
+            self.thread_queue.put(packet)
         self.packet_success += 1
 
     def close_session(self):
@@ -853,8 +870,9 @@ class UdpProtocol(BaseProtocol):
         protocol's timed work, which its packets alone can't drive (the
         switcher's pings never reach it). The earliest of several wins."""
         with self._wake_lock:
-            if self._wake_due is None or when < self._wake_due:
-                self._wake_due = when
+            if self._wake_due is not None and self._wake_due <= when:
+                return                           # select() wakes sooner anyway
+            self._wake_due = when
         self.thread_queue.put(None)              # select() takes the new timeout
 
     def _fire_wake(self):

{bmdwire-1.5.2 → bmdwire-1.5.4/bmdwire.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bmdwire
-Version: 1.5.2
+Version: 1.5.4
 Summary: Python libraries for Blackmagic Design broadcast devices: ATEM switchers, HyperDeck recorders, Ultimatte keyers and Videohub routers
 Author: Lucas Romanenko, Martijn Braam and the OpenAtem contributors
 License-Expression: LGPL-3.0-only AND MIT
@@ -49,7 +49,7 @@ pip install bmdwire
 | **`ultimattewire`** | Ultimatte 12 keyers: archive and restore over the native TCP protocol, Smart Remote 4 compatible zips | MIT | [ultimattewire/README.md](ultimattewire/README.md) |
 | **`videohubwire`** | Videohub routers: state snapshot, crosspoint routing, labels over TCP 9990 | MIT | [videohubwire/README.md](videohubwire/README.md) |
 
-All four are pure standard library except atemwire, whose small C extension ships prebuilt for Linux, macOS and Windows on CPython 3.10 to 3.14, so installing needs no compiler. Pin the version in a requirements file (`bmdwire==1.5.2`) so a later release cannot change your install under you.
+All four are pure standard library except atemwire, whose small C extension ships prebuilt for Linux, macOS and Windows on CPython 3.10 to 3.14, so installing needs no compiler. Pin the version in a requirements file (`bmdwire==1.5.4`) so a later release cannot change your install under you.
 
 ## atemwire stands on pyatem
 

{bmdwire-1.5.2 → bmdwire-1.5.4}/pyproject.toml

@@ -13,7 +13,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bmdwire"
-version = "1.5.2"
+version = "1.5.4"
 description = "Python libraries for Blackmagic Design broadcast devices: ATEM switchers, HyperDeck recorders, Ultimatte keyers and Videohub routers"
 readme = "README.md"
 # atemwire is a fork of pyatem and stays LGPL-3.0-only; the other three were