omq 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d77750001a2c45808301e5a005f83c8a6f4df44ffa033aa121cc9229b597347
-  data.tar.gz: b009c94d5ea30d5e0983831fb443e1ceb31e8980725b1b9c75b9403814a7a469
+  metadata.gz: 27a1d700594261a36d3212b00ff84e15be3053a32db07a04a48aa0eb52fec902
+  data.tar.gz: 2797e4863af5cfcde9fe446c79929705e6ab17656ba016532b54d6c6b57564b9
 SHA512:
-  metadata.gz: e6612b16ae23874f1539154f108359190ac70eeaf9691c326deb4b2545151590e4458071912a987258b9d59cf80c5015024fbfa546d1f5bbcd979564be5cdffe
-  data.tar.gz: 7706e73997b1a96446e6c5e6053756e57e4b33d6b084a82c49f78e40b9454aa26aed1d5e3ca14207c450be75864707618c3a87cf27c750020064393dbe85c71f
+  metadata.gz: a116b039dc996a0099bbb86e8c138fd71f03051bd23c142b653e1c8e932e541245476bed51a47183ecb3723f9f86b30f36b6e3956b77494f8d77c924354f39ad
+  data.tar.gz: bdd7a62bb68390c942ebb1517981ca69d0efab007f3be7d3149fcccb525ad9b2cb279689ba2ec640db0f6057d6d7219e804074bb5ba4eb4d8339517bf6de5805

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.3.2 — 2026-03-26
+
+### Improved
+
+- Hide the warning about the experimental `IO::Buffer` (used by io-stream)
+
 ## 0.3.1 — 2026-03-26
 
 ### Improved

data/README.md

@@ -137,6 +137,52 @@ Benchmarked with benchmark-ips on Linux x86_64 (Ruby 4.0.1 +YJIT):
 
 See [`bench/`](bench/) for full results and scripts.
 
+## omqcat — CLI tool
+
+`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
+omqcat rep -b tcp://:5555 -e '$F.map(&:upcase)'
+
+# Client
+echo "hello" | omqcat req -c tcp://localhost:5555
+# => HELLO
+
+# PUB/SUB
+omqcat sub -b tcp://:5556 -s "weather."  &
+echo "weather.nyc 72F" | omqcat pub -c tcp://localhost:5556 -d 0.3
+
+# Pipeline with filtering
+tail -f /var/log/syslog | omqcat push -c tcp://collector:5557
+omqcat pull -b tcp://:5557 -e '$F.first.include?("error") ? $F : nil'
+
+# Multipart messages via tabs
+printf "routing-key\tpayload data" | omqcat push -c tcp://localhost:5557
+omqcat pull -b tcp://:5557
+# => routing-key	payload data
+
+# JSONL for structured data
+echo '["key","value"]' | omqcat push -c tcp://localhost:5557 -J
+omqcat pull -b tcp://:5557 -J
+
+# Zstandard compression
+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"
+```
+
+The `-e` flag runs Ruby inside the socket instance — the full socket API (`self <<`, `send`, `subscribe`, ...) is available. Use `-r` to require gems:
+
+```sh
+omqcat sub -c tcp://localhost:5556 -s "" -r json \
+  -e 'JSON.parse($F.first)["temperature"]'
+```
+
+Formats: `--ascii` (default, tab-separated), `--quoted`, `--raw`, `--jsonl`, `--msgpack`. See `omqcat --help` for all options.
+
 ## Interop with native ZMQ
 
 OMQ speaks ZMTP 3.1 on the wire and interoperates with libzmq, CZMQ, pyzmq, etc. over **tcp** and **ipc**. The `inproc://` transport is OMQ-internal (in-process Ruby queues) and is not visible to native ZMQ running in the same process — use `ipc://` to talk across library boundaries.

data/exe/omqcat

@@ -1,5 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
+Warning[:experimental] = false
 
 #
 # omqcat — command-line access to OMQ (ZeroMQ) sockets.

data/lib/omq/version.rb

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

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

@@ -35,7 +35,7 @@ module OMQ
                   engine.handle_accepted(IO::Stream::Buffered.wrap(client, minimum_write_size: 0), endpoint: endpoint)
                 rescue ProtocolError, *ZMTP::CONNECTION_LOST
                   # peer disconnected during handshake
-                rescue => e
+                rescue
                   client&.close rescue nil
                   raise
                 end

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

@@ -32,7 +32,7 @@ module OMQ
                   engine.handle_accepted(IO::Stream::Buffered.wrap(client, minimum_write_size: 0), endpoint: resolved)
                 rescue ProtocolError, *ZMTP::CONNECTION_LOST
                   # peer disconnected during handshake
-                rescue => e
+                rescue
                   client&.close rescue nil
                   raise
                 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omq
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Patrik Wenger