Template rendering tool for cherrypy

templating, cherrypy, mako, jinja2, pystache, cheetah, genshi
pip install lribeiro.cherrypy.templating==1.0.1



Template rendering tool for cherrypy.

It does not render any template, so you must provide a renderer for your template system to do the actual rendering.

The renderer must be a callable accepting two arguments:

  • The name of the template to be rendered
  • A context object, which can be a dict or any other object that your template system can handle

The template name comes from the @template decorator argument and the context is the value return from the handler.

Renderer parameters

You can optionally pass parameters to your renderer function by just passing additional arguments to the @template decorator

class Controller:
    @template('template_name', 'some arg', some='keyword arg')
    # pass your additional parameters here
    def handler():

def renderer(template_name, context, *args, **kwargs):
    # and do something with the parameters here

Developed under Python3.4 and tested against Python2.7, Python3.4 and pypy.


from os import path

import cherrypy
import pystache

from lribeiro.cherrypy.templating import template

def _renderer(template_name, context):
    Template renderer using Pystache

    search_dir = path.join(path.dirname(path.abspath(__file__)), 'templates')
    renderer = pystache.Renderer(file_extension='html', search_dirs=search_dir)

    template_str = renderer.load_template(template_name)
    return renderer.render(template_str, context)

class Root:
    def index(self):
        return {'name': 'Lorem', 'lastname': 'Ipsum'}

    def page(self):
        return {'name': 'Lorem', 'lastname': 'Ipsum'}

    @template('page_with_args', 'some', 'arg')
    def page_with_args(self):
        return {'name': 'Lorem', 'lastname': 'Ipsum'}

    @template('page_with_kwargs', some='keyword arg')
    def page_with_kwargs(self):
        return {'name': 'Lorem', 'lastname': 'Ipsum'}

config = {
    '/': {
        'templating.renderer': _renderer,

if __name__ == '__main__':
    cherrypy.quickstart(Root(), '/', config)