stagnum 0.9.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d935b2dcef0e06bf324569727b0e0416444d733d20da884426bd28d5d76ea18
-  data.tar.gz: f00a9639d70ba8c6fbd3da0e0877e4c8bbff5ae8968a1691d5312644f230e4b4
+  metadata.gz: e0cac0775cf6ecc7f093c11d1e7d0b5a5cc1684ec54c2d6437343206a4428737
+  data.tar.gz: 87a83019e96db408649034b01ddae9be7e1061ae27d68bdc5b0cd5cea0d1c58c
 SHA512:
-  metadata.gz: '08c53834df95715abd1b77ab151ff49d29b9913db15cb81903c18174e67e0a2d4b33fecd45697efdfb4574bb732b0cb840b2d438ac9def2bae70e448b41eeea9'
-  data.tar.gz: ce0f53b3c4650e5aa3d2e1880a4fe31a49162949881f1fa755c70e7b9aed8979669e3044027aff6297515c19f33139a6c7b2cc7ebaa055898226b80e983c12ce
+  metadata.gz: ec87441d4d3ed2cb15da9b41fccb4fee7cece403e52159acff0f16cc43f54ebafcf280a38a418b83f9e49f62ba55c6664c981ee1042bce2caf19cd7a83a81f0c
+  data.tar.gz: c9cc2a5b4f35eac7c4be651c65182631b4c550e61389d6ec44a33700be2f951256d8e0661275c7ba206858dfa1e54decd7bf7598c46e879ee1fce5ce326f068e

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+
+# CHANGELOG.md
+
+
+## stagnum 1.0.0 released 2025-03-05
+
+* Stagnum::DoneQueue.on_(success|failure|pop)
+
+
+## stagnum 0.9.0 released 2025-03-04
+
+* Initial release
+

data/README.md

@@ -45,6 +45,32 @@ pp successes
 
 One can use `Thread::Queue` instead of `Stagnum::DoneQueue`
 
+`Stagnum::DoneQueue` also has `#on_success` and `#on_failure` methods:
+
+```ruby
+pool = Stagnum::Pool.new('pool-zero', 4)
+
+s, f = [], []
+
+q = Stagnum::DoneQueue.new
+q.on_success do |r|
+  s << r
+end
+q.on_failure do |r|
+  f << r
+end
+
+30.times do |i|
+
+  pool.enqueue(q, { i: i }) do |d|
+    sleep rand * 1
+    d[:tname] = Thread.current.name
+  end
+end
+
+q.pop_all
+```
+
 ## LICENSE
 
 MIT, see [LICENSE.txt](LICENSE.txt)

data/lib/stagnum.rb

@@ -5,8 +5,7 @@ require 'thread'
 
 module Stagnum
 
-  VERSION = '0.9.0'
-
+  VERSION = '1.0.0'.freeze
 
   class Pool
 
@@ -57,12 +56,13 @@ module Stagnum
 
   class DoneQueue < ::Thread::Queue
 
-    attr_reader :count
+    attr_reader :listeners, :count
 
     def initialize(items=[])
 
       super
 
+      @listeners = []
       @count = 0
     end
 
@@ -77,20 +77,36 @@ module Stagnum
 
       @count.times
         .inject([ [], [] ]) { |a, i|
-          r = self.pop
+          r = pop
           a[r[0] == :success ? 0 : 1] << r
           a }
     end
+
+    def pop(non_blocking=false)
+
+      r = super
+
+      @listeners.each do |l|
+        l0 = l[0]
+        l[1].call(r) if l0 == :any || l0 == r[0]
+      end if r.is_a?(Array)
+
+      r
+    end
+
+    def on_success(&block); @listeners << [ :success, block ]; end
+    def on_failure(&block); @listeners << [ :failure, block ]; end
+    def on_pop(&block); @listeners << [ :any, block ]; end
   end
 
   class WorkerThread < ::Thread
 
-    def initialize(stagnum, work_queue)
+    def initialize(pool, work_queue)
 
-      @stagnum = stagnum
+      @pool = pool
       @work_queue = work_queue
 
-      self.name = "#{stagnum.name}__#{stagnum.next_worker_thread_id}"
+      self.name = "#{pool.name}__#{pool.next_worker_thread_id}"
 
       super do
 

data/stagnum.gemspec

@@ -12,10 +12,10 @@ Gem::Specification.new do |s|
   s.email = [ 'jmettraux+flor@gmail.com' ]
   s.homepage = 'https://github.com/floraison/stagnum'
   s.license = 'MIT'
-  s.summary = 'a worker pool'
+  s.summary = 'a work thread pool'
 
   s.description = %{
-A stupid worker pool
+A stupid work thread pool
   }.strip
 
   s.metadata = {

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: stagnum
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 1.0.0
 platform: ruby
 authors:
 - John Mettraux
 bindir: bin
 cert_chain: []
-date: 2025-03-04 00:00:00.000000000 Z
+date: 2025-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: probatio
@@ -23,13 +23,14 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-description: A stupid worker pool
+description: A stupid work thread pool
 email:
 - jmettraux+flor@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 - lib/stagnum.rb
@@ -60,5 +61,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.2
 specification_version: 4
-summary: a worker pool
+summary: a work thread pool
 test_files: []