Mako

Here's a simple Tool for Mako templating:

{{{
#!python
import cherrypy
from mako.lookup import TemplateLookup


class MakoHandler(cherrypy.dispatch.LateParamPageHandler):
    """Callable which sets response.body."""
    
    def __init__(self, template, next_handler):
        self.template = template
        self.next_handler = next_handler
    
    def __call__(self):
        env = globals().copy()
        env.update(self.next_handler())
        try:
            return self.template.render(**env)
        except:
            # something went wrong rendering the template
            # this will generate a pretty error page with details
            cherrypy.response.status = "500"
            return exceptions.html_error_template().render()


class MakoLoader(object):
    
    def __init__(self):
        self.lookups = {}
    
    def __call__(self, filename, directories, module_directory=None,
                 collection_size=-1):
        # Find the appropriate template lookup.
        key = (tuple(directories), module_directory)
        try:
            lookup = self.lookups[key]
        except KeyError:
            lookup = TemplateLookup(directories=directories,
                                    module_directory=module_directory,
                                    collection_size=collection_size,
                                    )
            self.lookups[key] = lookup
        cherrypy.request.lookup = lookup
        
        # Replace the current handler.
        cherrypy.request.template = t = lookup.get_template(filename)
        cherrypy.request.handler = MakoHandler(t, cherrypy.request.handler)

main = MakoLoader()
cherrypy.tools.mako = cherrypy.Tool('on_start_resource', main)
}}}

Use it like this:

{{{
#!python
@cherrypy.expose
@cherrypy.tools.mako(filename="index.html")
def index(name=None):
    return {'username': name}
}}}

You will also need two config options:
{{{
tools.mako.collection_size = 500
tools.mako.directories = "path/to/templates"
}}}

index.html:
{{{
<html>
<body>
Hello, ${username}!
</body>
</html>
}}}


------
To avoid UTF-8 encoding problems use following for template lookup

{{{
#!python
lookup = TemplateLookup(directories=directories, module_directory=module_directory, collection_size=collection_size,output_encoding='utf-8', encoding_errors='replace')
}}}