6 (codename to be selected, release date to be announced)
8 - Choice and prefix loaders now dispatch source and template lookup
9 separately in order to work in combination with module loaders as
14 (codename Convolution, released on July 24th 2011)
16 - internal attributes now raise an internal attribute error now instead
17 of returning an undefined. This fixes problems when passing undefined
18 objects to Python semantics expecting APIs.
19 - traceback support now works properly for PyPy. (Tested with 1.4)
20 - implemented operator intercepting for sandboxed environments. This
21 allows application developers to disable builtin operators for better
22 security. (For instance limit the mathematical operators to actual
23 integers instead of longs)
24 - groupby filter now supports dotted notation for grouping by attributes
26 - scoped blocks now properly treat toplevel assignments and imports.
27 Previously an import suddenly "disappeared" in a scoped block.
28 - automatically detect newer Python interpreter versions before loading code
29 from bytecode caches to prevent segfaults on invalid opcodes. The segfault
30 in earlier Jinja2 versions here was not a Jinja2 bug but a limitation in
31 the underlying Python interpreter. If you notice Jinja2 segfaulting in
32 earlier versions after an upgrade of the Python interpreter you don't have
33 to upgrade, it's enough to flush the bytecode cache. This just no longer
34 makes this necessary, Jinja2 will automatically detect these cases now.
35 - the sum filter can now sum up values by attribute. This is a backwards
36 incompatible change. The argument to the filter previously was the
37 optional starting index which defaultes to zero. This now became the
38 second argument to the function because it's rarely used.
39 - like sum, sort now also makes it possible to order items by attribute.
40 - like sum and sort, join now also is able to join attributes of objects
42 - the internal eval context now has a reference to the environment.
43 - added a mapping test to see if an object is a dict or an object with
48 (re-release of 2.5.4 with built documentation removed for filesize.
49 Released on October 18th 2010)
51 - built documentation is no longer part of release.
55 (bugfix release, released on October 17th 2010)
57 - Fixed extensions not loading properly with overlays.
58 - Work around a bug in cpython for the debugger that causes segfaults
59 on 64bit big-endian architectures.
63 (bugfix release, released on October 17th 2010)
65 - fixed an operator precedence error introduced in 2.5.2. Statements
66 like "-foo.bar" had their implicit parentheses applied around the
67 first part of the expression ("(-foo).bar") instead of the more
72 (bugfix release, released on August 18th 2010)
74 - improved setup.py script to better work with assumptions people
75 might still have from it (``--with-speedups``).
76 - fixed a packaging error that excluded the new debug support.
80 (bugfix release, released on August 17th 2010)
82 - StopIteration exceptions raised by functions called from templates
83 are now intercepted and converted to undefineds. This solves a
84 lot of debugging grief. (StopIteration is used internally to
85 abort template execution)
86 - improved performance of macro calls slightly.
87 - babel extraction can now properly extract newstyle gettext calls.
88 - using the variable `num` in newstyle gettext for something else
89 than the pluralize count will no longer raise a :exc:`KeyError`.
90 - removed builtin markup class and switched to markupsafe. For backwards
91 compatibility the pure Python implementation still exists but is
92 pulled from markupsafe by the Jinja2 developers. The debug support
93 went into a separate feature called "debugsupport" and is disabled
94 by default because it is only relevant for Python 2.4
95 - fixed an issue with unary operators having the wrong precendence.
99 (codename Incoherence, relased on May 29th 2010)
101 - improved the sort filter (should have worked like this for a
102 long time) by adding support for case insensitive searches.
103 - fixed a bug for getattribute constant folding.
104 - support for newstyle gettext translations which result in a
105 nicer in-template user interface and more consistent
106 catalogs. (:ref:`newstyle-gettext`)
107 - it's now possible to register extensions after an environment
112 (bugfix release, released on April 20th 2010)
114 - fixed an error reporting bug for undefineds.
118 (codename Correlation, released on April 13th 2010)
120 - the environment template loading functions now transparently
121 pass through a template object if it was passed to it. This
122 makes it possible to import or extend from a template object
123 that was passed to the template.
124 - added a :class:`ModuleLoader` that can load templates from
125 precompiled sources. The environment now features a method
126 to compile the templates from a configured loader into a zip
128 - the _speedups C extension now supports Python 3.
129 - added support for autoescaping toggling sections and support
130 for evaluation contexts (:ref:`eval-context`).
131 - extensions have a priority now.
135 (bugfix release, released on February 19th 2010)
137 - fixed an error reporting bug on all python versions
138 - fixed an error reporting bug on Python 2.4
142 (3000 Pythons, released on February 10th 2010)
144 - fixes issue with code generator that causes unbound variables
145 to be generated if set was used in if-blocks and other small
147 - include tags are now able to select between multiple templates
148 and take the first that exists, if a list of templates is
150 - fixed a problem with having call blocks in outer scopes that
151 have an argument that is also used as local variable in an
153 - greatly improved error message reporting (#339)
154 - implicit tuple expressions can no longer be totally empty.
155 This change makes ``{% if %}...{% endif %}`` a syntax error
157 - added support for translator comments if extracted via babel.
158 - added with-statement extension.
159 - experimental Python 3 support.
163 (bugfix release, released on September 14th 2009)
165 - fixes some smaller problems for Jinja2 on Jython.
169 (codename Kong, released on September 13th 2009)
171 - Include statements can now be marked with ``ignore missing`` to skip
172 non existing templates.
173 - Priority of `not` raised. It's now possible to write `not foo in bar`
174 as an alias to `foo not in bar` like in python. Previously the grammar
175 required parentheses (`not (foo in bar)`) which was odd.
176 - Fixed a bug that caused syntax errors when defining macros or using the
177 `{% call %}` tag inside loops.
178 - Fixed a bug in the parser that made ``{{ foo[1, 2] }}`` impossible.
179 - Made it possible to refer to names from outer scopes in included templates
180 that were unused in the callers frame (#327)
181 - Fixed a bug that caused internal errors if names where used as iteration
182 variable and regular variable *after* the loop if that variable was unused
183 *before* the loop. (#331)
184 - Added support for optional `scoped` modifier to blocks.
185 - Added support for line-comments.
186 - Added the `meta` module.
187 - Renamed (undocumented) attribute "overlay" to "overlayed" on the
188 environment because it was clashing with a method of the same name.
189 - speedup extension is now disabled by default.
195 - Fixed a translation error caused by looping over empty recursive loops.
199 (codename Yasuzō, released on November 23rd 2008)
201 - fixed a bug with nested loops and the special loop variable. Before the
202 change an inner loop overwrote the loop variable from the outer one after
205 - fixed a bug with the i18n extension that caused the explicit pluralization
206 block to look up the wrong variable.
208 - fixed a limitation in the lexer that made ``{{ foo.0.0 }}`` impossible.
210 - index based subscribing of variables with a constant value returns an
211 undefined object now instead of raising an index error. This was a bug
212 caused by eager optimizing.
214 - the i18n extension looks up `foo.ugettext` now followed by `foo.gettext`
215 if an translations object is installed. This makes dealing with custom
216 translations classes easier.
218 - fixed a confusing behavior with conditional extending. loops were partially
219 executed under some conditions even though they were not part of a visible
222 - added `sort` filter that works like `dictsort` but for arbitrary sequences.
224 - fixed a bug with empty statements in macros.
226 - implemented a bytecode cache system. (:ref:`bytecode-cache`)
228 - the template context is now weakref-able
230 - inclusions and imports "with context" forward all variables now, not only
233 - added a cycle helper called `cycler`.
235 - added a joining helper called `joiner`.
237 - added a `compile_expression` method to the environment that allows compiling
238 of Jinja expressions into callable Python objects.
240 - fixed an escaping bug in urlize
244 (codename jinjavitus, released on July 17th 2008)
246 - the subscribing of objects (looking up attributes and items) changed from
247 slightly. It's now possible to give attributes or items a higher priority
248 by either using dot-notation lookup or the bracket syntax. This also
249 changed the AST slightly. `Subscript` is gone and was replaced with
250 :class:`~jinja2.nodes.Getitem` and :class:`~jinja2.nodes.Getattr`.
252 For more information see :ref:`the implementation details <notes-on-subscriptions>`.
254 - added support for preprocessing and token stream filtering for extensions.
255 This would allow extensions to allow simplified gettext calls in template
256 data and something similar.
258 - added :meth:`jinja2.environment.TemplateStream.dump`.
260 - added missing support for implicit string literal concatenation.
261 ``{{ "foo" "bar" }}`` is equivalent to ``{{ "foobar" }}``
263 - `else` is optional for conditional expressions. If not given it evaluates
266 - improved error reporting for undefined values by providing a position.
268 - `filesizeformat` filter uses decimal prefixes now per default and can be
269 set to binary mode with the second parameter.
271 - fixed bug in finalizer
275 (no codename, released on June 9th 2008)
277 - first release of Jinja2