omq 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d49a1c7caa7a1548615285ae294341b31833fd02bb60a7fa7cbfc0ed5c707d79
-  data.tar.gz: db36537c5dab13faa9cbdbe611c282cbf9dd96726e88145f80c3aaa7bf3df8a5
+  metadata.gz: dd6af0ae414feae27d1119fe4f1144b680e7e039229d512fe2915cd0289fc4dc
+  data.tar.gz: b68f9a321eb93350fc175bd603f8d4c29e23518b6b2dfd2a13072eade5904c8f
 SHA512:
-  metadata.gz: 3e3a9e5a0b9ee3857a2946e7468ea2ca30c87544fa75965c79b1ea905c3a8d969aeb94b49282acd502d2ffbb6a0db5b2952f7a18a17e90363f1c5ed13cfbecd4
-  data.tar.gz: 1cb5f13312278d55684f22c420f17287a922633eebdfd143336415aafdc725dd7a38e23b5f9387cc55bf28acc0b125840c5770ef9112556b97b7c3cca8578ee6
+  metadata.gz: 3e17e9b4d867a7d2972b8caa4eff31dfd3c77095c60e9e5d9fdb53bc2646458dbfff244228065c145f0eb818d32f68bc196a7d0099fa4a5f2f02142f4c9a94b2
+  data.tar.gz: d0a7cc664076ea333433e5e14b5d1701219e4bf15200302cf0ab4420e928d50b2fe8d08d35889d69de6f35f7715b40f423195d33055a67f15af18404ee850536

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.4.1 — 2026-03-27
+
+### Improved
+
+- Explicit flush after `send_message`/`send_command` instead of
+  `minimum_write_size: 0` workaround — enables write buffering
+  (multi-frame messages coalesced into fewer syscalls).
+  **+68% inproc throughput** (145k → 244k msg/s),
+  **-40% inproc latency** (15 → 9 µs)
+
+### Fixed
+
+- Require `async ~> 2.38` for `Promise#wait?` (was `~> 2`)
+
 ## 0.4.0 — 2026-03-27
 
 ### Added (omqcat)

data/README.md

