omq 0.6.3 → 0.6.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a43ed94bf4595d9388897a74f6e642a865ec98a66c0cf64db084d6cb714705e
-  data.tar.gz: feb63595995ac894ea816e44f9ebf01d3bacf756cdb8c55b6f5438f00a6aab96
+  metadata.gz: 94402697e206444e39655869c1382cea2a2839732d373d6cbcc237dcb125cd44
+  data.tar.gz: dbcaa10eb1213e935325d0290611716552d28394dd479d8fc79564a0af6f0e4d
 SHA512:
-  metadata.gz: 9bbe45d76566342849dcc59a8a334cf98c4f79b56392c0031e2491d4a0d3fb45d9ce7c0a9235c7138f2dd483b40721baa7fd9ce3d189c3230757f30a9c9e57f4
-  data.tar.gz: 1b7eccb931b57458c6cec4321fa3b4ee1de34314de7855aa3772affc434fb32561cf18e4365ab17ef5af6d5dbad62e24e7eba57d1e166d279a2b519fcfbfcf0f
+  metadata.gz: 9a4b4eab9767b52f874bf85816589558bf42e9730da827220490e80ca9dd499ae5ae604c06022d3db07402042a1b52ea1c88737e2c1556b4d78af90391dc1d2f
+  data.tar.gz: e2db5e6aaea16af48024be90af8353a81f4d77a4b0b1973131f74dbd915b9aaf52fdd06d08cc57749ffb74b6bd70214ffb2ab04063925887c8a1b72afd4582cb

data/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 0.6.5 — 2026-03-30
+
+### Fixed
+
+- **CLI error path** — use `Kernel#exit` instead of `Process.exit!`
+
+## 0.6.4 — 2026-03-30
+
+### Added
+
+- **Dual-stack TCP bind** — `TCP.bind` resolves the hostname via
+  `Addrinfo.getaddrinfo` and binds to all returned addresses.
+  `tcp://localhost:PORT` now listens on both `127.0.0.1` and `::1`.
+- **Eager DNS validation on connect** — `Engine#connect` resolves TCP
+  hostnames upfront via `Addrinfo.getaddrinfo`. Unresolvable hostnames
+  raise `Socket::ResolutionError` immediately instead of failing silently
+  in the background reconnect loop.
+- **`Socket::ResolutionError` in `CONNECTION_FAILED`** — DNS failures
+  during reconnect are now retried with backoff (DNS may recover or
+  change), matching libzmq behavior.
+- **CLI catches `SocketDeadError` and `Socket::ResolutionError`** —
+  prints the error and exits with code 1 instead of silently exiting 0.
+
+### Improved
+
+- **CLI endpoint shorthand** — `tcp://:PORT` expands to
+  `tcp://localhost:PORT` (loopback, safe default). `tcp://*:PORT` expands
+  to `tcp://0.0.0.0:PORT` (all interfaces, explicit opt-in).
+
+### Fixed
+
+- **`tcp://*:PORT` failed on macOS** — `*` is not a resolvable hostname.
+  Connects now use `localhost` by default; `*` only expands to `0.0.0.0`
+  for explicit all-interface binding.
+- **`Socket` constant resolution inside `OMQ` namespace** — bare `Socket`
+  resolved to `OMQ::Socket` instead of `::Socket`, causing `NameError`
+  for `Socket::ResolutionError` and `Socket::AI_PASSIVE`.
+
 ## 0.6.3 — 2026-03-30
 
 ### Fixed

data/README.md

@@ -107,18 +107,18 @@ end
 
 ## Socket Types
 
-| Pattern | Classes | Direction |
-|---------|---------|-----------|
-| Request/Reply | `REQ`, `REP` | bidirectional |
-| Publish/Subscribe | `PUB`, `SUB`, `XPUB`, `XSUB` | unidirectional |
-| Pipeline | `PUSH`, `PULL` | unidirectional |
-| Routing | `DEALER`, `ROUTER` | bidirectional |
-| Exclusive pair | `PAIR` | bidirectional |
-| Client/Server | `CLIENT`, `SERVER` | bidirectional |
-| Group messaging | `RADIO`, `DISH` | unidirectional |
-| Pipeline (draft) | `SCATTER`, `GATHER` | unidirectional |
-| Peer-to-peer | `PEER` | bidirectional |
-| Channel (draft) | `CHANNEL` | bidirectional |
+| Pattern | Classes | Direction | Multipart |
+|---------|---------|-----------|-----------|
+| Request/Reply | `REQ`, `REP` | bidirectional | yes |
+| Publish/Subscribe | `PUB`, `SUB`, `XPUB`, `XSUB` | unidirectional | yes |
+| Pipeline | `PUSH`, `PULL` | unidirectional | yes |
+| Routing | `DEALER`, `ROUTER` | bidirectional | yes |
+| Exclusive pair | `PAIR` | bidirectional | yes |
+| Client/Server | `CLIENT`, `SERVER` | bidirectional | no |
+| Group messaging | `RADIO`, `DISH` | unidirectional | no |
+| Pipeline (draft) | `SCATTER`, `GATHER` | unidirectional | no |
+| Peer-to-peer | `PEER` | bidirectional | no |
+| Channel (draft) | `CHANNEL` | bidirectional | no |
 
 All classes live under `OMQ::`. For the purists, `ØMQ` is an alias:
 
@@ -163,16 +163,16 @@ echo "hello" | omq req -c tcp://localhost:5555
 omq sub -b tcp://:5556 -s "weather."  &
 echo "weather.nyc 72F" | omq pub -c tcp://localhost:5556 -d 0.3
 
-# Pipeline with filtering
+# Pipeline with filtering ($F = message parts, $_ = first part)
+# /regexp/ matches against $_, next skips, break stops
 tail -f /var/log/syslog | omq push -c tcp://collector:5557
-omq pull -b tcp://:5557 -e '$F.first.include?("error") ? $F : nil'
+omq pull -b tcp://:5557 -e 'next unless /error/; $F'
 
 # Pipe: PULL → eval → PUSH in one process
 omq pipe -c ipc://@work -c ipc://@sink -e '$F.map(&:upcase)'
 
-# Pipe with 4 Ractor workers for CPU parallelism
-omq pipe -c ipc://@work -c ipc://@sink -P 4 \
-  -r ./fib.rb -e 'fib(Integer($_)).to_s'
+# Pipe with Ractor workers for CPU parallelism (-P = all CPUs)
+omq pipe -c ipc://@work -c ipc://@sink -P -r./fib -e 'fib(Integer($_)).to_s'
 
 # Exit when all peers disconnect (pipeline workers, sinks)
 omq pipe -c ipc://@work -c ipc://@sink --transient -e '$F'

data/lib/omq/cli/base_runner.rb

@@ -412,7 +412,7 @@ module OMQ
         end
       rescue => e
         $stderr.puts "omq: -e error: #{e.message} (#{e.class})"
-        Process.exit!(3)
+        exit 3
       end
 
       # ── Logging ─────────────────────────────────────────────────────

data/lib/omq/cli/pipe.rb

@@ -237,7 +237,7 @@ module OMQ
         end
       rescue => e
         $stderr.puts "omq: -e error: #{e.message} (#{e.class})"
-        Process.exit!(3)
+        exit 3
       end
 
 

data/lib/omq/cli.rb

@@ -268,6 +268,12 @@ module OMQ
       rescue IO::TimeoutError, Async::TimeoutError
         $stderr.puts "omq: timeout" unless config.quiet
         exit 2
+      rescue OMQ::SocketDeadError => e
+        $stderr.puts "omq: #{e.cause.class}: #{e.cause.message}"
+        exit 1
+      rescue ::Socket::ResolutionError => e
+        $stderr.puts "omq: #{e.message}"
+        exit 1
       end
     end
 
@@ -415,9 +421,9 @@ module OMQ
 
       opts[:type_name] = type_name.downcase
 
