tenjin 0.6.0

data/test/data/users_guide/ex.script

@@ -0,0 +1,5 @@
+require 'tenjin'
+engine = Tenjin::Engine.new()
+context = { :name=>'World', :items=>['<AAA>', 'B&B', '"CCC"'] }
+output = engine.render('ex.rbhtml', context)
+print output

data/test/data/users_guide/ex_script.result

@@ -0,0 +1,7 @@
+$ ruby ex.script
+Hello World!
+<ul>
+ <li>&lt;AAA&gt;</li>
+ <li>B&amp;B</li>
+ <li>&quot;CCC&quot;</li>
+</ul>

data/test/data/users_guide/ex_source.result

@@ -0,0 +1,8 @@
+$ rbtenjin -s ex.rbhtml
+_buf = '';  _buf << %Q`Hello #{@name}!
+<ul>\n`
+for item in @items
+ _buf << %Q` <li>#{escape((item).to_s)}</li>\n`
+end
+ _buf << %Q`</ul>\n`
+_buf.to_s

data/test/data/users_guide/example1.rbhtml

@@ -0,0 +1,12 @@
+<table>
+  <tbody>
+<?rb i = 0 ?>
+<?rb for item in ['<foo>', 'bar&bar', '"baz"'] ?>
+<?rb     i += 1 ?>
+    <tr>
+      <td>#{item}</td>
+      <td>${item}</td>
+    </tr>
+<?rb end ?>
+  <tbody>
+</table>

data/test/data/users_guide/example1.result

@@ -0,0 +1,17 @@
+$ rbtenjin example1.rbhtml
+<table>
+  <tbody>
+    <tr>
+      <td><foo></td>
+      <td>&lt;foo&gt;</td>
+    </tr>
+    <tr>
+      <td>bar&bar</td>
+      <td>bar&amp;bar</td>
+    </tr>
+    <tr>
+      <td>"baz"</td>
+      <td>&quot;baz&quot;</td>
+    </tr>
+  <tbody>
+</table>

data/test/data/users_guide/example10.rbhtml

@@ -0,0 +1,4 @@
+<?xml version="1.0"?>
+<?rb #@ARGS title, name ?>
+<h1>${title}</h1>
+<p>Hello ${name}!</p>

data/test/data/users_guide/example10_template_args.result

@@ -0,0 +1,6 @@
+$ rbtenjin -s example10.rbhtml
+_buf = '';  _buf << %Q`<?xml version="1.0"?>\n`
+ title = @title; name = @name;
+ _buf << %Q`<h1>#{escape((title).to_s)}</h1>
+<p>Hello #{escape((name).to_s)}!</p>\n`
+_buf.to_s

data/test/data/users_guide/example11.rbhtml

@@ -0,0 +1,5 @@
+<p>
+<?rb #@ARGS x ?>
+x = #{x}
+y = #{y}   # NameError
+</p>

data/test/data/users_guide/example11_template_args_result

@@ -0,0 +1,2 @@
+$ rbtenjin -c '@x=10;@y=20' example11.rbhtml
+example12.rbhtml:4:in `_render': undefined local variable or method `y' (NameError)

data/test/data/users_guide/example12.rbhtml

@@ -0,0 +1,12 @@
+<?RB states = { "CA" => "California", ?>
+<?RB            "NY" => "New York", ?>
+<?RB            "FL" => "Florida",  ?>
+<?RB            "TX" => "Texas",  ?>
+<?RB            "HI" => "Hawaii", } ?>
+<?rb chk = { @params['state'] => ' selected="selected"' } ?>
+<select name="state">
+  <option value="">-</option>
+<?RB for code in states.keys.sort ?>
+  <option value="#{{code}}"#{chk[#{{code.inspect}}]}>${{states[code]}}</option>
+<?RB end ?>
+</select>

data/test/data/users_guide/example12_preprocessed.result

