RubyGems - tenjin - Versions diffs - 0.6.2 → 0.7.0 - Mend

tenjin 0.6.2 → 0.7.0

Files changed (282) hide show

data/CHANGES.txt +163 -0
data/MIT-LICENSE +16 -17
data/README.txt +5 -5
data/benchmark/Makefile +9 -0
data/benchmark/bench.rb +3 -2
data/bin/rbtenjin +6 -3
data/doc/docstyle.css +25 -4
data/doc/users-guide.html +2088 -1563
data/lib/tenjin.rb +784 -158
data/public_html/_layout.rbhtml +33 -0
data/public_html/css/style.css +77 -0
data/public_html/env.rbhtml +15 -0
data/public_html/favicon.ico +0 -0
data/public_html/hello.rbhtml +14 -0
data/public_html/index.rbhtml +39 -0
data/public_html/rbtenjin.cgi +188 -0
data/tenjin.gemspec +9 -6
data/test/data/examples/preprocessing/main.rb +1 -1
data/test/data/examples/preprocessing/select.rbhtml +1 -1
data/test/data/faq/{ex11-bench.rb → ex10-bench.rb} +3 -3
data/test/data/faq/ex10-content.rbhtml +8 -11
data/test/data/faq/{ex11-layout1.rbhtml → ex10-layout1.rbhtml} +0 -0
data/test/data/faq/{ex11-layout2.rbhtml → ex10-layout2.rbhtml} +0 -0
data/test/data/faq/{ex11.rb → ex10.rb} +1 -1
data/test/data/faq/{ex11.rbhtml → ex10.rbhtml} +0 -0
data/test/data/faq/{ex11.source → ex10.source} +2 -2
data/test/data/faq/{ex11_arraybuffer.result → ex10_arraybuffer.result} +1 -1
data/test/data/faq/{ex5.rbhtml → ex2.rbhtml} +0 -0
data/test/data/faq/{ex5_template_args.source → ex2_template_args.source} +1 -1
data/test/data/faq/{ex7-expr-pattern.rb → ex4-expr-pattern.rb} +1 -1
data/test/data/faq/{ex7-expr-pattern.rbhtml → ex4-expr-pattern.rbhtml} +0 -0
data/test/data/faq/{ex7_expr_pattern.result → ex4_expr_pattern.result} +1 -1
data/test/data/faq/{ex6-content.rhtml → ex5-content.rhtml} +0 -0
data/test/data/faq/{ex6-layout.rhtml → ex5-layout.rhtml} +0 -0
data/test/data/faq/{ex6.rb → ex5.rb} +2 -2
data/test/data/faq/{ex6_eruby.result → ex5_eruby.result} +1 -1
data/test/data/faq/{ex2-content.rbhtml → ex6-content.rbhtml} +0 -0
data/test/data/faq/{ex2-layout.rbhtml → ex6-layout.rbhtml} +0 -0
data/test/data/faq/{ex2_removenl.result → ex6_removenl.result} +1 -1
data/test/data/faq/ex7-m18n.rb +48 -0
data/test/data/faq/{ex8-m18n.rbhtml → ex7-m18n.rbhtml} +0 -0
data/test/data/faq/{ex8_m18n.result → ex7_m18n.result} +1 -1
data/test/data/faq/ex8-baselayout.rbhtml +8 -0
data/test/data/faq/ex8-content.rbhtml +6 -0
data/test/data/faq/{ex9-mylayout.rbhtml → ex8-mylayout.rbhtml} +0 -0
data/test/data/faq/{ex9_changelayout.result → ex8_changelayout.result} +1 -1
data/test/data/faq/ex9-baselayout.rbhtml +24 -5
data/test/data/faq/ex9-content.rbhtml +12 -6
data/test/data/faq/{ex10-customlayout.rbhtml → ex9-customlayout.rbhtml} +1 -1
data/test/data/faq/{ex10_inherit.result → ex9_inherit.result} +1 -1
data/test/data/faq/helpers1.rb +17 -0
data/test/data/faq/helpers1.rbhtml +4 -0
data/test/data/faq/helpers1.result +11 -0
data/test/data/faq/helpers2.rb +21 -0
data/test/data/faq/helpers2.rbhtml +4 -0
data/test/data/faq/helpers2.result +11 -0
data/test/data/faq/weekday1.rb +6 -0
data/test/data/faq/weekday1.rbhtml +9 -0
data/test/data/faq/weekday1.result +23 -0
data/test/data/faq/weekday2.rb +8 -0
data/test/data/faq/weekday2.rbhtml +10 -0
data/test/data/faq/weekday2.result +24 -0
data/test/data/faq/weekday3.rb +22 -0
data/test/data/faq/weekday3.rbhtml +3 -0
data/test/data/faq/weekday3.result +28 -0
data/test/data/users_guide/test_010/main.rb +14 -0
data/test/data/users_guide/test_010/result.output +13 -0
data/test/data/users_guide/test_010/views/page.rbhtml +11 -0
data/test/data/users_guide/test_011/main.rb +14 -0
data/test/data/users_guide/test_011/result.output +2 -0
data/test/data/users_guide/test_011/views/page.rbhtml +11 -0
data/test/data/users_guide/test_020/main.rb +14 -0
data/test/data/users_guide/test_020/result.output +13 -0
data/test/data/users_guide/test_020/views/page.rbhtml +11 -0
data/test/data/users_guide/test_021/main.rb +12 -0
data/test/data/users_guide/test_021/result.output +12 -0
data/test/data/users_guide/test_021/views/page.rbhtml +11 -0
data/test/data/users_guide/test_030/main.rb +14 -0
data/test/data/users_guide/test_030/result.output +23 -0
data/test/data/users_guide/test_030/views/_layout.rbhtml +10 -0
data/test/data/users_guide/test_030/views/page.rbhtml +11 -0
data/test/data/users_guide/test_040/main.rb +14 -0
data/test/data/users_guide/test_040/result.output +23 -0
data/test/data/users_guide/test_040/views/_layout.rbhtml +10 -0
data/test/data/users_guide/test_040/views/page.rbhtml +12 -0
data/test/data/users_guide/test_050/main.rb +14 -0
data/test/data/users_guide/test_050/result.output +14 -0
data/test/data/users_guide/test_050/views/_layout.rbhtml +10 -0
data/test/data/users_guide/test_050/views/page.rbhtml +13 -0
data/test/data/users_guide/test_051/main.rb +14 -0
data/test/data/users_guide/test_051/result.output +12 -0
data/test/data/users_guide/test_051/views/_layout.rbhtml +11 -0
data/test/data/users_guide/test_051/views/page.rbhtml +13 -0
data/test/data/users_guide/test_060/main.rb +14 -0
data/test/data/users_guide/test_060/result.output +29 -0
data/test/data/users_guide/test_060/views/_footer.rbhtml +3 -0
data/test/data/users_guide/test_060/views/_header.rbhtml +3 -0
data/test/data/users_guide/test_060/views/_layout.rbhtml +13 -0
data/test/data/users_guide/test_060/views/page.rbhtml +13 -0
data/test/data/users_guide/test_070/main.rb +14 -0
data/test/data/users_guide/test_070/result.output +29 -0
data/test/data/users_guide/test_070/views/_footer.rbhtml +3 -0
data/test/data/users_guide/test_070/views/_header.rbhtml +3 -0
data/test/data/users_guide/test_070/views/_layout.rbhtml +13 -0
data/test/data/users_guide/test_070/views/page.rbhtml +13 -0
data/test/data/users_guide/test_capturing/main.rb +24 -0
data/test/data/users_guide/test_capturing/result.output +28 -0
data/test/data/users_guide/test_capturing/views/_layout.rbhtml +21 -0
data/test/data/users_guide/test_capturing/views/blog-post.rbhtml +13 -0
data/test/data/users_guide/test_context/context.rb +5 -0
data/test/data/users_guide/test_context/context.yaml +4 -0
data/test/data/users_guide/test_context/example.rbhtml +5 -0
data/test/data/users_guide/test_context/result1.output +6 -0
data/test/data/users_guide/test_context/result2.output +6 -0
data/test/data/users_guide/test_context/result3.output +6 -0
data/test/data/users_guide/test_context/result4.output +6 -0
data/test/data/users_guide/test_convert/example.rbhtml +5 -0
data/test/data/users_guide/test_convert/result1.output +7 -0
data/test/data/users_guide/test_convert/result2.output +6 -0
data/test/data/users_guide/test_escape/main.rb +4 -0
data/test/data/users_guide/test_escape/result.output +5 -0
data/test/data/users_guide/test_escape/views/page.rbhtml +4 -0
data/test/data/users_guide/test_execute/example.rbhtml +6 -0
data/test/data/users_guide/test_execute/result.output +6 -0
data/test/data/users_guide/test_fragmentcache/cache.d/items/1 +5 -0
data/test/data/users_guide/test_fragmentcache/main.rb +21 -0
data/test/data/users_guide/test_fragmentcache/result.output +8 -0
data/test/data/users_guide/test_fragmentcache/result2.output +6 -0
data/test/data/users_guide/test_fragmentcache/views/items.rbhtml +10 -0
data/test/data/users_guide/test_logging/ex-logger.rb +11 -0
data/test/data/users_guide/test_logging/example.rbhtml +0 -0
data/test/data/users_guide/test_logging/result1.output +3 -0
data/test/data/users_guide/test_logging/result2.output +2 -0
data/test/data/users_guide/test_m17n/m17n.rb +44 -0
data/test/data/users_guide/test_m17n/m17n.rbhtml +5 -0
data/test/data/users_guide/test_m17n/result.output +9 -0
data/test/data/users_guide/test_m17n/result_en.output +4 -0
data/test/data/users_guide/test_m17n/result_fr.output +4 -0
data/test/data/users_guide/test_nested/main.rb +8 -0
data/test/data/users_guide/test_nested/result.output +15 -0
data/test/data/users_guide/test_nested/views/_blog_layout.rbhtml +5 -0
data/test/data/users_guide/{layout8_html.rbhtml → test_nested/views/_site_layout.rbhtml} +0 -0
data/test/data/users_guide/test_nested/views/blog_post.rbhtml +4 -0
data/test/data/users_guide/test_preprocessing/pp-example1.rb +14 -0
data/test/data/users_guide/test_preprocessing/result1a.output +11 -0
data/test/data/users_guide/test_preprocessing/result1b.output +5 -0
data/test/data/users_guide/test_preprocessing/result1c.output +6 -0
data/test/data/users_guide/test_preprocessing/result2a.output +10 -0
data/test/data/users_guide/test_preprocessing/result2b.output +10 -0
data/test/data/users_guide/test_preprocessing/result3a.output +2 -0
data/test/data/users_guide/test_preprocessing/result3b.output +2 -0
data/test/data/users_guide/test_preprocessing/views/pp-example1.rbhtml +4 -0
data/test/data/users_guide/{example12.rbhtml → test_preprocessing/views/pp-example2.rbhtml} +4 -4
data/test/data/users_guide/test_preprocessing/views/pp-example3.rbhtml +7 -0
data/test/data/users_guide/test_retrieve/example.rbhtml +10 -0
data/test/data/users_guide/test_retrieve/result1.output +11 -0
data/test/data/users_guide/test_retrieve/result2.output +11 -0
data/test/data/users_guide/test_retrieve/result3.output +11 -0
data/test/data/users_guide/test_retrieve/result4.output +8 -0
data/test/data/users_guide/test_retrieve/result5.output +5 -0
data/test/data/users_guide/test_safe/result.output +6 -0
data/test/data/users_guide/test_safe/safe-test.rb +21 -0
data/test/data/users_guide/test_safehelper/main.rb +16 -0
data/test/data/users_guide/test_safehelper/result.output +8 -0
data/test/data/users_guide/{example3.rbhtml → test_syntax_check/example.rbhtml} +0 -0
data/test/data/users_guide/test_syntax_check/result.output +2 -0
data/test/data/users_guide/test_trace/layout.rbhtml +7 -0
data/test/data/users_guide/test_trace/main.rbhtml +5 -0
data/test/data/users_guide/test_trace/result.output +16 -0
data/test/data/users_guide/test_trace/trace-example.rb +4 -0
data/test/oktest.rb +755 -0
data/test/test_all.rb +24 -14
data/test/test_engine.rb +628 -63
data/test/test_engine.yaml +40 -3
data/test/test_examples.rb +14 -12
data/test/test_faq.rb +17 -12
data/test/test_htmlhelper.rb +104 -33
data/test/test_main.rb +32 -21
data/test/test_main.yaml +2 -2
data/test/test_safe.rb +206 -0
data/test/test_store.rb +220 -0
data/test/test_tcache.rb +94 -0
data/test/test_template.rb +65 -23
data/test/test_template.yaml +7 -7
data/test/test_users_guide.rb +75 -29
data/test/testcase-helper.rb +20 -18
data/test/testunit-assertions.rb +71 -0
metadata +185 -159
data/doc-api/classes/Tenjin.html +0 -141
data/doc-api/classes/Tenjin/ArrayBufferTemplate.html +0 -270
data/doc-api/classes/Tenjin/BaseContext.html +0 -329
data/doc-api/classes/Tenjin/Context.html +0 -126
data/doc-api/classes/Tenjin/ContextHelper.html +0 -461
data/doc-api/classes/Tenjin/Engine.html +0 -616
data/doc-api/classes/Tenjin/ErubisTemplate.html +0 -166
data/doc-api/classes/Tenjin/HtmlHelper.html +0 -359
data/doc-api/classes/Tenjin/Preprocessor.html +0 -242
data/doc-api/classes/Tenjin/Template.html +0 -916
data/doc-api/created.rid +0 -1
data/doc-api/files/README_txt.html +0 -188
data/doc-api/files/lib/tenjin_rb.html +0 -136
data/doc-api/fr_class_index.html +0 -36
data/doc-api/fr_file_index.html +0 -28
data/doc-api/fr_method_index.html +0 -91
data/doc-api/index.html +0 -24
data/doc-api/rdoc-style.css +0 -208
data/doc/examples.html +0 -312
data/doc/faq.html +0 -909
data/examples/preprocessing/select.rbhtml.cache +0 -17
data/test/Rookbook.yaml +0 -14
data/test/assert-text-equal.rb +0 -45
data/test/data/faq/ex10-baselayout.rbhtml +0 -27
data/test/data/faq/ex11-content.rbhtml +0 -9
data/test/data/faq/ex8-m18n.rb +0 -77
data/test/data/users_guide/content6.rbhtml +0 -3
data/test/data/users_guide/content7.rbhtml +0 -5
data/test/data/users_guide/content8.rbhtml +0 -2
data/test/data/users_guide/contextdata.rb +0 -7
data/test/data/users_guide/datafile.rb +0 -5
data/test/data/users_guide/datafile.yaml +0 -10
data/test/data/users_guide/ex.rbhtml +0 -6
data/test/data/users_guide/ex.result +0 -7
data/test/data/users_guide/ex.script +0 -5
data/test/data/users_guide/ex_script.result +0 -7
data/test/data/users_guide/ex_source.result +0 -8
data/test/data/users_guide/example1.rbhtml +0 -12
data/test/data/users_guide/example1.result +0 -17
data/test/data/users_guide/example10.rbhtml +0 -4
data/test/data/users_guide/example10_template_args.result +0 -6
data/test/data/users_guide/example11.rbhtml +0 -5
data/test/data/users_guide/example11_template_args_result +0 -2
data/test/data/users_guide/example12_preprocessed.result +0 -10
data/test/data/users_guide/example12_preprocessed_source.result +0 -10
data/test/data/users_guide/example13.rbhtml +0 -6
data/test/data/users_guide/example13_preprocessed.result +0 -2
data/test/data/users_guide/example13_preprocessed_source.result +0 -2
data/test/data/users_guide/example14.rb +0 -32
data/test/data/users_guide/example14.rbhtml +0 -6
data/test/data/users_guide/example14_tmplclass.result +0 -15
data/test/data/users_guide/example15.rb +0 -10
data/test/data/users_guide/example15_escapefunc.result +0 -14
data/test/data/users_guide/example16.rbhtml +0 -4
data/test/data/users_guide/example16a.rb +0 -10
data/test/data/users_guide/example16a.result +0 -4
data/test/data/users_guide/example16b.rb +0 -13
data/test/data/users_guide/example16b.result +0 -4
data/test/data/users_guide/example16c.rb +0 -12
data/test/data/users_guide/example16c.result +0 -4
data/test/data/users_guide/example16d.rb +0 -27
data/test/data/users_guide/example16d.result +0 -4
data/test/data/users_guide/example1_S.result +0 -14
data/test/data/users_guide/example1_SXNC.result +0 -10
data/test/data/users_guide/example1_source.result +0 -14
data/test/data/users_guide/example2.rbhtml +0 -3
data/test/data/users_guide/example2_sb.result2 +0 -9
data/test/data/users_guide/example3_syntaxcheck.result +0 -2
data/test/data/users_guide/example4.rbhtml +0 -13
data/test/data/users_guide/example4_datafile_rb.result +0 -13
data/test/data/users_guide/example4_yaml.result +0 -13
data/test/data/users_guide/example5.rbhtml +0 -9
data/test/data/users_guide/example5_datastr_rb.result +0 -9
data/test/data/users_guide/example5_datastr_yaml.result +0 -9
data/test/data/users_guide/example6.rbhtml +0 -19
data/test/data/users_guide/example6_layout.result +0 -29
data/test/data/users_guide/example6_nested.result +0 -28
data/test/data/users_guide/example7_layout2.result +0 -13
data/test/data/users_guide/example8_layout3.result +0 -8
data/test/data/users_guide/example9.rbhtml +0 -18
data/test/data/users_guide/example9_capture.result +0 -26
data/test/data/users_guide/footer.html +0 -5
data/test/data/users_guide/footer.rbhtml +0 -4
data/test/data/users_guide/layout6.rbhtml +0 -17
data/test/data/users_guide/layout7.rbhtml +0 -9
data/test/data/users_guide/layout8_xhtml.rbhtml +0 -6
data/test/data/users_guide/layout9.rbhtml +0 -25
data/test/data/users_guide/sidemenu.rbhtml +0 -5
data/test/data/users_guide/user_app.cgi +0 -39
data/test/data/users_guide/user_app.result +0 -30
data/test/data/users_guide/user_create.rbhtml +0 -6
data/test/data/users_guide/user_edit.rbhtml +0 -7
data/test/data/users_guide/user_form.rbhtml +0 -10
data/test/data/users_guide/user_layout.rbhtml +0 -16

data/test/data/users_guide/test_m17n/m17n.rbhtml ADDED

@@ -0,0 +1,5 @@
+<div>
+<?RB ## '_()' represents translator method ?>
+<?RB _ = @_ ?>
+ <p>${{_['Hello']}} ${@username}!</p>
+</div>

data/test/data/users_guide/test_m17n/result.output ADDED

@@ -0,0 +1,9 @@
+$ ruby m17n.rb
+--- lang: en ---
+<div>
+ <p>Hello World!</p>
+</div>
+--- lang: fr ---
+<div>
+ <p>Bonjour World!</p>
+</div>

data/test/data/users_guide/test_m17n/result_en.output ADDED

@@ -0,0 +1,4 @@
+$ cat m17n.rbhtml.en.cache
+ _buf << %Q`<div>
+ <p>Hello #{escape((@username).to_s)}!</p>
+</div>\n`

data/test/data/users_guide/test_m17n/result_fr.output ADDED

@@ -0,0 +1,4 @@
+$ cat m17n.rbhtml.fr.cache
+ _buf << %Q`<div>
+ <p>Bonjour #{escape((@username).to_s)}!</p>
+</div>\n`

data/test/data/users_guide/test_nested/main.rb ADDED

@@ -0,0 +1,8 @@
+require 'tenjin'
+engine = Tenjin::Engine.new(:path=>['views'])
+context = {
+  :title => 'Blog Post Test',
+  :post_content => "Foo\nBar\nBaz",
+}
+html = engine.render('blog_post.rbhtml', context)
+print(html)

