thread 0.0.1.1 → 0.0.2

data/README.md

@@ -66,3 +66,45 @@ loop {
   sleep 0.5
 }
 ```
+
+Promise
+=======
+This implements the promise pattern, allowing you to pass around an object
+where you can send a value and extract a value, in a thread-safe way, accessing
+the value will wait for the value to be delivered.
+
+Example
+-------
+
+```ruby
+require 'thread/promise'
+
+p = promise
+
+Thread.new {
+  sleep 5
+  p << 42
+}
+
+puts ~p # => 42
+```
+
+Future
+======
+A future is somewhat a promise, except you pass it a block to execute in
+another thread.
+
+The value returned by the block will be the value of the promise.
+
+Example
+-------
+
+```ruby
+require 'thread/future'
+
+puts ~future {
+  sleep 5
+
+  42
+} # => 42
+```

data/lib/thread/future.rb

@@ -0,0 +1,25 @@
+#--
+#            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/promise'
+
+class Thread::Future < Thread::Promise
+	def initialize (&block)
+		Thread.new {
+			deliver block.call
+		}
+	end
+end
+
+module Kernel
+	def future (&block)
+		Thread::Future.new(&block)
+	end
+end

data/lib/thread/pool.rb

@@ -18,9 +18,13 @@ class Thread::Pool
 		attr_reader :pool, :timeout, :exception, :thread, :started_at
 
 		def initialize (pool, *args, &block)
-			@pool      = pool
-			@arguments = args
-			@block     = block
+			@pool       = pool
+			@arguments  = args
+			@block      = block
+			@running    = false
+			@finished   = false
+			@timedout   = false
+			@terminated = false
 		end
 
 		def running?;    @running;   end
@@ -221,7 +225,7 @@ class Thread::Pool
 	end
 
 	def wake_up_timeout
-		if @pipes
+		if defined? @pipes
 			@pipes.last.write_nonblock 'x' rescue nil
 		end
 	end

data/lib/thread/promise.rb

@@ -0,0 +1,64 @@
+#--
+#            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'
+
+class Thread::Promise
+	def delivered?
+		instance_variable_defined? :@value
+	end
+
+	def deliver (value)
+		return if delivered?
+
+		@value = value
+
+		if cond?
+			mutex.synchronize {
+				cond.broadcast
+			}
+		end
+
+		self
+	end
+
+	alias << deliver
+
+	def value
+		return @value if delivered?
+
+		mutex.synchronize {
+			cond.wait(mutex)
+		}
+
+		return @value
+	end
+
+	alias ~ value
+
+private
+	def cond?
+		instance_variable_defined? :@cond
+	end
+
+	def cond
+		@cond ||= ConditionVariable.new
+	end
+
+	def mutex
+		@mutex ||= Mutex.new
+	end
+end
+
+module Kernel
+	def promise
+		Thread::Promise.new
+	end
+end

data/thread.gemspec

@@ -1,12 +1,12 @@
 Gem::Specification.new {|s|
 	s.name         = 'thread'
-	s.version      = '0.0.1.1'
+	s.version      = '0.0.2'
 	s.author       = 'meh.'
 	s.email        = 'meh@schizofreni.co'
 	s.homepage     = 'http://github.com/meh/ruby-thread'
 	s.platform     = Gem::Platform::RUBY
 	s.summary      = 'Various extensions to the base thread stdlib.'
-	s.description  = 'Includes a thread pool, message passing capabilities and a recursive mutex.'
+	s.description  = 'Includes a thread pool, message passing capabilities, a recursive mutex, promise and future.'
 
 	s.files         = `git ls-files`.split("\n")
 	s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: thread
 version: !ruby/object:Gem::Version
-  version: 0.0.1.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,10 +9,10 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-10 00:00:00.000000000 Z
+date: 2013-02-25 00:00:00.000000000 Z
 dependencies: []
-description: Includes a thread pool, message passing capabilities and a recursive
-  mutex.
+description: Includes a thread pool, message passing capabilities, a recursive mutex,
+  promise and future.
 email: meh@schizofreni.co
 executables: []
 extensions: []
@@ -20,7 +20,9 @@ extra_rdoc_files: []
 files:
 - README.md
 - lib/thread/channel.rb
+- lib/thread/future.rb
 - lib/thread/pool.rb
+- lib/thread/promise.rb
 - lib/thread/recursive_mutex.rb
 - thread.gemspec
 homepage: http://github.com/meh/ruby-thread
@@ -43,7 +45,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Various extensions to the base thread stdlib.