RubyGems - erubis - Versions diffs - 2.2.0 → 2.3.0 - Mend

erubis 2.2.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (220) hide show

data/CHANGES +120 -3
data/README.txt +1 -1
data/benchmark/Makefile +6 -0
data/benchmark/bench.rb +306 -0
data/benchmark/{erubybench.yaml → bench_context.yaml} +20 -20
data/benchmark/templates/_footer.html +4 -0
data/benchmark/{erubybench.rhtml → templates/_header.html} +1 -34
data/benchmark/templates/bench_erb.rhtml +29 -0
data/benchmark/templates/bench_erubis.rhtml +29 -0
data/benchmark/templates/bench_eruby.rhtml +29 -0
data/bin/erubis +2 -2
data/contrib/erubis +3 -3114
data/contrib/erubis-run.rb +132 -0
data/contrib/inline-require +1 -1
data/doc-api/classes/{ERB.html → ActionView/Base/ERB.html} +3 -3
data/doc-api/classes/Erubis.html +8 -1
data/doc-api/classes/Erubis/ArrayEnhancer.html +12 -12
data/doc-api/classes/Erubis/Basic/Converter.html +24 -24
data/doc-api/classes/Erubis/BiPatternEnhancer.html +14 -14
data/doc-api/classes/Erubis/CGenerator.html +60 -60
data/doc-api/classes/Erubis/Context.html +42 -42
data/doc-api/classes/Erubis/Converter.html +27 -27
data/doc-api/classes/Erubis/DeleteIndentEnhancer.html +150 -0
data/doc-api/classes/Erubis/DeleteIndentEruby.html +120 -0
data/doc-api/classes/Erubis/Engine.html +31 -31
data/doc-api/classes/Erubis/ErboutEnhancer.html +175 -0
data/doc-api/classes/Erubis/ErboutEruby.html +120 -0
data/doc-api/classes/Erubis/Eruby.html +5 -0
data/doc-api/classes/Erubis/EscapeEnhancer.html +6 -6
data/doc-api/classes/Erubis/Evaluator.html +19 -19
data/doc-api/classes/Erubis/FastEruby.html +131 -0
data/doc-api/classes/Erubis/HeaderFooterEnhancer.html +14 -14
data/doc-api/classes/Erubis/Helpers/RailsHelper.html +49 -45
data/doc-api/classes/Erubis/InterpolationEnhancer.html +304 -0
data/doc-api/classes/Erubis/InterpolationEruby.html +120 -0
data/doc-api/classes/Erubis/JavaGenerator.html +54 -54
data/doc-api/classes/Erubis/JavascriptGenerator.html +60 -60
data/doc-api/classes/Erubis/Main.html +35 -27
data/doc-api/classes/Erubis/NoCodeEnhancer.html +5 -5
data/doc-api/classes/Erubis/NoTextEnhancer.html +7 -7
data/doc-api/classes/Erubis/OptimizedEruby.html +6 -6
data/doc-api/classes/Erubis/OptimizedGenerator.html +72 -72
data/doc-api/classes/Erubis/OptimizedXmlEruby.html +6 -6
data/doc-api/classes/Erubis/PI/Converter.html +18 -18
data/doc-api/classes/Erubis/PI/Ec.html +6 -6
data/doc-api/classes/Erubis/PI/Ejava.html +6 -6
data/doc-api/classes/Erubis/PI/Ejavascript.html +6 -6
data/doc-api/classes/Erubis/PI/Eperl.html +6 -6
data/doc-api/classes/Erubis/PI/Ephp.html +6 -6
data/doc-api/classes/Erubis/PI/Eruby.html +7 -7
data/doc-api/classes/Erubis/PI/Escheme.html +6 -6
data/doc-api/classes/Erubis/PI/TinyEruby.html +24 -24
data/doc-api/classes/Erubis/PercentLineEnhancer.html +8 -8
data/doc-api/classes/Erubis/PerlGenerator.html +54 -54
data/doc-api/classes/Erubis/PhpGenerator.html +54 -54
data/doc-api/classes/Erubis/PrintEnabledEnhancer.html +20 -20
data/doc-api/classes/Erubis/PrintOutEnhancer.html +30 -30
data/doc-api/classes/Erubis/RubyEvaluator.html +12 -12
data/doc-api/classes/Erubis/RubyGenerator.html +48 -48
data/doc-api/classes/Erubis/SchemeGenerator.html +60 -60
data/doc-api/classes/Erubis/SimplifyEnhancer.html +8 -8
data/doc-api/classes/Erubis/StdoutEnhancer.html +12 -12
data/doc-api/classes/Erubis/StringBufferEnhancer.html +12 -12
data/doc-api/classes/Erubis/TinyEruby.html +24 -24
data/doc-api/classes/Erubis/XmlHelper.html +14 -14
data/doc-api/created.rid +1 -1
data/doc-api/files/README_txt.html +4 -4
data/doc-api/files/erubis/context_rb.html +2 -2
data/doc-api/files/erubis/converter_rb.html +2 -2
data/doc-api/files/erubis/engine/ec_rb.html +2 -2
data/doc-api/files/erubis/engine/ejava_rb.html +2 -2
data/doc-api/files/erubis/engine/ejavascript_rb.html +2 -2
data/doc-api/files/erubis/engine/enhanced_rb.html +2 -2
data/doc-api/files/erubis/engine/eperl_rb.html +2 -2
data/doc-api/files/erubis/engine/ephp_rb.html +2 -2
data/doc-api/files/erubis/engine/eruby_rb.html +2 -2
data/doc-api/files/erubis/engine/escheme_rb.html +2 -2
data/doc-api/files/erubis/engine/optimized_rb.html +2 -2
data/doc-api/files/erubis/engine_rb.html +2 -2
data/doc-api/files/erubis/enhancer_rb.html +2 -2
data/doc-api/files/erubis/error_rb.html +2 -2
data/doc-api/files/erubis/evaluator_rb.html +2 -2
data/doc-api/files/erubis/generator_rb.html +2 -2
data/doc-api/files/erubis/helper_rb.html +2 -2
data/doc-api/files/erubis/helpers/rails_helper_rb.html +2 -2
data/doc-api/files/erubis/local-setting_rb.html +2 -2
data/doc-api/files/erubis/main_rb.html +2 -2
data/doc-api/files/erubis/tiny_rb.html +2 -2
data/doc-api/files/erubis_rb.html +1 -1
data/doc-api/fr_class_index.html +8 -1
data/doc-api/fr_method_index.html +166 -158
data/doc/users-guide.html +623 -215
data/lib/erubis.rb +2 -2
data/lib/erubis/context.rb +2 -2
data/lib/erubis/converter.rb +2 -2
data/lib/erubis/engine.rb +3 -3
data/lib/erubis/engine/ec.rb +2 -2
data/lib/erubis/engine/ejava.rb +2 -2
data/lib/erubis/engine/ejavascript.rb +2 -2
data/lib/erubis/engine/enhanced.rb +17 -2
data/lib/erubis/engine/eperl.rb +2 -2
data/lib/erubis/engine/ephp.rb +2 -2
data/lib/erubis/engine/eruby.rb +10 -2
data/lib/erubis/engine/escheme.rb +2 -2
data/lib/erubis/engine/optimized.rb +2 -2
data/lib/erubis/enhancer.rb +134 -25
data/lib/erubis/error.rb +2 -2
data/lib/erubis/evaluator.rb +2 -2
data/lib/erubis/generator.rb +2 -2
data/lib/erubis/helper.rb +2 -2
data/lib/erubis/helpers/rails_helper.rb +19 -75
data/lib/erubis/local-setting.rb +2 -2
data/lib/erubis/main.rb +63 -36
data/lib/erubis/tiny.rb +2 -2
data/test/assert-text-equal.rb +2 -2
data/test/data/users-guide/Example.ejava +55 -0
data/test/data/users-guide/array_example.result +9 -0
data/test/data/users-guide/arraybuffer_example.result +9 -0
data/test/data/users-guide/bipattern-example.rhtml +4 -0
data/test/data/users-guide/bipattern_example.result +6 -0
data/test/data/users-guide/context.rb +6 -0
data/test/data/users-guide/context.yaml +8 -0
data/test/data/users-guide/escape_example.result +9 -0
data/test/data/users-guide/example.ec +27 -0
data/test/data/users-guide/example.ejs +20 -0
data/test/data/users-guide/example.eperl +18 -0
data/test/data/users-guide/example.ephp +18 -0
data/test/data/users-guide/example.eruby +6 -0
data/test/data/users-guide/example.escheme +28 -0
data/test/data/users-guide/example1.eruby +6 -0
data/test/data/users-guide/example1.rb +16 -0
data/test/data/users-guide/example1.result +16 -0
data/test/data/users-guide/example10.rb +4 -0
data/test/data/users-guide/example10.result +17 -0
data/test/data/users-guide/example10.xhtml +14 -0
data/test/data/users-guide/example10_x.result +17 -0
data/test/data/users-guide/example11.php +20 -0
data/test/data/users-guide/example11.result +23 -0
data/test/data/users-guide/example11.rhtml +21 -0
data/test/data/users-guide/example11_C.result +10 -0
data/test/data/users-guide/example11_N.result +16 -0
data/test/data/users-guide/example11_U.result +16 -0
data/test/data/users-guide/example11_php.result +15 -0
data/test/data/users-guide/example1_x.result +9 -0
data/test/data/users-guide/example2.eruby +7 -0
data/test/data/users-guide/example2.rb +10 -0
data/test/data/users-guide/example2.result +27 -0
data/test/data/users-guide/example2_trim.result +10 -0
data/test/data/users-guide/example2_x.result +10 -0
data/test/data/users-guide/example3.eruby +6 -0
data/test/data/users-guide/example3.rb +10 -0
data/test/data/users-guide/example31.result +22 -0
data/test/data/users-guide/example32.result +4 -0
data/test/data/users-guide/example3_e.result +8 -0
data/test/data/users-guide/example4.eruby +3 -0
data/test/data/users-guide/example4.rb +11 -0
data/test/data/users-guide/example4.result +10 -0
data/test/data/users-guide/example4_x.result +5 -0
data/test/data/users-guide/example5.eruby +6 -0
data/test/data/users-guide/example5.rb +16 -0
data/test/data/users-guide/example5.result +7 -0
data/test/data/users-guide/example6.rb +12 -0
data/test/data/users-guide/example6.result +7 -0
data/test/data/users-guide/example7.eruby +8 -0
data/test/data/users-guide/example71.result +13 -0
data/test/data/users-guide/example72.result +13 -0
data/test/data/users-guide/example8.eruby +6 -0
data/test/data/users-guide/example8_ruby.result +7 -0
data/test/data/users-guide/example8_yaml.result +7 -0
data/test/data/users-guide/example9.eruby +3 -0
data/test/data/users-guide/example9.rb +8 -0
data/test/data/users-guide/example9.result +9 -0
data/test/data/users-guide/example91.result +5 -0
data/test/data/users-guide/example92.result +4 -0
data/test/data/users-guide/example_c.result +29 -0
data/test/data/users-guide/example_java.result +56 -0
data/test/data/users-guide/example_js.result +22 -0
data/test/data/users-guide/example_perl.result +20 -0
data/test/data/users-guide/example_php.result +19 -0
data/test/data/users-guide/example_scheme.result +30 -0
data/test/data/users-guide/example_scheme_display.result +29 -0
data/test/data/users-guide/fasteruby.rb +11 -0
data/test/data/users-guide/fasteruby.result +38 -0
data/test/data/users-guide/fasteruby.rhtml +15 -0
data/test/data/users-guide/headerfooter-example.eruby +9 -0
data/test/data/users-guide/headerfooter-example2.rb +8 -0
data/test/data/users-guide/headerfooter-example2.rhtml +10 -0
data/test/data/users-guide/headerfooter_example.result +11 -0
data/test/data/users-guide/headerfooter_example2.result +13 -0
data/test/data/users-guide/interpolation_example.result +9 -0
data/test/data/users-guide/nocode-example.eruby +14 -0
data/test/data/users-guide/nocode-php.result +20 -0
data/test/data/users-guide/nocode_example.result +15 -0
data/test/data/users-guide/normal-eruby-test.eruby +9 -0
data/test/data/users-guide/normal_eruby_test.result +11 -0
data/test/data/users-guide/notext-example.eruby +14 -0
data/test/data/users-guide/notext-example.php +19 -0
data/test/data/users-guide/notext-php.result +20 -0
data/test/data/users-guide/notext_example.result +16 -0
data/test/data/users-guide/percentline-example.rhtml +4 -0
data/test/data/users-guide/percentline_example.result +7 -0
data/test/data/users-guide/printenable_example.result +4 -0
data/test/data/users-guide/printenabled-example.eruby +3 -0
data/test/data/users-guide/printenabled-example.rb +8 -0
data/test/data/users-guide/printstatement_example.result +8 -0
data/test/data/users-guide/simplify_example.result +9 -0
data/test/data/users-guide/stdout_exmple.result +9 -0
data/test/data/users-guide/stringbuffer_example.result +9 -0
data/test/test-engines.rb +2 -2
data/test/test-enhancers.rb +569 -0
data/test/test-erubis.rb +3 -380
data/test/test-main.rb +39 -15
data/test/test-users-guide.rb +56 -0
data/test/test.rb +4 -3
data/test/testutil.rb +2 -2
metadata +166 -57
data/benchmark/erubybench-lib.rb +0 -189
data/benchmark/erubybench.rb +0 -600
data/bin/notext +0 -154
data/test/test-notext.rb +0 -27

