epitools 0.5.128 → 0.5.129

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55db8684ff41f2465660f1b532823595eda3c5ffadcd15e43538c29a5ea5ef20
-  data.tar.gz: e866e2ebc77c18506142528d9de6da16db99a03f31f1caed72960329439d2a8e
+  metadata.gz: 74b341f10e9697a2d9e93aad5aa91b7f799e75a3cd817d712bce3e15cd18428d
+  data.tar.gz: bce241006bd3b743410e3b6833145a5e72052637d7e918caa2562564b6ad4f5b
 SHA512:
-  metadata.gz: 4d3c32dd1040271ae4eaf4e6d4a190d0d3518ceff7eb91a668ab243a306410460bc6336262e12f2d8db2b6e5f5ad87ae91c13e3eff23a2f31b4fb999b671cf29
-  data.tar.gz: '086ea2d99290c419af5cecd34bcfd367517429bee37f2ff0a404178b8ae50f46ba2fd68b147f456bd0ea946b89665f592c463c47b4423f6d953d317b3cc5ea5f'
+  metadata.gz: ef8edebf3480e814c17e90f5c200fe1dc70a45827d8c2e52d2d7834291f61fb67824c5c5b6f869805f8751ea53d0eb95aa83e86daba42eb748d34ea66061ad6a
+  data.tar.gz: 38abf237811351f91306dd1d1e66e9104040645aa3ff743d13609a155853aa6ffa80b9967961edda5f20e1ad67068ffc298beafac47857210eca9ebb6a4ec87f

data/VERSION

@@ -1 +1 @@
-0.5.128
+0.5.129

data/lib/epitools/autoloads.rb

@@ -65,19 +65,20 @@ autoload :IPAddr, 'ipaddr'
 
 ## Nonstandard library (epitools)
 
-autoload :Path,         'epitools/path'
-autoload :Ezdb,         'epitools/ezdb'
-autoload :Browser,      'epitools/browser'
-autoload :Rash,         'epitools/rash'
-autoload :Ratio,        'epitools/ratio'
-autoload :ProgressBar,  'epitools/progressbar'
-autoload :Trie,         'epitools/trie'
-autoload :MimeMagic,    'epitools/mimemagic'
-autoload :Term,         'epitools/term'
-autoload :Iter,         'epitools/iter'
-autoload :WM,           'epitools/wm'
-autoload :TypedStruct,  'epitools/typed_struct'
-autoload :Sys,          'epitools/sys'
+autoload :Path,            'epitools/path'
+autoload :Ezdb,            'epitools/ezdb'
+autoload :Browser,         'epitools/browser'
+autoload :Rash,            'epitools/rash'
+autoload :Ratio,           'epitools/ratio'
+autoload :ProgressBar,     'epitools/progressbar'
+autoload :Trie,            'epitools/trie'
+autoload :MimeMagic,       'epitools/mimemagic'
+autoload :Term,            'epitools/term'
+autoload :Iter,            'epitools/iter'
+autoload :WM,              'epitools/wm'
+autoload :TypedStruct,     'epitools/typed_struct'
+autoload :Sys,             'epitools/sys'
+autoload :JobRunner,       'epitools/job_runner'
 autoload :SemanticVersion, 'epitools/semantic_version'
 
 autoload :Matrix, 'epitools/core_ext/matrix'
@@ -87,7 +88,7 @@ autoreq(:Vector) { Matrix }
 module Epi
   autoload :Slop, 'epitools/slop'
 end
-autoreq(:Slop) do 
+autoreq(:Slop) do
   Slop = Epi::Slop
 end
 

data/lib/epitools/job_runner.rb

@@ -0,0 +1,97 @@
+#
+# Runs many jobs in parallel, and returns their interleaved results.
+# (NOTE: The JobRunner can be run multiple times; each time the blocks
+#  will be executed again.)
+#
+# Examples:
+#
+# JobRunner.new do |jr|
+#   jr.add { 3 }
+#   jr.add { sleep 0.1; 2 }
+#   jr.add { sleep 0.2; 1 }
+#
+#   jr.each_result do |result|
+#     p result
+#   end
+# end
+#
+# jr = JobRunner.new(
+#   proc { 1 },
+#   proc { 2 },
+#   proc { 3 }
+# )
+#
+# 2.times do
+#   jr.each_result { |result| p result }
+# end
+#
+class JobRunner
+  def initialize(*blocks)
+    @threads = []
+    @results = Thread::Queue.new
+    @jobs    = []
+    @started = false
+
+    if blocks.any?
+      blocks.each { |block| add &block }
+    else
+      yield self if block_given?
+    end
+  end
+
+  def add(&block)
+    @jobs << block
+  end
+
+  def reap!
+    @threads.delete_if { |t| not t.alive? } if @threads.any?
+  end
+
+  def go!
+    raise "Error: already started" if @started
+    @started = true
+    @jobs.each do |job|
+      @threads << Thread.new do
+        @results << job.call
+      end
+    end
+  end
+
+  def each_result
+    go! unless @started
+
+    loop do
+      yield @results.pop
+      reap!
+      break if @threads.empty? and @results.empty?
+    end
+
+    @started = false
+  end
+end
+
+
+if __FILE__ == $0
+  JobRunner.new do |jr|
+    jr.add { 3 }
+    jr.add { sleep 0.1; 2 }
+    jr.add { sleep 0.2; 1 }
+
+    jr.each_result do |result|
+      p result
+    end
+  end
+
+  puts
+
+  jr = JobRunner.new(
+    proc { 1 },
+    proc { 2 },
+    proc { 3 }
+  )
+
+  2.times do
+    jr.each_result { |r| p r }
+    puts
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: epitools
 version: !ruby/object:Gem::Version
-  version: 0.5.128
+  version: 0.5.129
 platform: ruby
 authors:
 - epitron
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-09-22 00:00:00.000000000 Z
+date: 2020-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -72,6 +72,7 @@ files:
 - lib/epitools/hexdump.rb
 - lib/epitools/iter.rb
 - lib/epitools/its.rb
+- lib/epitools/job_runner.rb
 - lib/epitools/lcs.rb
 - lib/epitools/mimemagic.rb
 - lib/epitools/mimemagic_tables.rb