Configuration

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.

CHAMELEON_EAGER

Parse and compile templates on instantiation.

CHAMELEON_CACHE

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.

CHAMELEON_RELOAD

This setting controls the default value of the auto_reload parameter.

Development

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

CHAMELEON_DEBUG

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.