atomic-ruby 0.15.5 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6022f081e7f3e4ce545c40989e5a644beea0697da5d840f645ae3764fbb80e4e
-  data.tar.gz: 94b4312e55cfbda05127bde7ac74efd98da8708cb9835e718e7c02641f1d241a
+  metadata.gz: b17a39b18e427bf9b4467457831fd5acf724af9d86b4ca35a3ef10582726b74e
+  data.tar.gz: 3285f13f8e5ef021f7fdbcbdcf52b17ab6ff171fc70106543799c0f09f577979
 SHA512:
-  metadata.gz: bbcef6942791f3611e55c7c9806bd5daa4b71dd4bae4bedd255c0d1598e16c0ba50a19ae92423768fca04a4baafd80f464877f60960a7e43be0fc08ed2ffb3a3
-  data.tar.gz: '0883a4a401963ad0db23713c6ae6917bec1c3bd1cd3bd8ecff069cc63c99b3000a914ee0c9345cd9f2495f88f0d6da6c35a51057b80a56877409ba19ce3c5e4f'
+  metadata.gz: 0b99a0e2100707aada701ed45c044cc06b6319bffe5a68ff996b8e536a42e1c1cd0ca36c092e9dfe6e24cfea03dd739cc1338b08926479ba2424d59a6a216221
+  data.tar.gz: 51d042574a1c3b9c8eb6b7606eaa3e6512ad97f9dbb72a38f349d40bc14eaa5b271e6953bac796ece002192ebd3831ac28ce6538e70297721eaa724cf12ab3bf

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.16.1] - 2026-10-18
+
+- Grow `AtomicThreadPool` until Ruby execution uses three quarters of one CPU
+
+## [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.1
 
 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.1
 
 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.1
 
 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.1
 
 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.1
 
 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.1
 
 Benchmark Results:
 Concurrent Ruby Count Down Latch:    0.000511 CPU seconds, 2.001465 elapsed seconds

data/lib/atomic-ruby/atomic_thread_pool.rb

@@ -55,7 +55,8 @@ module AtomicRuby
     AUTOSCALE_INITIAL_WINDOW = 0.002
     AUTOSCALE_MAX_WINDOW = 0.05
     AUTOSCALE_SAMPLES_PER_WINDOW = 5
-    private_constant :AUTOSCALE_IDLE_TIME, :AUTOSCALE_INITIAL_WINDOW, :AUTOSCALE_MAX_WINDOW, :AUTOSCALE_SAMPLES_PER_WINDOW
+    AUTOSCALE_RUBY_CPU_SHARE = 0.75
+    private_constant :AUTOSCALE_IDLE_TIME, :AUTOSCALE_INITIAL_WINDOW, :AUTOSCALE_MAX_WINDOW, :AUTOSCALE_SAMPLES_PER_WINDOW, :AUTOSCALE_RUBY_CPU_SHARE
 
     class Error < StandardError; end
 
@@ -118,6 +119,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 +240,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 +372,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,10 +390,11 @@ 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
-                if running_cpu_time * 2 >= elapsed_time * 1_000_000_000
+                if running_cpu_time >= elapsed_time * 1_000_000_000 * AUTOSCALE_RUBY_CPU_SHARE
                   @ruby_cpu_trim_requested.make_true
                   @work_available.broadcast
                 end
@@ -465,8 +488,9 @@ module AtomicRuby
     #
     # Requiring workers to spend a majority of their time blocked outside the
     # GVL recognizes blocking operations. The pool grows while Ruby execution
-    # uses less than half of one CPU and shrinks when Ruby execution becomes
-    # the bottleneck, without mistaking OS scheduling delays for GVL contention.
+    # uses less than three quarters of one CPU and shrinks when Ruby execution
+    # becomes the bottleneck, without mistaking OS scheduling delays for GVL
+    # contention.
     #
     # @param previous_snapshot [Array<Integer>] previous GVL state snapshot
     # @param snapshot [Array<Integer>] current GVL state snapshot
@@ -492,7 +516,7 @@ module AtomicRuby
         total_time = running_time + waiting_time + blocked_time
       end
 
-      ruby_cpu_bound = running_cpu_time * 2 >= elapsed_time * 1_000_000_000
+      ruby_cpu_bound = running_cpu_time >= elapsed_time * 1_000_000_000 * AUTOSCALE_RUBY_CPU_SHARE
       blocking = total_time.positive? && blocked_time * 2 > total_time && !ruby_cpu_bound
 
       return :up if blocking && workers.length < @max_size

data/lib/atomic-ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AtomicRuby
-  VERSION = "0.15.5"
+  VERSION = "0.16.1"
 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.1
 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: []