data/test/data/users-guide/example1.eruby ADDED

@@ -0,0 +1,6 @@
+<ul>
+  <% for item in list %>
+  <li><%= item %></li>
+  <% end %>
+  <%# here is ignored because starting with '#' %>
+</ul>

data/test/data/users-guide/example1.rb ADDED

@@ -0,0 +1,16 @@
+require 'erubis'
+input = File.read('example1.eruby')
+eruby = Erubis::Eruby.new(input)    # create Eruby object
+puts "---------- script source ---"
+puts eruby.src                      # print script source
+puts "---------- result ----------"
+list = ['aaa', 'bbb', 'ccc']
+puts eruby.result(binding())        # get result
+## # or
+## eruby = Erubis::Eruby.new
+## input = File.read('example1.eruby')
+## src = eruby.convert(input)
+## eval src

data/test/data/users-guide/example1.result ADDED

@@ -0,0 +1,16 @@
+$ ruby example1.rb
+---------- script source ---
+_buf = ''; _buf << '<ul>
+';   for item in list
+ _buf << '  <li>'; _buf << ( item ).to_s; _buf << '</li>
+';   end
+ _buf << '</ul>
+';
+_buf.to_s
+---------- result ----------
+<ul>
+  <li>aaa</li>
+  <li>bbb</li>
+  <li>ccc</li>
+</ul>

data/test/data/users-guide/example10.rb ADDED

@@ -0,0 +1,4 @@
+require 'erubis'
+input = File.read('example10.xhtml')
+eruby = Erubis::PI::Eruby.new(input)
+print eruby.src

data/test/data/users-guide/example10.result ADDED

@@ -0,0 +1,17 @@
+$ ruby example10.rb
+_buf = ''; _buf << '<?xml version="1.0" ?>
+';
+  lang = 'en'
+  list = ['<aaa>', 'b&b', '"ccc"']
+ _buf << '<html lang="'; _buf << (lang).to_s; _buf << '">
+ <body>
+  <ul>
+';   for item in list
+ _buf << '   <li>'; _buf << Erubis::XmlHelper.escape_xml(item); _buf << '</li>
+';   end
+ _buf << '  </ul>
+ </body>
+</html>
+';
+_buf.to_s

data/test/data/users-guide/example10.xhtml ADDED

@@ -0,0 +1,14 @@
+<?xml version="1.0" ?>
+<?rb
+  lang = 'en'
+  list = ['<aaa>', 'b&b', '"ccc"']
+?>
+<html lang="@!{lang}@">
+ <body>
+  <ul>
+  <?rb for item in list ?>
+   <li>@{item}@</li>
+  <?rb end ?>
+  </ul>
+ </body>
+</html>

