ready_pool 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    OGE3MTVjNThkYTQxM2U3ZGE1ODg4OWU2ODUyMWNiZDNjYzk1ZWJhYg==
+  data.tar.gz: !binary |-
+    MDQ4OWJkOTQyZjVhOTZmOGNiMmQ5OGNjYjdjYmVmYmUyYjhmZjk0NQ==
+SHA512:
+  metadata.gz: !binary |-
+    ODM0ODIxZjEzYTkzYmJjMDAzMzNlZWY5N2YzYTI3YjBjYTI2OGUzYTU5OTVj
+    ZjJkNWI0ZDFlYzk2ZTk0ODA3NDk2N2NhNDIzZTE1ZTgzZDIxMjVhNTkwZDll
+    M2ZjMWRmMGViNzZiZmE0OTYxMjEyY2U2YzFkMTQ2NTZlZGE4NzI=
+  data.tar.gz: !binary |-
+    Y2U0ODdlYzcyNGU4ZWVhODU5ZTkxNDRmNWJlMTAzNzRmMWM5NDgzOWM3Y2Q1
+    NTk5ZTZmOThlNzliNWZjZDVkMTczYTJhNzY3ZTk0MjNkMmQ5ODUwYjUwMjhm
+    MDc0YmUxNWQyNGExYWRkNDljZTk3NjgwZWY2MDBlZGY5OTg1ZGY=

data/lib/ready_pool.rb

@@ -0,0 +1,131 @@
+require 'thread'
+
+########################################################################
+# thread pool implementation
+#
+# In the example 10 threads are prepared to run the Proc passed as the 
+# second argument. If more are needed they are spun up when required.
+# When a thread completes its task it returns itself to the pool.
+#
+# The start method passes its argument to the thread Proc.
+#
+# ==Example
+# 	
+#	require 'ready_pool'
+#	require 'async_emitter'
+#
+#	emitter = AsyncEmitter.new
+#
+#	emitter.on :data, lambda { |data| puts "emitted #{data}" }
+#
+#	rp = ReadyPool.new 10, Proc.new { |data| emitter.emit :data, data }
+#
+#	20.times do |i|
+#		rp.start i
+#	end
+#
+#	gets #wait for user input
+#
+#	rp.kill_all
+#
+########################################################################
+
+class ReadyPool
+
+	################################################################
+	# ReadyPool constructor
+	#
+	# @param num_threads [FixedNum] initial number of threads
+	# @param procedure [Proc] called when start method is called
+	################################################################
+	def initialize (num_threads, procedure)
+		@procedure = procedure
+		@pool_semaphore = Mutex.new
+		@pool_condition = ConditionVariable.new
+		@pool = []
+
+		@pool_semaphore.synchronize do
+			num_threads.times do |i|
+				@pool[i] = new_thread
+				@pool[i][:ready] = false
+				
+				@pool[i][:thread] = Thread.new do 
+					thread_proc @pool[i]
+				end
+
+				@pool_condition.wait @pool_semaphore
+
+			end
+		end
+	end
+
+	################################################################
+	# starts the thread
+	#
+	# @param data [Object] data passed to the thread Proc
+	################################################################
+	def start data
+		th = nil
+		@pool_semaphore.synchronize do
+			th = @pool.shift
+		end
+
+		if th == nil
+			th = new_thread
+			th[:ready] = false
+			th[:thread] = Thread.new do
+				thread_proc th
+			end
+				
+			@pool_semaphore.synchronize do
+				@pool_condition.wait @pool_semaphore
+			end
+		end
+
+		th[:data] = data
+		signal_thread th	
+	end
+
+	################################################################
+	# kills all threads
+	################################################################
+	def kill_all
+		@pool.each do |th|
+			Thread.kill th[:thread]
+		end
+		@pool = []
+	end
+
+	protected
+	def thread_proc (th)
+		while true
+			th[:semaphore].synchronize do
+
+				@pool_semaphore.synchronize do
+					@pool_condition.signal
+				end
+
+				th[:cv].wait th[:semaphore]
+				@procedure.call th[:data]
+				@pool_semaphore.synchronize do
+					@pool.push th
+				end	
+				
+			end
+		end
+	end
+
+	def new_thread
+		th = {}
+		th[:semaphore] = Mutex.new
+		th[:cv] = ConditionVariable.new
+		return th
+	end
+
+	def signal_thread (th)
+		th[:semaphore].synchronize do
+			th[:cv].signal
+		end
+	end
+end
+

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: ready_pool
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Greg Martin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-27 00:00:00.000000000 Z
+dependencies: []
+description: A thread pool implementation for ruby
+email: greg@softsprocket.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ready_pool.rb
+homepage: http://rubygems.org/gems/ready_pool.rb
+licenses:
+- MIT
+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.4.6
+signing_key: 
+specification_version: 4
+summary: ReadyPool
+test_files: []
+has_rdoc: