atomic-ruby 0.15.5 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6022f081e7f3e4ce545c40989e5a644beea0697da5d840f645ae3764fbb80e4e
-  data.tar.gz: 94b4312e55cfbda05127bde7ac74efd98da8708cb9835e718e7c02641f1d241a
+  metadata.gz: ecdfa4ed4bb185acac2d6ce288418318e23c1e4825fddff06d74a702d19d0d39
+  data.tar.gz: d2c935cb440869f1f622a30a585d71767ef57e3d08de78f332810e63acff1aa5
 SHA512:
-  metadata.gz: bbcef6942791f3611e55c7c9806bd5daa4b71dd4bae4bedd255c0d1598e16c0ba50a19ae92423768fca04a4baafd80f464877f60960a7e43be0fc08ed2ffb3a3
-  data.tar.gz: '0883a4a401963ad0db23713c6ae6917bec1c3bd1cd3bd8ecff069cc63c99b3000a914ee0c9345cd9f2495f88f0d6da6c35a51057b80a56877409ba19ce3c5e4f'
+  metadata.gz: 10e31be43b93f0d22de13ec3bea7f7d8bf411aa5282c5d36de2ee8da7693b968ab1aacbdc6c428317450670585bb857f0b8ecf657b71af6f18fcea9ab8c8c314
+  data.tar.gz: d99ed0322536e33b725a5ddda3202eced49bc71de567d6505079d3fbcd8b11b4df9d2216c834a5b0fa546105860eef3ccf0848d4455870992061991be6f772aa

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.16.0] - 2026-10-18
+
+- Add `AtomicThreadPool#wait_for_capacity`
+
 ## [0.15.5] - 2026-09-03
 
 - Adapt `AtomicThreadPool` scaling to workload pressure

data/README.md

@@ -270,7 +270,7 @@ puts "Atomic Ruby Atomic Bank Account:     #{results[2].real.round(6)} seconds"
 
 ruby version:            ruby 4.0.6 (2026-07-14 revision 03b6d3f889) +YJIT +PRISM [arm64-darwin23]
 concurrent-ruby version: 1.3.8
-atomic-ruby version:     0.15.5
+atomic-ruby version:     0.16.0
 
 Balances:
 Synchronized Bank Account Balance:           975
@@ -361,7 +361,7 @@ end
 
 ruby version:            ruby 4.0.6 (2026-07-14 revision 03b6d3f889) +YJIT +PRISM [arm64-darwin23]
 concurrent-ruby version: 1.3.8
-atomic-ruby version:     0.15.5
+atomic-ruby version:     0.16.0
 
 Warming up --------------------------------------
           Synchronized Boolean Toggle   165.000 i/100ms
@@ -444,7 +444,7 @@ end
 > bundle exec rake clobber && bundle exec rake compile && bundle exec ruby examples/atomic_condition_variable_benchmark.rb
 
 ruby version:        ruby 4.0.6 (2026-07-14 revision 03b6d3f889) +YJIT +PRISM [arm64-darwin23]
-atomic-ruby version: 0.15.5
+atomic-ruby version: 0.16.0
 
 Warming up --------------------------------------
       Synchronized Condition Variable Wait/Signal     4.062k i/100ms
@@ -519,7 +519,7 @@ end
 > bundle exec rake clobber && bundle exec rake compile && bundle exec ruby examples/atomic_queue_benchmark.rb
 
 ruby version:        ruby 4.0.6 (2026-07-14 revision 03b6d3f889) +YJIT +PRISM [arm64-darwin23]
-atomic-ruby version: 0.15.5
+atomic-ruby version: 0.16.0
 
 Warming up --------------------------------------
       Synchronized Queue Push/Pop   184.000 i/100ms