@@ -7,11 +7,11 @@
 
 Pure Ruby implementation of the [ZMTP 3.1](https://rfc.zeromq.org/spec/23/) wire protocol ([ZeroMQ](https://zeromq.org/)) using the [Async](https://github.com/socketry/async) gem. No native libraries required.
 
-> **145k msg/s** inproc | **40k msg/s** ipc | **32k msg/s** tcp
+> **244k msg/s** inproc | **47k msg/s** ipc | **36k msg/s** tcp
 >
-> **15 µs** inproc latency | **62 µs** ipc | **88 µs** tcp
+> **9 µs** inproc latency | **47 µs** ipc | **61 µs** tcp
 >
-> Ruby 4.0 + YJIT on a Linux VM on a 2019 MacBook Pro (Intel) — [223k msg/s with io_uring](bench/README.md#io_uring)
+> Ruby 4.0 + YJIT on a Linux VM on a 2019 MacBook Pro (Intel) — [~340k msg/s with io_uring](bench/README.md#io_uring)
 
 ---
 
@@ -121,19 +121,19 @@ req = ØMQ::REQ.new(">tcp://localhost:5555")
 
 ## Performance
 
-Benchmarked with benchmark-ips on Linux x86_64 (Ruby 4.0.1 +YJIT):
+Benchmarked with benchmark-ips on Linux x86_64 (Ruby 4.0.2 +YJIT):
 
 #### Throughput (push/pull, 64 B messages)
 
 | inproc | ipc | tcp |
 |--------|-----|-----|
-| 184k/s | 35k/s | 18k/s |
+| 244k/s | 47k/s | 36k/s |
 
 #### Latency (req/rep roundtrip)
 
 | inproc | ipc | tcp |
 |--------|-----|-----|
-| 13 µs | 70 µs | 97 µs |
+| 9 µs | 47 µs | 61 µs |
 
 See [`bench/`](bench/) for full results and scripts.
 
@@ -142,7 +142,10 @@ See [`bench/`](bench/) for full results and scripts.
 `omqcat` is a command-line tool for sending and receiving messages on any OMQ socket. Like `nngcat` from libnng, but with Ruby superpowers.
 
 ```sh
-# Echo server in one line
+# Echo server
+omqcat rep -b tcp://:5555 --echo
+
+# Upcase server in one line
 omqcat rep -b tcp://:5555 -e '$F.map(&:upcase)'
 
 # Client
@@ -170,8 +173,10 @@ omqcat pull -b tcp://:5557 -J
 omqcat push -c tcp://remote:5557 -z < data.txt
 omqcat pull -b tcp://:5557 -z
 
-# CURVE encryption (auto-detected from env vars)
-SERVER_KEY=... omqcat req -c tcp://secure:5555 -D "secret"
+# CURVE encryption
+omqcat rep -b tcp://:5555 -D "secret" --curve-server
+# prints: OMQ_SERVER_KEY='...'
+omqcat req -c tcp://localhost:5555 --curve-server-key '...'
 ```
 
 The `-e` flag runs Ruby inside the socket instance — the full socket API (`self <<`, `send`, `subscribe`, ...) is available. Use `-r` to require gems:

data/lib/omq/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OMQ
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

data/lib/omq/zmtp/connection.rb

@@ -92,6 +92,7 @@ module OMQ
               @io.write(Codec::Frame.new(part, more: more).to_wire)
             end
           end
+          @io.flush
         end
       end
 
@@ -156,6 +157,7 @@ module OMQ
           else
             @io.write(command.to_frame.to_wire)
           end
+          @io.flush
         end
       end
 

data/lib/omq/zmtp/transport/ipc.rb

@@ -32,7 +32,7 @@ module OMQ
               loop do
                 client = server.accept
                 Reactor.run do
-                  engine.handle_accepted(IO::Stream::Buffered.wrap(client, minimum_write_size: 0), endpoint: endpoint)
+                  engine.handle_accepted(IO::Stream::Buffered.wrap(client), endpoint: endpoint)
                 rescue ProtocolError, *ZMTP::CONNECTION_LOST
                   # peer disconnected during handshake
                 rescue
@@ -57,7 +57,7 @@ module OMQ
             path = parse_path(endpoint)
             sock_path = to_socket_path(path)
             sock = UNIXSocket.new(sock_path)
-            engine.handle_connected(IO::Stream::Buffered.wrap(sock, minimum_write_size: 0), endpoint: endpoint)
+            engine.handle_connected(IO::Stream::Buffered.wrap(sock), endpoint: endpoint)
           end
 
           private

data/lib/omq/zmtp/transport/tcp.rb

@@ -29,7 +29,7 @@ module OMQ
               loop do
                 client = server.accept
                 Reactor.run do
-                  engine.handle_accepted(IO::Stream::Buffered.wrap(client, minimum_write_size: 0), endpoint: resolved)
+                  engine.handle_accepted(IO::Stream::Buffered.wrap(client), endpoint: resolved)
                 rescue ProtocolError, *ZMTP::CONNECTION_LOST
                   # peer disconnected during handshake
                 rescue
@@ -53,7 +53,7 @@ module OMQ
           def connect(endpoint, engine)
             host, port = parse_endpoint(endpoint)
             sock = TCPSocket.new(host, port)
-            engine.handle_connected(IO::Stream::Buffered.wrap(sock, minimum_write_size: 0), endpoint: endpoint)
+            engine.handle_connected(IO::Stream::Buffered.wrap(sock), endpoint: endpoint)
           end
 
           private

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omq
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Patrik Wenger
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '2.38'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '2.38'
 - !ruby/object:Gem::Dependency
   name: io-stream
   requirement: !ruby/object:Gem::Requirement