OLD | NEW |
1 # -*- coding: utf-8 -*- | 1 # -*- coding: utf-8 -*- |
2 """ | 2 """ |
3 jinja2 | 3 jinja2 |
4 ~~~~~~ | 4 ~~~~~~ |
5 | 5 |
6 Jinja2 is a template engine written in pure Python. It provides a | 6 Jinja2 is a template engine written in pure Python. It provides a |
7 Django inspired non-XML syntax but supports inline expressions and | 7 Django inspired non-XML syntax but supports inline expressions and |
8 an optional sandboxed environment. | 8 an optional sandboxed environment. |
9 | 9 |
10 Nutshell | 10 Nutshell |
11 -------- | 11 -------- |
12 | 12 |
13 Here a small example of a Jinja2 template:: | 13 Here a small example of a Jinja2 template:: |
14 | 14 |
15 {% extends 'base.html' %} | 15 {% extends 'base.html' %} |
16 {% block title %}Memberlist{% endblock %} | 16 {% block title %}Memberlist{% endblock %} |
17 {% block content %} | 17 {% block content %} |
18 <ul> | 18 <ul> |
19 {% for user in users %} | 19 {% for user in users %} |
20 <li><a href="{{ user.url }}">{{ user.username }}</a></li> | 20 <li><a href="{{ user.url }}">{{ user.username }}</a></li> |
21 {% endfor %} | 21 {% endfor %} |
22 </ul> | 22 </ul> |
23 {% endblock %} | 23 {% endblock %} |
24 | 24 |
25 | 25 |
26 :copyright: (c) 2010 by the Jinja Team. | 26 :copyright: (c) 2010 by the Jinja Team. |
27 :license: BSD, see LICENSE for more details. | 27 :license: BSD, see LICENSE for more details. |
28 """ | 28 """ |
29 __docformat__ = 'restructuredtext en' | 29 __docformat__ = 'restructuredtext en' |
30 __version__ = '2.7.1' | 30 __version__ = '2.8' |
31 | 31 |
32 # high level interface | 32 # high level interface |
33 from jinja2.environment import Environment, Template | 33 from jinja2.environment import Environment, Template |
34 | 34 |
35 # loaders | 35 # loaders |
36 from jinja2.loaders import BaseLoader, FileSystemLoader, PackageLoader, \ | 36 from jinja2.loaders import BaseLoader, FileSystemLoader, PackageLoader, \ |
37 DictLoader, FunctionLoader, PrefixLoader, ChoiceLoader, \ | 37 DictLoader, FunctionLoader, PrefixLoader, ChoiceLoader, \ |
38 ModuleLoader | 38 ModuleLoader |
39 | 39 |
40 # bytecode caches | 40 # bytecode caches |
41 from jinja2.bccache import BytecodeCache, FileSystemBytecodeCache, \ | 41 from jinja2.bccache import BytecodeCache, FileSystemBytecodeCache, \ |
42 MemcachedBytecodeCache | 42 MemcachedBytecodeCache |
43 | 43 |
44 # undefined types | 44 # undefined types |
45 from jinja2.runtime import Undefined, DebugUndefined, StrictUndefined | 45 from jinja2.runtime import Undefined, DebugUndefined, StrictUndefined, \ |
| 46 make_logging_undefined |
46 | 47 |
47 # exceptions | 48 # exceptions |
48 from jinja2.exceptions import TemplateError, UndefinedError, \ | 49 from jinja2.exceptions import TemplateError, UndefinedError, \ |
49 TemplateNotFound, TemplatesNotFound, TemplateSyntaxError, \ | 50 TemplateNotFound, TemplatesNotFound, TemplateSyntaxError, \ |
50 TemplateAssertionError | 51 TemplateAssertionError |
51 | 52 |
52 # decorators and public utilities | 53 # decorators and public utilities |
53 from jinja2.filters import environmentfilter, contextfilter, \ | 54 from jinja2.filters import environmentfilter, contextfilter, \ |
54 evalcontextfilter | 55 evalcontextfilter |
55 from jinja2.utils import Markup, escape, clear_caches, \ | 56 from jinja2.utils import Markup, escape, clear_caches, \ |
56 environmentfunction, evalcontextfunction, contextfunction, \ | 57 environmentfunction, evalcontextfunction, contextfunction, \ |
57 is_undefined | 58 is_undefined |
58 | 59 |
59 __all__ = [ | 60 __all__ = [ |
60 'Environment', 'Template', 'BaseLoader', 'FileSystemLoader', | 61 'Environment', 'Template', 'BaseLoader', 'FileSystemLoader', |
61 'PackageLoader', 'DictLoader', 'FunctionLoader', 'PrefixLoader', | 62 'PackageLoader', 'DictLoader', 'FunctionLoader', 'PrefixLoader', |
62 'ChoiceLoader', 'BytecodeCache', 'FileSystemBytecodeCache', | 63 'ChoiceLoader', 'BytecodeCache', 'FileSystemBytecodeCache', |
63 'MemcachedBytecodeCache', 'Undefined', 'DebugUndefined', | 64 'MemcachedBytecodeCache', 'Undefined', 'DebugUndefined', |
64 'StrictUndefined', 'TemplateError', 'UndefinedError', 'TemplateNotFound', | 65 'StrictUndefined', 'TemplateError', 'UndefinedError', 'TemplateNotFound', |
65 'TemplatesNotFound', 'TemplateSyntaxError', 'TemplateAssertionError', | 66 'TemplatesNotFound', 'TemplateSyntaxError', 'TemplateAssertionError', |
66 'ModuleLoader', 'environmentfilter', 'contextfilter', 'Markup', 'escape', | 67 'ModuleLoader', 'environmentfilter', 'contextfilter', 'Markup', 'escape', |
67 'environmentfunction', 'contextfunction', 'clear_caches', 'is_undefined', | 68 'environmentfunction', 'contextfunction', 'clear_caches', 'is_undefined', |
68 'evalcontextfilter', 'evalcontextfunction' | 69 'evalcontextfilter', 'evalcontextfunction', 'make_logging_undefined', |
69 ] | 70 ] |
OLD | NEW |