@@ -0,0 +1,10 @@
+$ rbtenjin -P example12.rbhtml
+<?rb chk = { @params['state'] => ' selected="selected"' } ?>
+<select name="state">
+  <option value="">-</option>
+  <option value="CA"#{chk["CA"]}>California</option>
+  <option value="FL"#{chk["FL"]}>Florida</option>
+  <option value="HI"#{chk["HI"]}>Hawaii</option>
+  <option value="NY"#{chk["NY"]}>New York</option>
+  <option value="TX"#{chk["TX"]}>Texas</option>
+</select>

data/test/data/users_guide/example12_preprocessed_source.result

@@ -0,0 +1,10 @@
+$ rbtenjin --preprocess -sb example12.rbhtml
+chk = { @params['state'] => ' selected="selected"' }
+ _buf << %Q`<select name="state">
+  <option value="">-</option>
+  <option value="CA"#{chk["CA"]}>California</option>
+  <option value="FL"#{chk["FL"]}>Florida</option>
+  <option value="HI"#{chk["HI"]}>Hawaii</option>
+  <option value="NY"#{chk["NY"]}>New York</option>
+  <option value="TX"#{chk["TX"]}>Texas</option>
+</select>\n`

data/test/data/users_guide/example13.rbhtml

@@ -0,0 +1,6 @@
+<?RB require 'cgi' ?>
+<?RB ## ex. link_to('Show', '/show/1')  => <a href="/show/1">Show</a> ?>
+<?RB def link_to(label, url) ?>
+<?RB     return "<a href=\"#{CGI.unescape(url)}\">#{label}</a>" ?>
+<?RB end ?>
+#{{link_to 'Show '+_P('@params["name"]'), '/items/show/'+_p('@params["id"]')}}

data/test/data/users_guide/example13_preprocessed.result

@@ -0,0 +1,2 @@
+$ rbtenjin -P example13.rbhtml
+<a href="/items/show/#{@params["id"]}">Show ${@params["name"]}</a>

data/test/data/users_guide/example13_preprocessed_source.result

@@ -0,0 +1,2 @@
+$ rbtenjin --preprocess -sb example13.rbhtml
+ _buf << %Q`<a href="/items/show/#{@params["id"]}">Show #{escape((@params["name"]).to_s)}</a>\n`

data/test/data/users_guide/example14.rb

@@ -0,0 +1,32 @@
+## template file
+filename = 'example14.rbhtml'
+
+## convert into ruby code
+require 'tenjin'
+template = Tenjin::Template.new(filename)
+## or
+# template = Tenjin::Template.new()
+# script = template.convert_file(filename)
+## or
+# template = Tenjin::Template.new()
+# input = File.read(filename)
+# script = template.convert(input, filename)  # filename is optional
+
+## show converted ruby code
+puts "---- ruby code ----"
+puts template.script
+
+## evaluate ruby code
+hash = {:title=>'rbTenjin Example', :items=>['<AAA>','B&B','"CCC"']}
+output = template.render(hash)
+puts "---- output ----"
+puts output
+## or
+#hash = {:title=>'rbTenjin Example', :items=>['<AAA>','B&B','"CCC"']}
+#context = Tenjin::Context.new(hash)
+#output = template.render(context)
+## or
+# context = Tenjin::Context.new
+# context[:title] = 'rbTenjin Example'
+# context[:items] = ['<AAA>','B&B','"CCC"']
+# output = template.render(context)

data/test/data/users_guide/example14.rbhtml

@@ -0,0 +1,6 @@
+<h1>#{@title}</h1>
+<ul>
+<?rb for item in @items ?>
+ <li>${item}</li>
+<?rb end ?>
+</ul>

data/test/data/users_guide/example14_tmplclass.result

@@ -0,0 +1,15 @@
+$ ruby example14.rb
+---- ruby code ----
+ _buf << %Q`<h1>#{@title}</h1>
+<ul>\n`
+for item in @items
+ _buf << %Q` <li>#{escape((item).to_s)}</li>\n`
+end
+ _buf << %Q`</ul>\n`
+---- output ----
+<h1>rbTenjin Example</h1>
+<ul>
+ <li>&lt;AAA&gt;</li>
+ <li>B&amp;B</li>
+ <li>&quot;CCC&quot;</li>
+</ul>