@@ -620,17 +620,17 @@ puts "Atomic Ruby Adaptive Thread Pool: #{adaptive_results[1].real.round(6)} sec
 ```
 > bundle exec rake clobber && bundle exec rake compile && bundle exec ruby examples/atomic_thread_pool_benchmark.rb
 
-ruby version:            ruby 4.0.6 (2026-07-14 revision 03b6d3f889) +YJIT +PRISM [arm64-darwin23]
+ruby version:            ruby 4.0.7 (2026-09-15 revision 229531a6cf) +YJIT +PRISM [arm64-darwin23]
 concurrent-ruby version: 1.3.8
-atomic-ruby version:     0.15.5
+atomic-ruby version:     0.16.0
 
 Fixed Pool Results:
-Concurrent Ruby Fixed Thread Pool: 5.05313 seconds
-Atomic Ruby Fixed Thread Pool:     4.753026 seconds
+Concurrent Ruby Fixed Thread Pool: 5.147226 seconds
+Atomic Ruby Fixed Thread Pool:     4.743301 seconds
 
 Adaptive Pool Results:
-Concurrent Ruby IO Thread Pool:   0.221072 seconds
-Atomic Ruby Adaptive Thread Pool: 0.233328 seconds
+Concurrent Ruby IO Thread Pool:   0.217971 seconds
+Atomic Ruby Adaptive Thread Pool: 0.227701 seconds
 ```
 
 </details>
@@ -684,7 +684,7 @@ puts "Atomic Ruby Atomic Count Down Latch: #{results[1].total.round(6)} CPU seco
 
 ruby version:            ruby 4.0.6 (2026-07-14 revision 03b6d3f889) +YJIT +PRISM [arm64-darwin23]
 concurrent-ruby version: 1.3.8
-atomic-ruby version:     0.15.5
+atomic-ruby version:     0.16.0
 
 Benchmark Results:
 Concurrent Ruby Count Down Latch:    0.000511 CPU seconds, 2.001465 elapsed seconds

data/lib/atomic-ruby/atomic_thread_pool.rb

@@ -118,6 +118,7 @@ module AtomicRuby
       @queue = AtomicQueue.new
       @shutdown = AtomicBoolean.new(false)
       @work_available = AtomicConditionVariable.new
+      @capacity_changed = AtomicConditionVariable.new
       @alive_thread_count = Atom.new(0)
       @active_thread_count = Atom.new(0)
       @threads = []
@@ -238,6 +239,25 @@ module AtomicRuby
       @active_thread_count.value
     end
 
+    # Blocks until the given block returns a truthy value, checking it again
+    # whenever a worker takes or finishes work.
+    #
+    # Useful for applying backpressure, such as holding off on accepting more
+    # work until the pool has capacity for it.
+    #
+    # @yieldreturn [untyped] Truthy to stop waiting, falsy to keep waiting
+    # @return [untyped] The first truthy value returned by the block
+    #
+    # @example Wait until no work is queued
+    #   pool = AtomicThreadPool.new(size: 2)
+    #   5.times { pool << proc { sleep(0.1) } }
+    #   pool.wait_for_capacity { pool.queue_length.zero? } #=> true
+    #
+    # @rbs () { () -> untyped } -> untyped
+    def wait_for_capacity(&block)
+      @capacity_changed.wait(&block)
+    end
+
     # Gracefully shuts down the thread pool.
     #
     # This method:
@@ -351,6 +371,7 @@ module AtomicRuby
             break if should_exit
 
             @active_thread_count.swap { |current_count| current_count + 1 }
+            @capacity_changed.broadcast unless @capacity_changed.waiter_count.zero?
             if temporary
               work_started_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
               running_cpu_time_at_start = @thread_pool_monitor.snapshot[6]
@@ -368,6 +389,7 @@ module AtomicRuby
             ensure
               @thread_pool_monitor&.stop_work
               @active_thread_count.swap { |current_count| current_count - 1 }
+              @capacity_changed.broadcast unless @capacity_changed.waiter_count.zero?
               if temporary && !@queue.empty?
                 elapsed_time = Process.clock_gettime(Process::CLOCK_MONOTONIC) - work_started_at
                 running_cpu_time = @thread_pool_monitor.snapshot[6] - running_cpu_time_at_start

data/lib/atomic-ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AtomicRuby
-  VERSION = "0.15.5"
+  VERSION = "0.16.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: atomic-ruby
 version: !ruby/object:Gem::Version
-  version: 0.15.5
+  version: 0.16.0
 platform: ruby
 authors:
 - Joshua Young
@@ -52,7 +52,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Atomic primitives for Ruby
 test_files: []