ember 0.2.0 → 0.3.0

data/lib/ember/inochi.rb

@@ -18,12 +18,12 @@ module Ember
   ##
   # Number of this release of this project.
   #
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 
   ##
   # Date of this release of this project.
   #
-  RELDATE = "2010-04-25"
+  RELDATE = "2010-04-26"
 
   ##
   # Description of this release of this project.

data/lib/ember/template.rb

@@ -61,24 +61,14 @@ module Ember
       @compile
     end
 
-    @@contexts = {}
-
     ##
     # Returns the result of executing the Ruby program for this template
     # (provided by the {#program} method) inside the given context binding.
     #
-    def render context = nil, parent_context_id = nil
-      context ||=
-        @@contexts[parent_context_id] ||        # inherit parent context
-        Object.new.instance_eval('binding')     # create new context
-      @@contexts[@render_context_id] = context  # provide to children
-
-      result = eval @compile, context,
+    def render context = Object.new.instance_eval('binding')
+      eval @compile, context,
         (@options[:source_file] || :SOURCE).to_s,
         (@options[:source_line] || 1).to_i
-
-      @@contexts.delete @render_context_id      # free the memory
-      result
     end
 
     class << self
@@ -104,6 +94,69 @@ module Ember
         File.read resolve_path(path, options)
       end
 
+      ##
+      # Returns the template evaluation result buffer
+      # associated with the given content block.
+      #
+      def buffer_from_block content_block
+        context = content_block.binding
+        result_variable = eval(Program::RESULT_VARIABLE_BACKDOOR, context)
+        eval result_variable.to_s, context
+      end
+
+      ##
+      # Invokes the given block while passing the given arguments to
+      # it and then returns an Array of things that the given block
+      # tried to append to its template evaluation result buffer.
+      #
+      # If the given block did not try to append anything, then the
+      # result of invoking the given block is returned as an Array.
+      #
+      def content_from_block content_block, *content_block_args
+        context = content_block.binding
+
+        orig_result_variable = eval(Program::RESULT_VARIABLE_BACKDOOR, context)
+        temp_result_variable = "#{orig_result_variable}_#{context.object_id.abs}"
+        eval "#{temp_result_variable} = #{orig_result_variable}", context
+
+        begin
+          # the content block appends to the result buffer when invoked.
+          # so we temporarily replace the result buffer with an empty one,
+          # invoke the content block, and viola!  we now have its content.
+          block_content = eval("#{orig_result_variable} = []", context)
+          return_value = content_block.call(*content_block_args)
+        ensure
+          eval "#{orig_result_variable} = #{temp_result_variable}", context
+        end
+
+        if block_content.empty?
+          # no content was appended to the result buffer when the content
+          # block was invoked because it did not contain any vocal directives.
+          # so we return the return value of content block invocation instead.
+          Array(return_value)
+        else
+          block_content
+        end
+      end
+
+      ##
+      # Passes the given content block's content (obtained by invoking
+      # the given content block with the given arguments) as an argument
+      # to given wrapper block.  The result of the wrapper block is (1)
+      # appended to the template evaluation result buffer associated with
+      # the given content block and is (2) returned by this method.
+      #
+      def wrap_content_block content_block, *content_block_args, &wrapper
+        raise ArgumentError, 'wrapper block must be given' unless wrapper
+
+        buffer = buffer_from_block(content_block)
+        content = content_from_block(content_block, *content_block_args)
+
+        wrapped_content = wrapper.call(content)
+        buffer << wrapped_content
+        wrapped_content
+      end
+
       private
 
       def resolve_path path, options = {}
@@ -368,7 +421,7 @@ module Ember
         nest_template_with = lambda do |meth|
           @program.emit_code "#{template_class_name}.#{meth}(#{
             nested_template_args
-          }.merge!(:continue_result => true)).render(nil, #{@render_context_id.inspect})"
+          }.merge!(:continue_result => true)).render(::Kernel.binding)"
         end
 
         case operation
@@ -425,6 +478,13 @@ module Ember
     end
 
     class Program #:nodoc:
+      ##
+      # Name of a variable whose value is the
+      # name of the result variable in the
+      # Ruby code produced by this program.
+      #
+      RESULT_VARIABLE_BACKDOOR = 'e08afdfb_62c7_485f_87a0_80914e1b4703' # UUID
+
       ##
       # Transforms this program into Ruby code which uses
       # the given variable name as the evaluation buffer.
