Narnach-future 0.1.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Wes Oldenbeuving
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

data/README.rdoc

@@ -0,0 +1,42 @@
+= Future
+
+Future implements the future concept from IO.
+A future is an object that you create now, but which only gets a usable
+value in the future. Think of asynchronous messaging and long-lasting method
+calls.
+
+An example:
+  include Future
+  f = future { sleep 5; 123}
+  puts f * 5
+The future will take 5 seconds to run, then 123 is returned.
+The call f.*(5) will block until the future is done.
+
+Another example:
+  include Future
+  f1 = future { sleep 5; 10}
+  f2 = future { sleep 3; 20}
+  f3 = future { sleep 1; 30}
+  puts f3 + f2 + f1
+Here it only takes 5 seconds to calculate the sum instead of the 9 it would take when done sequentially.
+
+== Recent changes
+
+=== Version 0.1.1
+* Added specs
+
+=== Version 0.1.0
+* Created project
+* Added first version of future.rb, wrapped in a Module
+* Added documentation
+
+== Installation
+=== From git
+From the project root, use rake to install.
+  git clone http://github.com/Narnach/future
+  cd future
+  rake install
+This will build the gem and install it for you.
+
+== About
+future was created by Wes Oldenbeuving. It is licensed under the MIT license.

data/Rakefile

@@ -0,0 +1,29 @@
+require "rake"
+require "rake/clean"
+require "rake/gempackagetask"
+require 'rubygems'
+
+################################################################################
+### Gem
+################################################################################
+
+begin
+  # Parse gemspec using the github safety level.
+  data = File.read('future.gemspec')
+  spec = nil
+  Thread.new { spec = eval("$SAFE = 3
+%s" % data)}.join
+
+  # Create the gem tasks
+  Rake::GemPackageTask.new(spec) do |package|
+    package.gem_spec = spec
+  end
+rescue Exception => e
+  printf "WARNING: Error caught (%s): %s
+", e.class.name, e.message
+end
+
+desc 'Package and install the gem for the current version'
+task :install => :gem do
+  system "sudo gem install -l pkg/%s-%s.gem" % [spec.name, spec.version]
+end

data/future.gemspec

@@ -0,0 +1,33 @@
+Gem::Specification.new do |s|
+  # Project
+  s.name         = 'future'
+  s.summary      = "A naieve implementation of futures"
+  s.description  = "A naieve implementation of futures"
+  s.version      = '0.1.1'
+  s.date         = '2008-12-08'
+  s.platform     = Gem::Platform::RUBY
+  s.authors      = ["Wes Oldenbeuving"]
+  s.email        = "narnach@gmail.com"
+  s.homepage     = "http://www.github.com/Narnach/future"
+
+  # Files
+  root_files     = %w[MIT-LICENSE README.rdoc Rakefile future.gemspec]
+  bin_files      = %w[]
+  lib_files      = %w[future]
+  test_files     = %w[]
+  spec_files     = %w[future]
+  other_files    = %w[spec/spec_helper.rb]
+  s.bindir       = "bin"
+  s.require_path = "lib"
+  s.executables  = bin_files
+  s.test_files   = test_files.map {|f| 'test/%s_test.rb' % f} + spec_files.map {|f| 'spec/%s_spec.rb' % f}
+  s.files        = root_files + bin_files.map {|f| 'bin/%s' % f} + lib_files.map {|f| 'lib/%s.rb' % f} + s.test_files + other_files
+
+  # rdoc
+  s.has_rdoc         = true
+  s.extra_rdoc_files = %w[ README.rdoc MIT-LICENSE]
+  s.rdoc_options << '--inline-source' << '--line-numbers' << '--main' << 'README.rdoc'
+
+  # Requirements
+  s.required_ruby_version = ">= 1.8.0"
+end

data/lib/future.rb

@@ -0,0 +1,33 @@
+# Future implements the future concept from IO.
+# A future is an object that you create now, but which only gets a usable
+# value in the future. Think of asynchronous messaging and long-lasting method
+# calls.
+#
+# An example:
+#   include Future
+#   f = future { sleep 5; 123}
+#   puts f * 5 #=> 615
+# The future will take 5 seconds to run, then 123 is returned.
+# The call f.*(5) will block until the future is done.
+#
+# Another example:
+#   include Future
+#   f1 = future { sleep 5; 10}
+#   f2 = future { sleep 3; 20}
+#   f3 = future { sleep 1; 30}
+#   puts f3 + f2 + f1
+# Here it only takes 5 seconds to calculate the sum instead of the 9 it would take when done sequentially.
+module Future
+  def future(&block)
+    t = Thread.new(&block)
+    class << t
+      (instance_methods - %w[value __send__ __id__]).each do |meth|
+        eval("undef #{meth}")
+      end
+      def method_missing(*args, &block)
+        value.send(*args,&block)
+      end
+    end
+    t
+  end
+end

data/spec/future_spec.rb

@@ -0,0 +1,28 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+require 'future'
+
+class TimeTraveller
+  include Future
+end
+
+describe Future, '#future' do
+  it 'should return the return value of the block' do
+    tt = TimeTraveller.new
+    f1 = tt.future { 10 }
+    f2 = tt.future { 20 }
+    f3 = tt.future { 30 }
+    (f3 + f2 + f1).should == 60
+  end
+
+  it 'should execute futures in parallel' do
+    tt = TimeTraveller.new
+    now = Time.now
+    f1 = tt.future { sleep 0.2; 10 }
+    f2 = tt.future { sleep 0.1; 20 }
+    f3 = tt.future { 30 }
+    f3+f2+f1
+    diff = Time.now - now
+    diff.should < 0.3
+    diff.should > 0.1
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+lib_dir = File.join(File.dirname(__FILE__),'..','lib')
+$LOAD_PATH.unshift(lib_dir)

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: Narnach-future
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Wes Oldenbeuving
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-08 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: A naieve implementation of futures
+email: narnach@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- MIT-LICENSE
+files: 
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- future.gemspec
+- lib/future.rb
+- spec/future_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://www.github.com/Narnach/future
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --line-numbers
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.0
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A naieve implementation of futures
+test_files: 
+- spec/future_spec.rb