RubyGems - tenjin - Versions diffs - 0.6.0 - Mend

tenjin 0.6.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 (170) hide show

data/MIT-LICENSE +20 -0
data/README.txt +54 -0
data/benchmark/bench.rb +502 -0
data/benchmark/bench_context.rb +17 -0
data/benchmark/bench_context.yaml +141 -0
data/benchmark/templates/_footer.html +4 -0
data/benchmark/templates/_header.html +52 -0
data/benchmark/templates/bench_eruby.rhtml +29 -0
data/benchmark/templates/bench_tenjin.rbhtml +29 -0
data/bin/rbtenjin +449 -0
data/doc-api/classes/Tenjin.html +141 -0
data/doc-api/classes/Tenjin/ArrayBufferTemplate.html +270 -0
data/doc-api/classes/Tenjin/BaseContext.html +312 -0
data/doc-api/classes/Tenjin/Context.html +126 -0
data/doc-api/classes/Tenjin/ContextHelper.html +433 -0
data/doc-api/classes/Tenjin/Engine.html +616 -0
data/doc-api/classes/Tenjin/ErubisTemplate.html +166 -0
data/doc-api/classes/Tenjin/HtmlHelper.html +359 -0
data/doc-api/classes/Tenjin/Preprocessor.html +242 -0
data/doc-api/classes/Tenjin/Template.html +916 -0
data/doc-api/created.rid +1 -0
data/doc-api/files/README_txt.html +185 -0
data/doc-api/files/lib/tenjin_rb.html +136 -0
data/doc-api/fr_class_index.html +36 -0
data/doc-api/fr_file_index.html +28 -0
data/doc-api/fr_method_index.html +89 -0
data/doc-api/index.html +24 -0
data/doc-api/rdoc-style.css +208 -0
data/doc/docstyle.css +188 -0
data/doc/examples.html +312 -0
data/doc/faq.html +909 -0
data/doc/users-guide.html +1691 -0
data/lib/tenjin.rb +959 -0
data/setup.rb +1331 -0
data/tenjin.gemspec +58 -0
data/test/assert-text-equal.rb +45 -0
data/test/data/examples/form/create.rbhtml +4 -0
data/test/data/examples/form/form.rbhtml +14 -0
data/test/data/examples/form/layout.rbhtml +8 -0
data/test/data/examples/form/main.rb +9 -0
data/test/data/examples/form/main.result +21 -0
data/test/data/examples/form/update.rbhtml +4 -0
data/test/data/examples/preprocessing/helper.rb +16 -0
data/test/data/examples/preprocessing/main.rb +11 -0
data/test/data/examples/preprocessing/main.result +17 -0
data/test/data/examples/preprocessing/select.rbhtml +15 -0
data/test/data/examples/preprocessing/select_P.result +18 -0
data/test/data/examples/table/table.rb +9 -0
data/test/data/examples/table/table.rbhtml +16 -0
data/test/data/examples/table/table.result +20 -0
data/test/data/examples/table/table_s.result +18 -0
data/test/data/faq/ex1.rbhtml +5 -0
data/test/data/faq/ex10-baselayout.rbhtml +27 -0
data/test/data/faq/ex10-content.rbhtml +12 -0
data/test/data/faq/ex10-customlayout.rbhtml +11 -0
data/test/data/faq/ex10_inherit.result +25 -0
data/test/data/faq/ex11-bench.rb +28 -0
data/test/data/faq/ex11-content.rbhtml +9 -0
data/test/data/faq/ex11-layout1.rbhtml +5 -0
data/test/data/faq/ex11-layout2.rbhtml +6 -0
data/test/data/faq/ex11.rb +5 -0
data/test/data/faq/ex11.rbhtml +8 -0
data/test/data/faq/ex11.source +11 -0
data/test/data/faq/ex11_arraybuffer.result +15 -0
data/test/data/faq/ex1_chksyntax.result +3 -0
data/test/data/faq/ex2-content.rbhtml +3 -0
data/test/data/faq/ex2-layout.rbhtml +11 -0
data/test/data/faq/ex2_removenl.result +19 -0
data/test/data/faq/ex3.rb +4 -0
data/test/data/faq/ex3.rbhtml +1 -0
data/test/data/faq/ex3_escapefunc1.result +2 -0
data/test/data/faq/ex3_escapefunc2.result +2 -0
data/test/data/faq/ex5.rbhtml +7 -0
data/test/data/faq/ex5_template_args.source +9 -0
data/test/data/faq/ex6-content.rhtml +6 -0
data/test/data/faq/ex6-layout.rhtml +6 -0
data/test/data/faq/ex6.rb +10 -0
data/test/data/faq/ex6_eruby.result +12 -0
data/test/data/faq/ex7-expr-pattern.rb +34 -0
data/test/data/faq/ex7-expr-pattern.rbhtml +3 -0
data/test/data/faq/ex7_expr_pattern.result +4 -0
data/test/data/faq/ex8-m18n.rb +77 -0
data/test/data/faq/ex8-m18n.rbhtml +4 -0
data/test/data/faq/ex8_m18n.result +10 -0
data/test/data/faq/ex9-baselayout.rbhtml +8 -0
data/test/data/faq/ex9-content.rbhtml +6 -0
data/test/data/faq/ex9-mylayout.rbhtml +5 -0
data/test/data/faq/ex9_changelayout.result +11 -0
data/test/data/users_guide/content6.rbhtml +3 -0
data/test/data/users_guide/content7.rbhtml +5 -0
data/test/data/users_guide/content8.rbhtml +2 -0
data/test/data/users_guide/contextdata.rb +7 -0
data/test/data/users_guide/datafile.rb +5 -0
data/test/data/users_guide/datafile.yaml +10 -0
data/test/data/users_guide/ex.rbhtml +6 -0
data/test/data/users_guide/ex.result +7 -0
data/test/data/users_guide/ex.script +5 -0
data/test/data/users_guide/ex_script.result +7 -0
data/test/data/users_guide/ex_source.result +8 -0
data/test/data/users_guide/example1.rbhtml +12 -0
data/test/data/users_guide/example1.result +17 -0
data/test/data/users_guide/example10.rbhtml +4 -0
data/test/data/users_guide/example10_template_args.result +6 -0
data/test/data/users_guide/example11.rbhtml +5 -0
data/test/data/users_guide/example11_template_args_result +2 -0
data/test/data/users_guide/example12.rbhtml +12 -0
data/test/data/users_guide/example12_preprocessed.result +10 -0
data/test/data/users_guide/example12_preprocessed_source.result +10 -0
data/test/data/users_guide/example13.rbhtml +6 -0
data/test/data/users_guide/example13_preprocessed.result +2 -0
data/test/data/users_guide/example13_preprocessed_source.result +2 -0
data/test/data/users_guide/example14.rb +32 -0
data/test/data/users_guide/example14.rbhtml +6 -0
data/test/data/users_guide/example14_tmplclass.result +15 -0
data/test/data/users_guide/example15.rb +10 -0
data/test/data/users_guide/example15_escapefunc.result +14 -0
data/test/data/users_guide/example16.rbhtml +4 -0
data/test/data/users_guide/example16a.rb +10 -0
data/test/data/users_guide/example16a.result +4 -0
data/test/data/users_guide/example16b.rb +13 -0
data/test/data/users_guide/example16b.result +4 -0
data/test/data/users_guide/example16c.rb +12 -0
data/test/data/users_guide/example16c.result +4 -0
data/test/data/users_guide/example1_S.result +14 -0
data/test/data/users_guide/example1_SXNC.result +10 -0
data/test/data/users_guide/example1_source.result +14 -0
data/test/data/users_guide/example2.rbhtml +3 -0
data/test/data/users_guide/example2_sb.result2 +9 -0
data/test/data/users_guide/example3.rbhtml +5 -0
data/test/data/users_guide/example3_syntaxcheck.result +2 -0
data/test/data/users_guide/example4.rbhtml +13 -0
data/test/data/users_guide/example4_datafile_rb.result +13 -0
data/test/data/users_guide/example4_yaml.result +13 -0
data/test/data/users_guide/example5.rbhtml +9 -0
data/test/data/users_guide/example5_datastr_rb.result +9 -0
data/test/data/users_guide/example5_datastr_yaml.result +9 -0
data/test/data/users_guide/example6.rbhtml +19 -0
data/test/data/users_guide/example6_layout.result +29 -0
data/test/data/users_guide/example6_nested.result +28 -0
data/test/data/users_guide/example7_layout2.result +13 -0
data/test/data/users_guide/example8_layout3.result +8 -0
data/test/data/users_guide/example9.rbhtml +18 -0
data/test/data/users_guide/example9_capture.result +26 -0
data/test/data/users_guide/footer.html +5 -0
data/test/data/users_guide/footer.rbhtml +4 -0
data/test/data/users_guide/layout6.rbhtml +17 -0
data/test/data/users_guide/layout7.rbhtml +9 -0
data/test/data/users_guide/layout8_html.rbhtml +5 -0
data/test/data/users_guide/layout8_xhtml.rbhtml +6 -0
data/test/data/users_guide/layout9.rbhtml +25 -0
data/test/data/users_guide/sidemenu.rbhtml +5 -0
data/test/data/users_guide/user_app.cgi +39 -0
data/test/data/users_guide/user_app.result +30 -0
data/test/data/users_guide/user_create.rbhtml +6 -0
data/test/data/users_guide/user_edit.rbhtml +7 -0
data/test/data/users_guide/user_form.rbhtml +10 -0
data/test/data/users_guide/user_layout.rbhtml +16 -0
data/test/test_all.rb +23 -0
data/test/test_engine.rb +526 -0
data/test/test_engine.yaml +2039 -0
data/test/test_examples.rb +81 -0
data/test/test_faq.rb +60 -0
data/test/test_htmlhelper.rb +78 -0
data/test/test_main.rb +564 -0
data/test/test_main.yaml +174 -0
data/test/test_template.rb +113 -0
data/test/test_template.yaml +1244 -0
data/test/test_users_guide.rb +75 -0
data/test/testcase-helper.rb +166 -0
metadata +226 -0

data/lib/tenjin.rb ADDED Viewed

@@ -0,0 +1,959 @@
+##
+## copyright(c) 2007 kuwata-lab all rights reserved.
+##
+## Permission is hereby granted, free of charge, to any person obtaining
+## a copy of this software and associated documentation files (the
+## "Software"), to deal in the Software without restriction, including
+## without limitation the rights to use, copy, modify, merge, publish,
+## distribute, sublicense, and/or sell copies of the Software, and to
+## permit persons to whom the Software is furnished to do so, subject to
+## the following conditions:
+##
+## The above copyright notice and this permission notice shall be
+## included in all copies or substantial portions of the Software.
+##
+## THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+## EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+## MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+## NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+## LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+## OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+## WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##
+##
+## Tenjin module
+##
+## $Rev: 59 $
+## $Release: 0.6.0 $
+##
+module Tenjin
+  RELEASE = ('$Release: 0.6.0 $' =~ /[\d.]+/) && $&
+  ##
+  ## helper module for Context class
+  ##
+  module HtmlHelper
+    module_function
+    XML_ESCAPE_TABLE = { '&'=>'&amp;', '<'=>'&lt;', '>'=>'&gt;', '"'=>'&quot;', "'"=>'&#039;' }
+    def escape_xml(s)
+      #return s.gsub(/[&<>"]/) { XML_ESCAPE_TABLE[$&] }
+      return s.gsub(/[&<>"]/) { |s| XML_ESCAPE_TABLE[s] }
+      ##
+      #s = s.gsub(/&/, '&amp;')
+      #s.gsub!(/</, '&lt;')
+      #s.gsub!(/>/, '&gt;')
+      #s.gsub!(/"/, '&quot;')
+      #return s
+      ##
+      #return s.gsub(/&/, '&amp;').gsub(/</, '&lt;').gsub(/>/, '&gt;').gsub(/"/, '&quot;')
+    end
+    alias escape escape_xml
+    ## (experimental) return ' name="value"' if expr is not false nor nil.
+    ## if value is nil or false then expr is used as value.
+    def tagattr(name, expr, value=nil, escape=true)
+      if !expr
+        return ''
+      elsif escape
+        return " #{name}=\"#{escape_xml((value || expr).to_s)}\""
+      else
+        return " #{name}=\"#{value || expr}\""
+      end
+    end
+    ## return ' checked="checked"' if expr is not false or nil
+    def checked(expr)
+      return expr ? ' checked="checked"' : ''
+    end
+    ## return ' selected="selected"' if expr is not false or nil
+    def selected(expr)
+      return expr ? ' selected="selected"' : ''
+    end
+    ## return ' disabled="disabled"' if expr is not false or nil
+    def disabled(expr)
+      return expr ? ' disabled="disabled"' : ''
+    end
+    ## convert "\n" into "<br />\n"
+    def nl2br(text)
+      return text.to_s.gsub(/\n/, "<br />\n")
+    end
+    ## convert "\n" and "  " into "<br />\n" and " &nbsp;"
+    def text2html(text)
+      return nl2br(escape_xml(text.to_s).gsub(/  /, ' &nbsp;'))
+    end
+  end
+  ##
+  ## helper module for BaseContext class
+  ##
+  module ContextHelper
+    attr_accessor :_buf, :_engine, :_layout
+    ## include template. 'template_name' can be filename or short name.
+    def import(template_name, _append_to_buf=true)
+      _buf = self._buf
+      output = self._engine.render(template_name, context=self, layout=false)
+      _buf << output if _append_to_buf
+      return output
+    end
+    ## add value into _buf. this is equivarent to '#{value}'.
+    def echo(value)
+      self._buf << value
+    end
+    ##
+    ## start capturing.
+    ## returns captured string if block given, else return nil.
+    ## if block is not given, calling stop_capture() is required.
+    ##
+    ## ex. list.rbhtml
+    ##   <html><body>
+    ##     <h1><?rb start_capture(:title) do ?>Document Title<?rb end ?></h1>
+    ##     <?rb start_capture(:content) ?>
+    ##     <ul>
+    ##      <?rb for item in list do ?>
+    ##       <li>${item}</li>
+    ##      <?rb end ?>
+    ##     </ul>
+    ##     <?rb stop_capture() ?>
+    ##   </body></html>
+    ##
+    ## ex. layout.rbhtml
+    ##   <?xml version="1.0" ?>
+    ##   <html xml:lang="en">
+    ##    <head>
+    ##     <title>${@title}</title>
+    ##    </head>
+    ##    <body>
+    ##     <h1>${@title}</h1>
+    ##     <div id="content">
+    ##      <?rb echo(@content) ?>
+    ##     </div>
+    ##    </body>
+    ##   </html>
+    ##
+    def start_capture(varname=nil)
+      @_capture_varname = varname
+      @_start_position = self._buf.length
+      if block_given?
+        yield
+        output = stop_capture()
+        return output
+      else
+        return nil
+      end
+    end
+    ##
+    ## stop capturing.
+    ## returns captured string.
+    ## see start_capture()'s document.
+    ##
+    def stop_capture(store_to_context=true)
+      output = self._buf[@_start_position..-1]
+      self._buf[@_start_position..-1] = ''
+      @_start_position = nil
+      if @_capture_varname
+        self.instance_variable_set("@#{@_capture_varname}", output) if store_to_context
+        @_capture_varname = nil
+      end
+      return output
+    end
+    ##
+    ## if captured string is found then add it to _buf and return true,
+    ## else return false.
+    ## this is a helper method for layout template.
+    ##
+    def captured_as(name)
+      str = self.instance_variable_get("@#{name}")
+      return false unless str
+      @_buf << str
+      return true
+    end
+    ##
+    ## ex. _p("item['name']")  =>  #{item['name']}
+    ##
+    def _p(arg)
+      return "<`\##{arg}\#`>"    # decoded into #{...} by preprocessor
+    end
+    ##
+    ## ex. _P("item['name']")  =>  ${item['name']}
+    ##
+    def _P(arg)
+      return "<`$#{arg}$`>"    # decoded into ${...} by preprocessor
+    end
+    ##
+    ## decode <`#...#`> and <`$...$`> into #{...} and ${...}
+    ##
+    def _decode_params(s)
+      require 'cgi'
+      return s unless s.is_a?(String)
+      s = s.dup
+      s.gsub!(/%3C%60%23(.*?)%23%60%3E/im) { "\#\{#{CGI::unescape($1)}\}" }
+      s.gsub!(/%3C%60%24(.*?)%24%60%3E/im) { "\$\{#{CGI::unescape($1)}\}" }
+      s.gsub!(/&lt;`\#(.*?)\#`&gt;/m) { "\#\{#{CGI::unescapeHTML($1)}\}" }
+      s.gsub!(/&lt;`\$(.*?)\$`&gt;/m) { "\$\{#{CGI::unescapeHTML($1)}\}" }
+      s.gsub!(/<`\#(.*?)\#`>/m, '#{\1}')
+      s.gsub!(/<`\$(.*?)\$`>/m, '${\1}')
+      return s
+    end
+  end
+  ##
+  ## base class for Context class
+  ##
+  class BaseContext
+    include Enumerable
+    include ContextHelper
+    def initialize(vars=nil)
+      update(vars) if vars.is_a?(Hash)
+    end
+    def [](key)
+      instance_variable_get("@#{key}")
+    end
+    def []=(key, val)
+      instance_variable_set("@#{key}", val)
+    end
+    def escape(val)
+      return val
+    end
+    def update(hash)
+      hash.each do |key, val|
+        self[key] = val
+      end
+    end
+    def key?(key)
+      return self.instance_variables.include?("@#{key}")
+    end
+    def each()
+      instance_variables().each do |name|
+        val = instance_variable_get(name)
+        key = name[1..-1]
+        yield([key, val]) if name != '@_buf' && name != '@_engine'
+      end
+    end
+  end
+  ##
+  ## context class for Template
+  ##
+  class Context < BaseContext
+    include HtmlHelper
+  end
+  ##
+  ## template class
+  ##
+  ## ex. file 'example.rbhtml'
+  ##   <html>
+  ##    <body>
+  ##     <h1>${@title}</h1>
+  ##     <ul>
+  ##     <?rb i = 0 ?>
+  ##     <?rb for item in @items ?>
+  ##     <?rb   i += 1 ?>
+  ##       <li>#{i} : ${item}</li>
+  ##     <?rb end ?>
+  ##     </ul>
+  ##    </body>
+  ##   </html>
+  ##
+  ## ex. convertion
+  ##   require 'tenjin'
+  ##   template = Tenjin::Template.new('example.rbhtml')
+  ##   print template.script
+  ##   ## or
+  ##   # template = Tenjin::Template.new()
+  ##   # print template.convert_file('example.rbhtml')
+  ##   ## or
+  ##   # template = Tenjin::Template.new()
+  ##   # fname = 'example.rbhtml'
+  ##   # print template.convert(File.read(fname), fname)  # filename is optional
+  ##
+  ## ex. evaluation
+  ##   context = {:title=>'Tenjin Example', :items=>['foo', 'bar', 'baz'] }
+  ##   output = template.render(context)
+  ##   ## or
+  ##   # context = Tenjin::Context(:title=>'Tenjin Example', :items=>['foo','bar','baz'])
+  ##   # output = template.render(context)
+  ##   ## or
+  ##   # output = template.render(:title=>'Tenjin Example', :items=>['foo','bar','baz'])
+  ##   print output
+  ##
+  class Template
+    ESCAPE_FUNCTION = 'escape'  # or 'Eruby::Helper.escape'
+    ##
+    ## initializer of Template class.
+    ##
+    ## options:
+    ## :escapefunc ::  function name to escape value (default 'escape')
+    ## :preamble   ::  preamble such as "_buf = ''" (default nil)
+    ## :postamble  ::  postamble such as "_buf.to_s" (default nil)
+    ##
+    def initialize(filename=nil, options={})
+      if filename.is_a?(Hash)
+        options = filename
+        filename = nil
+      end
+      @filename   = filename
+      @escapefunc = options[:escapefunc] || ESCAPE_FUNCTION
+      @preamble   = options[:preamble]  == true ? "_buf = #{init_buf_expr()}; " : options[:preamble]
+      @postamble  = options[:postamble] == true ? "_buf.to_s"   : options[:postamble]
+      @args       = nil  # or array of argument names
+      convert_file(filename) if filename
+    end
+    attr_accessor :filename, :escapefunc, :initbuf, :newline
+    attr_accessor :timestamp, :args
+    attr_accessor :script #,:bytecode
+    ## convert file into ruby code
+    def convert_file(filename)
+      return convert(File.read(filename), filename)
+    end
+    ## convert string into ruby code
+    def convert(input, filename=nil)
+      @input = input
+      @filename = filename
+      @proc = nil
+      pos = input.index(?\n)
+      if pos && input[pos-1] == ?\r
+        @newline = "\r\n"
+        @newlinestr = '\\r\\n'
+      else
+        @newline = "\n"
+        @newlinestr = '\\n'
+      end
+      before_convert()
+      parse_stmts(input)
+      after_convert()
+      return @script
+    end
+    protected
+    ## hook method called before convert()
+    def before_convert()
+      @script = ''
+      @script << @preamble if @preamble
+    end
+    ## hook method called after convert()
+    def after_convert()
+      @script << @newline unless @script[-1] == ?\n
+      @script << @postamble << @newline if @postamble
+    end
+    def self.compile_stmt_pattern(pi)
+      return /<\?#{pi}( |\t|\r?\n)(.*?) ?\?>([ \t]*\r?\n)?/m
+    end
+    STMT_PATTERN = self.compile_stmt_pattern('rb')
+    def stmt_pattern
+      STMT_PATTERN
+    end
+    ## parse statements ('<?rb ... ?>')
+    def parse_stmts(input)
+      return unless input
+      is_bol = true
+      prev_rspace = nil
+      pos = 0
+      input.scan(stmt_pattern()) do |mspace, code, rspace|
+        m = Regexp.last_match
+        text = input[pos, m.begin(0) - pos]
+        pos = m.end(0)
+        ## detect spaces at beginning of line
+        lspace = nil
+        if rspace.nil?
+          # nothing
+        elsif text.empty?
+          lspace = "" if is_bol
+        elsif text[-1] == ?\n
+          lspace = ""
+        else
+          rindex = text.rindex(?\n)
+          if rindex
+            s = text[rindex+1..-1]
+            if s =~ /\A[ \t]*\z/
+              lspace = s
+              text = text[0..rindex]
+              #text[rindex+1..-1] = ''
+            end
+          else
+            if is_bol && text =~ /\A[ \t]*\z/
+              lspace = text
+              text = nil
+              #lspace = text.dup
+              #text[0..-1] = ''
+            end
+          end
+        end
+        is_bol = rspace ? true : false
+        ##
+        text.insert(0, prev_rspace) if prev_rspace
+        parse_exprs(text)
+        code.insert(0, mspace) if mspace != ' '
+        if lspace
+          assert if rspace.nil?
+          code.insert(0, lspace)
+          code << rspace
+          #add_stmt(code)
+          prev_rspace = nil
+        else
+          code << ';' unless code[-1] == ?\n
+          #add_stmt(code)
+          prev_rspace = rspace
+        end
+        if code
+          code = statement_hook(code)
+          add_stmt(code)
+        end
+      end
+      #rest = $' || input
+      rest = pos > 0 ? input[pos..-1] : input
+      rest.insert(0, prev_rspace) if prev_rspace
+      parse_exprs(rest) if rest && !rest.empty?
+    end
+    def expr_pattern
+      #return /([\#$])\{(.*?)\}/
+      return /(\$)\{(.*?)\}/m
+      #return /\$\{.*?\}/
+    end
+    ## ex. get_expr_and_escapeflag('$', 'item[:name]') => 'item[:name]', true
+    def get_expr_and_escapeflag(matched)
+      return matched[2], matched[1] == '$'
+    end
+    ## parse expressions ('#{...}' and '${...}')
+    def parse_exprs(input)
+      return if !input or input.empty?
+      pos = 0
+      start_text_part()
+      input.scan(expr_pattern()) do
+        m = Regexp.last_match
+        text = input[pos, m.begin(0) - pos]
+        pos = m.end(0)
+        expr, flag_escape = get_expr_and_escapeflag(m)
+        #m = Regexp.last_match
+        #start = m.begin(0)
+        #stop  = m.end(0)
+        #text  = input[pos, start - pos]
+        #expr  = input[start+2, stop-start-3]
+        #pos = stop
+        add_text(text)
+        add_expr(expr, flag_escape)
+      end
+      rest = $' || input
+      #if !rest || rest.empty?
+      #  @script << '`; '
+      #elsif rest[-1] == ?\n
+      #  rest.chomp!
+      #  @script << escape_str(rest) << @newlinestr << '`' << @newline
+      #else
+      #  @script << escape_str(rest) << '`; '
+      #end
+      flag_newline = input[-1] == ?\n
+      add_text(rest, true)
+      stop_text_part()
+      @script << (flag_newline ? @newline : '; ')
+    end
+    ## expand macros and parse '#@ARGS' in a statement.
+    def statement_hook(stmt)
+      ## macro expantion
+      #macro_pattern = /\A\s*(\w+)\((.*?)\);?(\s*)\z/
+      #if macro_pattern =~ stmt
+      #  name = $1; arg  = $2; rspace = $3
+      #  handler = get_macro_handler(name)
+      #  ret = handler ? handler.call(arg) + $3 : stmt
+      #  return ret
+      #end
+      ## arguments declaration
+      if @args.nil?
+        args_pattern = /\A *\#@ARGS([ \t]+(.*?))?(\s*)\z/   #
+        if args_pattern =~ stmt
+          @args = []
+          declares = ''
+          rspace = $3
+          if $2
+            for s in $2.split(/,/)
+              arg = s.strip()
+              next if s.empty?
+              arg =~ /\A[a-zA-Z_]\w*\z/ or raise ArgumentError.new("#{arg}: invalid template argument.")
+              @args << arg
+              declares << " #{arg} = @#{arg};"
+            end
+          end
+          declares << rspace
+          return declares
+        end
+      end
+      ##
+      return stmt
+    end
+    #MACRO_HANDLER_TABLE = {
+    #  "echo" => proc { |arg|
+    #    " _buf << (#{arg});"
+    #  },
+    #  "import" => proc { |arg|
+    #    " _buf << @_engine.render(#{arg}, self, false);"
+    #  },
+    #  "start_capture" => proc { |arg|
+    #    " _buf_bkup = _buf; _buf = \"\"; _capture_varname = #{arg};"
+    #  },
+    #  "stop_capture" => proc { |arg|
+    #    " self[_capture_varname] = _buf; _buf = _buf_bkup;"
+    #  },
+    #  "start_placeholder" => proc { |arg|
+    #    " if self[#{arg}] then _buf << self[#{arg}] else;"
+    #  },
+    #  "stop_placeholder" => proc { |arg|
+    #    " end;"
+    #  },
+    #}
+    #
+    #def get_macro_handler(name)
+    #  return MACRO_HANDLER_TABLE[name]
+    #end
+    ## start text part
+    def start_text_part()
+      @script << " _buf << %Q`"
+    end
+    ## stop text part
+    def stop_text_part()
+      @script << '`'
+    end
+    ## add text string
+    def add_text(text, encode_newline=false)
+      return unless text && !text.empty?
+      if encode_newline && text[-1] == ?\n
+        text.chomp!
+        @script << escape_str(text) << @newlinestr
+      else
+        @script << escape_str(text)
+      end
+    end
+    ## escape '\\' and '`' into '\\\\' and '\`'
+    def escape_str(str)
+      str.gsub!(/[`\\]/, '\\\\\&')
+      str.gsub!(/\r\n/, "\\r\r\n") if @newline == "\r\n"
+      return str
+    end
+    ## add expression code
+    def add_expr(code, flag_escape=nil)
+      return if !code || code.empty?
+      @script << (flag_escape ? "\#{#{@escapefunc}((#{code}).to_s)}" : "\#{#{code}}")
+    end
+    ## add statement code
+    def add_stmt(code)
+      @script << code
+    end
+    private
+    ## create proc object
+    def _render()   # :nodoc:
+      return eval("proc { |_context| self._buf = _buf = #{init_buf_expr()}; #{@script}; _buf.to_s }".untaint, nil, @filename || '(tenjin)')
+    end
+    public
+    def init_buf_expr()  # :nodoc:
+      return "''"
+    end
+    ## evaluate converted ruby code and return it.
+    ## argument '_context' should be a Hash object or Context object.
+    def render(context=Context.new)
+      context = Context.new(context) if context.is_a?(Hash)
+      @proc ||= _render()
+      return context.instance_eval(&@proc)
+    end
+  end
+  ##
+  ## preprocessor class
+  ##
+  class Preprocessor < Template
+    protected
+    STMT_PATTERN = compile_stmt_pattern('RB')
+    def stmt_pattern
+      return STMT_PATTERN
+    end
+    def expr_pattern
+      return /([\#$])\{\{(.*?)\}\}/m
+    end
+    #--
+    #def get_expr_and_escapeflag(matched)
+    #  return matched[2], matched[1] == '$'
+    #end
+    #++
+    def escape_str(str)
+      str.gsub!(/[\\`\#]/, '\\\\\&')
+      str.gsub!(/\r\n/, "\\r\r\n") if @newline == "\r\n"
+      return str
+    end
+    def add_expr(code, flag_escape=nil)
+      return if !code || code.empty?
+      super("_decode_params((#{code}))", flag_escape)
+    end
+  end
+  ##
+  ## (experimental) fast template class which use Array buffer and Array#push()
+  ##
+  ## ex. ('foo.rb')
+  ##   require 'tenjin'
+  ##   engine = Tenjin::Engine.new(:templateclass=>Tenjin::ArrayBufferTemplate)
+  ##   template = engine.get_template('foo.rbhtml')
+  ##   puts template.script
+  ##
+  ## result:
+  ##   $ cat foo.rbhtml
+  ##   <ul>
+  ##   <?rb for item in items ?>
+  ##     <li>#{item}</li>
+  ##   <?rb end ?>
+  ##   </ul>
+  ##   $ ruby foo.rb
+  ##    _buf.push('<ul>
+  ##   '); for item in items
+  ##    _buf.push('  <li>', (item).to_s, '</li>
+  ##   '); end
+  ##    _buf.push('</ul>
+  ##   ');
+  ##
+  class ArrayBufferTemplate < Template
+    protected
+    def expr_pattern
+      return /([\#$])\{(.*?)\}/
+    end
+    ## parse expressions ('#{...}' and '${...}')
+    def parse_exprs(input)
+      return if !input or input.empty?
+      pos = 0
+      items = []
+      input.scan(expr_pattern()) do
+        prefix, expr = $1, $2
+        m = Regexp.last_match
+        text = input[pos, m.begin(0) - pos]
+        pos = m.end(0)
+        items << quote_str(text) if text && !text.empty?
+        items << quote_expr(expr, prefix == '$') if expr && !expr.empty?
+      end
+      rest = $' || input
+      items << quote_str(rest) if rest && !rest.empty?
+      @script << " _buf.push(" << items.join(", ") << "); " unless items.empty?
+    end
+    def quote_str(text)
+      text.gsub!(/[\'\\]/, '\\\\\&')
+      return "'#{text}'"
+    end
+    def quote_expr(expr, flag_escape)
+      return flag_escape ? "#{@escapefunc}((#{expr}).to_s)" : "(#{expr}).to_s"  # or "(#{expr})"
+    end
+    #--
+    #def get_macro_handler(name)
+    #  if name == "start_capture"
+    #    return proc { |arg|
+    #      " _buf_bkup = _buf; _buf = []; _capture_varname = #{arg};"
+    #    }
+    #  elsif name == "stop_capture"
+    #    return proc { |arg|
+    #      " self[_capture_varname] = _buf.join; _buf = _buf_bkup;"
+    #    }
+    #  else
+    #    return super
+    #  end
+    #end
+    #++
+    public
+    def init_buf_expr()  # :nodoc:
+      return "[]"
+    end
+  end
+  ##
+  ## template class to use eRuby template file (*.rhtml) instead of
+  ## Tenjin template file (*.rbhtml).
+  ## requires 'erubis' (http://www.kuwata-lab.com/erubis).
+  ##
+  ## ex.
+  ##   require 'erubis'
+  ##   require 'tenjin'
+  ##   engine = Tenjin::Engine.new(:templateclass=>Tenjin::ErubisTemplate)
+  ##
+  class ErubisTemplate < Tenjin::Template
+    protected
+    def parse_stmts(input)
+      eruby = Erubis::Eruby.new(input, :preamble=>false, :postamble=>false)
+      @script << eruby.src
+    end
+  end
+  ##
+  ## engine class for templates
+  ##
+  ## Engine class supports the followings.
+  ## * template caching
+  ## * partial template
+  ## * layout template
+  ## * capturing (experimental)
+  ##
+  ## ex. file 'ex_list.rbhtml'
+  ##   <ul>
+  ##   <?rb for item in @items ?>
+  ##     <li>#{item}</li>
+  ##   <?rb end ?>
+  ##   </ul>
+  ##
+  ## ex. file 'ex_layout.rbhtml'
+  ##   <html>
+  ##    <body>
+  ##     <h1>${@title}</li>
+  ##   #{@_content}
+  ##   <?rb import 'footer.rbhtml' ?>
+  ##    </body>
+  ##   </html>
+  ##
+  ## ex. file 'main.rb'
+  ##   require 'tenjin'
+  ##   options = {:prefix=>'ex_', :postfix=>'.rbhtml', :layout=>'ex_layout.rbhtml'}
+  ##   engine = Tenjin::Engine.new(options)
+  ##   context = {:title=>'Tenjin Example', :items=>['foo', 'bar', 'baz']}
+  ##   output = engine.render(:list, context)  # or 'ex_list.rbhtml'
+  ##   print output
+  ##
+  class Engine
+    ##
+    ## initializer of Engine class.
+    ##
+    ## options:
+    ## :prefix  :: prefix string for template name (ex. 'template/')
+    ## :postfix :: postfix string for template name (ex. '.rbhtml')
+    ## :layout  :: layout template name (default nil)
+    ## :path    :: array of directory name (default nil)
+    ## :cache   :: save converted ruby code into file or not (default true)
+    ## :path    :: list of directory (default nil)
+    ## :preprocess :: flag to activate preprocessing (default nil)
+    ## :templateclass :: template class object (default Tenjin::Template)
+    ##
+    def initialize(options={})
+      @prefix  = options[:prefix]  || ''
+      @postfix = options[:postfix] || ''
+      @layout  = options[:layout]
+      @cache   = options.fetch(:cache, true)
+      @path    = options[:path]
+      @preprocess = options.fetch(:preprocess, nil)
+      @templateclass = options.fetch(:templateclass, Template)
+      @init_opts_for_template = options
+      @templates = {}   # filename->template
+    end
+    ## convert short name into filename (ex. ':list' => 'template/list.rb.html')
+    def to_filename(template_name)
+      name = template_name
+      return name.is_a?(Symbol) ? "#{@prefix}#{name}#{@postfix}" : name
+    end
+    ## find template filename
+    def find_template_file(template_name)
+      filename = to_filename(template_name)
+      if @path
+        for dir in @path
+          filepath = "#{dir}#{File::SEPARATOR}#{filename}"
+          return filepath if test(?f, filepath.untaint)
+        end
+      else
+        return filename if test(?f, filename.dup.untaint)  # dup is required for frozen string
+      end
+      raise Errno::ENOENT.new("#{filename} (path=#{@path.inspect})")
+    end
+    ## read template file and preprocess it
+    def read_template_file(filename, _context)
+      return File.read(filename) if !@preprocess
+      _context ||= {}
+      if _context.is_a?(Hash) || _context._engine.nil?
+        _context = hook_context(_context)
+      end
+      preprocessor = Preprocessor.new(filename)
+      return preprocessor.render(_context)
+    end
+    ## register template object
+    def register_template(template_name, template)
+      #template.timestamp = Time.new unless template.timestamp
+      @templates[template_name] = template
+    end
+    def cachename(filename)
+      return (filename + '.cache').untaint
+    end
+    ## create template object from file
+    def create_template(filename, _context=nil)
+      template = @templateclass.new(nil, @init_opts_for_template)
+      template.timestamp = Time.now()
+      cache_filename = cachename(filename)
+      _context = hook_context(Context.new) if _context.nil?
+      if !@cache
+        input = read_template_file(filename, _context)
+        template.convert(input, filename)
+      elsif !test(?f, cache_filename) || File.mtime(cache_filename) < File.mtime(filename)
+        #$stderr.puts "*** debug: load original"
+        input = read_template_file(filename, _context)
+        template.convert(input, filename)
+        store_cachefile(cache_filename, template)
+      else
+        #$stderr.puts "*** debug: load cache"
+        template.filename = filename
+        load_cachefile(cache_filename, template)
+      end
+      return template
+    end
+    ## store template into cache file
+    def store_cachefile(cache_filename, template)
+      s = template.script
+      s = "\#@ARGS #{template.args.join(',')}\n#{s}" if template.args
+      File.open(cache_filename, 'w') do |f|
+        f.flock(File::LOCK_EX)
+        f.write(s)
+        #f.lock(FIle::LOCK_UN)   # File#close() unlocks automatically
+      end
+    end
+    ## load template from cache file
+    def load_cachefile(cache_filename, template)
+      s = File.read(cache_filename)
+      if s.sub!(/\A\#\@ARGS (.*?)\r?\n/, '')
+        template.args = $1.split(',')
+      end
+      template.script = s
+    end
+    ## get template object
+    def get_template(template_name, _context=nil)
+      template = @templates[template_name]
+      t = template
+      unless t && t.timestamp && t.filename && t.timestamp >= File.mtime(t.filename)
+        filename = find_template_file(template_name)
+        template = create_template(filename, _context)  # _context is passed only for preprocessor
+        register_template(template_name, template)
+      end
+      return template
+    end
+    ## get template object and evaluate it with context object.
+    ## if argument 'layout' is true then default layout file (specified at
+    ## initializer) is used as layout template, else if false then no layout
+    ## template is used.
+    ## if argument 'layout' is string, it is regarded as layout template name.
+    def render(template_name, context=Context.new, layout=true)
+      #context = Context.new(context) if context.is_a?(Hash)
+      context = hook_context(context)
+      while true
+        template = get_template(template_name, context)  # context is passed only for preprocessor
+        _buf = context._buf
+        output = template.render(context)
+        context._buf = _buf
+        unless context['_layout'].nil?
+          layout = context['_layout']
+          context['_layout'] = nil
+        end
+        layout = @layout if layout == true or layout.nil?
+        break unless layout
+        template_name = layout
+        layout = false
+        context['_content'] = output
+      end
+      return output
+    end
+    def hook_context(context)
+      if !context
+        context = Context.new
+      elsif context.is_a?(Hash)
+        context = Context.new(context)
+      end
+      context._engine = self
+      context._layout = nil
+      return context
+    end
+  end
+end