data/test/data/users-guide/example10_x.result ADDED

@@ -0,0 +1,17 @@
+$ erubis -x --pi example10.xhtml
+_buf = ''; _buf << '<?xml version="1.0" ?>
+';
+  lang = 'en'
+  list = ['<aaa>', 'b&b', '"ccc"']
+ _buf << '<html lang="'; _buf << (lang).to_s; _buf << '">
+ <body>
+  <ul>
+';   for item in list
+ _buf << '   <li>'; _buf << Erubis::XmlHelper.escape_xml(item); _buf << '</li>
+';   end
+ _buf << '  </ul>
+ </body>
+</html>
+';
+_buf.to_s

data/test/data/users-guide/example11.php ADDED

@@ -0,0 +1,20 @@
+<?xml version="1.0"?>
+<html>
+  <body>
+    <h3>List</h3>
+    <?php if (!$list) { ?>
+    <p>not found.</p>
+    <?php } else { ?>
+    <table>
+      <tbody>
+        <?php $i = 0; ?>
+        <?php foreach ($list as $item) { ?>
+        <tr bgcolor="<?php echo ++$i % 2 == 1 ? '#FCC' : '#CCF'; ?>">
+          <td><?php echo $item; ?></td>
+        </tr>
+        <?php } ?>
+      </tbody>
+    </table>
+    <?php } ?>
+  </body>
+</html>