data/test/data/users_guide/test_nested/result.output ADDED

@@ -0,0 +1,15 @@
+$ ruby main.rb
+<html>                        # by _layout.rbhtml
+  <body>                      #       :
+<h2>Blog Post Test</h2>       #   by _blog_layout.rbhtml
+<!-- content -->              #         :
+<div class="article">         #     by blog_post.rbhtml
+Foo<br />                     #           :
+Bar<br />                     #           :
+Baz                           #           :
+</div>                        #           :
+                              #           :
+<!-- /content -->             #   by _blog_layout.rbhtml
+                              #         :
+  </body>                     # by _layout.rbhtml
+</html>                       #       :

data/test/data/users_guide/test_nested/views/_blog_layout.rbhtml ADDED

@@ -0,0 +1,5 @@
+<?rb @_layout = '_site_layout.rbhtml' ?>
+<h2>${@title}</h2>
+<!-- content -->
+#{@_content}
+<!-- /content -->

data/test/data/users_guide/{layout8_html.rbhtml → test_nested/views/_site_layout.rbhtml} RENAMED

File without changes

data/test/data/users_guide/test_nested/views/blog_post.rbhtml ADDED

@@ -0,0 +1,4 @@
+<?rb @_layout = '_blog_layout.rbhtml' ?>
+<div class="article">
+#{text2html(@post_content)}
+</div>