@@ -527,7 +587,10 @@ module Ember
       # Transforms this program into executable Ruby source code.
       #
       def compile
-        '(%s %s []; %s; %s.join)' % [
+        '(%s = %s; %s %s []; %s; %s.join)' % [
+          RESULT_VARIABLE_BACKDOOR,
+          @result_variable.inspect,
+
           @result_variable,
           @continue_result ? '||=' : '=',
 

data/man.html

@@ -2,7 +2,7 @@
 <html>
 <head>
   <meta http-equiv='content-type' value='text/html;charset=utf8'>
-  <meta name='generator' value='Ronn/v0.5'>
+  <meta name='generator' value='Ronn/v0.5 (http://github.com/rtomayko/ronn)'>
   <title>ember(1) - eRuby template processor</title>
   <style type='text/css'>
     body {margin:0}
@@ -73,13 +73,26 @@
 <body>
 <div id='man'>
 
-<div class='man-navigation'><a href='#NAME'>NAME</a> <a href='#ABOUT'>ABOUT</a> <a href='#SYNOPSIS'>SYNOPSIS</a> <a href='#DESCRIPTION'>DESCRIPTION</a> <a href='#OPTIONS'>OPTIONS</a> <a href='#SYNTAX'>SYNTAX</a> <a href='#EXAMPLES'>EXAMPLES</a> <a href='#HACKING'>HACKING</a> <a href='#VERSIONS'>VERSIONS</a> <a href='#CREDITS'>CREDITS</a> <a href='#LICENSE'>LICENSE</a> <a href='#SEE-ALSO'>SEE ALSO</a></div>
+<div class='man-navigation'>
+  <a href="#NAME">NAME</a>
+  <a href="#ABOUT">ABOUT</a>
+  <a href="#SYNOPSIS">SYNOPSIS</a>
+  <a href="#DESCRIPTION">DESCRIPTION</a>
+  <a href="#OPTIONS">OPTIONS</a>
+  <a href="#SYNTAX">SYNTAX</a>
+  <a href="#EXAMPLES">EXAMPLES</a>
+  <a href="#HACKING">HACKING</a>
+  <a href="#VERSIONS">VERSIONS</a>
+  <a href="#CREDITS">CREDITS</a>
+  <a href="#LICENSE">LICENSE</a>
+  <a href="#SEE-ALSO">SEE ALSO</a>
+  </div>
 
 <h1 class='man-title'>ember(1)</h1>
 
 <ol class='head man'>
   <li class='tl'>ember(1)</li>
-  <li class='tc'>Version 0.2.0</li>
+  <li class='tc'>Version 0.3.0</li>
   <li class='tr'>ember(1)</li>
 </ol>
 
@@ -98,7 +111,7 @@ debugging, reduces markup, and improves composability of eRuby templates.</p>
 <li><p>Omits newlines trailing code-only <code>&lt;% ... %&gt;</code> directives.</p></li>
 <li><p>Can infer missing <code>&lt;% end %></code> directives based on indentation.</p></li>
 <li><p>Can unindent eRuby block bodies hierarchically.</p></li>
-<li><p>Written in 335 lines of pure
+<li><p>Written in 361 lines of pure
 Ruby.</p></li>
 </ul>
 
@@ -261,50 +274,37 @@ template processor to evaluate the eRuby template given as input:</p>
 
 <h3 id="An-empty-template">An empty template</h3>
 
-<p>Begin with an empty template:</p>
+<pre></pre>
 
-<pre>
-</pre>
 
+<p>The above template compiles into:</p>
 
-<p>The
-above template compiles into:</p>
-
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-; _erbout.join)
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ; _erbout.join)
 </code></pre>
 
 <p>And renders as:</p>
 
-<pre>
-</pre>
+<pre></pre>
 
 
 <h3 id="Comment-directives">Comment directives</h3>
 
-<p>Add comment directives:</p>
-
 <pre><code>&lt;%# this is a comment %>
 %# this is also a comment
-
 &lt;%# this
 is
     a
 multi-line comment %>
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
 
 
 
 
-_erbout &lt;&lt; "  \n"
 ; _erbout.join)
 </code></pre>
 
@@ -312,27 +312,19 @@ _erbout &lt;&lt; "  \n"
 
 <pre>
 
-
-
-  
 </pre>
 
 
 <h3 id="Escaped-directives">Escaped directives</h3>
 
-<p>Add escaped directives:</p>
-
 <pre><code>&lt;%% this is an escaped directive %>
 %% this is an escaped directive
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "&lt;% this is an escaped directive %>\n"
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; "&lt;% this is an escaped directive %>\n"
 _erbout &lt;&lt; "% this is an escaped directive\n"
-_erbout &lt;&lt; "  \n"
 ; _erbout.join)
 </code></pre>
 
@@ -344,20 +336,14 @@ _erbout &lt;&lt; "  \n"
 
 <h3 id="Vocal-directives">Vocal directives</h3>
 
-<p>Add vocal directives, which produce output:</p>
-
 <pre><code>&lt;%= "hello" %>
 %= "world"
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; ("hello") &lt;&lt; "\n"
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; ("hello") &lt;&lt; "\n"
 _erbout &lt;&lt; ("world") &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "  \n"
 ; _erbout.join)
 </code></pre>
 
@@ -369,8 +355,6 @@ world
 
 <h3 id="Silent-directives">Silent directives</h3>
 
-<p>Add silent directives, which do not produce output:</p>
-
 <pre><code>&lt;% a = "hello" %>
 % b = "world"
 
@@ -378,17 +362,13 @@ world
 %= b
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
- a = "hello" 
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  a = "hello" 
  b = "world"
 _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; (a) &lt;&lt; "\n"
 _erbout &lt;&lt; (b) &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "  \n"
 ; _erbout.join)
 </code></pre>
 
@@ -400,8 +380,6 @@ world
 
 <h3 id="Block-directives">Block directives</h3>
 
-<p>Add some Ruby blocks:</p>
-
 <pre><code>% words = %w[hello world]
 
 &lt;% words.each do |w| %&gt;
@@ -417,11 +395,9 @@ world
 % end
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
- words = %w[hello world]
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  words = %w[hello world]
 _erbout &lt;&lt; "\n"
  words.each do |w| 
 _erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
@@ -434,8 +410,6 @@ _erbout &lt;&lt; "\n"
 words.each do |w|
 _erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
  end
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "  \n"
 ; _erbout.join)
 </code></pre>
 
@@ -451,6 +425,212 @@ _erbout &lt;&lt; "  \n"
   world
 </code></pre>
 
+<h3 id="Unindent-block-content">Unindent block content</h3>
+
+<pre><code>&lt;% [1].each do |i| %&gt;
+  &lt;%= i %>
+    % [2].each do |j|
+      %= j
+              %|[3].each |k|
+                   %= k
+              % end
+    % end
+&lt;% end %>
+</code></pre>
+
+<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
+
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  [1].each do |i| 
+_erbout &lt;&lt; (i) &lt;&lt; "\n"
+ [2].each do |j|
+_erbout &lt;&lt; (j) &lt;&lt; "\n"
+[3].each do |k|
+_erbout &lt;&lt; (k) &lt;&lt; "\n"
+ end
+ end
+ end 
+; _erbout.join)
+</code></pre>
+
+<p>And renders as:</p>
+
+<pre><code>1
+2
+3
+</code></pre>
+
+<h3 id="Wrap-block-content">Wrap block content</h3>
+
+<p>In this manner, you can create domain specific languages in eRuby.</p>
+
+<pre><code>&lt;%
+  def introducing(subject, &amp;block)
+    Ember::Template.wrap_content_block(block, rand(10)) do |content|
+      "And now I would like to introduce #{subject}:\n\n#{content.join}"
+    end
+  end
+
+  def coin_toss(pronoun, &amp;block)
+    Ember::Template.wrap_content_block(block) do |content|
+      "#{pronoun} favorite side of a coin toss is #{content.join}."
+    end
+  end
+ %&gt;
+
+% introducing "Matz" do |number|
+  Father of the Ruby programming language,
+  and also a jolly and well mannered fellow.
+
+  % coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
+% end
+</code></pre>
+
+<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
+
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; 
+  def introducing(subject, &amp;block)
+    Ember::Template.wrap_content_block(block, rand(10)) do |content|
+      "And now I would like to introduce #{subject}:\n\n#{content.join}"
+    end
+  end
+
+  def coin_toss(pronoun, &amp;block)
+    Ember::Template.wrap_content_block(block) do |content|
+      "#{pronoun} favorite side of a coin toss is #{content.join}."
+    end
+  end
+
+_erbout &lt;&lt; "\n"
+ introducing "Matz" do |number|
+_erbout &lt;&lt; "Father of the Ruby programming language,\n"
+_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
+_erbout &lt;&lt; "\n"
+ coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
+ end
+; _erbout.join)
+</code></pre>
+
+<p>And renders as:</p>
+
+<pre><code>And now I would like to introduce Matz:
+
+Father of the Ruby programming language,
+and also a jolly and well mannered fellow.
+
+His favorite side of a coin toss is tails.
+</code></pre>
+
+<h3 id="Capture-block-content">Capture block content</h3>
+
+<p>In this manner, you can create domain specific languages in eRuby.</p>
+
+<pre><code>&lt;%
+  def introducing(subject, &amp;block)
+    content = Ember::Template.content_from_block(block, rand(2))
+
+    buffer = Ember::Template.buffer_from_block(block)
+    buffer &lt;&lt; "introducing(#{subject.inspect}):\n\n#{content.join}"
+  end
+
+  def coin_toss(pronoun, &amp;block)
+    content = Ember::Template.content_from_block(block)
+
+    buffer = Ember::Template.buffer_from_block(block)
+    buffer &lt;&lt; "coin_toss(#{pronoun.inspect}): #{content.join}"
+  end
+ %&gt;
+
+% introducing "Matz" do |number|
+  Father of the Ruby programming language,
+  and also a jolly and well mannered fellow.
+
+  % coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
+% end
+</code></pre>
+
+<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
+
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; 
+  def introducing(subject, &amp;block)
+    content = Ember::Template.content_from_block(block, rand(2))
+
+    buffer = Ember::Template.buffer_from_block(block)
+    buffer &lt;&lt; "introducing(#{subject.inspect}):\n\n#{content.join}"
+  end
+
+  def coin_toss(pronoun, &amp;block)
+    content = Ember::Template.content_from_block(block)
+
+    buffer = Ember::Template.buffer_from_block(block)
+    buffer &lt;&lt; "coin_toss(#{pronoun.inspect}): #{content.join}"
+  end
+
+_erbout &lt;&lt; "\n"
+ introducing "Matz" do |number|
+_erbout &lt;&lt; "Father of the Ruby programming language,\n"
+_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
+_erbout &lt;&lt; "\n"
+ coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
+ end
+; _erbout.join)
+</code></pre>
+
+<p>And renders as:</p>
+
+<pre><code>introducing("Matz"):
+
+Father of the Ruby programming language,
+and also a jolly and well mannered fellow.
+
+coin_toss("His"): heads
+</code></pre>
+
+<h3 id="Template-evaluation-result-buffer">Template evaluation result buffer</h3>
+
+<p>In this manner, you can create domain specific languages in eRuby.</p>
+
+<pre><code>&lt;%
+  def introducing(subject, &amp;block)
+    buffer = Ember::Template.buffer_from_block(block)
+    #
+    # you can do whatever you want with buffer,
+    # now that you have a reference to it! &gt;:-)
+    #
+    buffer &lt;&lt; "introducing(#{subject.inspect})"
+  end
+ %&gt;
+
+% introducing "Matz" do |number|
+  Father of the Ruby programming language,
+  and also a jolly and well mannered fellow.
+% end
+</code></pre>
+
+<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
+
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; 
+  def introducing(subject, &amp;block)
+    buffer = Ember::Template.buffer_from_block(block)
+    #
+    # you can do whatever you want with buffer,
+    # now that you have a reference to it! &gt;:-)
+    #
+    buffer &lt;&lt; "introducing(#{subject.inspect})"
+  end
+
+_erbout &lt;&lt; "\n"
+ introducing "Matz" do |number|
+_erbout &lt;&lt; "Father of the Ruby programming language,\n"
+_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
+ end
+; _erbout.join)
+</code></pre>
+
+<p>And renders as:</p>
+
+<pre><code>introducing("Matz")
+</code></pre>
+
 <h3 id="Infer-block-endings">Infer block endings</h3>
 
 <p>Omit <code>&lt;% end %></code> directives from the template:</p>
@@ -467,11 +647,9 @@ _erbout &lt;&lt; "  \n"
   %= w
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true, :infer_end=&gt;true}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true, :infer_end=&gt;true}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
- words = %w[hello world]
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  words = %w[hello world]
 _erbout &lt;&lt; "\n"
  words.each do |w| 
 _erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
@@ -481,9 +659,7 @@ _erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
 end; _erbout &lt;&lt; "\n"
 words.each do |w|
 _erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
-end; _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "  \n"
-; _erbout.join)
+end; _erbout.join)
 </code></pre>
 
 <p>And renders as:</p>
@@ -513,15 +689,11 @@ _erbout &lt;&lt; "  \n"
 %&lt; "doc/example.txt"
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "  \n"
 ; _erbout.join)
 </code></pre>
 
@@ -549,15 +721,11 @@ This is a plain-text file.  Notice that &lt;%=
 %+ "doc/example.erb"
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(nil, 78416100); _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(nil, 78416100); _erbout &lt;&lt; "\n"
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "  \n"
+::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
 ; _erbout.join)
 </code></pre>
 
@@ -575,15 +743,11 @@ This is an eRuby template.  Notice that eRuby directives do take effect here!
 %~ "%= 2 + 2"
 </code></pre>
 
-<p>With <code>{:shorthand=&gt;true}</code> options, the
-above template compiles into:</p>
+<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
 
-<pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(nil, 77958272); _erbout &lt;&lt; "\n"
+<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
-::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(nil, 77958272); _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "  \n"
+::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
 ; _erbout.join)
 </code></pre>
 
@@ -679,6 +843,37 @@ in the <code>test/test_helper.rb</code> file.</p>
 
 <p>This section contains release notes of current and past releases.</p>
 
+<h3 id="Version-0-3-0-2010-04-26-">Version 0.3.0 (2010-04-26)</h3>
+
+<p>This release adds <em>class methods</em> that let you (portably and more easily)
+create your own domain specific languages in eRuby; adds more usage
+<strong>EXAMPLES</strong> in the help manual; and removes a binding inheritance hack.</p>
+
+<p>New features:</p>
+
+<dl>
+<dt><code>Ember::Template::wrap_content_block()</code></dt><dd><p>Wraps eRuby block content appending.</p></dd>
+<dt><code>Ember::Template::content_from_block()</code></dt><dd><p>Extracts content from eRuby blocks.</p></dd>
+<dt><code>Ember::Template::buffer_from_block()</code></dt><dd><p>Gives access to template evalutaion result buffer.</p></dd>
+</dl>
+
+
+<p>Bug fixes:</p>
+
+<ul>
+<li>Remove hack for inheriting parent template binding.</li>
+</ul>
+
+
+<p>Housekeeping:</p>
+
+<ul>
+<li><p>Add example on unindenting node content and eRuby DSL examples that use
+the new content block methods.</p></li>
+<li><p>Simplify code examples using the new wrap_content_block() method.</p></li>
+</ul>
+
+
 <h3 id="Version-0-2-0-2010-04-25-">Version 0.2.0 (2010-04-25)</h3>
 
 <p>This release adds <a href="http://rubyonrails.org">Ruby on Rails</a> integration.</p>
@@ -806,7 +1001,7 @@ Kamil Kukura</p>
 
 <p>(the ISC license)</p>
 
-<p>Copyright 2009 Suraj N. Kurapati <a href="&#x6d;&#97;&#x69;&#108;&#116;&#111;&#x3a;&#x73;&#117;&#x6e;&#x61;&#x6b;&#x75;&#64;&#103;&#x6d;&#97;&#105;&#x6c;&#x2e;&#99;&#x6f;&#x6d;" data-bare-link="true">&#115;&#117;&#x6e;&#97;&#x6b;&#117;&#x40;&#x67;&#x6d;&#x61;&#105;&#108;&#46;&#99;&#x6f;&#x6d;</a></p>
+<p>Copyright 2009 Suraj N. Kurapati <a href="&#x6d;&#97;&#x69;&#108;&#116;&#x6f;&#x3a;&#115;&#117;&#x6e;&#x61;&#107;&#x75;&#64;&#103;&#109;&#x61;&#x69;&#x6c;&#x2e;&#99;&#111;&#109;" data-bare-link="true">&#x73;&#117;&#110;&#97;&#x6b;&#x75;&#64;&#x67;&#109;&#97;&#105;&#108;&#x2e;&#x63;&#x6f;&#x6d;</a></p>
 
 <p>Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Suraj N. Kurapati
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-25 00:00:00 -07:00
+date: 2010-04-26 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency