Genshi (templating language)
Genshi is a template engine for XML-based vocabularies written in
Python. Genshi is used to easily insert generated output into XML-based languages, usually HTML, and reuse elements between documents. Genshi's syntax is based on Kid, but its architecture is different. Genshi aims to implement some of its functionality while processing templates faster, by dynamically processing templates using a stream based API, instead of compiling templates to Python code.
Genshi can be used with several Python web frameworks, such as CherryPy, TurboGears, Pylons and web2py. Genshi has replaced Kid in the TurboGears 2.x web framework.
Genshi markup
Genshi makes use of namespaces to embed instructions into HTML. A typical instruction is given as an, with a Python expression inside the quotes. For example, the following will render a paragraph that shows 4:This will be replaced with 4
Because of the use of namespaces, Genshi can be used in WYSIWYG HTML editors.
Differences between Kid and Genshi
- Genshi directly interprets templates
- Genshi uses XInclude for template reuse
- Genshi adds attributes Kid does not have, like
py:choose - Genshi templates are easier to debug, because it tracks template source file names and line numbers, and errors from Genshi's interpreter produce more comprehensible stack traces than from Kid's generated code.