omq 0.28.7 → 0.28.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ba6c1a230231646b3a6c62e2989df1b7e1cc8a0f221ecaa36866d34fa1d0e37
-  data.tar.gz: c8fd13bec0c8bc71ce65d7986fc90e2d4269a00c9aceecde3f15f5594ec83550
+  metadata.gz: 69989ec63abfcf84fc4a2c6fb6900601a426da84efceda4214756d6cfe6c5730
+  data.tar.gz: 8fd5f283d00aa4b41e9a43bf9fd0f9d818e8a33fdfb6e8fba300b815cb87581d
 SHA512:
-  metadata.gz: 2e628c0814a1596514e7ec4f845689c90392c74d5d45652c1e6efa8c85acc801cb88a04d0a5acaa95a6696467d76ea609cac2b93e7de00347fb980104a81564a
-  data.tar.gz: e69d5a0698a8f2a2879378dbd35b983e0e45ef52ea323c3a439947b5f657a734333cdec0c869389bf186dabc92beee3fba0093f5498cf67f6ab49ca7e243a868
+  metadata.gz: c6a18373a24aee32befeb94f684770f23784417af36f9d6d60475ee1969559105ff4403223dea44caeeafcfe3e18899a6f0e95493a4e05486336a15b37933194
+  data.tar.gz: 21e86d33a77985738681f0d248214ccf5b85c2dde32e8efcf94b673ac1323d6a8c434c6b9b04a6315374b4eb129924ab5801af341f79aceb983c33056904f789

data/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 ## [Unreleased]
 
+## [0.28.9] - 2026-08-26
+
+### Fixed
+
+- Used `SocketError` when `Socket::ResolutionError` is unavailable, so
+  `require "omq"` works on JRuby.
+
+## [0.28.8] - 2026-08-08
+
+### Added
+
+- Imported `omq-cli` under `gems/omq-cli` and wired it into monorepo
+  test and release tasks.
+- Added `OMQ_BACKEND` support to `omq-cli` for choosing `ruby`, `rust`,
+  or `libzmq` as the default socket backend.
+- Made `omq -v` print the effective socket backend at startup.
+- Added `Socket#closed?`.
+
+### Changed
+
+- Removed TruffleRuby Async compatibility shims. The pure Ruby backend now
+  requires a native `Fiber.scheduler`.
+- Made `Socket#monitor` require native scheduler support.
+
 ## [0.28.7] - 2026-08-02
 
 ### Fixed

data/README.md

@@ -11,8 +11,8 @@
 >
 > Ruby 4.0 + YJIT on a Linux VM. See [`bench/`](bench/) for full results
 
-`gem install omq` and you're done. No libzmq, no compiler, no system packages,
-just Ruby talking to every other ZeroMQ peer out there.
+`gem install omq` and you're done on MRI Ruby. No libzmq, no compiler, no
+system packages, just Ruby talking to every other ZeroMQ peer out there.
 
 ØMQ gives your Ruby processes a way to talk to each other, and to anything
 else speaking ZeroMQ, without a broker in the middle. Same API whether they
@@ -26,7 +26,7 @@ walkthrough of every major pattern with working code.
 ## Highlights
 
 - **Zero dependencies on C**: no extensions, no FFI, no libzmq. `gem install`
-  just works everywhere
+  just works on supported MRI Rubies
 - **Fast**: YJIT-optimized hot paths, batched sends, GC-tuned allocations,
   buffered I/O via [io-stream](https://github.com/socketry/io-stream),
   direct-pipe inproc bypass
@@ -59,6 +59,15 @@ gem install omq
 gem 'omq'
 ```
 
+### Ruby Engines
+
+MRI Ruby 3.3 and 4.0 can use the pure Ruby backend. TruffleRuby and JRuby
+should use the Rust backend with `backend: :rust`; the pure Ruby backend is
+not supported there because OMQ needs native `Fiber.scheduler` behavior.
+JRuby support uses OMQ.java on Java 25 or newer. The Java gem selects the
+matching OMQ.java artifact on Linux x86_64, macOS aarch64, macOS x86_64, and
+Windows x86_64.
+
 ## Quick Start
 
 ### Request / Reply
@@ -217,8 +226,12 @@ See the [omq-cli README](https://github.com/paddor/omq-cli) for full documentati
 
 ## Optional Rust backend
 
-Install `omq-backend-rust` for a Rust/omq-tokio backend. Same socket API,
-but connection handling runs in native code on a Tokio runtime.
+Install `omq-backend-rust` for an OMQ.rs backend through the first-class
+`omq-rs` binding. Same socket API, with connection handling on a Tokio runtime.
+
+The Rust backend also supports TruffleRuby. The pure Ruby backend currently
+requires MRI-style native `Fiber.scheduler` support, so use `backend: :rust`
+on TruffleRuby.
 
 ```ruby
 require "omq/backend/rust"

data/lib/omq/constants.rb

@@ -43,6 +43,7 @@ module OMQ
     IO::Stream::ConnectionResetError,
   ]
 
