atomic-ruby 0.15.3 → 0.15.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a50be9a8594152f8d07b2338588a01be6aecadf55f993ea6cc4c2431e80e2b76
-  data.tar.gz: eb9c45d8dff70d0697d3d62ba5a539e3d71e42c21ea7ab6b646d44fde69f39ac
+  metadata.gz: e7c0136cf37fe5133affc1f090fa517636f5bfda0f5f43564a4877eee15bae3f
+  data.tar.gz: 0ae3a3aadabcc2bb69621df62188800451289a46032fa57a49c1af9326bcc31e
 SHA512:
-  metadata.gz: abde2bc85010be3634caeaf66d262acf1c5c70c50af5e9e420a43c87071965bd543a475b01b5d1b0d1569682802595e936a9d224e636896a681e5c3c85d98a77
-  data.tar.gz: e93d7b35c3ccdba9c82906587c24455c248655ffbe3f9d4141e4cb029705306f80c13b36f6a0ce7193a33701758ad0a9c2f77a7aa0c94ad92e49392ba899c055
+  metadata.gz: 1786faa43a25379cbe68c9de2372c6168a62ab225436c45bbf5049791c39191e3ed75955ab2f5f6385069ddeb86640aa11ba431ce9f2ab54335005a61bd42092
+  data.tar.gz: 704c7e7224c9eec351aa0174f597c10c992f4e1594921b8ca91e9ad2df43a6b3eb2c260b9b25ab2d47f8fb0934afa9739ed5312fb00d5d7519d9283c6bf68170

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 ## [Unreleased]
 
-## [0.15.2] - 2026-08-31
+## [0.15.4] - 2026-09-01
+
+- Keep temporary `AtomicThreadPool` workers alive for five seconds
+- Speed up `AtomicThreadPool` scaling for blocking work
+
+## [0.15.3] - 2026-08-31
 
 - Prevent enqueues from racing `AtomicThreadPool#shutdown`
 - Remove interrupted waiters from `AtomicConditionVariable`

data/README.md

@@ -268,7 +268,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.3
+atomic-ruby version:     0.15.4
 
 Balances:
 Synchronized Bank Account Balance:           975
@@ -359,7 +359,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.3
+atomic-ruby version:     0.15.4
 
 Warming up --------------------------------------
           Synchronized Boolean Toggle   165.000 i/100ms
@@ -442,7 +442,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.3
+atomic-ruby version: 0.15.4
 
 Warming up --------------------------------------
       Synchronized Condition Variable Wait/Signal     4.062k i/100ms
@@ -517,7 +517,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.3
+atomic-ruby version: 0.15.4
 
 Warming up --------------------------------------
       Synchronized Queue Push/Pop   184.000 i/100ms
@@ -547,7 +547,7 @@ require "benchmark"
 require "concurrent-ruby"
 require_relative "../lib/atomic-ruby"
 
-results = []
+fixed_results = []
 
 2.times do |idx|
   result = Benchmark.measure do
@@ -569,7 +569,36 @@ results = []
     pool.wait_for_termination if idx == 0
   end
 
-  results << result
+  fixed_results << result
+end
+
+adaptive_results = []
+
+2.times do |idx|
+  result = Benchmark.measure do
+    pool = case idx
+    when 0 then Concurrent.new_io_executor
+    when 1 then AtomicThreadPool.new(size: 1, max_size: Float::INFINITY)
+    end
+    latch = case idx
+    when 0 then Concurrent::CountDownLatch.new(100)
+    when 1 then AtomicCountDownLatch.new(100)
+    end
+
+    100.times do
+      pool << proc do
+        sleep(0.2)
+        latch.count_down
+      end
+    end
+
+    latch.wait
+    pool.shutdown
+    # concurrent-ruby's #shutdown does not wait for threads to terminate
+    pool.wait_for_termination if idx == 0
+  end
+
+  adaptive_results << result
 end
 
 puts "\n"
@@ -577,9 +606,13 @@ puts "ruby version:            #{RUBY_DESCRIPTION}"
 puts "concurrent-ruby version: #{Concurrent::VERSION}"
 puts "atomic-ruby version:     #{AtomicRuby::VERSION}"
 puts "\n"