-      normalize = ->(url) { url.sub(%r{\Atcp://:}, "tcp://*:") }
-      opts[:connects].map!(&normalize)
+      normalize = ->(url) { url.sub(%r{\Atcp://\*:}, "tcp://0.0.0.0:").sub(%r{\Atcp://:}, "tcp://localhost:") }
       opts[:binds].map!(&normalize)
+      opts[:connects].map!(&normalize)
       opts[:endpoints].map! { |ep| Endpoint.new(normalize.call(ep.url), ep.bind?) }
 
       opts

data/lib/omq/version.rb

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

data/lib/omq/zmtp/engine.rb

@@ -89,6 +89,7 @@ module OMQ
       #
       def connect(endpoint)
         capture_parent_task
+        validate_endpoint!(endpoint)
         @connected_endpoints << endpoint
         if endpoint.start_with?("inproc://")
           # Inproc connect is synchronous and instant
@@ -348,6 +349,7 @@ module OMQ
           wrapped
         end
         @routing.recv_queue.enqueue(nil) rescue nil
+        @peer_connected.resolve(nil) rescue nil
       end
 
 
@@ -462,10 +464,26 @@ module OMQ
               delay = ri.is_a?(Range) ? ri.begin : ri if delay == 0
             end
           end
+        rescue Async::Stop
+          # normal shutdown
+        rescue => error
+          signal_fatal_error(error)
         end
       end
 
 
+      # Eagerly validates TCP hostnames so resolution errors fail
+      # on connect, not silently in the background reconnect loop.
+      # Reconnects still re-resolve (DNS may change), and transient
+      # resolution failures during reconnect are retried with backoff.
+      #
+      def validate_endpoint!(endpoint)
+        return unless endpoint.start_with?("tcp://")
+        host = URI.parse(endpoint.sub("tcp://", "http://")).hostname
+        Addrinfo.getaddrinfo(host, nil, nil, :STREAM) if host
+      end
+
+
       def transport_for(endpoint)
         case endpoint
         when /\Atcp:\/\//    then Transport::TCP

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

@@ -20,23 +20,38 @@ module OMQ
           def bind(endpoint, engine)
             host, port = parse_endpoint(endpoint)
             host = "0.0.0.0" if host == "*"
-            server = TCPServer.new(host, port)
-            actual_port = server.local_address.ip_port
-            host_part   = host.include?(":") ? "[#{host}]" : host
-            resolved    = "tcp://#{host_part}:#{actual_port}"
-
-            accept_task = Reactor.spawn_pump(annotation: "tcp accept #{resolved}") do
-              loop do
-                client = server.accept
-                Async::Task.current.defer_stop do
-                  engine.handle_accepted(IO::Stream::Buffered.wrap(client), endpoint: resolved)
+
+            addrs = Addrinfo.getaddrinfo(host, port, nil, :STREAM, nil, ::Socket::AI_PASSIVE)
+            raise ::Socket::ResolutionError, "no addresses for #{host}" if addrs.empty?
+
+            servers      = []
+            accept_tasks = []
+            actual_port  = nil
+
+            addrs.each do |addr|
+              server = TCPServer.new(addr.ip_address, actual_port || port)
+              actual_port ||= server.local_address.ip_port
+              servers << server
+
+              ip        = addr.ip_address
+              host_part = ip.include?(":") ? "[#{ip}]" : ip
+              resolved  = "tcp://#{host_part}:#{actual_port}"
+
+              accept_tasks << Reactor.spawn_pump(annotation: "tcp accept #{resolved}") do
+                loop do
+                  client = server.accept
+                  Async::Task.current.defer_stop do
+                    engine.handle_accepted(IO::Stream::Buffered.wrap(client), endpoint: resolved)
+                  end
                 end
+              rescue IOError
+                # server closed
               end
-            rescue IOError
-              # server closed
             end
 
-            Listener.new(resolved, server, accept_task, actual_port)
+            host_part = host.include?(":") ? "[#{host}]" : host
+            resolved  = "tcp://#{host_part}:#{actual_port}"
+            Listener.new(resolved, servers, accept_tasks, actual_port)
           end
 
           # Connects to a TCP endpoint.
@@ -81,19 +96,19 @@ module OMQ
           # @param accept_task [#stop] the accept loop handle
           # @param port [Integer] bound port number
           #
-          def initialize(endpoint, server, accept_task, port)
-            @endpoint    = endpoint
-            @server      = server
-            @accept_task = accept_task
-            @port        = port
+          def initialize(endpoint, servers, accept_tasks, port)
+            @endpoint     = endpoint
+            @servers      = servers
+            @accept_tasks = accept_tasks
+            @port         = port
           end
 
 
           # Stops the listener.
           #
           def stop
-            @accept_task.stop
-            @server.close rescue nil
+            @accept_tasks.each(&:stop)
+            @servers.each { |s| s.close rescue nil }
           end
         end
       end

data/lib/omq/zmtp.rb

@@ -27,6 +27,7 @@ module OMQ
       Errno::ETIMEDOUT,
       Errno::EHOSTUNREACH,
       Errno::ENETUNREACH,
+      Socket::ResolutionError,
     ].freeze
   end
 end

metadata

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