atomic-ruby 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e47f4b67bd3d4dcaecbd560ed61b8dc4c86c24882b52279a5d0e92fd6de666a
-  data.tar.gz: 2fb299af89ccc871b7c8b3d6ef18f15924e98b90ad196143c0ea9fa3cac76419
+  metadata.gz: 21542683125e7a193b4500ff05f3ee74249db2e3b16e71a3b10b46ff53a52d4b
+  data.tar.gz: 609c1f8e8edb35ad1ad049a33c515a74522803b64a592ed49ac8666d8c06a8ba
 SHA512:
-  metadata.gz: fb201628eedea540bea2a8436daf0bb9f9db3cf2f0cd1caa5d27a54af840b992474cf4e08496a52c16f963ab311cd14f3796977f6777140c648e38cd283a6679
-  data.tar.gz: fe346ae21ffa67e8ed82048a1b79fe2eada3f101e2b812112eef689139f924e01b420b6e0d56f37ca2c795e597bd86631e79f8d93fa5d32f50a77ef7eb1f9734
+  metadata.gz: 8a3e15dee614e4455540272dba417192800fe85d41acdd0ff30babe8681f1d768b408a38fcf8acba878054fab96c94e085516299670b1643c591cc617a165919
+  data.tar.gz: ae7b2e2e3a03019471d741a995d95a83f2e52eeb36137942b14cea55e8e76f8fd48ae734acbad5c2ac1a98a2fc8c88ddf5192ff6a2598f53555d7c08bfcbce9e

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.4.0] - 2025-07-06
+
+- Revert "Fix `AtomicThreadPool#<<` shutdown check race condition"
+- Add `:name` to `AtomicThreadPool` initializer
+- Add `AtomicCountDownLatch`
+
 ## [0.3.2] - 2025-06-14
 
 - Fix `AtomicThreadPool#<<` shutdown check race condition

data/README.md

@@ -190,7 +190,7 @@ puts "Atomic Ruby Atomic Bank Account:     #{results[2].real.round(6)} seconds"
 
 ruby version:            ruby 3.4.4 (2025-05-14 revision a38531fd3f) +YJIT +PRISM [arm64-darwin24]
 concurrent-ruby version: 1.3.5
-atomic-ruby version:     0.3.2
+atomic-ruby version:     0.4.0
 
 Balances:
 Synchronized Bank Account Balance:           975
@@ -198,9 +198,9 @@ Concurrent Ruby Atomic Bank Account Balance: 975
 Atomic Ruby Atomic Bank Account Balance:     975
 
 Benchmark Results:
-Synchronized Bank Account:           5.130792 seconds
-Concurrent Ruby Atomic Bank Account: 5.121400 seconds
-Atomic Ruby Atomic Bank Account:     5.119191 seconds
+Synchronized Bank Account:           5.110062 seconds
+Concurrent Ruby Atomic Bank Account: 5.107966 seconds
+Atomic Ruby Atomic Bank Account:     5.107739 seconds
 ```
 
 </details>
@@ -281,27 +281,27 @@ end
 
 ruby version:            ruby 3.4.4 (2025-05-14 revision a38531fd3f) +YJIT +PRISM [arm64-darwin24]
 concurrent-ruby version: 1.3.5
-atomic-ruby version:     0.3.2
+atomic-ruby version:     0.4.0
 
 Warming up --------------------------------------
 Synchronized Boolean Toggle
-                        87.000 i/100ms
+                       102.000 i/100ms
 Concurrent Ruby Atomic Boolean Toggle
-                        81.000 i/100ms
+                        88.000 i/100ms
 Atomic Ruby Atomic Boolean Toggle
-                        92.000 i/100ms
+                       109.000 i/100ms
 Calculating -------------------------------------
 Synchronized Boolean Toggle
-                        969.205 (± 5.8%) i/s    (1.03 ms/i) -      4.872k in   5.043520s
+                          1.062k (± 2.5%) i/s  (941.81 μs/i) -      5.406k in   5.094827s
 Concurrent Ruby Atomic Boolean Toggle
-                        885.546 (± 5.2%) i/s    (1.13 ms/i) -      4.455k in   5.044282s
+                        981.495 (± 3.5%) i/s    (1.02 ms/i) -      4.928k in   5.027167s
 Atomic Ruby Atomic Boolean Toggle
-                         1.154k (± 5.3%) i/s  (866.65 μs/i) -      5.796k in   5.037272s
+                          1.274k (± 1.5%) i/s  (784.70 μs/i) -      6.431k in   5.047458s
 
 Comparison:
-Atomic Ruby Atomic Boolean Toggle:     1153.9 i/s
-Synchronized Boolean Toggle:            969.2 i/s - 1.19x  slower
-Concurrent Ruby Atomic Boolean Toggle:  885.5 i/s - 1.30x  slower
+Atomic Ruby Atomic Boolean Toggle:         1274.4 i/s
+Synchronized Boolean Toggle:               1061.8 i/s - 1.20x  slower
+Concurrent Ruby Atomic Boolean Toggle:      981.5 i/s - 1.30x  slower
 ```
 
 </details>