+  RESOLUTION_ERROR = defined?(Socket::ResolutionError) ? Socket::ResolutionError : SocketError
 
   # Errors raised when a peer cannot be reached.
   CONNECTION_FAILED = [
@@ -52,7 +53,7 @@ module OMQ
     Errno::EHOSTUNREACH,
     Errno::ENETUNREACH,
     Errno::EPROTOTYPE, # IPC: existing socket file is SOCK_DGRAM, not SOCK_STREAM
-    Socket::ResolutionError,
+    RESOLUTION_ERROR,
   ]
 
 

data/lib/omq/reactor.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "async"
+require "timeout"
 
 module OMQ
   # Shared IO reactor for the Ruby backend.
@@ -16,6 +17,9 @@ module OMQ
   #
   module Reactor
     THREAD_NAME = 'omq-io'
+    NATIVE_FIBER_SCHEDULER = RUBY_ENGINE != "jruby" &&
+                             Fiber.respond_to?(:scheduler) &&
+                             Fiber.method(:scheduler).source_location.nil?
 
     @mutex      = Mutex.new
     @pid        = nil
@@ -31,6 +35,11 @@ module OMQ
       attr_reader :lingers
 
 
+      def native_fiber_scheduler?
+        NATIVE_FIBER_SCHEDULER
+      end
+
+
       # Returns the root Async task inside the shared IO thread.
       # Starts the thread exactly once (double-checked lock).
       #
@@ -76,6 +85,12 @@ module OMQ
           else
             yield
           end
+        elsif !native_fiber_scheduler?
+          if timeout
+            Timeout.timeout(timeout, IO::TimeoutError) { yield }
+          else
+            yield
+          end
         else
           result = Async::Promise.new
           root_task # ensure started

data/lib/omq/readable.rb

@@ -17,7 +17,11 @@ module OMQ
       if @engine.on_io_thread?
         Reactor.run(timeout: @options.read_timeout) { @engine.dequeue_recv }
       elsif (timeout = @options.read_timeout)
-        Async::Task.current.with_timeout(timeout, IO::TimeoutError) { @engine.dequeue_recv }
+        if Reactor.native_fiber_scheduler?
+          Async::Task.current.with_timeout(timeout, IO::TimeoutError) { @engine.dequeue_recv }
+        else
+          Reactor.run(timeout:) { @engine.dequeue_recv }
+        end
       else
         @engine.dequeue_recv
       end

data/lib/omq/socket.rb

@@ -202,6 +202,10 @@ module OMQ
     #   task.stop
     #
     def monitor(verbose: false, &block)
+      unless Reactor.native_fiber_scheduler?
+        raise NotImplementedError, "Socket#monitor requires native Fiber.scheduler"
+      end
+
       ensure_parent_task
 
       queue                   = Async::LimitedQueue.new(64)
@@ -245,6 +249,12 @@ module OMQ
     end
 
 
+    # @return [Boolean] true once the underlying engine is closed.
+    def closed?
+      @engine.closed?
+    end
+
+
     # Immediate hard stop. Skips the linger drain and cascades teardown
     # through the socket-level Async::Barrier. Intended for crash-path
     # cleanup or when the caller already knows no pending sends matter.
@@ -316,6 +326,10 @@ module OMQ
       @options.conflate     = conflate
       @options.on_mute      = on_mute      if on_mute
       backend_name = (backend || :ruby).to_sym
+      if backend_name == :ruby && !Reactor.native_fiber_scheduler?
+        raise NotImplementedError, "Ruby backend requires native Fiber.scheduler; use backend: :rust"
+      end
+
       require_backend(backend_name) unless Backend.registered?(backend_name)
 
       engine_class = Backend.fetch(backend_name)

data/lib/omq/version.rb

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

data/lib/omq/writable.rb

@@ -46,7 +46,11 @@ module OMQ
       if @engine.on_io_thread?
         Reactor.run(timeout: @options.write_timeout) { @engine.enqueue_send(parts) }
       elsif (timeout = @options.write_timeout)
-        Async::Task.current.with_timeout(timeout, IO::TimeoutError) { @engine.enqueue_send(parts) }
+        if Reactor.native_fiber_scheduler?
+          Async::Task.current.with_timeout(timeout, IO::TimeoutError) { @engine.enqueue_send(parts) }
+        else
+          Reactor.run(timeout:) { @engine.enqueue_send(parts) }
+        end
       else
         @engine.enqueue_send(parts)
       end

metadata

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