Skip to main content

Fast XML-based template engine with Genshi syntax and Jinja blocks

Project description

Kajiki provides fast well-formed XML templates

Because Kajiki’s input is XML, it can ensure that your HTML/XML output is well-formed. The Genshi-like syntax, based on XML attributes or tags, is simply beautiful and easily understood (or ignored) by web designers. But instead of the slow performance of Genshi, Kajiki compiles templates to Python code that renders with blazing-fast speed, so Kajiki can compete with the speed of Jinja, Mako, Chameleon and others. Also, one of Genshi’s misfeatures – py:match – is replaced with blocks which work like Jinja’s blocks.

By combining the best ideas out there – XML input, Genshi’s syntax and features, Jinja’s template inheritance and final compilation to Python –, Kajiki is ready to become the most widely used templating engine for web development in Python. And more features are coming soon; stay tuned!

Example

>>> import kajiki
>>> Template = kajiki.XMLTemplate('''<html>
...     <head><title>$title</title></head>
...     <body>
...         <h1>$title</h1>
...         <ul>
...             <li py:for="x in range(repetitions)">$title</li>
...         </ul>
...     </body>
... </html>''')
>>> print(Template(dict(title='Kajiki is teh awesome!', repetitions=3)).render())
<html>
    <head><title>Kajiki is teh awesome!</title></head>
    <body>
        <h1>Kajiki is teh awesome!</h1>
        <ul>
            <li>Kajiki is teh awesome!</li><li>Kajiki is teh awesome!</li><li>Kajiki is teh awesome!</li>
        </ul>
    </body>
</html>

CHANGES

0.5.0 (2015-07-25)

  • CDATA sections created by the user are now properly preserved

  • cdata_scripts=False option in XMLTemplate allows disabling automatic CDATA for script and style tags.

  • Autoblocks experimental feature automatically creates blocks from specified tag names.

0.4.4 (2013-09-07)

  • Also accept “$.” without erroring out. In fact, accept anything.

  • Add integration plugin for TurboGears 1

0.4.3 (2013-08-12)

  • Accept “$(” without erroring out. Easier to write jQuery stuff.

0.4.2 (2013-08-01)

  • There was a showstopper regression in FileLoader. Fixes #1

0.4.0 (2013-07-29)

  • Support Python versions 2.6, 2.7, 3.2, 3.3 in a single codebase using the nine library.

  • Support HTML entities as well as XML entities in input templates.

  • py:include fixed, can see global variables.

  • Genshi compatibility: support built-in functions: defined(), value_of() and Markup().

  • py:def: Do not crash if a function has no content.

  • py:strip='' is the same as py:strip='True'.

  • Correctness: escape HTML attribute values.

  • Correctness: Always close script tags, even in XML mode.

  • Add integration module for the Pyramid web framework.

  • Give the FileLoader a path, not just a base directory.

  • Documentation improvements, including the need to write CDATA sections.

  • Move from Sourceforge to Github.

  • Use Travis for continuous integration.

  • The whole codebase is formatted according to PEP8.

0.3.5 (2012-05-07)

  • Several bugfixes

  • Output HTML attributes in alphabetical order (for testability)

0.3.4 (2011-06-01)

  • Make Kajiki work on Python 2.4

0.3.2 (2010-11-26)

  • Fix Python 2.5 syntax error

0.3.1 (2010-11-24)

  • Add support for py:with

  • Remove unused babel import that was breaking pip/easy_install

  • Python 2.5 fixes

  • Correctly strip None attributes and expressions

  • Turn off autoescaping in text templates

0.3 (2010-10-10)

  • Adds i18n support

  • Fixes several bugs: [#7], [#9], [#10]

Download files

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

Source Distribution

Kajiki-0.5.0.tar.gz (165.2 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