data/test/data/users-guide/example11.result ADDED

@@ -0,0 +1,23 @@
+$ erubis -X example11.rhtml
+_buf = '';
+     if @list.nil? || @list.empty?
+     else
+         @list.each_with_index do |item, i|
+                      _buf << ( i % 2 == 0 ? '#FCC' : '#CCF' ).to_s;
+               _buf << ( item ).to_s;
+         end
+     end
+_buf.to_s

data/test/data/users-guide/example11.rhtml ADDED

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <body>
+    <h3>List</h3>
+    <% if @list.nil? || @list.empty? %>
+    <p>not found.</p>
+    <% else %>
+    <table>
+      <tbody>
+        <% @list.each_with_index do |item, i| %>
+        <tr bgcolor="<%= i % 2 == 0 ? '#FCC' : '#CCF' %>">
+          <td><%= item %></td>
+        </tr>
+        <% end %>
+      </tbody>
+    </table>
+    <% end %>
+  </body>
+</html>

data/test/data/users-guide/example11_C.result ADDED

@@ -0,0 +1,10 @@
+$ erubis -XC example11.rhtml
+_buf = '';
+     if @list.nil? || @list.empty?
+     else
+         @list.each_with_index do |item, i|
+                      _buf << ( i % 2 == 0 ? '#FCC' : '#CCF' ).to_s;
+               _buf << ( item ).to_s;
+         end
+     end
+_buf.to_s

data/test/data/users-guide/example11_N.result ADDED

@@ -0,0 +1,16 @@
+$ erubis -XNU example11.rhtml
+    1:  _buf = '';
+    7:       if @list.nil? || @list.empty?
+    9:       else
+   12:           @list.each_with_index do |item, i|
+   13:                        _buf << ( i % 2 == 0 ? '#FCC' : '#CCF' ).to_s;
+   14:                 _buf << ( item ).to_s;
+   16:           end
+   19:       end
+   22:  _buf.to_s

data/test/data/users-guide/example11_U.result ADDED

@@ -0,0 +1,16 @@
+$ erubis -XU example11.rhtml
+_buf = '';
+     if @list.nil? || @list.empty?
+     else
+         @list.each_with_index do |item, i|
+                      _buf << ( i % 2 == 0 ? '#FCC' : '#CCF' ).to_s;
+               _buf << ( item ).to_s;
+         end
+     end
+_buf.to_s

data/test/data/users-guide/example11_php.result ADDED

@@ -0,0 +1,15 @@
+$ erubis -XNU -l php --pi=php --trim=false example11.php
+    5:      <?php if (!$list) { ?>
+    7:      <?php } else { ?>
+   10:          <?php $i = 0; ?>
+   11:          <?php foreach ($list as $item) { ?>
+   12:                       <?php echo ++$i % 2 == 1 ? '#FCC' : '#CCF'; ?>
+   13:                <?php echo $item; ?>
+   15:          <?php } ?>
+   18:      <?php } ?>

data/test/data/users-guide/example1_x.result ADDED

@@ -0,0 +1,9 @@
+$ erubis -x example1.eruby
+_buf = ''; _buf << '<ul>
+';   for item in list
+ _buf << '  <li>'; _buf << ( item ).to_s; _buf << '</li>
+';   end
+ _buf << '</ul>
+';
+_buf.to_s

data/test/data/users-guide/example2.eruby ADDED

@@ -0,0 +1,7 @@
+<ul>
+  <% for item in list %>
+  <li>
+    <%= item %>
+  </li>
+  <% end %>
+</ul>

data/test/data/users-guide/example2.rb ADDED

@@ -0,0 +1,10 @@
+require 'erubis'
+input = File.read('example2.eruby')
+eruby = Erubis::Eruby.new(input, :trim=>false)
+puts "----- script source ---"
+puts eruby.src                            # print script source
+puts "----- result ----------"
+list = ['aaa', 'bbb', 'ccc']
+puts eruby.result(binding())              # get result

data/test/data/users-guide/example2.result ADDED

@@ -0,0 +1,27 @@
+$ ruby example2.rb
+----- script source ---
+_buf = ''; _buf << '<ul>
+'; _buf << '  '; for item in list ; _buf << '
+'; _buf << '  <li>
+    '; _buf << ( item ).to_s; _buf << '
+'; _buf << '  </li>
+'; _buf << '  '; end ; _buf << '
+'; _buf << '</ul>
+';
+_buf.to_s
+----- result ----------
+<ul>
+  <li>
+    aaa
+  </li>
+  <li>
+    bbb
+  </li>
+  <li>
+    ccc
+  </li>
+</ul>

data/test/data/users-guide/example2_trim.result ADDED

@@ -0,0 +1,10 @@
+$ erubis -x --trim=false example2.eruby
+_buf = ''; _buf << '<ul>
+'; _buf << '  '; for item in list ; _buf << '
+'; _buf << '  <li>
+    '; _buf << ( item ).to_s; _buf << '
+'; _buf << '  </li>
+'; _buf << '  '; end ; _buf << '
+'; _buf << '</ul>
+';
+_buf.to_s

data/test/data/users-guide/example2_x.result ADDED

@@ -0,0 +1,10 @@
+$ erubis -x example2.eruby
+_buf = ''; _buf << '<ul>
+';   for item in list
+ _buf << '  <li>
+    '; _buf << ( item ).to_s; _buf << '
+'; _buf << '  </li>
+';   end
+ _buf << '</ul>
+';
+_buf.to_s

data/test/data/users-guide/example3.eruby ADDED

@@ -0,0 +1,6 @@
+<% for item in list %>
+  <p><%= item %></p>
+  <p><%== item %></p>
+  <p><%=== item %></p>
+<% end %>

data/test/data/users-guide/example3.rb ADDED

@@ -0,0 +1,10 @@
+require 'erubis'
+input = File.read('example3.eruby')
+eruby = Erubis::EscapedEruby.new(input)    # or Erubis::XmlEruby
+puts "----- script source ---"
+puts eruby.src                             # print script source
+puts "----- result ----------"
+list = ['<aaa>', 'b&b', '"ccc"']
+puts eruby.result(binding())               # get result

data/test/data/users-guide/example31.result ADDED

@@ -0,0 +1,22 @@
+$ ruby example3.rb 2> stderr.log
+----- script source ---
+_buf = ''; for item in list
+ _buf << '  <p>'; _buf << Erubis::XmlHelper.escape_xml( item ); _buf << '</p>
+  <p>'; _buf << ( item ).to_s; _buf << '</p>
+  <p>'; $stderr.puts("*** debug: item=#{(item).inspect}"); _buf << '</p>
+'; end
+_buf.to_s
+----- result ----------
+  <p>&lt;aaa&gt;</p>
+  <p><aaa></p>
+  <p></p>
+  <p>b&amp;b</p>
+  <p>b&b</p>
+  <p></p>
+  <p>&quot;ccc&quot;</p>
+  <p>"ccc"</p>
+  <p></p>

data/test/data/users-guide/example32.result ADDED

@@ -0,0 +1,4 @@
+$ cat stderr.log
+*** debug: item="<aaa>"
+*** debug: item="b&b"
+*** debug: item="\"ccc\""

data/test/data/users-guide/example3_e.result ADDED

@@ -0,0 +1,8 @@
+$ erubis -l ruby -e example3.eruby
+_buf = ''; for item in list
+ _buf << '  <p>'; _buf << Erubis::XmlHelper.escape_xml( item ); _buf << '</p>
+  <p>'; _buf << ( item ).to_s; _buf << '</p>
+  <p>'; $stderr.puts("*** debug: item=#{(item).inspect}"); _buf << '</p>
+'; end
+_buf.to_s

data/test/data/users-guide/example4.eruby ADDED

@@ -0,0 +1,3 @@
+<!--% for item in list %-->
+  <p><!--%= item %--></p>
+<!--% end %-->

data/test/data/users-guide/example4.rb ADDED

@@ -0,0 +1,11 @@
+require 'erubis'
+input = File.read('example4.eruby')
+eruby = Erubis::Eruby.new(input, :pattern=>'<!--% %-->')
+                                      # or '<(?:!--)?% %(?:--)?>'
+puts "---------- script source ---"
+puts eruby.src                            # print script source
+puts "---------- result ----------"
+list = ['aaa', 'bbb', 'ccc']
+puts eruby.result(binding())              # get result

data/test/data/users-guide/example4.result ADDED

@@ -0,0 +1,10 @@
+$ ruby example4.rb
+---------- script source ---
+_buf = ''; for item in list
+ _buf << '  <p>'; _buf << ( item ).to_s; _buf << '</p>
+'; end
+_buf.to_s
+---------- result ----------
+  <p>aaa</p>
+  <p>bbb</p>
+  <p>ccc</p>

data/test/data/users-guide/example4_x.result ADDED

@@ -0,0 +1,5 @@
+$ erubis -x -p '<!--% %-->' example4.eruby
+_buf = ''; for item in list
+ _buf << '  <p>'; _buf << ( item ).to_s; _buf << '</p>
+'; end
+_buf.to_s

data/test/data/users-guide/example5.eruby ADDED

@@ -0,0 +1,6 @@
+<span><%= @val %></span>
+<ul>
+ <% for item in @list %>
+  <li><%= item %></li>
+ <% end %>
+</ul>

data/test/data/users-guide/example5.rb ADDED

@@ -0,0 +1,16 @@
+require 'erubis'
+input = File.read('example5.eruby')
+eruby = Erubis::Eruby.new(input)      # create Eruby object
+## create context object
+## (key means var name, which may be string or symbol.)
+context = {
+  :val   => 'Erubis Example',
+  'list' => ['aaa', 'bbb', 'ccc'],
+}
+## or
+# context = Erubis::Context.new()
+# context['val'] = 'Erubis Example'
+# context[:list] = ['aaa', 'bbb', 'ccc'],
+puts eruby.evaluate(context)         # get result

data/test/data/users-guide/example5.result ADDED

@@ -0,0 +1,7 @@
+$ ruby example5.rb
+<span>Erubis Example</span>
+<ul>
+  <li>aaa</li>
+  <li>bbb</li>
+  <li>ccc</li>
+</ul>