Documented autoescaping behavior and eval contexts.
[jinja2.git] / CHANGES
1 Jinja2 Changelog
2 ================
3
4 Version 2.4
5 -----------
6 (codename to be selected, release date unknown)
7
8 - the environment template loading functions now transparently
9   pass through a template object if it was passed to it.  This
10   makes it possible to import or extend from a template object
11   that was passed to the template.
12 - added a :class:`ModuleLoader` that can load templates from
13   precompiled sources.  The environment now features a method
14   to compile the templates from a configured loader into a zip
15   file or folder.
16 - the _speedups C extension now supports Python 3.
17 - added support for autoescaping toggling sections and support
18   for evaluation contexts (:ref:`eval-context`).
19
20 Version 2.3.1
21 -------------
22 (bugfix release, released on February 19th 2010)
23
24 - fixed an error reporting bug on all python versions
25 - fixed an error reporting bug on Python 2.4
26
27 Version 2.3
28 -----------
29 (3000 Pythons, released on February 10th 2010)
30
31 - fixes issue with code generator that causes unbound variables
32   to be generated if set was used in if-blocks and other small
33   identifier problems.
34 - include tags are now able to select between multiple templates
35   and take the first that exists, if a list of templates is
36   given.
37 - fixed a problem with having call blocks in outer scopes that
38   have an argument that is also used as local variable in an
39   inner frame (#360).
40 - greatly improved error message reporting (#339)
41 - implicit tuple expressions can no longer be totally empty.
42   This change makes ``{% if %}...{% endif %}`` a syntax error
43   now. (#364)
44 - added support for translator comments if extracted via babel.
45 - added with-statement extension.
46 - experimental Python 3 support.
47
48 Version 2.2.1
49 -------------
50 (bugfix release, released on September 14th 2009)
51
52 - fixes some smaller problems for Jinja2 on Jython.
53
54 Version 2.2
55 -----------
56 (codename Kong, released on September 13th 2009)
57
58 - Include statements can now be marked with ``ignore missing`` to skip
59   non existing templates.
60 - Priority of `not` raised.  It's now possible to write `not foo in bar`
61   as an alias to `foo not in bar` like in python.  Previously the grammar
62   required parentheses (`not (foo in bar)`) which was odd.
63 - Fixed a bug that caused syntax errors when defining macros or using the
64   `{% call %}` tag inside loops.
65 - Fixed a bug in the parser that made ``{{ foo[1, 2] }}`` impossible.
66 - Made it possible to refer to names from outer scopes in included templates
67   that were unused in the callers frame (#327)
68 - Fixed a bug that caused internal errors if names where used as iteration
69   variable and regular variable *after* the loop if that variable was unused
70   *before* the loop.  (#331)
71 - Added support for optional `scoped` modifier to blocks.
72 - Added support for line-comments.
73 - Added the `meta` module.
74 - Renamed (undocumented) attribute "overlay" to "overlayed" on the
75   environment because it was clashing with a method of the same name.
76 - speedup extension is now disabled by default.
77
78 Version 2.1.1
79 -------------
80 (Bugfix release)
81
82 - Fixed a translation error caused by looping over empty recursive loops.
83
84 Version 2.1
85 -----------
86 (codename Yasuzō, released on November 23rd 2008)
87
88 - fixed a bug with nested loops and the special loop variable.  Before the
89   change an inner loop overwrote the loop variable from the outer one after
90   iteration.
91
92 - fixed a bug with the i18n extension that caused the explicit pluralization
93   block to look up the wrong variable.
94
95 - fixed a limitation in the lexer that made ``{{ foo.0.0 }}`` impossible.
96
97 - index based subscribing of variables with a constant value returns an
98   undefined object now instead of raising an index error.  This was a bug
99   caused by eager optimizing.
100
101 - the i18n extension looks up `foo.ugettext` now followed by `foo.gettext`
102   if an translations object is installed.  This makes dealing with custom
103   translations classes easier.
104
105 - fixed a confusing behavior with conditional extending.  loops were partially
106   executed under some conditions even though they were not part of a visible
107   area.
108
109 - added `sort` filter that works like `dictsort` but for arbitrary sequences.
110
111 - fixed a bug with empty statements in macros.
112
113 - implemented a bytecode cache system.  (:ref:`bytecode-cache`)
114
115 - the template context is now weakref-able
116
117 - inclusions and imports "with context" forward all variables now, not only
118   the initial context.
119
120 - added a cycle helper called `cycler`.
121
122 - added a joining helper called `joiner`.
123
124 - added a `compile_expression` method to the environment that allows compiling
125   of Jinja expressions into callable Python objects.
126
127 - fixed an escaping bug in urlize
128
129 Version 2.0
130 -----------
131 (codename jinjavitus, released on July 17th 2008)
132
133 - the subscribing of objects (looking up attributes and items) changed from
134   slightly.  It's now possible to give attributes or items a higher priority
135   by either using dot-notation lookup or the bracket syntax.  This also
136   changed the AST slightly.  `Subscript` is gone and was replaced with
137   :class:`~jinja2.nodes.Getitem` and :class:`~jinja2.nodes.Getattr`.
138
139   For more information see :ref:`the implementation details <notes-on-subscriptions>`.
140
141 - added support for preprocessing and token stream filtering for extensions.
142   This would allow extensions to allow simplified gettext calls in template
143   data and something similar.
144
145 - added :meth:`jinja2.environment.TemplateStream.dump`.
146
147 - added missing support for implicit string literal concatenation.
148   ``{{ "foo" "bar" }}`` is equivalent to ``{{ "foobar" }}``
149
150 - `else` is optional for conditional expressions.  If not given it evaluates
151   to `false`.
152
153 - improved error reporting for undefined values by providing a position.
154
155 - `filesizeformat` filter uses decimal prefixes now per default and can be
156   set to binary mode with the second parameter.
157
158 - fixed bug in finalizer
159
160 Version 2.0rc1
161 --------------
162 (no codename, released on June 9th 2008)
163
164 - first release of Jinja2