Most settings can be provided as keyword-arguments to the template constructor classes.

There are certain settings which are required at environment level. Acceptable values are "0", "1", or the literals "true" or "false" (case-insensitive).

General usage

The following settings are useful in general.


Parse and compile templates on instantiation.


When set to a file system path, the template compiler will write its output to files in this directory and use it as a cache.

This not only enables you to see the compiler output, but also speeds up startup.


This setting controls the default value of the auto_reload parameter.


The following settings are mostly useful during development or debugging of the library itself.


Enables a set of debugging settings which make it easier to discover and research issues with the engine itself.

This implicitly enables auto-reload for any template.