data/test/data/users_guide/example15.rb

@@ -0,0 +1,10 @@
+require 'tenjin'
+filename = 'example14.rbhtml'
+template = Tenjin::Template.new(filename, :escapefunc=>'CGI.escapeHTML')
+print template.script, "\n"
+
+require 'cgi'
+title = 'rbTenjin Example'
+items = ['<foo>', '&bar', '"baz"']
+output = template.render(:title=>title, :items=>items)
+print output

data/test/data/users_guide/example15_escapefunc.result

@@ -0,0 +1,14 @@
+$ ruby example15.rb
+ _buf << %Q`<h1>#{@title}</h1>
+<ul>\n`
+for item in @items
+ _buf << %Q` <li>#{CGI.escapeHTML((item).to_s)}</li>\n`
+end
+ _buf << %Q`</ul>\n`
+
+<h1>rbTenjin Example</h1>
+<ul>
+ <li>&lt;foo&gt;</li>
+ <li>&amp;bar</li>
+ <li>&quot;baz&quot;</li>
+</ul>

data/test/data/users_guide/example16.rbhtml

@@ -0,0 +1,4 @@
+<?rb #@ARGS label, url ?>
+<ul>
+  <li>#{link_to(label, url)}</li>
+</ul>

data/test/data/users_guide/example16a.rb

@@ -0,0 +1,10 @@
+require 'tenjin'
+
+def link_to(label, url)
+  return "<a href=\"#{escape_xml(url)}\">#{escape_xml(label)}</a>"
+end
+
+engine = Tenjin::Engine.new()
+context = { :label=>'Top', :url=>'/' }
+output = engine.render('example16.rbhtml', context)
+print output

data/test/data/users_guide/example16a.result

@@ -0,0 +1,4 @@
+$ ruby example16a.rb
+<ul>
+  <li><a href="/">Top</a></li>
+</ul>

data/test/data/users_guide/example16b.rb

@@ -0,0 +1,13 @@
+require 'tenjin'
+
+module Tenjin::ContextHelper
+  module_function
+  def link_to(label, url)
+    return "<a href=\"#{escape_xml(url)}\">#{escape_xml(label)}</a>"
+  end
+end
+
+engine = Tenjin::Engine.new()
+context = { :label=>'Top', :url=>'/' }
+output = engine.render('example16.rbhtml', context)
+print output

data/test/data/users_guide/example16b.result

@@ -0,0 +1,4 @@
+$ ruby example16b.rb
+<ul>
+  <li><a href="/">Top</a></li>
+</ul>

data/test/data/users_guide/example16c.rb

@@ -0,0 +1,12 @@
+require 'tenjin'
+
+class MyContext < Tenjin::Context
+  def link_to(label, url)
+    return "<a href=\"#{escape_xml(url)}\">#{escape_xml(label)}</a>"
+  end
+end
+
+engine = Tenjin::Engine.new()
+context = MyContext.new(:label=>'Top', :url=>'/')
+output = engine.render('example16.rbhtml', context)
+print output

data/test/data/users_guide/example16c.result

@@ -0,0 +1,4 @@
+$ ruby example16c.rb
+<ul>
+  <li><a href="/">Top</a></li>
+</ul>

data/test/data/users_guide/example1_S.result

@@ -0,0 +1,14 @@
+$ rbtenjin -S example1.rbhtml
+_buf = ''; 
+
+i = 0
+for item in ['<foo>', 'bar&bar', '"baz"']
+    i += 1
+
+
+escape((item).to_s); 
+
+end
+
+
+_buf.to_s

data/test/data/users_guide/example1_SXNC.result

