luego 0.1.0 → 0.2.0

data/.travis.yml

@@ -0,0 +1,11 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - rbx-19mode
+  - ruby-head
+script: rspec spec
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: rbx-19mode

data/README.md

@@ -1,20 +1,27 @@
-Luego
+Luego ![Build status](https://secure.travis-ci.org/brianewing/luego.png?branch=master)
 =====
 
 A simple gem to bring the wonder of Io Futures to Ruby.
 
-Why do you care?
-----------------
+Futures are objects, created with a(n expensive) block, that can be passed around freely and only block at the point that they're used.
 
-*TODO*
+```ruby
+thing = future { fetch_thing_from_slow_api }
+```
+
+`thing` is now just an object that can be passed around. It will 'become' the result as soon as it's used, or your block returns - whichever comes first.
+
+In practice, you could use futures for things like IO, while passing it around like it's the end result you want.
+**The rest of your stack can get on with doing its thing until the result is actually needed/used.**
 
 Usage
 -----
 
 ```ruby
+require 'luego/kernel'
 thing = "hello!"
 
-string = Luego::Future.new do
+string = future do
   sleep 5
   thing
 end
@@ -22,10 +29,10 @@ end
 string.upcase! # 5 seconds pass, then => "HELLO!"
 string === thing # true
 
-future = Luego::Future.new &some_block
-future.ready? # => false until the block, in a new thread, returns
+aye = future &some_block
+aye.ready? # => false until the block, in a new thread, returns
 
-future.await! # => return value of the block, waits for the thread to join
+aye.await! # => return value of the block, waits for the thread to join
 ```
 
 But wait, there's more!

data/lib/luego/delegate.rb

@@ -5,12 +5,12 @@ module Luego
     end
 
     def send(*args, &block)
-      return super unless delegating?
+      return super if not delegating?
       @child.send *args, &block
     end
 
     def method_missing(*args, &block)
-      return super unless delegating?
+      return super if not delegating?
       send *args, &block
     end
 

data/lib/luego/future.rb

@@ -7,14 +7,13 @@ module Luego
 
     def initialize(thread = nil, &block)
       @thread = thread || ::Thread.new(&block)
-      @thread.run
     end
 
     def method_missing(*args, &block)
       await!
       super
     end
-    
+
     def await!
       return @child unless @child.nil?
 

data/lib/luego/kernel.rb

@@ -0,0 +1,7 @@
+require 'luego'
+
+module Kernel
+  def future(*args, &block)
+    Luego::Future.new(*args, &block)
+  end
+end

data/lib/luego/version.rb

@@ -1,3 +1,3 @@
 module Luego
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/spec/delegate_spec.rb

@@ -7,7 +7,7 @@ describe Luego::Delegate do
 
   it "should not delegate methods until delegate! is called" do
     string = Luego::Delegate.new("hello world")
-    Proc.new { string.upcase }.should raise_error NoMethodError
+    lambda { string.upcase }.should raise_error NoMethodError
 
     string.delegate!
     string.upcase.should == "HELLO WORLD"
@@ -16,7 +16,7 @@ describe Luego::Delegate do
   it "should offer its own methods for handling the delegation" do
     d = Luego::Delegate.new(nil)
     d.delegating?.should == false
-    
+
     d.delegate!
     d.delegating?.should == true
 

data/spec/future_spec.rb

@@ -2,21 +2,24 @@ require 'spec_helper'
 
 describe Luego::Future do
   it "should accept both a block and a thread" do
-    Luego::Future.new{sleep 1}.ready?.should == false
-    Luego::Future.new(Thread.new{sleep 1}).ready?.should == false
+    sleeper = lambda { sleep 1 }
+    Luego::Future.new(&sleeper).ready?.should == false
+    Luego::Future.new(Thread.new &sleeper).ready?.should == false
   end
 
   it "shouldn't be ready until its block returns" do
-    future = Luego::Future.new {sleep 0.1}
+    thread = Thread.new { sleep 0.05 }
+
+    future = Luego::Future.new(thread)
     future.ready?.should == false
 
-    sleep 0.2
+    thread.join
     future.ready?.should == true
   end
 
   it "should 'become' the future object when it's ready" do
     subject = "hello"
-    future = Luego::Future.new{subject}
+    future = Luego::Future.new { subject }
 
     future.should === subject
     subject.upcase!

data/spec/kernel_spec.rb

@@ -0,0 +1,16 @@
+describe "Kernel#future" do
+  it "should not be defined before requiring 'luego/kernel'" do
+    Kernel.instance_methods.should_not include(:future)
+  end
+
+  it "should define Kernel#future" do
+    require 'luego/kernel'
+
+    Kernel.instance_methods.should include(:future)
+  end
+
+  it "should work like using Luego::Future.new" do
+    future { 5 }.should == 5
+    future { sleep 5 }.ready?.should == false
+  end
+end

metadata

@@ -1,41 +1,48 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: luego
-version: !ruby/object:Gem::Version
-  version: 0.1.0
+version: !ruby/object:Gem::Version 
+  hash: 2380615109590600174
   prerelease: 
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
-authors:
+authors: 
 - Brian Ewing
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-01 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
+
+date: 2012-10-31 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-description: Simplify your threads with future objects that turn into the thread value
-  when it finishes
-email:
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 2002549777813010636
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Simplify your threads with future objects that turn into the thread value when it finishes
+email: 
 - me@brianewing.co.uk
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - .gitignore
+- .travis.yml
 - Gemfile
 - LICENSE
 - README.md
@@ -43,36 +50,48 @@ files:
 - lib/luego.rb
 - lib/luego/delegate.rb
 - lib/luego/future.rb
+- lib/luego/kernel.rb
 - lib/luego/version.rb
 - luego.gemspec
 - spec/delegate_spec.rb
 - spec/future_spec.rb
+- spec/kernel_spec.rb
 - spec/spec_helper.rb
 homepage: http://brianewing.me
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 2002549777813010636
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 2002549777813010636
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.8.21
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Implementation of Futures from the great Io language
-test_files:
+test_files: 
 - spec/delegate_spec.rb
 - spec/future_spec.rb
+- spec/kernel_spec.rb
 - spec/spec_helper.rb