data/test/data/users_guide/test_preprocessing/pp-example1.rb ADDED

@@ -0,0 +1,14 @@
+$VALUE = 'My Great Example'
+## create engine object with preprocessing enabled
+require 'tenjin'
+engine = Tenjin::Engine.new(:path=>['views'], :preprocess=>true)
+## print Python script code
+puts "------ converted script ------"
+puts engine.get_template('pp-example1.rbhtml').script
+## render html
+html = engine.render('pp-example1.rbhtml', {})
+puts "------ rendered html ------"
+puts html

data/test/data/users_guide/test_preprocessing/result1a.output ADDED

@@ -0,0 +1,11 @@
+$ ruby pp-example1.rb
+------ converted script ------
+ _buf << %Q`## normal expression
+value = #{escape(($VALUE).to_s)}
+## with preprocessing
+value = My Great Example\n`
+------ rendered html ------
+## normal expression
+value = My Great Example
+## with preprocessing
+value = My Great Example

data/test/data/users_guide/test_preprocessing/result1b.output ADDED

@@ -0,0 +1,5 @@
+$ rbtenjin -P -c '$VALUE="My Great Example"' views/pp-example1.rbhtml
+## normal expression
+value = ${$VALUE}
+## with preprocessing
+value = My Great Example

data/test/data/users_guide/test_preprocessing/result1c.output ADDED

@@ -0,0 +1,6 @@
+$ rbtenjin -sP -c '$VALUE="My Great Example"' views/pp-example1.rbhtml
+_buf = '';  _buf << %Q`\#\# normal expression
+value = ${$VALUE}
+\#\# with preprocessing
+value = #{escape((_decode_params(($VALUE))).to_s)}\n`
+_buf.to_s

data/test/data/users_guide/test_preprocessing/result2a.output ADDED

@@ -0,0 +1,10 @@
+$ rbtenjin -P views/pp-example2.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/test_preprocessing/result2b.output ADDED

@@ -0,0 +1,10 @@
+$ rbtenjin --preprocess -sb views/pp-example2.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/test_preprocessing/result3a.output ADDED

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

data/test/data/users_guide/test_preprocessing/result3b.output ADDED

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

data/test/data/users_guide/test_preprocessing/views/pp-example1.rbhtml ADDED

@@ -0,0 +1,4 @@
+## normal expression
+value = ${$VALUE}
+## with preprocessing
+value = ${{$VALUE}}

data/test/data/users_guide/{example12.rbhtml → test_preprocessing/views/pp-example2.rbhtml} RENAMED

@@ -3,10 +3,10 @@
 <?RB            "FL" => "Florida",  ?>
 <?RB            "TX" => "Texas",  ?>
 <?RB            "HI" => "Hawaii", } ?>
-<?rb chk = { @params['state'] => ' selected="selected"' } ?>
+<?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 ?>
+  <?RB for code in states.keys.sort ?>
+  <option value="#{{code}}"#{chk['#{{code}}']}>${{states[code]}}</option>
+  <?RB end ?>
 </select>

data/test/data/users_guide/test_preprocessing/views/pp-example3.rbhtml ADDED

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

data/test/data/users_guide/test_retrieve/example.rbhtml ADDED

@@ -0,0 +1,10 @@
+<table>
+  <?rb i = 0 ?>
+  <?rb for item in @items ?>
+  <?rb   i += 1 ?>
+  <tr>
+    <td>#{i}</td>
+    <td>${item}</td>
+  </tr>
+  <?rb end ?>
+</table>

data/test/data/users_guide/test_retrieve/result1.output ADDED

@@ -0,0 +1,11 @@
+$ rbtenjin -Sb example.rbhtml
+  i = 0
+  for item in @items
+    i += 1
+        escape((item).to_s);
+  end

