File: configuration.rst

package info (click to toggle)
python-chameleon 2.16-4
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 2,700 kB
  • ctags: 1,471
  • sloc: python: 17,872; xml: 597; makefile: 75
file content (43 lines) | stat: -rw-r--r-- 1,101 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
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.