ick 0.2.4 → 0.3.0

data/History.txt

@@ -15,4 +15,6 @@
   * #fork
 * 6 tiny enhancement
   * work in progress on Advisor
+* 7 minor enhancement
+  * letn added experimentally
   

data/Manifest.txt

@@ -10,7 +10,9 @@ lib/ick/advisor.rb
 lib/ick/base.rb
 lib/ick/bizarro.rb
 lib/ick/guard.rb
+lib/ick/letn.rb
 lib/ick/sugar.rb
+lib/ick/syntax.rb
 lib/ick/tee.rb
 lib/ick/version.rb
 lib/ick/wrap.rb
@@ -26,7 +28,7 @@ test/test_180_seconds.rb
 test/test_advisor.rb
 test/test_helper.rb
 test/test_ick.rb
-test/test_not.rb
+test/test_letn.rb
 website/180seconds.html
 website/180seconds.txt
 website/index.html

data/config/hoe.rb

@@ -58,7 +58,9 @@ hoe = Hoe.new(GEM_NAME, VERS) do |p|
   
   # == Optional
   p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
-  #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  p.extra_deps = [
+    ['ruby2ruby', '>= 1.1.8']
+  ]     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
   
   #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
   

data/lib/ick.rb

@@ -6,4 +6,6 @@ require 'ick/advisor'
 require 'ick/guard'
 require 'ick/tee'
 require 'ick/bizarro'
-require 'ick/sugar'
+require 'ick/sugar'
+require 'ick/syntax'
+require 'ick/letn'

data/lib/ick/letn.rb

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'ruby2ruby'
+
+module Ick
+  
+  module LetnLambda
+    
+    def letn_lambda(names_to_values, proc)
+      sorted_names = (names_to_values || {}).keys.map { |name| name.to_s }.sort
+      letn_body = <<LETN_BODY
+lambda { |#{sorted_names.join(', ')}|
+  #{proc.to_ruby[/^proc \{(.*)\}$/m, 1]}
+}
+LETN_BODY
+      Kernel.eval(letn_body, proc.binding)
+    end
+    
+    def rewritten(names_to_values, proc)
+      sorted_symbols = (names_to_values || {}).keys.map { |name| name.to_s }.sort.map { |name| name.to_sym }
+      lambda { |names_to_values|
+        letn_lambda(names_to_values, proc).call(*sorted_symbols.map { |sym| names_to_values[sym] })
+      }
+    end
+    
+  end
+  
+  # naïve implementation
+  class Letn < Syntax
+    
+    include LetnLambda
+    
+    def rewrite(names_to_values, proc)
+      rewritten(names_to_values, proc)
+    end
+    
+    evaluates_in_calling_environment and returns_result
+    
+  end
+  
+  class Cletn < Letn
+    
+    include LetnLambda
+    
+    def rewrite(names_to_values, proc)
+      @lambda ||= rewritten(names_to_values, proc)
+    end
+    
+    evaluates_in_calling_environment and returns_result
+    
+  end
+  
+end

data/lib/ick/sugar.rb

@@ -1,7 +1,7 @@
 module Ick
   def self.sugarize
-    [Let, Returning, My, Inside, Maybe, Try, Please, Tee, Fork].each do |clazz|
-      clazz.belongs_to Object
+    [Let, Returning, My, Inside, Maybe, Try, Please, Tee, Fork, Letn].each do |clazz|
+      clazz.belongs_to Kernel
     end
   end
 end

data/lib/ick/syntax.rb

@@ -0,0 +1,16 @@
+module Ick
+  
+  class Syntax < Base
+    
+    def rewrite(value, proc)
+      raise 'implemented by subclass or by calling meta-method!'
+    end
+    
+    def invoke(value = nil, &proc)
+      rewritten_proc = rewrite(value, proc)
+      super(value, &rewritten_proc)
+    end
+    
+  end
+  
+end

data/lib/ick/version.rb

@@ -1,8 +1,8 @@
 module Ick #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
-    MINOR = 2
-    TINY  = 4
+    MINOR = 3
+    TINY  = 0
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/test/test_letn.rb

@@ -0,0 +1,17 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestLetn < Test::Unit::TestCase
+  
+  def test_empty_body
+    assert_nil letn(:foo => 'bar') { }
+  end
+  
+  def test_one_parameter
+    assert_equal('expected', letn(:foo => 'expected') { foo }) 
+  end
+  
+  def test_two_parameters
+    assert_equal(3, letn(:one => 1, :two => 2) { one + two })
+  end
+  
+end

