trenza 0.1.0 → 0.2.0

data/README.md

@@ -1,4 +1,4 @@
-# Trenza
+# Trenza [![Build Status](https://secure.travis-ci.org/porras/trenza.png?branch=master)](http://travis-ci.org/porras/trenza)
 
 Trenza is the spanish word for *braid* or *plait*.
 
@@ -6,13 +6,13 @@ Trenza is the spanish word for *braid* or *plait*.
 
 ![Trenza](http://dl.dropbox.com/u/521377/trenza_cinco.jpg)
 
-Trenza is also an experiment in dynamic programming inspired by the reading of Paolo Perrotta's *“Metaprogramming Ruby”* (an awesome book, by the way), and in evaluation models and strategies, inspired in my late adventures with Erlang and Haskell.
+Trenza is also an experiment in dynamic programming inspired by the reading of [Paolo Perrotta](http://twitter.com/nusco)'s [*“Metaprogramming Ruby”*](http://pragprog.com/book/ppmetr/metaprogramming-ruby) (an awesome book, by the way), and in evaluation models and strategies, inspired in my late adventures with [Erlang](http://www.erlang.org/) and [Haskell](http://haskell.org/).
 
 Trenza provides two methods to every Ruby object: `lazy` and `parallel`. Those two methods return an object that behaves exactly the same way the old one, except that, instead or evaluating its methods right away when they're called, they do it in a *lazy* or *parallel* way.
 
 ## *Lazy* objects
 
-*Lazy* objects defer the actual evaluation of its methods until the moment its really needed:
+*Lazy* objects defer the actual evaluation of its methods until the moment it's really needed:
 
     class Wadus
       def calculate
@@ -28,11 +28,11 @@ Trenza provides two methods to every Ruby object: `lazy` and `parallel`. Those t
     # no calculation is actually done
     
     puts x # now wadus1.calculate is run in order to print it
-           # wadus2.calculate never gets run since its not needed
+           # wadus2.calculate never gets run since it's not needed
 
 ## *Parallel* objects
 
-*Parallel* objects are similar to *lazy* objects, but instead of deferring the whole evaluation of the method, they start it in the background and follow with your program. Whenever the actual return value is needed, then and only then will your program for the calculation to end (in case it hadn't ended already). This way your programs can become massively parallel without changing your programming style at all:
+*Parallel* objects are similar to *lazy* objects, but instead of deferring the whole evaluation of the method, they start it in the background and follow with your program. Whenever the actual return value is needed, then and only then will your program wait for the calculation to end (in case it hadn't ended already). This way your programs can become massively parallel without changing your programming style at all:
 
     class Wadus
       def calculate
@@ -49,7 +49,7 @@ Trenza provides two methods to every Ruby object: `lazy` and `parallel`. Those t
     ...
     
     puts x + y # in case they hadn't finished already, now your program will wait for the
-               # calculations to finished, since the return values are needed
+               # calculations to finish, since the return values are needed
 
 Please note that Trenza uses the underlying Ruby's `Thread` class implementation, so the actual kind of parallelism achieved depends greatly on the Ruby implementation you're using. Check Ruby 1.8, Ruby 1.9 and JRuby documentation for further details.
 
@@ -57,7 +57,7 @@ Please note that Trenza uses the underlying Ruby's `Thread` class implementation
 
 Trenza is an experiment and might not have any practical uses apart from that. But if you find one, let me know!
 
-As for me, scripts with lots of I/O waiting (such as scripts that download files) seem a natural fit for `parallel` (see `examples/download.rb` for an example).
+As for me, scripts with lots of I/O waiting (such as scripts that download files) seem a natural fit for `parallel` (see [`examples/downloads.rb`](https://github.com/porras/trenza/blob/master/examples/downloads.rb) for an example).
 
 ## Usage
 

data/lib/trenza/lazy.rb

@@ -24,7 +24,7 @@ module Trenza
       end
     
       def value
-        @value ||= @block.call
+        @value ||= @block.call.lazy
       end
     end
   end

data/lib/trenza/parallel.rb

@@ -20,7 +20,7 @@ module Trenza
       end
     
       def method_missing(meth, *args, &blk)
-        @thread.value.send(meth, *args, &blk)
+        @thread.value.send(meth, *args, &blk).parallel
       end
     end
   end

metadata

@@ -1,22 +1,32 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: trenza
-version: !ruby/object:Gem::Version
-  version: 0.1.0
+version: !ruby/object:Gem::Version 
+  hash: 23
   prerelease: 
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
-authors:
+authors: 
 - Sergio Gil
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-09 00:00:00.000000000 Z
+
+date: 2012-03-12 00:00:00 Z
 dependencies: []
+
 description: 
 email: sgilperez@gmail.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - README.md
 - lib/trenza/blank_slate.rb
 - lib/trenza/lazy.rb
@@ -27,26 +37,37 @@ files:
 - examples/slow_calculator.rb
 homepage: http://github.com/porras/trenza
 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: 3
+      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: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
 rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
-summary: Adds parallelism to any object in a transparent way
+summary: Adds laziness & parallelism to any Ruby object in a transparent way
 test_files: []
+
+has_rdoc: