thread 0.0.4.2 → 0.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1e61241a244fa1f608588c3c156d01f8bad93eff
+  data.tar.gz: 47ad810211ec3eb3f8843d28af75c2f2c593b1ce
+SHA512:
+  metadata.gz: e70de9f4469875502be7c335c380962f7db0bc8737007e008bc37de1f296547dba1c5ca47ab3ef161b68e5c84f3ef85c7a15a1067c770a7cce4d34b068e2d045
+  data.tar.gz: 9b6b631aa5b791a66475898ddbd9ec465f52e254e5caf9d17d41f317dda2df47af64e9b0a72f1b218f941af81c1aa793761dcee832ce6d7199d564fe1e5f5f8f

data/README.md

@@ -67,6 +67,25 @@ loop {
 }
 ```
 
+Pipe
+====
+A pipe allows you to execute various tasks on a set of data in parallel,
+each datum inserted in the pipe is passed along through queues to the various
+functions composing the pipe, the final result is inserted in the final queue.
+
+Example
+-------
+
+```ruby
+require 'thread/pipe'
+
+p = Thread::Pipe.new \
+	|-> d { d * 2 } |-> d { d * 4 }
+
+p << 2
+puts ~p
+```
+
 Promise
 =======
 This implements the promise pattern, allowing you to pass around an object

data/lib/thread/pipe.rb

@@ -0,0 +1,91 @@
+#--
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#                    Version 2, December 2004
+#
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+#
+#  0. You just DO WHAT THE FUCK YOU WANT TO.
+#++
+
+require 'thread'
+
+# A pipe lets you execute various tasks on a set of data in parallel,
+# each datum inserted in the pipe is passed along through queues to the various
+# functions composing the pipe, the final result is inserted in the final queue.
+class Thread::Pipe
+	class Task
+		attr_accessor :input, :output
+
+		def initialize (func, input = Queue.new, output = Queue.new)
+			@input  = input
+			@output = output
+
+			@thread = Thread.new {
+				while true
+					begin
+						value = @input.deq
+						value = func.call(value)
+
+						@output.enq value
+					rescue Exception; end
+				end
+			}
+		end
+
+		def kill
+			@thread.raise
+		end
+	end
+
+	# Create a pipe using the optionally passed objects as input and
+	# output queue.
+	#
+	# The objects must respond to #enq and #deq, and block on #deq.
+	def initialize (input = Queue.new, output = Queue.new)
+		@tasks = []
+
+		@input  = input
+		@output = output
+
+		ObjectSpace.define_finalizer(self, self.class.finalize(@tasks))
+	end
+
+	def self.finalize (tasks)
+		proc {
+			tasks.each(&:kill)
+		}
+	end
+
+	# Insert data in the pipe.
+	def << (data)
+		return if @tasks.empty?
+
+		@input.enq data
+
+		self
+	end
+
+	# Add a task to the pipe, it must respond to #call and #arity,
+	# and #arity must return 1.
+	def | (func)
+		if func.arity != 1
+			raise ArgumentError, 'wrong arity'
+		end
+
+		Task.new(func, (@tasks.empty? ? @input : Queue.new), @output).tap {|t|
+			@tasks.last.output = t.input unless @tasks.empty?
+			@tasks << t
+		}
+
+		self
+	end
+
+	# Get an element from the output queue.
+	def pop (non_block = false)
+		@output.deq(non_block)
+	end
+	
+	alias deq pop
+	alias ~   pop
+end

data/thread.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new {|s|
 	s.name         = 'thread'
-	s.version      = '0.0.4.2'
+	s.version      = '0.0.5'
 	s.author       = 'meh.'
 	s.email        = 'meh@schizofreni.co'
 	s.homepage     = 'http://github.com/meh/ruby-thread'

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: thread
 version: !ruby/object:Gem::Version
-  version: 0.0.4.2
-  prerelease: 
+  version: 0.0.5
 platform: ruby
 authors:
 - meh.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-12 00:00:00.000000000 Z
+date: 2013-03-28 00:00:00.000000000 Z
 dependencies: []
 description: Includes a thread pool, message passing capabilities, a recursive mutex,
   promise, future and delay.
@@ -22,33 +21,32 @@ files:
 - lib/thread/channel.rb
 - lib/thread/delay.rb
 - lib/thread/future.rb
+- lib/thread/pipe.rb
 - lib/thread/pool.rb
 - lib/thread/promise.rb
 - lib/thread/recursive_mutex.rb
 - thread.gemspec
 homepage: http://github.com/meh/ruby-thread
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.0.0
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Various extensions to the base thread library.
 test_files: []
-has_rdoc: