erubis 2.0.1 → 2.1.0

data/doc-api/classes/Erubis/Engine.html

@@ -80,7 +80,8 @@
 
     <div id="description">
       <p>
-.[abstract] base engine class
+(abstract) abstract engine class. subclass must include evaluator and
+converter module.
 </p>
 
     </div>
@@ -92,23 +93,11 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000075">add_expr</a>&nbsp;&nbsp;
-      <a href="#M000078">add_expr_debug</a>&nbsp;&nbsp;
-      <a href="#M000077">add_expr_escaped</a>&nbsp;&nbsp;
-      <a href="#M000076">add_expr_literal</a>&nbsp;&nbsp;
-      <a href="#M000079">add_postamble</a>&nbsp;&nbsp;
-      <a href="#M000072">add_preamble</a>&nbsp;&nbsp;
-      <a href="#M000074">add_stmt</a>&nbsp;&nbsp;
-      <a href="#M000073">add_text</a>&nbsp;&nbsp;
-      <a href="#M000068">compile</a>&nbsp;&nbsp;
-      <a href="#M000069">compile!</a>&nbsp;&nbsp;
-      <a href="#M000070">escape_text</a>&nbsp;&nbsp;
-      <a href="#M000071">escaped_expr</a>&nbsp;&nbsp;
-      <a href="#M000066">evaluate</a>&nbsp;&nbsp;
-      <a href="#M000064">load_file</a>&nbsp;&nbsp;
-      <a href="#M000063">new</a>&nbsp;&nbsp;
-      <a href="#M000067">pattern_regexp</a>&nbsp;&nbsp;
-      <a href="#M000065">result</a>&nbsp;&nbsp;
+      <a href="#M000165">convert!</a>&nbsp;&nbsp;
+      <a href="#M000167">load_file</a>&nbsp;&nbsp;
+      <a href="#M000166">new</a>&nbsp;&nbsp;
+      <a href="#M000168">process</a>&nbsp;&nbsp;
+      <a href="#M000169">process_proc</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -120,40 +109,9 @@
     <div id="section">
 
 
-    <div id="constants-list">
-      <h3 class="section-bar">Constants</h3>
-
-      <div class="name-list">
-        <table summary="Constants">
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">DEFAULT_REGEXP</td>
-          <td>=</td>
-          <td class="context-item-value">/(.*?)(^[ \t]*)?&lt;%(=+|\#)?(.*?)-?%&gt;([ \t]*\r?\n)?/m</td>
-        </tr>
-        </table>
-      </div>
-    </div>
-
 
 
-    <div id="attribute-list">
-      <h3 class="section-bar">Attributes</h3>
 
-      <div class="name-list">
-        <table>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">filename</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">src</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        </table>
-      </div>
-    </div>
       
 
 
@@ -161,11 +119,11 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000064" class="method-detail">
-        <a name="M000064"></a>
+      <div id="method-M000167" class="method-detail">
+        <a name="M000167"></a>
 
         <div class="method-heading">
-          <a href="#M000064" class="method-signature">
+          <a href="#M000167" class="method-signature">
           <span class="method-name">load_file</span><span class="method-args">(filename, properties={})</span>
           </a>
         </div>
@@ -175,10 +133,10 @@
 load file and create engine object
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000064-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000064-source">
+            onclick="toggleCode('M000167-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000167-source">
 <pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 93</span>
+<span class="ruby-comment cmt"># File erubis/engine.rb, line 40</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">load_file</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">properties</span>={})
       <span class="ruby-identifier">input</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-value str">'rb'</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">read</span> }
       <span class="ruby-identifier">input</span>.<span class="ruby-identifier">untaint</span>   <span class="ruby-comment cmt"># is it ok?</span>
@@ -191,30 +149,27 @@ load file and create engine object
         </div>
       </div>
 
-      <div id="method-M000063" class="method-detail">
-        <a name="M000063"></a>
+      <div id="method-M000166" class="method-detail">
+        <a name="M000166"></a>
 
         <div class="method-heading">
-          <a href="#M000063" class="method-signature">
-          <span class="method-name">new</span><span class="method-args">(input, properties={})</span>
+          <a href="#M000166" class="method-signature">
+          <span class="method-name">new</span><span class="method-args">(input=nil, properties={})</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000063-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000063-source">
+            onclick="toggleCode('M000166-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000166-source">
 <pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 79</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">input</span>, <span class="ruby-identifier">properties</span>={})
-      <span class="ruby-comment cmt">#@input    = input</span>
-      <span class="ruby-ivar">@pattern</span>   = <span class="ruby-identifier">properties</span>[<span class="ruby-identifier">:pattern</span>]
-      <span class="ruby-ivar">@filename</span>  = <span class="ruby-identifier">properties</span>[<span class="ruby-identifier">:filename</span>]
-      <span class="ruby-ivar">@trim</span>      = <span class="ruby-identifier">properties</span>[<span class="ruby-identifier">:trim</span>] <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">false</span>
-      <span class="ruby-ivar">@preamble</span>  = <span class="ruby-identifier">properties</span>[<span class="ruby-identifier">:preamble</span>]
-      <span class="ruby-ivar">@postamble</span> = <span class="ruby-identifier">properties</span>[<span class="ruby-identifier">:postamble</span>]
-      <span class="ruby-ivar">@escape</span>    = <span class="ruby-identifier">properties</span>[<span class="ruby-identifier">:escape</span>]
-      <span class="ruby-ivar">@src</span>       = <span class="ruby-identifier">compile</span>(<span class="ruby-identifier">input</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">input</span>
+<span class="ruby-comment cmt"># File erubis/engine.rb, line 31</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">input</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">properties</span>={})
+      <span class="ruby-comment cmt">#@input = input</span>
+      <span class="ruby-identifier">init_generator</span>(<span class="ruby-identifier">properties</span>)
+      <span class="ruby-identifier">init_converter</span>(<span class="ruby-identifier">properties</span>)
+      <span class="ruby-identifier">init_evaluator</span>(<span class="ruby-identifier">properties</span>)
+      <span class="ruby-ivar">@src</span>    = <span class="ruby-identifier">convert</span>(<span class="ruby-identifier">input</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">input</span>
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
@@ -223,201 +178,59 @@ load file and create engine object
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000068" class="method-detail">
-        <a name="M000068"></a>
-
-        <div class="method-heading">
-          <a href="#M000068" class="method-signature">
-          <span class="method-name">compile</span><span class="method-args">(input)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-compile input string into target language
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000068-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000068-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 132</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">compile</span>(<span class="ruby-identifier">input</span>)
-      <span class="ruby-identifier">src</span> = <span class="ruby-value str">&quot;&quot;</span>
-      <span class="ruby-ivar">@preamble</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-value">? </span><span class="ruby-identifier">add_preamble</span>(<span class="ruby-identifier">src</span>) <span class="ruby-operator">:</span> (<span class="ruby-ivar">@preamble</span> <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">src</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@preamble</span>))
-      <span class="ruby-identifier">regexp</span> = <span class="ruby-identifier">pattern_regexp</span>(<span class="ruby-ivar">@pattern</span>)
-      <span class="ruby-identifier">input</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">regexp</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">text</span>, <span class="ruby-identifier">lspace</span>, <span class="ruby-identifier">indicator</span>, <span class="ruby-identifier">code</span>, <span class="ruby-identifier">rspace</span><span class="ruby-operator">|</span>
-        <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">text</span>)
-        <span class="ruby-comment cmt">## * when '&lt;%= %&gt;', do nothing</span>
-        <span class="ruby-comment cmt">## * when '&lt;% %&gt;' or '&lt;%# %&gt;', delete spaces iff only spaces are around '&lt;% %&gt;'</span>
-        <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">indicator</span>               <span class="ruby-comment cmt"># &lt;% %&gt;</span>
-          <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@trim</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">lspace</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">rspace</span>
-            <span class="ruby-identifier">add_stmt</span>(<span class="ruby-identifier">src</span>, <span class="ruby-node">&quot;#{lspace}#{code}#{rspace}&quot;</span>)
-          <span class="ruby-keyword kw">else</span>
-            <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">lspace</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">lspace</span>
-            <span class="ruby-identifier">add_stmt</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>)
-            <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">rspace</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">rspace</span>
-          <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">indicator</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">?\#</span>   <span class="ruby-comment cmt"># &lt;%# %&gt;</span>
-          <span class="ruby-identifier">n</span> = <span class="ruby-identifier">code</span>.<span class="ruby-identifier">count</span>(<span class="ruby-value str">&quot;\n&quot;</span>) <span class="ruby-operator">+</span> (<span class="ruby-identifier">rspace</span> <span class="ruby-value">? </span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-value">0</span>)
-          <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@trim</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">lspace</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">rspace</span>
-            <span class="ruby-identifier">add_stmt</span>(<span class="ruby-identifier">src</span>, <span class="ruby-value str">&quot;\n&quot;</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">n</span>)
-          <span class="ruby-keyword kw">else</span>
-            <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">lspace</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">lspace</span>
-            <span class="ruby-identifier">add_stmt</span>(<span class="ruby-identifier">src</span>, <span class="ruby-value str">&quot;\n&quot;</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">n</span>)
-            <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">rspace</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">rspace</span>
-          <span class="ruby-keyword kw">end</span>
-          <span class="ruby-comment cmt">#flag_trim = @trim &amp;&amp; lspace &amp;&amp; rspace</span>
-          <span class="ruby-comment cmt">#add_text(src, lspace) if !flag_trim &amp;&amp; lspace</span>
-          <span class="ruby-comment cmt">#n = code.count(&quot;\n&quot;) + (rspace ? 1 : 0)</span>
-          <span class="ruby-comment cmt">#add_stmt(src, &quot;\n&quot; * n)</span>
-          <span class="ruby-comment cmt">#add_text(src, rspace) if !flag_trim &amp;&amp; rspace</span>
-        <span class="ruby-keyword kw">else</span>                        <span class="ruby-comment cmt"># &lt;%= %&gt;</span>
-          <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">lspace</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">lspace</span>
-          <span class="ruby-identifier">add_expr</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>, <span class="ruby-identifier">indicator</span>)
-          <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">rspace</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">rspace</span>
-        <span class="ruby-keyword kw">end</span>
-        <span class="ruby-comment cmt">#if indicator &amp;&amp; indicator[0] == ?=</span>
-        <span class="ruby-comment cmt">#  flag_trim = false</span>
-        <span class="ruby-comment cmt">#else</span>
-        <span class="ruby-comment cmt">#  flag_trim = @trim &amp;&amp; lspace &amp;&amp; rspace</span>
-        <span class="ruby-comment cmt">#end</span>
-        <span class="ruby-comment cmt">##flag_trim = @trim &amp;&amp; !(indicator &amp;&amp; indicator[0]==?=) &amp;&amp; lspace &amp;&amp; rspace</span>
-        <span class="ruby-comment cmt">#add_text(src, text)</span>
-        <span class="ruby-comment cmt">#add_text(src, lspace) if !flag_trim &amp;&amp; lspace</span>
-        <span class="ruby-comment cmt">#if !indicator             # &lt;% %&gt;</span>
-        <span class="ruby-comment cmt">#  code = &quot;#{lspace}#{code}#{rspace}&quot; if flag_trim</span>
-        <span class="ruby-comment cmt">#  add_stmt(src, code)</span>
-        <span class="ruby-comment cmt">#elsif indicator[0] == ?\# # &lt;%# %&gt;</span>
-        <span class="ruby-comment cmt">#  n = code.count(&quot;\n&quot;) + (rspace ? 1 : 0)</span>
-        <span class="ruby-comment cmt">#  add_stmt(src, &quot;\n&quot; * n)</span>
-        <span class="ruby-comment cmt">#else                      # &lt;%= %&gt;</span>
-        <span class="ruby-comment cmt">#  add_expr(src, code, indicator)</span>
-        <span class="ruby-comment cmt">#end</span>
-        <span class="ruby-comment cmt">#add_text(src, rspace) if !flag_trim &amp;&amp; rspace</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">rest</span> = <span class="ruby-identifier">$'</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">input</span>     <span class="ruby-comment cmt"># add input when no matched</span>
-      <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">rest</span>)
-      <span class="ruby-ivar">@postamble</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-value">? </span><span class="ruby-identifier">add_postamble</span>(<span class="ruby-identifier">src</span>) <span class="ruby-operator">:</span> (<span class="ruby-ivar">@postamble</span> <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">src</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@postamble</span>))
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">src</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000069" class="method-detail">
-        <a name="M000069"></a>
-
-        <div class="method-heading">
-          <a href="#M000069" class="method-signature">
-          <span class="method-name">compile!</span><span class="method-args">(input)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-compile input string and set it to @src
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000069-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000069-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 193</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">compile!</span>(<span class="ruby-identifier">input</span>)
-      <span class="ruby-ivar">@src</span> = <span class="ruby-identifier">compile</span>(<span class="ruby-identifier">input</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000066" class="method-detail">
-        <a name="M000066"></a>
-
-        <div class="method-heading">
-          <a href="#M000066" class="method-signature">
-          <span class="method-name">evaluate</span><span class="method-args">(context=Context.new)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-invoke context.instance_eval(@src)
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000066-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000066-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 113</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">evaluate</span>(<span class="ruby-identifier">context</span>=<span class="ruby-constant">Context</span>.<span class="ruby-identifier">new</span>)
-      <span class="ruby-identifier">context</span> = <span class="ruby-constant">Context</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">context</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">context</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Hash</span>)
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">context</span>.<span class="ruby-identifier">instance_eval</span>(<span class="ruby-ivar">@src</span>, (<span class="ruby-ivar">@filename</span> <span class="ruby-operator">||</span> <span class="ruby-value str">'(erubis)'</span>))
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000065" class="method-detail">
-        <a name="M000065"></a>
+      <div id="method-M000165" class="method-detail">
+        <a name="M000165"></a>
 
         <div class="method-heading">
-          <a href="#M000065" class="method-signature">
-          <span class="method-name">result</span><span class="method-args">(_binding_or_hash=TOPLEVEL_BINDING)</span>
+          <a href="#M000165" class="method-signature">
+          <span class="method-name">convert!</span><span class="method-args">(input)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-eval(@src) with binding object
+convert input string and set it to @src
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000065-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000065-source">
+            onclick="toggleCode('M000165-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000165-source">
 <pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 102</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">result</span>(<span class="ruby-identifier">_binding_or_hash</span>=<span class="ruby-constant">TOPLEVEL_BINDING</span>)
-      <span class="ruby-identifier">_arg</span> = <span class="ruby-identifier">_binding_or_hash</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">_arg</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Hash</span>)
-        <span class="ruby-comment cmt">## load _context data as local variables by eval</span>
-        <span class="ruby-identifier">eval</span> <span class="ruby-identifier">_arg</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">inject</span>(<span class="ruby-value str">&quot;&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">s</span>, <span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;#{k.to_s} = _arg[#{k.inspect}];&quot;</span> }
-        <span class="ruby-identifier">_arg</span> = <span class="ruby-identifier">binding</span>()
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">eval</span>(<span class="ruby-ivar">@src</span>, <span class="ruby-identifier">_arg</span>, (<span class="ruby-ivar">@filename</span> <span class="ruby-operator">||</span> <span class="ruby-value str">'(erubis)'</span>))
+<span class="ruby-comment cmt"># File erubis/engine.rb, line 27</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">convert!</span>(<span class="ruby-identifier">input</span>)
+      <span class="ruby-ivar">@src</span> = <span class="ruby-identifier">convert</span>(<span class="ruby-identifier">input</span>)
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <h3 class="section-bar">Protected Instance methods</h3>
-
-      <div id="method-M000075" class="method-detail">
-        <a name="M000075"></a>
+      <div id="method-M000168" class="method-detail">
+        <a name="M000168"></a>
 
         <div class="method-heading">
-          <a href="#M000075" class="method-signature">
-          <span class="method-name">add_expr</span><span class="method-args">(src, code, indicator)</span>
+          <a href="#M000168" class="method-signature">
+          <span class="method-name">process</span><span class="method-args">(input, context=nil, filename=nil)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-add expression code to src
+helper method to convert and evaluate input text with context object.
+context may be Binding, Hash, or Object.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000075-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000075-source">
+            onclick="toggleCode('M000168-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000168-source">
 <pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 237</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_expr</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>, <span class="ruby-identifier">indicator</span>)
-      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">indicator</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'='</span>
-        <span class="ruby-identifier">add_expr_literal</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>)
-      <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'=='</span>
-        <span class="ruby-identifier">add_expr_escaped</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>)
-      <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'==='</span>
-        <span class="ruby-identifier">add_expr_debug</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>)
+<span class="ruby-comment cmt"># File erubis/engine.rb, line 53</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process</span>(<span class="ruby-identifier">input</span>, <span class="ruby-identifier">context</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">filename</span>=<span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-identifier">code</span> = <span class="ruby-identifier">convert</span>(<span class="ruby-identifier">input</span>)
+      <span class="ruby-identifier">filename</span> <span class="ruby-operator">||=</span> <span class="ruby-value str">'(erubis)'</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">context</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Binding</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">eval</span>(<span class="ruby-identifier">code</span>, <span class="ruby-identifier">context</span>, <span class="ruby-identifier">filename</span>)
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">context</span> = <span class="ruby-constant">Context</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">context</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">context</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Hash</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">context</span>.<span class="ruby-identifier">instance_eval</span>(<span class="ruby-identifier">code</span>, <span class="ruby-identifier">filename</span>)
       <span class="ruby-keyword kw">end</span>
     <span class="ruby-keyword kw">end</span>
 </pre>
@@ -425,285 +238,32 @@ add expression code to src
         </div>
       </div>
 
-      <div id="method-M000078" class="method-detail">
-        <a name="M000078"></a>
-
-        <div class="method-heading">
-          <a href="#M000078" class="method-signature">
-          <span class="method-name">add_expr_debug</span><span class="method-args">(src, code)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] add expression code to src for debug. this is called by <a
-href="Engine.html#M000075">add_expr</a>().
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000078-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000078-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 259</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_expr_debug</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000077" class="method-detail">
-        <a name="M000077"></a>
-
-        <div class="method-heading">
-          <a href="#M000077" class="method-signature">
-          <span class="method-name">add_expr_escaped</span><span class="method-args">(src, code)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] add escaped expression code to src. this is called by <a
-href="Engine.html#M000075">add_expr</a>().
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000077-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000077-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 254</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_expr_escaped</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000076" class="method-detail">
-        <a name="M000076"></a>
-
-        <div class="method-heading">
-          <a href="#M000076" class="method-signature">
-          <span class="method-name">add_expr_literal</span><span class="method-args">(src, code)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] add expression literal code to src. this is called by <a
-href="Engine.html#M000075">add_expr</a>().
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000076-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000076-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 249</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_expr_literal</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000079" class="method-detail">
-        <a name="M000079"></a>
-
-        <div class="method-heading">
-          <a href="#M000079" class="method-signature">
-          <span class="method-name">add_postamble</span><span class="method-args">(src)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] add @postamble to src
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000079-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000079-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 264</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_postamble</span>(<span class="ruby-identifier">src</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000072" class="method-detail">
-        <a name="M000072"></a>
-
-        <div class="method-heading">
-          <a href="#M000072" class="method-signature">
-          <span class="method-name">add_preamble</span><span class="method-args">(src)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] add @preamble to src
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000072-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000072-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 222</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_preamble</span>(<span class="ruby-identifier">src</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000074" class="method-detail">
-        <a name="M000074"></a>
-
-        <div class="method-heading">
-          <a href="#M000074" class="method-signature">
-          <span class="method-name">add_stmt</span><span class="method-args">(src, code)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] add statement code to src
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000074-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000074-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 232</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_stmt</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">code</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000073" class="method-detail">
-        <a name="M000073"></a>
-
-        <div class="method-heading">
-          <a href="#M000073" class="method-signature">
-          <span class="method-name">add_text</span><span class="method-args">(src, text)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] add text string to src
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000073-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000073-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 227</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_text</span>(<span class="ruby-identifier">src</span>, <span class="ruby-identifier">text</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000070" class="method-detail">
-        <a name="M000070"></a>
-
-        <div class="method-heading">
-          <a href="#M000070" class="method-signature">
-          <span class="method-name">escape_text</span><span class="method-args">(text)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] escape text string
-</p>
-<p>
-ex.
-</p>
-<pre>
-  def escape_text(text)
-    return text.dump
-    # or return &quot;'&quot; + text.gsub(/['\\]/, '\\\\\&amp;') + &quot;'&quot;
-  end
-</pre>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000070-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000070-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 206</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">escape_text</span>(<span class="ruby-identifier">text</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000071" class="method-detail">
-        <a name="M000071"></a>
-
-        <div class="method-heading">
-          <a href="#M000071" class="method-signature">
-          <span class="method-name">escaped_expr</span><span class="method-args">(code)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-.[abstract] return escaped expression code
-</p>
-<p>
-ex.
-</p>
-<pre>
-  def escaped_expr(code)
-    @escape ||= 'escape'
-    return &quot;#{@escape}(#{code.strip})&quot;
-  end
-</pre>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000071-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000071-source">
-<pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 217</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">escaped_expr</span>(<span class="ruby-identifier">code</span>)
-      <span class="ruby-identifier">not_implemented</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000067" class="method-detail">
-        <a name="M000067"></a>
+      <div id="method-M000169" class="method-detail">
+        <a name="M000169"></a>
 
         <div class="method-heading">