data/website/180seconds.html

@@ -33,7 +33,7 @@
     <h1>Ick in 180 seconds or less</h1>
     <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/ick"; return false'>
       <p>Get Version</p>
-      <a href="http://rubyforge.org/projects/ick" class="numbers">0.2.4</a>
+      <a href="http://rubyforge.org/projects/ick" class="numbers">0.3.0</a>
     </div>
     <h2>Transforming your code</h2>
 

data/website/index.html

@@ -33,7 +33,7 @@
     <h1>Invocation Construction Kit</h1>
     <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/ick"; return false'>
       <p>Get Version</p>
-      <a href="http://rubyforge.org/projects/ick" class="numbers">0.2.4</a>
+      <a href="http://rubyforge.org/projects/ick" class="numbers">0.3.0</a>
     </div>
     <h1>&#x2192; &#8216;ick&#8217;</h1>
 
@@ -60,9 +60,6 @@
 
 <pre>sudo gem install ick</pre>
 
-	<p>You can also see <a href="180seconds.html">Ick in 180 seconds or less</a></p>
-
-
 	<h2>Block Structured Ruby</h2>
 
 
@@ -146,6 +143,22 @@
 </pre></p>
 
 
+	<h2>New in Version 0.3!</h2>
+
+
+	<p>Ick version 0.3 includes an experiemental form of let, <code>letn</code>, that allows you to bind multiple variables:</p>
+
+
+	<p><pre class='syntax'>
+<span class="ident">letn</span><span class="punct">(</span>
+    <span class="symbol">:person</span> <span class="punct">=&gt;</span> <span class="constant">Person</span><span class="punct">.</span><span class="ident">find</span><span class="punct">(</span><span class="symbol">:first</span><span class="punct">,</span> <span class="punct">...),</span>
+    <span class="symbol">:place</span>  <span class="punct">=&gt;</span> <span class="constant">City</span><span class="punct">.</span><span class="ident">select</span> <span class="punct">{</span> <span class="punct">...</span> <span class="punct">},</span>
+    <span class="symbol">:thing</span>  <span class="punct">=&gt;</span> <span class="punct">%w(</span><span class="string">ever loving blue eyed</span><span class="punct">))</span> <span class="punct">{</span>
+  <span class="punct">&quot;</span><span class="string"><span class="expr">#{person.name}</span> lives in <span class="expr">#{place}</span> where he is known as the '<span class="expr">#{thing}</span> thing.'</span><span class="punct">&quot;</span>
+<span class="punct">}</span>
+</pre></p>
+
+
 	<p>The Object#andand-style syntax is most useful when you&#8217;re just using it for a single method invocation, such as:</p>
 
 
@@ -246,7 +259,7 @@
 
 	<p>Comments are welcome. Send an email to <a href="mailto:raganwald+rubyforge@gmail.com">Reginald Braithwaite</a>. And you can always visit <a href="http://weblog.raganwald.com/">weblog.raganwald.com</a> to see what&#8217;s cooking.</p>
     <p class="coda">
-      <a href="http://weblog.raganwald.com/">Reginald Braithwaite</a>, 26th March 2008<br>
+      <a href="http://weblog.raganwald.com/">Reginald Braithwaite</a>, 9th May 2008<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/index.txt

@@ -18,8 +18,6 @@ h2. Getting Started
 
 <pre>sudo gem install ick</pre>
 
-You can also see "Ick in 180 seconds or less":180seconds.html
-
 h2. Block Structured Ruby
 
 Although Ruby borrows many of its features from Lisp and its syntax from Algol, it does not have block-local variables. In other words, if you declare a variable anywhere inside of a method, that variable is visible everywhere in that method. This is a problem, because it encourages writing methods where the instance variables create lot of dependencies between different expressions. Those methods can be hard to understand and refactor.
@@ -83,6 +81,19 @@ maybe(Person.find(:first, ...)) { |p|
 }
 </pre>
 
+h2. New in Version 0.3!
+
+Ick version 0.3 includes an experiemental form of let, @letn@, that allows you to bind multiple variables:
+
+<pre syntax="ruby">
+letn(
+    :person => Person.find(:first, ...),
+    :place  => City.select { ... },
+    :thing  => %w(ever loving blue eyed)) {
+  "#{person.name} lives in #{place} where he is known as the '#{thing} thing.'"
+}
+</pre>
+
 The Object#andand-style syntax is most useful when you're just using it for a single method invocation, such as:
 
 <pre syntax="ruby">

data/website/inside.html