-puts "Benchmark Results:"
-puts "Concurrent Ruby Thread Pool:    #{results[0].real.round(6)} seconds"
-puts "Atomic Ruby Atomic Thread Pool: #{results[1].real.round(6)} seconds"
+puts "Fixed Pool Results:"
+puts "Concurrent Ruby Fixed Thread Pool: #{fixed_results[0].real.round(6)} seconds"
+puts "Atomic Ruby Fixed Thread Pool:     #{fixed_results[1].real.round(6)} seconds"
+puts "\n"
+puts "Adaptive Pool Results:"
+puts "Concurrent Ruby IO Thread Pool:   #{adaptive_results[0].real.round(6)} seconds"
+puts "Atomic Ruby Adaptive Thread Pool: #{adaptive_results[1].real.round(6)} seconds"
 ```
 
 ```
@@ -587,11 +620,15 @@ puts "Atomic Ruby Atomic Thread Pool: #{results[1].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.3
+atomic-ruby version:     0.15.4
 
-Benchmark Results:
-Concurrent Ruby Thread Pool:    5.012798 seconds
-Atomic Ruby Atomic Thread Pool: 4.755237 seconds
+Fixed Pool Results:
+Concurrent Ruby Fixed Thread Pool: 5.069464 seconds
+Atomic Ruby Fixed Thread Pool:     4.791382 seconds
+
+Adaptive Pool Results:
+Concurrent Ruby IO Thread Pool:   0.22309 seconds
+Atomic Ruby Adaptive Thread Pool: 0.61561 seconds
 ```
 
 </details>
@@ -645,7 +682,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.3
+atomic-ruby version:     0.15.4
 
 Benchmark Results:
 Concurrent Ruby Count Down Latch:    0.000511 CPU seconds, 2.001465 elapsed seconds

data/lib/atomic-ruby/atomic_thread_pool.rb

@@ -51,11 +51,10 @@ module AtomicRuby
   # @note This class is NOT Ractor-safe as it contains mutable thread state
   #   that cannot be safely shared across ractors.
   class AtomicThreadPool
-    AUTOSCALE_GROWTH_SAMPLES = 3
-    AUTOSCALE_IDLE_TIME = 1
+    AUTOSCALE_IDLE_TIME = 5
     AUTOSCALE_INTERVAL = 0.01
     AUTOSCALE_WINDOW = 0.05
-    private_constant :AUTOSCALE_GROWTH_SAMPLES, :AUTOSCALE_IDLE_TIME, :AUTOSCALE_INTERVAL, :AUTOSCALE_WINDOW
+    private_constant :AUTOSCALE_IDLE_TIME, :AUTOSCALE_INTERVAL, :AUTOSCALE_WINDOW
 
     class Error < StandardError; end
 
@@ -71,7 +70,7 @@ module AtomicRuby
     # if work remains queued while its active workers spend most of their time
     # blocked outside the GVL, but not when Ruby execution is using the
     # available CPU.
-    # Temporary workers leave after the queue remains empty, returning the pool
+    # Temporary workers remain available between bursts before the pool returns
     # to its baseline size. Omitting `max_size` creates a fixed-size pool.
     #
     # @param size [Integer] The baseline number of worker threads (must be positive)
@@ -379,7 +378,6 @@ module AtomicRuby
       previous_snapshot = @thread_pool_monitor.snapshot
       pressure_started_at = nil
       idle_started_at = nil
-      growth_samples = 0
       phase_samples = [0, 0, 0]
 
       loop do
@@ -395,7 +393,6 @@ module AtomicRuby
           pressure_started_at = nil
           previous_snapshot = snapshot
           idle_started_at ||= now
-          growth_samples = 0
           phase_samples.fill(0)
 
           if now - idle_started_at >= AUTOSCALE_IDLE_TIME
@@ -412,13 +409,9 @@ module AtomicRuby
             phase_samples.fill(0)
           elsif now - pressure_started_at >= AUTOSCALE_WINDOW
             if should_grow?(previous_snapshot, snapshot, phase_samples, now - pressure_started_at)
-              growth_samples += 1
-              if growth_samples >= AUTOSCALE_GROWTH_SAMPLES
-                spawn_worker(temporary: true)
-                growth_samples = 0
-              end
-            else
-              growth_samples = 0
+              worker_count = @threads.length
+              workers_to_add = [worker_count, @queue.size, @max_size - worker_count].min
+              workers_to_add.times { spawn_worker(temporary: true) }
             end
             previous_snapshot = snapshot
             pressure_started_at = now

data/lib/atomic-ruby/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: atomic-ruby
 version: !ruby/object:Gem::Version
-  version: 0.15.3
+  version: 0.15.4
 platform: ruby
 authors:
 - Joshua Young