This will be 2.5.4
[jinja2.git] / CHANGES
1 Jinja2 Changelog
2 ================
3
4 Version 2.5.4
5 -------------
6 (bugfix release, release date to be announced)
7
8 Version 2.5.3
9 -------------
10 (bugfix release, released on October 17th 2010)
11
12 - fixed an operator precedence error introduced in 2.5.2.  Statements
13   like "-foo.bar" had their implicit parentheses applied around the
14   first part of the expression ("(-foo).bar") instead of the more
15   correct "-(foo.bar)".
16
17 Version 2.5.2
18 -------------
19 (bugfix release, released on August 18th 2010)
20
21 - improved setup.py script to better work with assumptions people
22   might still have from it (``--with-speedups``).
23 - fixed a packaging error that excluded the new debug support.
24
25 Version 2.5.1
26 -------------
27 (bugfix release, released on August 17th 2010)
28
29 - StopIteration exceptions raised by functions called from templates
30   are now intercepted and converted to undefineds.  This solves a
31   lot of debugging grief.  (StopIteration is used internally to
32   abort template execution)
33 - improved performance of macro calls slightly.
34 - babel extraction can now properly extract newstyle gettext calls.
35 - using the variable `num` in newstyle gettext for something else
36   than the pluralize count will no longer raise a :exc:`KeyError`.
37 - removed builtin markup class and switched to markupsafe.  For backwards
38   compatibility the pure Python implementation still exists but is
39   pulled from markupsafe by the Jinja2 developers.  The debug support
40   went into a separate feature called "debugsupport" and is disabled
41   by default because it is only relevant for Python 2.4
42 - fixed an issue with unary operators having the wrong precendence.
43
44 Version 2.5
45 -----------
46 (codename Incoherence, relased on May 29th 2010)
47
48 - improved the sort filter (should have worked like this for a
49   long time) by adding support for case insensitive searches.
50 - fixed a bug for getattribute constant folding.
51 - support for newstyle gettext translations which result in a
52   nicer in-template user interface and more consistent
53   catalogs. (:ref:`newstyle-gettext`)
54 - it's now possible to register extensions after an environment
55   was created.
56
57 Version 2.4.1
58 -------------
59 (bugfix release, released on April 20th 2010)
60
61 - fixed an error reporting bug for undefineds.
62
63 Version 2.4
64 -----------
65 (codename Correlation, released on April 13th 2010)
66
67 - the environment template loading functions now transparently
68   pass through a template object if it was passed to it.  This
69   makes it possible to import or extend from a template object
70   that was passed to the template.
71 - added a :class:`ModuleLoader` that can load templates from
72   precompiled sources.  The environment now features a method
73   to compile the templates from a configured loader into a zip
74   file or folder.
75 - the _speedups C extension now supports Python 3.
76 - added support for autoescaping toggling sections and support
77   for evaluation contexts (:ref:`eval-context`).
78 - extensions have a priority now.
79
80 Version 2.3.1
81 -------------
82 (bugfix release, released on February 19th 2010)
83
84 - fixed an error reporting bug on all python versions
85 - fixed an error reporting bug on Python 2.4
86
87 Version 2.3
88 -----------
89 (3000 Pythons, released on February 10th 2010)
90
91 - fixes issue with code generator that causes unbound variables
92   to be generated if set was used in if-blocks and other small
93   identifier problems.
94 - include tags are now able to select between multiple templates
95   and take the first that exists, if a list of templates is
96   given.
97 - fixed a problem with having call blocks in outer scopes that
98   have an argument that is also used as local variable in an
99   inner frame (#360).
100 - greatly improved error message reporting (#339)
101 - implicit tuple expressions can no longer be totally empty.
102   This change makes ``{% if %}...{% endif %}`` a syntax error
103   now. (#364)
104 - added support for translator comments if extracted via babel.
105 - added with-statement extension.
106 - experimental Python 3 support.
107
108 Version 2.2.1
109 -------------
110 (bugfix release, released on September 14th 2009)
111
112 - fixes some smaller problems for Jinja2 on Jython.
113
114 Version 2.2
115 -----------
116 (codename Kong, released on September 13th 2009)
117
118 - Include statements can now be marked with ``ignore missing`` to skip
119   non existing templates.
120 - Priority of `not` raised.  It's now possible to write `not foo in bar`
121   as an alias to `foo not in bar` like in python.  Previously the grammar
122   required parentheses (`not (foo in bar)`) which was odd.
123 - Fixed a bug that caused syntax errors when defining macros or using the
124   `{% call %}` tag inside loops.
125 - Fixed a bug in the parser that made ``{{ foo[1, 2] }}`` impossible.
126 - Made it possible to refer to names from outer scopes in included templates
127   that were unused in the callers frame (#327)
128 - Fixed a bug that caused internal errors if names where used as iteration
129   variable and regular variable *after* the loop if that variable was unused
130   *before* the loop.  (#331)
131 - Added support for optional `scoped` modifier to blocks.
132 - Added support for line-comments.
133 - Added the `meta` module.
134 - Renamed (undocumented) attribute "overlay" to "overlayed" on the
135   environment because it was clashing with a method of the same name.
136 - speedup extension is now disabled by default.
137
138 Version 2.1.1
139 -------------
140 (Bugfix release)
141
142 - Fixed a translation error caused by looping over empty recursive loops.
143
144 Version 2.1
145 -----------
146 (codename Yasuzō, released on November 23rd 2008)
147
148 - fixed a bug with nested loops and the special loop variable.  Before the
149   change an inner loop overwrote the loop variable from the outer one after
150   iteration.
151
152 - fixed a bug with the i18n extension that caused the explicit pluralization
153   block to look up the wrong variable.
154
155 - fixed a limitation in the lexer that made ``{{ foo.0.0 }}`` impossible.
156
157 - index based subscribing of variables with a constant value returns an
158   undefined object now instead of raising an index error.  This was a bug
159   caused by eager optimizing.
160
161 - the i18n extension looks up `foo.ugettext` now followed by `foo.gettext`
162   if an translations object is installed.  This makes dealing with custom
163   translations classes easier.
164
165 - fixed a confusing behavior with conditional extending.  loops were partially
166   executed under some conditions even though they were not part of a visible
167   area.
168
169 - added `sort` filter that works like `dictsort` but for arbitrary sequences.
170
171 - fixed a bug with empty statements in macros.
172
173 - implemented a bytecode cache system.  (:ref:`bytecode-cache`)
174
175 - the template context is now weakref-able
176
177 - inclusions and imports "with context" forward all variables now, not only
178   the initial context.
179
180 - added a cycle helper called `cycler`.
181
182 - added a joining helper called `joiner`.
183
184 - added a `compile_expression` method to the environment that allows compiling
185   of Jinja expressions into callable Python objects.
186
187 - fixed an escaping bug in urlize
188
189 Version 2.0
190 -----------
191 (codename jinjavitus, released on July 17th 2008)
192
193 - the subscribing of objects (looking up attributes and items) changed from
194   slightly.  It's now possible to give attributes or items a higher priority
195   by either using dot-notation lookup or the bracket syntax.  This also
196   changed the AST slightly.  `Subscript` is gone and was replaced with
197   :class:`~jinja2.nodes.Getitem` and :class:`~jinja2.nodes.Getattr`.
198
199   For more information see :ref:`the implementation details <notes-on-subscriptions>`.
200
201 - added support for preprocessing and token stream filtering for extensions.
202   This would allow extensions to allow simplified gettext calls in template
203   data and something similar.
204
205 - added :meth:`jinja2.environment.TemplateStream.dump`.
206
207 - added missing support for implicit string literal concatenation.
208   ``{{ "foo" "bar" }}`` is equivalent to ``{{ "foobar" }}``
209
210 - `else` is optional for conditional expressions.  If not given it evaluates
211   to `false`.
212
213 - improved error reporting for undefined values by providing a position.
214
215 - `filesizeformat` filter uses decimal prefixes now per default and can be
216   set to binary mode with the second parameter.
217
218 - fixed bug in finalizer
219
220 Version 2.0rc1
221 --------------
222 (no codename, released on June 9th 2008)
223
224 - first release of Jinja2