promise 0.1.0

data/AUTHORS

@@ -0,0 +1 @@
+* Ben Lavender <blavender@gmail.com> (Lead developer)

data/README

@@ -0,0 +1,35 @@
+# Promising Future
+A glimpse of a promising future in which ruby supports delayed execution
+
+## Overview
+
+    require 'promise'
+    require 'future'    # can just require future if using both
+
+    x = promise { 1 + 2 }
+    y = future  { sleep 10; 5 + 5 }
+
+    puts x      # => 3
+    # ... do work for 5 seconds
+    puts y      # => 10, after blocking 5 seconds
+
+Promises and futures both transparantly delay the execution of a block.
+Futures run the evaluation of the block optimistically in another thread.
+
+Note that this is pretty useless in irb, which will evaluate everything
+as part of its read-eval-print loop.
+
+## Classes
+
+ * {Promise}
+ * {Future}
+
+## Source
+The source is available at <http://github.com/bhuga/promising-future>
+
+## Author
+Ben Lavender (http://github.com/bhuga)
+
+## Unlicense
+Promising Future is free and unencumbered public domain software. For more
+information, see <http://unlicense.org/> or the accompanying UNLICENSE file.

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org/>

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/future.rb

@@ -0,0 +1,50 @@
+require 'promise'
+
+##
+# A delayed-execution result, optimistcally evaluated in a new Thread.
+# @example
+#     x = future { sleep 5; 1 + 2 }
+#     # do stuff...
+#     y = x * 2     # => 6.  blocks unless 5 seconds has passed.
+# 
+class Future
+  
+  instance_methods.each { |m| undef_method m unless m =~ /__/ }
+
+  ##
+  # @param [Proc] block
+  # @return [Future]
+  def initialize(block)
+    @promise = promise &block
+    @thread = Thread.new do
+      @promise.force
+    end
+  end
+
+  ##
+  # The value of the future's evaluation.  Blocks until result available.
+  # @return [Any]
+  def force
+    @thread.join
+    @promise
+  end
+
+  # @private
+  def method_missing(method, *args, &block)
+    @promise.send(method, *args, &block) 
+  end
+
+
+end
+
+
+module Kernel
+
+  # Create a new future 
+  # @example
+  #     x = future { 3 + 3 }
+  def future(&block)
+    Future.new(block)
+  end
+
+end

data/lib/promise.rb

@@ -0,0 +1,56 @@
+
+##
+# A delayed-execution promise.  Promises are only executed once.
+# @example
+#     x = promise { factorial 20 }
+#     y = promise { fibonacci 10**6 }
+#     a = x + 1     # => factorial 20 + 1 after factorial calculates
+#     result = promise { a += y }
+#     abort ""      # whew, we never needed to calculate y
+# @example
+#     y = 5
+#     x = promise { y = y + 5 }
+#     x + 5     # => 15
+#     x + 5     # => 15
+class Promise
+
+  instance_methods.each { |m| undef_method m unless m =~ /__/ }
+
+  # Returns a new promise
+  # @param [Proc] block
+  # @return [Promise]
+  def initialize(block)
+    if block.arity > 0
+      raise ArgumentError, "Cannot store a promise that requires an argument"
+    end
+    @block = block
+    @mutex = Mutex.new
+  end
+
+  # Force the evaluation of this promise immediately
+  # @return [Any]
+  def force
+    @mutex.synchronize do 
+      unless @result
+        @result = @block.call
+      end
+    end
+    @result
+  end
+
+  def method_missing(method, *args, &block)
+    force unless @result
+    @result.send(method, *args, &block)
+  end
+end
+
+module Kernel
+  
+  # Create a new promise
+  # @example
+  #     x = promise { 3 + 3 }
+  def promise(&block)
+    Promise.new(block)
+  end
+
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification 
+name: promise
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Ben Lavender
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-11 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.2
+    version: 
+description: "    A glimpse into a promising future, in which ruby supports delayed execution.\n    Provides 'promise' and 'future' functions.\n"
+email: blavender@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- AUTHORS
+- README
+- UNLICENSE
+- VERSION
+- lib/future.rb
+- lib/promise.rb
+has_rdoc: false
+homepage: http://promise.rubyforge.org/
+licenses: 
+- Public Domain
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.2
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: promising-future
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Promises and futures for Ruby
+test_files: []
+