@@ -0,0 +1,10 @@
+$ rbtenjin -SUNX example1.rbhtml
+    1:  _buf = ''; 
+
+    3:  i = 0
+    4:  for item in ['<foo>', 'bar&bar', '"baz"']
+    5:      i += 1
+
+   10:  end
+
+   13:  _buf.to_s

data/test/data/users_guide/example1_source.result

@@ -0,0 +1,14 @@
+$ rbtenjin -s example1.rbhtml
+_buf = '';  _buf << %Q`<table>
+  <tbody>\n`
+i = 0
+for item in ['<foo>', 'bar&bar', '"baz"']
+    i += 1
+ _buf << %Q`    <tr>
+      <td>#{item}</td>
+      <td>#{escape((item).to_s)}</td>
+    </tr>\n`
+end
+ _buf << %Q`  <tbody>
+</table>\n`
+_buf.to_s

data/test/data/users_guide/example2.rbhtml

@@ -0,0 +1,3 @@
+<?rb for i in [1, 2, 3] ?>
+<p>#{item}</p>
+<?rb end ?>

data/test/data/users_guide/example2_sb.result2

@@ -0,0 +1,9 @@
+$ rbtenjin -s example2.rbhtml
+_buf = ''; for i in [1, 2, 3]
+ _buf << %Q`<p>#{item}</p>\n`
+end
+_buf.to_s
+$ rbtenjin -sb example2.rbhtml
+for i in [1, 2, 3]
+ _buf << %Q`<p>#{item}</p>\n`
+end

data/test/data/users_guide/example3.rbhtml

@@ -0,0 +1,5 @@
+<ul>
+<?rb for item in items ?>
+  <li>${item}</li>
+<?rb ende ?>
+</ul>

data/test/data/users_guide/example3_syntaxcheck.result

@@ -0,0 +1,2 @@
+$ rbtenjin -wz example3.rbhtml
+example3.rbhtml:5: syntax error, unexpected $end, expecting kEND

data/test/data/users_guide/example4.rbhtml

@@ -0,0 +1,13 @@
+<p>
+  ${@text}
+  #{@num}
+  #{@flag}
+</p>
+
+<?rb for item in @items ?>
+<p>${item}</p>
+<?rb end ?>
+
+<?rb for key, value in @hash ?>
+<p>#{key} = ${value}</p>
+<?rb end ?>

data/test/data/users_guide/example4_datafile_rb.result

@@ -0,0 +1,13 @@
+$ rbtenjin -f datafile.rb example4.rbhtml
+<p>
+  foo
+  3.14
+  true
+</p>
+
+<p>foo</p>
+<p>bar</p>
+<p>baz</p>
+
+<p>x = 1</p>
+<p>y = 2</p>

data/test/data/users_guide/example4_yaml.result

@@ -0,0 +1,13 @@
+$ rbtenjin -f datafile.yaml example4.rbhtml
+<p>
+  foo
+  3.14
+  true
+</p>
+
+<p>foo</p>
+<p>bar</p>
+<p>baz</p>
+
+<p>x = 1</p>
+<p>y = 2</p>

data/test/data/users_guide/example5.rbhtml

@@ -0,0 +1,9 @@
+text:  #{@text}
+items:
+<?rb for item in @items ?>
+  - #{item}
+<?rb end ?>
+hash:
+<?rb for key, val in @hash ?>
+  #{key}: #{val}
+<?rb end ?>

data/test/data/users_guide/example5_datastr_rb.result

@@ -0,0 +1,9 @@
+$ rbtenjin -c '@text="foo"; @items=%w[a b c]; @hash={"x"=>1,"y"=>2}' example5.rbhtml
+text:  foo
+items:
+  - a
+  - b
+  - c
+hash:
+  x: 1
+  y: 2

data/test/data/users_guide/example5_datastr_yaml.result

@@ -0,0 +1,9 @@
+$ rbtenjin -c '{text: foo, items: [a, b, c], hash: {x: 1, y: 2} }' example5.rbhtml
+text:  foo
+items:
+  - a
+  - b
+  - c
+hash:
+  x: 1
+  y: 2