mako.template.Template

When True, and output_encoding is set to None, and .Template.render is used to render, the StringIO or cStringIO buffer will be used instead of the default "fast" buffer. This allows raw bytestrings in the output stream, such as in expressions, to pass straight through to the buffer. This flag is forced to True if disable_unicode is also configured.

Python callable which is called whenever compile or runtime exceptions occur. The callable is passed the current context as well as the exception. If the callable returns True, the exception is considered to be handled, else it is re-raised after the function completes. Is used to provide custom error-rendering functions.

An error handler that runs when this template is included within another one via the <%include> tag, and raises an error. Compare to the :paramref:`.Template.error_handler` option.

A callable which overrides how the Python module is written entirely. The callable is passed the encoded source content of the module and the destination path to be written to. The default behavior of module writing uses a tempfile in conjunction with a file move in order to make the operation atomic. So a user-defined module writing function that mimics the default behavior would be:

import tempfile
import os
import shutil

def module_writer(source, outputpath):
    (dest, name) = \\
        tempfile.mkstemp(
            dir=os.path.dirname(outputpath)
        )

    os.write(dest, source)
    os.close(dest)
    shutil.move(name, outputpath)

from mako.template import Template
mytemplate = Template(
                filename="index.html",
                module_directory="/path/to/modules",
                module_writer=module_writer
            )

The function is provided for unusual configurations where certain platform-specific permissions or other special steps are needed.

A .Lexer class used to parse the template. The .Lexer class is used by default.

Replaces the automatic usage of UNDEFINED for any undeclared variables not located in the .Context with an immediate raise of NameError. The advantage is immediate reporting of missing variables which include the name.