# 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.