data/test/data/users_guide/test_retrieve/result2.output ADDED

@@ -0,0 +1,11 @@
+$ rbtenjin -Xb example.rbhtml
+  i = 0
+  for item in @items
+    i += 1
+  end

data/test/data/users_guide/test_retrieve/result3.output ADDED

@@ -0,0 +1,11 @@
+$ rbtenjin -NXb example.rbhtml
+    1:
+    2:    i = 0
+    3:    for item in @items
+    4:      i += 1
+    5:
+    6:
+    7:
+    8:
+    9:    end
+   10:

data/test/data/users_guide/test_retrieve/result4.output ADDED

@@ -0,0 +1,8 @@
+$ rbtenjin -UNXb example.rbhtml
+    2:    i = 0
+    3:    for item in @items
+    4:      i += 1
+    9:    end

data/test/data/users_guide/test_retrieve/result5.output ADDED

@@ -0,0 +1,5 @@
+$ rbtenjin -CNXb example.rbhtml
+    2:    i = 0
+    3:    for item in @items
+    4:      i += 1
+    9:    end

data/test/data/users_guide/test_safe/result.output ADDED

@@ -0,0 +1,6 @@
+$ ruby safe-test.rb
+ _buf << %Q`s1 = #{safe_escape((@s1).to_s)}
+s2 = #{safe_escape((@s2).to_s)}\n`
+---------------------
+s1 = &lt;b&gt;SOS&lt;/b&gt;
+s2 = <b>SOS</b>

data/test/data/users_guide/test_safe/safe-test.rb ADDED

@@ -0,0 +1,21 @@
+require 'tenjin'
+include Tenjin::HtmlHelper   # defines escape()
+include Tenjin::SafeHelper   # defines safe_escape(), safe_str(), safe_str?()
+## both are same notation
+input = <<END
+s1 = ${@s1}
+s2 = ${@s2}
+END
+## but passed different data type
+context = {
+  :s1 => "<b>SOS</b>",
+  :s2 => safe_str("<b>SOS</b>"),
+}
+## SafeTemplate will escape 's1' but not 's2'
+template = Tenjin::SafeTemplate.new(:input=>input)
+print(template.script)
+print("---------------------\n")
+print(template.render(context))

data/test/data/users_guide/test_safehelper/main.rb ADDED

@@ -0,0 +1,16 @@
+require 'tenjin'
+include Tenjin::HtmlHelper
+include Tenjin::SafeHelper
+#
+s = "<AAA>"
+puts safe_str?(s)     #=> false
+s = safe_escape(s)    # same as SafeString.new(escape(s))
+puts safe_str?(s)     #=> true
+puts s                #=> &lt;AAA&gt;
+puts safe_escape(s)   #=> &lt;AAA&gt;
+#
+s = "<AAA>"
+s = safe_str(s)       # same as SafeString.new(s)
+puts safe_str?(s)     #=> true
+puts s                #=> <AAA>
+puts safe_escape(s)   #=> <AAA>

data/test/data/users_guide/test_safehelper/result.output ADDED

@@ -0,0 +1,8 @@
+$ ruby main.rb
+false
+true
+&lt;AAA&gt;
+&lt;AAA&gt;
+true
+<AAA>
+<AAA>

data/test/data/users_guide/{example3.rbhtml → test_syntax_check/example.rbhtml} RENAMED

File without changes

data/test/data/users_guide/test_syntax_check/result.output ADDED

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

data/test/data/users_guide/test_trace/layout.rbhtml ADDED

@@ -0,0 +1,7 @@
+<html>
+  <body>
+    <div class="content">
+    <?rb echo(@_content) ?>
+    </div>
+  </body>
+</html>

data/test/data/users_guide/test_trace/main.rbhtml ADDED

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

data/test/data/users_guide/test_trace/result.output ADDED

@@ -0,0 +1,16 @@
+$ ruby trace-example.rb
+<!-- ***** begin: layout.rbhtml ***** -->
+<html>
+  <body>
+    <div class="content">
+<!-- ***** begin: main.rbhtml ***** -->
+<ul>
+  <li>A</li>
+  <li>B</li>
+  <li>C</li>
+</ul>
+<!-- ***** end: main.rbhtml ***** -->
+    </div>
+  </body>
+</html>
+<!-- ***** end: layout.rbhtml ***** -->

data/test/data/users_guide/test_trace/trace-example.rb ADDED

@@ -0,0 +1,4 @@
+require 'tenjin'
+engine = Tenjin::Engine.new(:layout=>'layout.rbhtml', :trace=>true)
+output = engine.render('main.rbhtml', {'items'=>['A','B','C']})
+puts output

data/test/oktest.rb ADDED

