threadpuddle 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 88a3409088076ee968a4af551e72c1c5d769ce0f
+  data.tar.gz: dab7980497489aeeed8f5d022974e31150e2ddc7
+SHA512:
+  metadata.gz: b7475f7a25dfaf771bb2af4b3f47ef3168f927b368f2b580103bd7f09e63831f630cd4d2974a3f06e778fca9cd532a4b1353bc952aaed2e1df0109c8baf8a40a
+  data.tar.gz: 95a9d46bd9aa611b5f4533243a248b68dba7ee853d0d03167cf72d09ca399933f06e1e2e26d656f5fcdf0e23a3a01ba80be2779d5849881ddeb2fbc9fcb91135

data/lib/threadpuddle.rb

@@ -0,0 +1,83 @@
+#
+# Like a smaller, lamer thread pool.
+#
+class ThreadPuddle
+  def initialize capacity=10
+    @capacity = capacity
+    @threads = []
+  end
+
+  attr_reader :capacity
+
+  #
+  # Blocks execution of the calling thread until there's a free
+  # slot in the puddle.
+  #
+  # WARNING: there is no guarantee this will ever return.
+  #
+  def block
+    loop {
+      return self if @threads.length < @capacity
+      if @threads.any?{|t| t.join(0) }
+        sweep
+      end
+    }
+  end
+
+  #
+  # Current size of the puddle.
+  #
+  def size
+    sweep
+    @threads.length
+  end
+
+  #
+  # Spawns a new thread in the puddle.
+  #
+  # If the puddle is full, this call blocks.
+  #
+  # @see ThreadPuddle#block
+  # @return the new Thread object
+  #
+  def spawn *args, &blk
+    # wait for a slot to open
+    block
+    # add the new thread
+    @threads << (t = Thread.new(*args, &blk))
+    t
+  end
+
+  #
+  # Waits for all threads in the puddle to join.
+  #
+  # @return this ThreadPuddle object
+  #
+  def join
+    while @threads.any?
+      sweep
+      @threads.each{|t| t.join rescue nil }
+    end
+    self
+  end
+
+  #
+  # Kills all threads in the puddle.
+  #
+  # @return the number of threads killed
+  #
+  def kill
+    l = @threads.each{|t| t.kill rescue nil }.length
+    sweep
+    l
+  end
+
+private
+
+  # sweep the puddle, delete dead threads
+  def sweep #:nodoc:
+    @threads.delete_if {|t| ! t.alive? }
+  end
+
+end
+

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: threadpuddle
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Matthew Kerwin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-17 00:00:00.000000000 Z
+dependencies: []
+description: Create threads, with an upper bound on how many can exist at the same
+  time.
+email:
+- matthew@kerwin.net.au
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/threadpuddle.rb
+homepage: http://rubygems.org/gems/threadpuddle
+licenses:
+- Simplified BSD License
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.2
+signing_key: 
+specification_version: 4
+summary: Like a smaller, lamer thread pool.
+test_files: []