Class HandlerWrapperTool

source code

object --+    
         |    
      Tool --+
             |
            HandlerWrapperTool

Tool which wraps request.handler in a provided wrapper function.

The 'newhandler' arg must be a handler wrapper function that takes a
'next_handler' argument, plus *args and **kwargs. Like all page handler
functions, it must return an iterable for use as cherrypy.response.body.

For example, to allow your 'inner' page handlers to return dicts
which then get interpolated into a template:

    def interpolator(next_handler, *args, **kwargs):
        filename = cherrypy.request.config.get('template')
        cherrypy.response.template = env.get_template(filename)
        response_dict = next_handler(*args, **kwargs)
        return cherrypy.response.template.render(**response_dict)
    cherrypy.tools.jinja = HandlerWrapperTool(interpolator)