@@ -33,7 +33,7 @@
     <h1>Inside the Invocation Construction Kit</h1>
     <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/ick"; return false'>
       <p>Get Version</p>
-      <a href="http://rubyforge.org/projects/ick" class="numbers">0.2.4</a>
+      <a href="http://rubyforge.org/projects/ick" class="numbers">0.3.0</a>
     </div>
     <h2>More about the four block structures</h2>
 
@@ -98,6 +98,51 @@
 	<p>(The four methods were inspired by <a href="http://blog.rubyenrails.nl/articles/2008/02/18/our-daily-method-10-object-r-rs-ds-s">Michiel de Mare&#8217;s</a> post on the same subject, although Ick’s nomenclature is not compatible with Michiel’s. Michiel’s #rsss, #rrss, #rsds, and #rrds are called #returning, #let, #inside, and #my in Ick.)</p>
 
 
+	<h3>letn</h3>
+
+
+	<p>Ick version 0.3 includes an experiemental form of #let, #letn, that allows you to bind multiple variables:</p>
+
+
+	<p><pre class='syntax'>
+<span class="ident">letn</span><span class="punct">(</span>
+    <span class="symbol">:person</span> <span class="punct">=&gt;</span> <span class="constant">Person</span><span class="punct">.</span><span class="ident">find</span><span class="punct">(</span><span class="symbol">:first</span><span class="punct">,</span> <span class="punct">...),</span>
+    <span class="symbol">:place</span>  <span class="punct">=&gt;</span> <span class="constant">City</span><span class="punct">.</span><span class="ident">select</span> <span class="punct">{</span> <span class="punct">...</span> <span class="punct">},</span>
+    <span class="symbol">:thing</span>  <span class="punct">=&gt;</span> <span class="punct">%w(</span><span class="string">ever loving blue eyed</span><span class="punct">))</span> <span class="punct">{</span>
+  <span class="punct">&quot;</span><span class="string"><span class="expr">#{person.name}</span> lives in <span class="expr">#{place}</span> where he is known as the '<span class="expr">#{thing}</span> thing.'</span><span class="punct">&quot;</span>
+<span class="punct">}</span>
+</pre></p>
+
+
+	<p>You must have the <a href="http://seattlerb.rubyforge.org/ruby2ruby/">ruby2ruby gem</a> installed to use #letn. You know the drill:</p>
+
+
+<pre>sudo gem install ruby2ruby</pre>
+
+	<p>Like #let, #letn <em>evaluates_in_value_environment</em> and <em>returns_result</em>. You can roll your own variations if you want something else. If you&#8217;re familiar with Lisp, #letn is a lot like Lisp&#8217;s simplest let macro. But not like letrec or let*. If you don&#8217;t know the difference, then #letn will not suprise you. Basically, the binding of values to names works a lot like you would expect a hash to behave.</p>
+
+
+	<p>For example, if I wrote:</p>
+
+
+	<p><pre class='syntax'>
+<span class="ident">a</span> <span class="punct">=</span> <span class="constant">nil</span>
+<span class="ident">a</span> <span class="punct">=</span> <span class="punct">{</span> <span class="symbol">:foo</span> <span class="punct">=&gt;</span> <span class="ident">call_something_else</span><span class="punct">(),</span> <span class="symbol">:bash</span> <span class="punct">=&gt;</span> <span class="ident">a</span><span class="punct">[</span><span class="symbol">:foo</span><span class="punct">]</span> <span class="punct">}</span>
+</pre></p>
+
+
+	<p>You would consider this bad code, wouldn&#8217;t you? There&#8217;s no expectation that the espressions are evaluated in any particular order. It&#8217;s the same with #letn. This is probably a bad idea:</p>
+
+
+	<p><pre class='syntax'>
+<span class="ident">foo</span> <span class="punct">=</span> <span class="constant">nil</span>
+<span class="ident">letn</span><span class="punct">(</span><span class="symbol">:foo</span> <span class="punct">=&gt;</span> <span class="ident">call_something_else</span><span class="punct">(),</span> <span class="symbol">:bash</span> <span class="punct">=&gt;</span> <span class="ident">foo</span><span class="punct">)</span> <span class="punct">{</span> <span class="punct">...</span> <span class="punct">}</span>
+</pre></p>
+
+
+	<p><code>bash</code> is not going to be bound to the return value of <code>call_something_else</code>, it&#8217;s going to be bound to nil. The variables you bind are only visible inside the block.</p>
+
+
 	<h3>What about #try and #maybe?</h3>
 
 
@@ -312,7 +357,7 @@ Ick::Wrap.instance.invoke_wrapped(Person.find(:first, ...), MyWrapper, :foo, :ba
 
 	<p>Comments are welcome. Send an email to <a href="mailto:raganwald+rubyforge@gmail.com">Reginald Braithwaite</a>. And you can always visit <a href="http://weblog.raganwald.com/">weblog.raganwald.com</a> to see what&#8217;s cooking.</p>
     <p class="coda">
-      <a href="http://weblog.raganwald.com/">Reginald Braithwaite</a>, 9th March 2008<br>
+      <a href="http://weblog.raganwald.com/">Reginald Braithwaite</a>, 9th May 2008<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/inside.txt

@@ -48,6 +48,41 @@ The method #inside returns the value and evaluates the block in the value's envi
 
 (The four methods were inspired by "Michiel de Mare's":http://blog.rubyenrails.nl/articles/2008/02/18/our-daily-method-10-object-r-rs-ds-s post on the same subject, although Ick’s nomenclature is not compatible with Michiel’s. Michiel’s #rsss, #rrss, #rsds, and #rrds are called #returning, #let, #inside, and #my in Ick.)
 
+h3. letn
+
+Ick version 0.3 includes an experiemental form of #let, #letn, that allows you to bind multiple variables:
+
+<pre syntax="ruby">
+letn(
+    :person => Person.find(:first, ...),
+    :place  => City.select { ... },
+    :thing  => %w(ever loving blue eyed)) {
+  "#{person.name} lives in #{place} where he is known as the '#{thing} thing.'"
+}
+</pre>
+
+You must have the "ruby2ruby gem":http://seattlerb.rubyforge.org/ruby2ruby/ installed to use #letn. You know the drill:
+
+<pre>sudo gem install ruby2ruby</pre>
+
+Like #let, #letn _evaluates_in_value_environment_ and _returns_result_. You can roll your own variations if you want something else. If you're familiar with Lisp, #letn is a lot like Lisp's simplest let macro. But not like letrec or let*. If you don't know the difference, then #letn will not suprise you. Basically, the binding of values to names works a lot like you would expect a hash to behave.
+
+For example, if I wrote:
+
+<pre syntax="ruby">
+a = nil
+a = { :foo => call_something_else(), :bash => a[:foo] }
+</pre>
+
+You would consider this bad code, wouldn't you? There's no expectation that the espressions are evaluated in any particular order. It's the same with #letn. This is probably a bad idea:
+
+<pre syntax="ruby">
+foo = nil
+letn(:foo => call_something_else(), :bash => foo) { ... }
+</pre>
+
+@bash@ is not going to be bound to the return value of @call_something_else@, it's going to be bound to nil. The variables you bind are only visible inside the block.
+
 h3. What about #try and #maybe?
 
 The methods #try and #maybe are both implemented as _evaluates_in_calling_environment_, because that is least surprising. But when you're rolling your own, you might want to change that to make things more sugary. For example, here is a different version of #try:

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: ick
 version: !ruby/object:Gem::Version 
-  version: 0.2.4
-date: 2008-04-28 00:00:00 -04:00
+  version: 0.3.0
+date: 2008-05-09 00:00:00 -04:00
 summary: Invocation Construction Kit
 require_paths: 
 - lib
@@ -42,7 +42,9 @@ files:
 - lib/ick/base.rb
 - lib/ick/bizarro.rb
 - lib/ick/guard.rb
+- lib/ick/letn.rb
 - lib/ick/sugar.rb
+- lib/ick/syntax.rb
 - lib/ick/tee.rb
 - lib/ick/version.rb
 - lib/ick/wrap.rb
@@ -58,7 +60,7 @@ files:
 - test/test_advisor.rb
 - test/test_helper.rb
 - test/test_ick.rb
-- test/test_not.rb
+- test/test_letn.rb
 - website/180seconds.html
 - website/180seconds.txt
 - website/index.html
@@ -73,7 +75,7 @@ test_files:
 - test/test_advisor.rb
 - test/test_helper.rb
 - test/test_ick.rb
-- test/test_not.rb
+- test/test_letn.rb
 rdoc_options: 
 - --main
 - README.txt
@@ -91,5 +93,13 @@ extensions: []
 
 requirements: []
 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruby2ruby
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.8
+    version: 

data/test/test_not.rb

@@ -1,5 +0,0 @@
-require File.dirname(__FILE__) + '/test_helper.rb'
-
-def test_not
-  
-end