@@ -0,0 +1,755 @@
+###
+### $Release: 0.7.0 $
+### copyright(c) 2007-2011 kuwata-lab.com all rights reserved
+### $License: MIT License $
+###
+module Oktest
+  DIFF = ENV['DIFF'] || File.file?('/usr/bin/diff')
+  def self.DIFF=(command)
+    remove_const(:DIFF)
+    const_set(:DIFF, command)
+  end
+  def self.diff(actual, expected)
+    ## actual and expected should be different
+    return nil if actual == expected
+    ## both actual and expected should be String
+    return nil unless actual.is_a?(String) && expected.is_a?(String)
+    ## either actual or expected should contain "\n"
+    return nil unless actual.index("\n") || expected.index("\n")
+    ## diff command
+    command = Oktest::DIFF
+    return nil unless command
+    command = 'diff -u' if command == true
+    ## diff
+    require 'tempfile' unless defined?(Tempfile)
+    output = nil
+    #Tempfile.open('actual') do |af|    # af.path file is not removed. why?
+    #  af.write(actual); af.flush()
+    #  Tempfile.open('expected') do |ef|
+    #    ef.write(expected); ef.flush()
+    #    #output = `#{command} #{ef.path} #{af.path}`
+    #    output = IO.popen(cmd="#{command} #{ef.path} #{af.path}") {|io| io.read }
+    #  end
+    #end
+    af = ef = nil
+    begin
+      af = Tempfile.open('actual')   ; af.write(actual)   ; af.flush
+      ef = Tempfile.open('expected') ; ef.write(expected) ; ef.flush
+      #output = `#{command} #{ef.path} #{af.path}`
+      output = IO.popen("#{command} #{ef.path} #{af.path}") {|io| io.read() }
+    ensure
+      af.close if ef
+      ef.close if ef
+    end
+    return output.sub(/\A.*?\n.*?\n/, "--- expected\n+++ actual\n")
+  end
+  class AssertionFailed < Exception
+    attr_accessor :diff
+  end
+  ASSERTION_FAILED = AssertionFailed
+  class AssertionObject
+    attr_reader :actual, :negative
+    def initialize(this, actual, negative=false)
+      @this = this
+      @actual = actual
+      @negative = negative
+    end
+    def ==(expected)
+      begin
+        do_assert(@actual == expected, expected, '==', '!=')
+      rescue AssertionFailed => ex
+        ex.diff = Oktest.diff(@actual, expected) if @actual != expected
+        raise ex
+      rescue ASSERTION_FAILED => ex
+        diff = Oktest.diff(@actual, expected) if @actual != expected
+        ex.message << "\n" << diff.chomp() if diff && ! diff.empty?
+        raise ex
+      end
+    end
+    if Object.new.respond_to?(:'!=')
+      eval <<-'END'
+    def !=(expected)
+      do_assert(@actual == expected, expected, '!=', '==')
+    end
+      END
+    end
+    def >(expected)
+      do_assert(@actual > expected, expected, '>', '<=')
+    end
+    def <(expected)
+      do_assert(@actual < expected, expected, '<', '>=')
+    end
+    def >=(expected)
+      do_assert(@actual >= expected, expected, '>=', '<')
+    end
+    def <=(expected)
+      do_assert(@actual <= expected, expected, '<=', '>')
+    end
+    def ===(expected)
+      do_assert(@actual === expected, expected, '===', '!==')
+    end
+    def =~(expected)
+      do_assert(@actual =~ expected, expected, '=~', '!~')
+    end
+    def in_delta?(expected, delta)
+      flag = expected - delta <= @actual && @actual <= expected + delta
+      check2(flag) { "(#{(expected - delta).inspect} <= #{@actual.inspect} <= #{(expected + delta).inspect})" }
+    end
+    def file?
+      check2(File.file?(@actual)) { "File.file?(#{@actual.inspect})" }
+    end
+    def dir?
+      check2(File.directory?(@actual)) { "File.directory?(#{@actual.inspect})" }
+    end
+    def exist?
+      check2(File.exist?(@actual)) { "File.exist?(#{@actual.inspect})" }
+    end
+    def same?(expected)
+      check2(@actual.equal?(expected)) { "#{@actual.inspect}.equal?(#{expected.inspect})" }
+    end
+    def in?(expected)
+      check2(expected.include?(@actual)) { "#{expected.inspect}.include?(#{@actual.inspect})" }
+    end
+    def include?(expected)
+      check2(@actual.include?(expected)) { "#{@actual.inspect}.include?(#{expected.inspect})" }
+    end
+    def is_a?(expected)
+      check2(@actual.is_a?(expected)) { "#{@actual.inspect}.is_a?(#{expected})" }
+    end
+    alias kind_of? is_a?
+    def nil?
+      check2(@actual.nil?) { "#{@actual.inspect}.nil?" }
+    end
+    def empty?
+      check2(@actual.empty?) { "#{@actual.inspect}.empty?" }
+    end
+    def raise?(exception_class, message=nil)
+      if @negative
+        _should_not_raise(exception_class)
+        ex = nil
+      else
+        ex = _should_raise(exception_class, message)
+      end
+      return ex
+    end
+    private
+    def _should_raise(exception_class, message)
+      not_raised = false
+      begin
+        @actual.call
+        not_raised = true
+      rescue Exception => ex
+        @actual.instance_variable_set('@exception', ex)
+        def @actual.exception; @exception; end
+        ex.class <= exception_class  or
+          raise new_assertion_failed("#{exception_class.name} expected but #{ex.class.name} raised.", 2)
+        if message
+          op = message.is_a?(Regexp) ? '=~' : '=='
+          ex.message.__send__(op, message)  or
+            raise new_assertion_failed("#{ex.message.inspect} #{op} #{message.inspect}: failed.", 2)
+        end
+      end
+      raise new_assertion_failed("#{exception_class.name} expected but not raised.", 2) if not_raised
+      return ex
+    end
+    def _should_not_raise(exception_class=Exception)
+      begin
+        @actual.call
+      rescue Exception => ex
+        @actual.instance_variable_set('@exception', ex)
+        def @actual.exception; @exception; end
+        if ex.class <= exception_class
+          raise new_assertion_failed("unexpected #{ex.class.name} raised.", 2)
+        end
+      end
+    end
+    def do_assert(flag, expected, op, negative_op)
+      flag, msg = check(flag, expected, op, negative_op)
+      return true if flag
+      raise new_assertion_failed(msg)
+    end
+    def new_assertion_failed(msg, depth=2)
+      ex = AssertionFailed.new(msg)
+      ex.set_backtrace(caller(depth+1))    # manipulate backtrace
+      return ex
+    end
+    def check(flag, expected, op, negative_op)
+      if @negative
+        flag = ! flag
+        op = negative_op
+      end
+      msg = flag ? nil : failed_message(expected, op)
+      return flag, msg
+    end
+    def failed_message(expected, op)
+      "#{@actual.inspect} #{op} #{expected.inspect}: failed."
+    end
+    def check2(flag)
+      flag = ! flag if @negative
+      return true if flag
+      expr = yield
+      expr = "! #{expr}" if @negative
+      raise new_assertion_failed("#{expr}: failed.")
+    end
+  end
+  module Helper
+    module_function
+    def ok(actual=nil)
+      actual = yield if block_given?       # experimental
+      return Oktest::AssertionObject.new(self, actual, false)
+    end
+    alias ok_ ok
+    def not_ok(actual=nil)
+      actual = yield if block_given?       # experimental
+      return Oktest::AssertionObject.new(self, actual, true)
+    end
+    alias not_ok_ not_ok
+    def capture_io(stdin_str=nil)
+      require 'stringio' unless defined?(StringIO)
+      stdout, stderr = $stdout, $stderr
+      $stdout, $stderr = StringIO.new, StringIO.new
+      stdin, $stdin = $stdin, StringIO.new(stdin_str) if stdin_str
+      begin
+        yield
+        ret = [$stdout.string, $stderr.string]
+      ensure
+        $stdout, $stderr = stdout, stderr
+        $stdin = stdin if stdin_str
+      end
+      return ret
+    end
+    def dummy_file(pairs)
+      fnames = []
+      begin
+        pairs.each do |fname, content|
+          fnames << fname
+          File.open(fname, 'wb') {|f| f.write(content) }
+          yield
+        end
+      ensure
+        File.unlink(*fnames)
+      end
+    end
+    def dummy_dir(*paths)
+      require 'fileutils' unless defined?(FileUtils)
+      begin
+        paths.each {|path| FileUtils.mkdir_p(path) }
+        yield
+      ensure
+        paths.reverse.each {|path| FileUtils.rm_rf(path) }
+      end
+    end
+    ## marker method to represent pre-condition
+    def pre_cond; yield; end
+    ## marker method to represent post-condition
+    def post_cond; yield; end
+    ## marker method to describe target of specification
+    def target(desc); yield; end
+    ## marker method to describe specification
+    #def spec(desc); yield if block_given?; end
+    def spec(desc)
+      reporter = @_oktest_runner && @_oktest_runner.reporter
+      status = nil
+      begin
+        reporter.enter_spec(self, desc) if reporter
+        if block_given?
+          yield
+          status = :ok
+        else
+          status = :empty
+        end
+      rescue AssertionFailed => ex
+        status = :fail
+        raise ex
+      rescue => ex
+        status = :error
+        raise ex
+      ensure
+        reporter.exit_spec(self, status) if reporter
+      end
+    end
+    ##
+    ## intercept method call of object
+    ##
+    ## stub example.
+    ##    class Hello
+    ##      def hello(name); return "Hello #{name}!"; end
+    ##    end
+    ##    obj = Hello.new
+    ##    intr = intercept(obj, :hello)
+    ##    intr.called  #=> false
+    ##    obj.hello('World')   #=> "Hello World!"
+    ##    intr.called  #=> true
+    ##    intr.args    #=> ["World"]
+    ##    intr.return  #=> "Hello World!"
+    ##
+    ## mock example.
+    ##    class Hello
+    ##      def hello(name); return "Hello #{name}!"; end
+    ##    end
+    ##    obj = Hello.new
+    ##    intr = intercept(obj, :hello) do |name|
+    ##      "Bonjor #{name}!"   # or `obj.__intercepted_hello(name)'
+    ##    end
+    ##    intr.called  #=> false
+    ##    obj.hello('World')   #=> "Bonjor World!"
+    ##    intr.called  #=> true
+    ##    intr.args    #=> ["World"]
+    ##    intr.return  #=> "Bonjor World!"
+    ##
+    def intercept(object, method, &block)
+      return Oktest::Util::Interceptor.new(object, method, &block)
+    end
+  end
+  module ClassMethodHelper
+    def method_added(name)
+      dict = (@_test_method_names_dict ||= {})
+      name = name.to_s
+      if name =~ /\Atest_?/
+        ## if test method name is duplicated, raise error
+        dict[name].nil?  or
+          raise NameError.new("#{self.name}##{name}(): already defined (please change test method name).")
+        dict[name] = dict.size()
+        ## if ENV['TEST'] is set, remove unmatched method
+        if ENV['TEST']
+          remove_method(name) unless name.sub(/\Atest_?/, '').index(ENV['TEST'])
+        end
+      end
+    end
+    def test(desc, &block)
+      @_test_count ||= 0
+      @_test_count += 1
+      method_name = "test_%03d_%s" % [@_test_count, desc.to_s.gsub(/[^\w]/, '_')]
+      define_method(method_name, block)
+    end
+  end
+  module TestCase
+    include Helper
+    @_subclasses = []
+    def self._subclasses    # :nodoc:
+      return @_subclasses
+    end
+    def self.included(klass)
+      @_subclasses << klass if klass.is_a?(Class)
+      klass.class_eval do
+        extend Oktest::ClassMethodHelper
+      end
+    end
+  end
+  class Reporter
+    def before_all(klass)
+    end
+    def after_all(klass)
+    end
+    def before(obj)
+    end
+    def after(obj)
+    end
+    def print_ok(obj)
+    end
+    def print_failed(obj, ex)
+    end
+    def print_error(obj, ex)
+    end
+    def enter_spec(obj, desc)
+    end
+    def exit_spec(obj, status)
+    end
+  end
+  class BaseReporter < Reporter
+    def initialize(out=nil)
+      @out = out || $stdout
+      @_flush = @out.respond_to?(:flush)
+    end
+    def before_all(klass)
+      @count_test = 0
+      @count_spec = 0
+    end
+    def before(obj)
+      @count_test += 1
+      @spec_status = nil
+    end
+    def after(obj)
+    end
+    def enter_spec(obj, desc)
+      @count_spec += 1
+    end
+    def exit_spec(obj, status)
+      @spec_status = status
+      case status
+      when :ok      ; write('.')
+      when :empty   ; write('_')
+      when :fail    ; write('f')
+      when :error   ; write('E')
+      else
+        raise "** internal error: status=#{status.inspect}"
+      end
+    end
+    private
+    def _test_ident(obj)
+      return obj.instance_variable_get('@_test_method')
+    end
+    def write(str)
+      @out << str
+      @out.flush if @_flush
+    end
+    def print_backtrace(ex, out=@out)
+      ex.backtrace.each do |str|
+        out << "    #{str}\n"
+        if str =~ /\A(.*):(\d+):in `(.*?)'/
+          filepath, linenum, method = $1, $2.to_i, $3
+          #break if method =~ /\Atest_?/
+          line = get_line(filepath, linenum)
+          out << "      #{line.strip}\n" if line
+          break if method =~ /\Atest_?/
+        end
+      end
+    end
+    def get_line(filepath, linenum)
+      return nil unless File.file?(filepath)
+      linenum = linenum.to_i
+      line = File.open(filepath) do |f|
+        i = 0
+        f.find { (i += 1) == linenum }
+      end
+      return line
+    end
+  end
+  class SimpleReporter < BaseReporter
+    def before_all(klass)
+      super
+      write("### %s: " % klass.name)
+      @buf = ""
+    end
+    def after_all(klass)
+      super
+      write(" (#{@count_test} tests, #{@count_spec} specs)\n")
+      @out << @buf.to_s
+      @buf = nil
+    end
+    def print_ok(obj)
+      write(".") unless @spec_status
+    end
+    def print_failed(obj, ex)
+      write("f") unless @spec_status
+      @buf << "Failed: #{_test_ident(obj)}()\n"
+      @buf << "    #{ex.message}\n"
+      print_backtrace(ex, @buf)
+      #assert ex.is_a?(AssertionFailed)
+      @buf << ex.diff if ex.diff
+    end
+    def print_error(obj, ex)
+      write("E") unless @spec_status
+      @buf << "ERROR: #{_test_ident(obj)}()\n"
+      @buf << "    #{ex.class.name}: #{ex.message}\n"
+      print_backtrace(ex, @buf)
+    end
+  end
+  class VerboseReporter < BaseReporter
+    def before_all(klass)
+      super
+      write("### %s\n" % klass.name)
+    end
+    def after_all(klass)
+      super
+      write(" (#{@count_test} tests, #{@count_spec} specs)\n")
+    end
+    def before(obj)
+      super
+      write("- #{_test_ident(obj)}: ")
+    end
+    def print_ok(obj)
+      write(" ok\n")
+    end
+    def print_failed(obj, ex)
+      write(" FAILED\n")
+      write("    #{ex.message}\n")
+      print_backtrace(ex, @out)
+      #assert ex.is_a?(AssertionFailed)
+      write(ex.diff) if ex.diff
+    end
+    def print_error(obj, ex)
+      write(" ERROR\n")
+      write("  #{ex.class.name}: #{ex.message}\n")
+      print_backtrace(ex, @out)
+    end
+  end
+  REPORTER = SimpleReporter
+  #REPORTER = VerboseReporter
+  def self.REPORTER=(reporter_class)
+    remove_const(:REPORTER)
+    const_set(:REPORTER, reporter_class)
+  end
+  class Runner
+    def initialize(reporter=nil)
+      @reporter = reporter || REPORTER.new
+    end
+    attr_accessor :reporter
+    def test_method_names_from(klass)
+      test_method_names = klass.instance_methods(true).collect {|sym| sym.to_s }.grep(/\Atest/).sort()
+      dict = klass.instance_variable_get('@_test_method_names_dict')
+      if dict
+        dict = dict.dup()   # key: test method name (String), value: index (Integer)
+        i = 0
+        test_method_names.select {|name| ! dict.key?(name) }.reverse.each {|name| dict[name] = (i -= 1) }
+        test_method_names = dict.sort_by {|k, v| v }.collect {|k, v| k }
+      end
+      return test_method_names
+    end
+    def warning(msg)
+      warn "WARNING: #{msg}"
+    end
+    def run(klass)
+      reporter = @reporter
+      ## gather test methods
+      test_method_names = test_method_names_from(klass)
+      ## filer by $TEST environment variable
+      pattern = ENV['TEST']
+      test_method_names.delete_if {|x| x.index(pattern).nil? } if pattern
+      ## sort by linenumber
+      # nothing
+      ## invoke before_all()
+      reporter.before_all(klass)
+      if klass.respond_to?(:before_all)
+        klass.before_all()
+      elsif klass.method_defined?(:before_all)
+        warning "#{klass.name}#before_all() should be class method (but defined as instance method)"
+      end
+      ## invoke test methods
+      count = 0
+      flag_before   = klass.method_defined?(:before)
+      flag_setup    = klass.method_defined?(:setup)
+      flag_after    = klass.method_defined?(:after)
+      flag_teardown = klass.method_defined?(:teardown)
+      test_method_names.each do |method_name|
+        ## create instance object for each test
+        begin
+          obj = klass.new
+        rescue ArgumentError
+          obj = klass.new(method_name)
+        end
+        obj.instance_variable_set('@_name', method_name.sub(/\Atest_?/, ''))
+        obj.instance_variable_set('@_test_method', method_name)
+        obj.instance_variable_set('@_oktest_runner', self)
+        ## invoke before() or setup()
+        reporter.before(obj)
+        flag_before ? obj.before() : flag_setup ? obj.setup() : nil
+        ## invoke test method
+        begin
+          obj.__send__(method_name)
+          reporter.print_ok(obj)
+        rescue Oktest::AssertionFailed => ex
+          count += 1
+          reporter.print_failed(obj, ex)
+        rescue Exception => ex
+          count += 1
+          reporter.print_error(obj, ex)
+        ensure
+          ## invoke after() or teardown()
+          flag_after ? obj.after() : flag_teardown ? obj.teardown() : nil
+          reporter.after(obj)
+        end
+      end
+      ## invoke after_all()
+      if klass.respond_to?(:after_all)
+        klass.after_all()
+      elsif klass.method_defined?(:after_all)
+        warning "#{klass.name}#after_all() should be class method (but defined as instance method)"
+      end
+      reporter.after_all(klass)
+      ##
+      return count
+    end
+  end
+  def self.run(*classes)
+    opts = classes.last.is_a?(Hash) ? classes.pop() : {}
+    reporter_class = opts[:verbose] ? VerboseReporter : REPORTER
+    reporter = reporter_class.new(opts[:out])
+    runner = Runner.new(reporter)
+    classes.each {|cls| runner.run(cls) }
+    self.run_at_exit = false
+  end
+  def self.run_all(opts={})
+    classes = Oktest::TestCase._subclasses()
+    args = classes + [opts]
+    self.run(*args)
+  end
+  @_run_at_exit = true
+  def self.run_at_exit?
+    return @_run_at_exit
+  end
+  def self.run_at_exit=(flag)
+    @_run_at_exit = flag
+  end
+  module Util
+    class Interceptor
+      def initialize(object, method, &block)
+        @object, @method, @block = object, method, block
+        @called = false
+        intercept()
+      end
+      attr_accessor :object, :method, :block, :called, :args, :return
+      private
+      def intercept
+        intr = self
+        (class << @object; self; end).class_eval do
+          method = intr.method
+          alias_name = "__intercepted_#{method}"
+          alias_method alias_name, method
+          define_method(method) do |*args|
+            intr.called = true
+            intr.args   = args
+            intr.return = intr.block ? intr.block.call(*args) \
+                                     : __send__(alias_name, *args)
+            intr.return
+          end
+        end
+        return self
+      end
+    end
+  end #Util
+end
+at_exit do
+  ex = $!
+  if (! ex || ex.is_a?(SystemExit)) && Oktest.run_at_exit? # && ! defined?(Test::Unit)
+    Oktest.run_all()
+    raise ex if ex
+  end
+end