-          <a href="#M000067" class="method-signature">
-          <span class="method-name">pattern_regexp</span><span class="method-args">(pattern=@pattern)</span>
+          <a href="#M000169" class="method-signature">
+          <span class="method-name">process_proc</span><span class="method-args">(proc_obj, context=nil, filename=nil)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-return regexp of pattern to parse eRuby script
+helper method evaluate Proc object iwth contect object. context may be
+Binding, Hash, or Object.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000067-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000067-source">
+            onclick="toggleCode('M000169-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000169-source">
 <pre>
-<span class="ruby-comment cmt"># File erubis/engine.rb, line 121</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pattern_regexp</span>(<span class="ruby-identifier">pattern</span>=<span class="ruby-ivar">@pattern</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">pattern</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'&lt;% %&gt;'</span>
-        <span class="ruby-keyword kw">return</span> <span class="ruby-constant">DEFAULT_REGEXP</span>
+<span class="ruby-comment cmt"># File erubis/engine.rb, line 69</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process_proc</span>(<span class="ruby-identifier">proc_obj</span>, <span class="ruby-identifier">context</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">filename</span>=<span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">context</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Binding</span>)
+        <span class="ruby-identifier">filename</span> <span class="ruby-operator">||=</span> <span class="ruby-value str">'(erubis)'</span>
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">eval</span>(<span class="ruby-identifier">proc_obj</span>, <span class="ruby-identifier">context</span>, <span class="ruby-identifier">filename</span>)
       <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">prefix</span>, <span class="ruby-identifier">postfix</span> = <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">split</span>()
-        <span class="ruby-keyword kw">return</span> <span class="ruby-node">/(.*?)(^[ \t]*)?#{prefix}(=+|\#)?(.*?)-?#{postfix}([ \t]*\r?\n)?/</span><span class="ruby-identifier">m</span>
+        <span class="ruby-identifier">context</span> = <span class="ruby-constant">Context</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">context</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">context</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Hash</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">context</span>.<span class="ruby-identifier">instance_eval</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">proc_obj</span>)
       <span class="ruby-keyword kw">end</span>
     <span class="ruby-keyword kw">end</span>
 </pre>