omq 0.28.7 → 0.28.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ba6c1a230231646b3a6c62e2989df1b7e1cc8a0f221ecaa36866d34fa1d0e37
-  data.tar.gz: c8fd13bec0c8bc71ce65d7986fc90e2d4269a00c9aceecde3f15f5594ec83550
+  metadata.gz: 6ed8a560eb7abf29a97bdae6a35baaf18bfe1ef47476a33691f7d5ad2fdf2914
+  data.tar.gz: 91b6416e4ce9110cf13f73bd7a7b8fdc97b994132f718f99f3dcd2cff4030857
 SHA512:
-  metadata.gz: 2e628c0814a1596514e7ec4f845689c90392c74d5d45652c1e6efa8c85acc801cb88a04d0a5acaa95a6696467d76ea609cac2b93e7de00347fb980104a81564a
-  data.tar.gz: e69d5a0698a8f2a2879378dbd35b983e0e45ef52ea323c3a439947b5f657a734333cdec0c869389bf186dabc92beee3fba0093f5498cf67f6ab49ca7e243a868
+  metadata.gz: 41fbe26e73c2dae30b30a74ba347e9c1a52781ec13d7ecc4ee98f80e715e8a3c83f95a47adeac5294238a1cc29b8359bc1c7b6ae96320036855f789062b87eb7
+  data.tar.gz: 539696d1162ac357f319664657a33cb3cada7d6968a42b1cf3855498fee1ec1deaa1ff6ab340860c536784cfde2d53328496f7014c398b933ab36843ff86a02a

data/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [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,12 @@ gem install omq
 gem 'omq'
 ```
 
+### Ruby Engines
+
+MRI Ruby 3.3 and 4.0 can use the pure Ruby backend. TruffleRuby should use
+the Rust backend with `backend: :rust`; the pure Ruby backend is not supported
+there because OMQ needs native `Fiber.scheduler` behavior.
+
 ## Quick Start
 
 ### Request / Reply
@@ -220,6 +226,10 @@ See the [omq-cli README](https://github.com/paddor/omq-cli) for full documentati
 Install `omq-backend-rust` for a Rust/omq-tokio backend. Same socket API,
 but connection handling runs in native code 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"
 push = OMQ::PUSH.new(backend: :rust)

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,7 @@ module OMQ
   #
   module Reactor
     THREAD_NAME = 'omq-io'
+    NATIVE_FIBER_SCHEDULER = Fiber.respond_to?(:scheduler) && Fiber.method(:scheduler).source_location.nil?
 
     @mutex      = Mutex.new
     @pid        = nil
@@ -31,6 +33,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 +83,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.8"
 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.8
 platform: ruby
 authors:
 - Patrik Wenger