Skip to main content

a fast and full-featured template engine based on embedded Python

Project description

About

pyTenjin is a very fast and full-featured template engine. You can embed Python statements and expressions into your template file. pyTenjin converts it into Python script and evaluate it.

!!ATTENTION!!

pyTenjin is enough stable, but it is under beta release. It means that API or specification may change in the future.

Features

  • Very fast

    • About x10 faster than Django, x4 than Cheetah, x2 than Mako

    • In addition loading tenjin.py is very lightweight (important for CGI)

  • Full featured

    • Nestable layout template

    • Partial template

    • Fragment cache

    • Capturing

    • Preprocessing

  • Easy to learn

    • You don’t have to learn template-specific language

  • Supports Google App Engine

See User’s Guide and Changes for details.

Install

$ sudo easy_install Tenjin

Or:

$ tar xzf Tenjin-X.X.X.tar.gz
$ cd Tenjin-X.X.X
$ sudo python setup.py install

Or just copy ‘lib/tenjin.py’ and ‘bin/pytenjin’ into proper directory.

(Optional) Install PyYAML.

Example

example.pyhtml:

<?py # -*- coding: utf-8 -*- ?>
<?py #@ARGS items ?>
<table>
<?py cycle = new_cycle('odd', 'even') ?>
<?py for item in items: ?>
  <tr class="#{cycle()}">
    <td>${item}</td>
  </tr>
<?py #endfor ?>
</table>

example.py:

import tenjin
#tenjin.set_template_encoding('utf-8')  # optional (defualt 'utf-8')
from tenjin.helpers import *
from tenjin.html import *
#import tenjin.gae; tenjin.gae.init()   # for Google App Engine
engine = tenjin.Engine()
context = { 'items': ['<AAA>', 'B&B', '"CCC"'] }
html = engine.render('example.pyhtml', context)
print(html)

Output:

$ python example.py
<table>
  <tr class="odd">
    <td>&lt;AAA&gt;</td>
  </tr>
  <tr class="even">
    <td>B&amp;B</td>
  </tr>
  <tr class="odd">
    <td>&quot;CCC&quot;</td>
  </tr>
</table>

See other examples .

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Tenjin-1.1.1.tar.gz (206.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page