[ANN] Tenjin 0.6.1 - a fast and full-featured template engine

M

makoto kuwata

Hi all,

I have released Tenjin 0.6.1.
http://www.kuwata-lab.com/tenjin/
changes:
http://www.kuwata-lab.com/tenjin/rbtenjin-CHANGES.txt

Tenjin is a fast and full-featured template engine similar to eRuby
but it has the following advantages against to eRuby and ERB.

* Very fast (twice faster than eruby and three times faster than
ERB)
* Lightweight (only one file which contains about 1000 lines)
* Not break HTML design because it uses XML Processing
Instructions (PI) as embedded notation for Python statements.
* Secure because it supports escaping expression value by default.
* Auto caching of converted Python code.
* Nestable layout template
* Inlucde other templates
* Capture part of template
* Load YAML file as context data
* Preprocessing support

Notation of Tenjin is different from eRuby.

* '<?rb ... ?>' represents Ruby statements.
* '#{...}' represents Ruby expression.
* '${...}' represents Ruby expression with escaping (sanitizing).

ex. example.rbhtml
----------
<html>
<body>
<table>
<?rb for item in @items ?>
<tr>
<td>#{item}</td>
<td>${item}</td>
</tr>
<?rb end ?>
</table>
</body>
</html>
----------

ex. convert into Ruby script
==========
$ rbtenjin -s example.rbhtml
_buf = ''; _buf << %Q`<html>
<body>
<table>\n`
for item in @items
_buf << %Q` <tr>
<td>#{item}</td>
<td>#{escape((item).to_s)}</td>
</tr>\n`
end
_buf << %Q` </table>
</body>
</html>\n`
_buf.to_s
==========

ex. execute converted Ruby script
==========
$ rbtenjin -c '@items=%w[<AAA> B&B "CCC"]' example.rbhtml
<html>
<body>
<table>
<tr>
<td><AAA></td>
<td>&lt;AAA&gt;</td>
</tr>
<tr>
<td>B&B</td>
<td>B&amp;B</td>
</tr>
<tr>
<td>"CCC"</td>
<td>&quot;CCC&quot;</td>
</tr>
</table>
</body>
</html>
==========


Tenjin is more suitable for web applications than eRuby,
because it doesn't break HTML desing of template and
supports partial template and layout temlate.
See Tenjin User's Guide for details.
http://www.kuwata-lab.com/tenjin/rbtenjin-users-guide.html


Enhancements from 0.6.0:

* It is able to make any class which includes
Tenjin::ContextHelper module as context object class.
This is useful if you want to define helper functions
as instance method of that class.
See section 'Add Your Helper Functions' for details.
http://www.kuwata-lab.com/tenjin/rbtenjin-users-guide.html#dev-helpers

ex.
require 'tenjin'

class MyClass
include Tenjin::ContextHelper
#include Tenjin::HtmlHelper # optional

## define helper functions in current class
def link_to(label, url)
return "<a href=\"#{escape(url)}\">#{escape(label)}</a>"
end

def render_template(template_name)
engine = Tenjin::Engine.new()
## pass self as context object
output = engine.render(template_name, self)
return output
end

def main
## set context data as instance variables
@label = 'Top'
@url = '/'
output = render_template('example.rbhtml')
print output
end

end

MyClass.new.main()
 
M

Michael Neumann

makoto said:
Hi all,

I have released Tenjin 0.6.1.
http://www.kuwata-lab.com/tenjin/
changes:
http://www.kuwata-lab.com/tenjin/rbtenjin-CHANGES.txt

Tenjin is a fast and full-featured template engine similar to eRuby
but it has the following advantages against to eRuby and ERB.

Thanks for your great work on template engines!
* Very fast (twice faster than eruby and three times faster than
ERB)
* Lightweight (only one file which contains about 1000 lines)
* Not break HTML design because it uses XML Processing
Instructions (PI) as embedded notation for Python statements.
* Secure because it supports escaping expression value by default.
* Auto caching of converted Python code.
^^^^^^
Python? ;-)

Regards,

Michael
 
G

Gaspard Bucher

This looks really great !

I have written a pre-processor language for the templates in zena (a
CMS) called zafu. It would be really easy to generate tenjin code
instead of erb.

By looking at the code, I don't understand where the performance boost
comes from. At the end, we have a ruby method, just like with erb, no
?

Could explain why tenjin is faster ?

Is it during compilation ?

Or during execution (which means a compilation that generates faster
ruby code) ?

Thanks for your answer.

Gaspard
 
M

Michael Neumann

Josef said:
* Michael Neumann, 2008-02-09, 08:03:


Tenjin comes in different flavours including a Python one.

Cool! So I guess auto caching for Ruby was already implemented since the
beginning...

Regards,

Michael
 

Ask a Question

Want to reply to this thread or ask your own question?

You'll need to choose a username for the site, which only take a couple of moments. After that, you can post your question and our members will help you out.

Ask a Question

Members online

No members online now.

Forum statistics

Threads
473,754
Messages
2,569,516
Members
44,991
Latest member
Josephnag

Latest Threads

Top