@@ -359,11 +359,11 @@ puts "Atomic Ruby Atomic Thread Pool: #{results[1].real.round(6)} seconds"
 
 ruby version:            ruby 3.4.4 (2025-05-14 revision a38531fd3f) +YJIT +PRISM [arm64-darwin24]
 concurrent-ruby version: 1.3.5
-atomic-ruby version:     0.3.2
+atomic-ruby version:     0.4.0
 
 Benchmark Results:
-Concurrent Ruby Thread Pool:    5.032940 seconds
-Atomic Ruby Atomic Thread Pool: 4.508259 seconds
+Concurrent Ruby Thread Pool:    5.02207 seconds
+Atomic Ruby Atomic Thread Pool: 4.503302 seconds
 ```
 
 </details>

data/lib/atomic-ruby/atomic_boolean.rb

@@ -11,11 +11,11 @@ module AtomicRuby
         raise InvalidBooleanError, "expected boolean to be a `TrueClass` or `FalseClass`, got #{value.class}"
       end
 
-      @atom = Atom.new(value)
+      @boolean = Atom.new(value)
     end
 
     def value
-      @atom.value
+      @boolean.value
     end
 
     def true?
@@ -27,15 +27,15 @@ module AtomicRuby
     end
 
     def make_true
-      @atom.swap { true }
+      @boolean.swap { true }
     end
 
     def make_false
-      @atom.swap { false }
+      @boolean.swap { false }
     end
 
     def toggle
-      @atom.swap { |current_value| !current_value }
+      @boolean.swap { |current_value| !current_value }
     end
   end
 end

data/lib/atomic-ruby/atomic_count_down_latch.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "atom"
+
+module AtomicRuby
+  class AtomicCountDownLatch
+    class InvalidCountError < StandardError; end
+    class AlreadyCountedDownError < StandardError; end
+
+    def initialize(count)
+      unless count.is_a?(Integer)
+        raise InvalidCountError, "expected count to be an `Integer`, got #{count.class}"
+      end
+
+      @count = Atom.new(count)
+    end
+
+    def count
+      @count.value
+    end
+
+    def count_down
+      unless @count.value > 0
+        raise AlreadyCountedDownError, "count has already reached zero"
+      end
+
+      @count.swap { |current_value| current_value - 1 }
+    end
+
+    def wait
+      Thread.pass while @count.value > 0
+    end
+  end
+end

data/lib/atomic-ruby/atomic_thread_pool.rb

@@ -8,8 +8,9 @@ module AtomicRuby
     class UnsupportedWorkTypeError < StandardError; end
     class InvalidWorkQueueingError < StandardError; end
 
-    def initialize(size:)
+    def initialize(size:, name: nil)
       @size = size
+      @name = name
       @queue = Atom.new([])
       @threads = []
       @started_threads = Atom.new(0)
@@ -23,13 +24,11 @@ module AtomicRuby
         raise UnsupportedWorkTypeError, "expected work to be a `Proc`, got #{work.class}"
       end
 
-      @queue.swap do |current_queue|
-        if @stopping.true?
-          raise InvalidWorkQueueingError, "cannot queue work during or after pool shutdown"
-        end
-
-        current_queue += [work]
+      if @stopping.true?
+        raise InvalidWorkQueueingError, "cannot queue work during or after pool shutdown"
       end
+
+      @queue.swap { |current_queue| current_queue += [work] }
       true
     end
 
@@ -52,8 +51,9 @@ module AtomicRuby
     def start
       @threads = @size.times.map do |num|
         Thread.new(num) do |idx|
-          name = "AtomicRuby::AtomicThreadPool thread #{idx}"
-          Thread.current.name = name
+          thread_name = String.new("AtomicRuby::AtomicThreadPool thread #{idx}")
+          thread_name << " for #{@name}" if @name
+          Thread.current.name = thread_name
 
           @started_threads.swap { |current_count| current_count + 1 }
 
@@ -65,7 +65,7 @@ module AtomicRuby
               begin
                 work.call
               rescue => err
-                puts "#{name} rescued:"
+                puts "#{thread_name} rescued:"
                 puts "#{err.class}: #{err.message}"
                 puts err.backtrace.join("\n")
               end

data/lib/atomic-ruby/version.rb

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

data/lib/atomic-ruby.rb

@@ -3,7 +3,9 @@
 require_relative "atomic-ruby/version"
 require_relative "atomic-ruby/atomic_ruby"
 require_relative "atomic-ruby/atom"
+require_relative "atomic-ruby/atomic_boolean"
 require_relative "atomic-ruby/atomic_thread_pool"
+require_relative "atomic-ruby/atomic_count_down_latch"
 
 module AtomicRuby
   class Error < StandardError; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: atomic-ruby
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Joshua Young
@@ -27,6 +27,7 @@ files:
 - lib/atomic-ruby.rb
 - lib/atomic-ruby/atom.rb
 - lib/atomic-ruby/atomic_boolean.rb
+- lib/atomic-ruby/atomic_count_down_latch.rb
 - lib/atomic-ruby/atomic_ruby.bundle
 - lib/atomic-ruby/atomic_thread_pool.rb
 - lib/atomic-ruby/version.rb