blob: 43f5e8ff08cba51ff07f28ca29e5fee8cc4ba57f [file] [log] [blame]
Armin Ronacher9d472df2008-05-04 19:56:34 +02001Jinja2 Changelog
Armin Ronacher5e58d432008-11-23 15:45:13 +01002================
3
Armin Ronacher6fa6cb02011-09-13 23:27:41 +02004Version 2.7
5-----------
6(codename to be selected, release date to be announced)
7
8- Choice and prefix loaders now dispatch source and template lookup
9 separately in order to work in combination with module loaders as
10 advertised.
Armin Ronacherb1b7b082011-10-05 09:48:05 +020011- Fixed filesizeformat.
Armin Ronacher11619152011-12-15 11:50:27 +010012- Added a non-silent option for babel extraction.
Armin Ronacher51454012012-01-07 17:47:56 +010013- Added `urlencode` filter that automatically quotes values for
Armin Ronacher1d4c6382012-01-07 17:46:40 +010014 URL safe usage with utf-8 as only supported encoding. If applications
15 want to change this encoding they can override the filter.
W. Trevor King7e912c62013-01-11 08:23:24 -050016- Added `keep-trailing-newline` configuration to environments and
17 templates to optionally preserve the final trailing newline.
Armin Ronacher99b22852012-01-25 00:42:54 +010018- Accessing `last` on the loop context no longer causes the iterator
19 to be consumed into a list.
Armin Ronacher6fa6cb02011-09-13 23:27:41 +020020
Armin Ronacher44e1f562010-10-17 16:43:07 +020021Version 2.6
22-----------
Armin Ronacher397b42e2011-07-24 21:46:07 +020023(codename Convolution, released on July 24th 2011)
Armin Ronacher44e1f562010-10-17 16:43:07 +020024
Armin Ronacher6a3e95d2010-11-19 13:51:38 +010025- internal attributes now raise an internal attribute error now instead
26 of returning an undefined. This fixes problems when passing undefined
27 objects to Python semantics expecting APIs.
Armin Ronacher1b6425f2010-11-29 12:24:57 +010028- traceback support now works properly for PyPy. (Tested with 1.4)
Armin Ronachera9195382010-11-29 13:21:57 +010029- implemented operator intercepting for sandboxed environments. This
30 allows application developers to disable builtin operators for better
31 security. (For instance limit the mathematical operators to actual
32 integers instead of longs)
Armin Ronacher9573b662010-12-21 00:44:34 +010033- groupby filter now supports dotted notation for grouping by attributes
34 of attributes.
Simon Sapin8b5af892011-07-25 00:25:58 -070035- scoped blocks now properly treat toplevel assignments and imports.
Armin Ronacher5f3d6612010-12-22 23:22:08 +010036 Previously an import suddenly "disappeared" in a scoped block.
Armin Ronacher51db6c92011-01-11 20:53:42 +010037- automatically detect newer Python interpreter versions before loading code
38 from bytecode caches to prevent segfaults on invalid opcodes. The segfault
39 in earlier Jinja2 versions here was not a Jinja2 bug but a limitation in
40 the underlying Python interpreter. If you notice Jinja2 segfaulting in
41 earlier versions after an upgrade of the Python interpreter you don't have
42 to upgrade, it's enough to flush the bytecode cache. This just no longer
43 makes this necessary, Jinja2 will automatically detect these cases now.
Armin Ronacherdd8afa22011-01-24 00:57:58 +010044- the sum filter can now sum up values by attribute. This is a backwards
45 incompatible change. The argument to the filter previously was the
46 optional starting index which defaultes to zero. This now became the
47 second argument to the function because it's rarely used.
Armin Ronacherb7e75b82011-01-24 01:05:47 +010048- like sum, sort now also makes it possible to order items by attribute.
Armin Ronacher3383e1c2011-01-24 01:13:51 +010049- like sum and sort, join now also is able to join attributes of objects
50 as string.
51- the internal eval context now has a reference to the environment.
Armin Ronacheree352ec2011-05-24 16:40:23 +020052- added a mapping test to see if an object is a dict or an object with
53 a similar interface.
Armin Ronacher6a3e95d2010-11-19 13:51:38 +010054
Armin Ronacher11165732010-10-18 14:38:03 +020055Version 2.5.5
56-------------
57(re-release of 2.5.4 with built documentation removed for filesize.
58 Released on October 18th 2010)
59
60- built documentation is no longer part of release.
61
Armin Ronachere104f302010-10-17 16:42:26 +020062Version 2.5.4
63-------------
Armin Ronacher75cd04f2010-10-17 16:48:18 +020064(bugfix release, released on October 17th 2010)
Armin Ronachere104f302010-10-17 16:42:26 +020065
Armin Ronacher7b93e7e2010-10-17 16:44:19 +020066- Fixed extensions not loading properly with overlays.
Armin Ronacherda8d68f2010-10-17 16:47:06 +020067- Work around a bug in cpython for the debugger that causes segfaults
68 on 64bit big-endian architectures.
Armin Ronacher7b93e7e2010-10-17 16:44:19 +020069
Armin Ronacher613912d2010-10-17 15:53:59 +020070Version 2.5.3
71-------------
Armin Ronacherf858d622010-10-17 15:56:49 +020072(bugfix release, released on October 17th 2010)
Armin Ronacher613912d2010-10-17 15:53:59 +020073
74- fixed an operator precedence error introduced in 2.5.2. Statements
75 like "-foo.bar" had their implicit parentheses applied around the
76 first part of the expression ("(-foo).bar") instead of the more
77 correct "-(foo.bar)".
78
Armin Ronacher46036942010-08-18 11:10:50 +020079Version 2.5.2
80-------------
81(bugfix release, released on August 18th 2010)
82
83- improved setup.py script to better work with assumptions people
84 might still have from it (``--with-speedups``).
85- fixed a packaging error that excluded the new debug support.
86
Armin Ronacher02ea18a2010-07-01 11:30:42 +020087Version 2.5.1
88-------------
Armin Ronacherdd0039c2010-08-17 12:39:40 +020089(bugfix release, released on August 17th 2010)
Armin Ronacher9fb60422010-06-05 14:41:34 +020090
91- StopIteration exceptions raised by functions called from templates
92 are now intercepted and converted to undefineds. This solves a
93 lot of debugging grief. (StopIteration is used internally to
94 abort template execution)
95- improved performance of macro calls slightly.
Armin Ronacher4f77a302010-07-01 12:15:39 +020096- babel extraction can now properly extract newstyle gettext calls.
97- using the variable `num` in newstyle gettext for something else
98 than the pluralize count will no longer raise a :exc:`KeyError`.
Armin Ronacher10c34da2010-08-17 12:10:27 +020099- removed builtin markup class and switched to markupsafe. For backwards
100 compatibility the pure Python implementation still exists but is
101 pulled from markupsafe by the Jinja2 developers. The debug support
102 went into a separate feature called "debugsupport" and is disabled
103 by default because it is only relevant for Python 2.4
Armin Ronacher2ee64bc2010-08-17 12:36:38 +0200104- fixed an issue with unary operators having the wrong precendence.
Armin Ronacher9fb60422010-06-05 14:41:34 +0200105
Armin Ronacher4da90342010-05-29 17:35:10 +0200106Version 2.5
107-----------
108(codename Incoherence, relased on May 29th 2010)
Armin Ronacher73795492010-05-23 23:07:08 +0200109
110- improved the sort filter (should have worked like this for a
111 long time) by adding support for case insensitive searches.
112- fixed a bug for getattribute constant folding.
Armin Ronacher4da90342010-05-29 17:35:10 +0200113- support for newstyle gettext translations which result in a
114 nicer in-template user interface and more consistent
Armin Ronacherffaa2e72010-05-29 20:57:16 +0200115 catalogs. (:ref:`newstyle-gettext`)
116- it's now possible to register extensions after an environment
117 was created.
Armin Ronacher2ec1d2c2010-04-20 13:46:08 +0200118
Armin Ronacher800ac7f2010-04-20 13:45:11 +0200119Version 2.4.1
120-------------
121(bugfix release, released on April 20th 2010)
122
123- fixed an error reporting bug for undefineds.
Armin Ronacher27387aa2010-04-13 00:56:34 +0200124
Armin Ronacher559025a2010-02-10 02:23:56 +0100125Version 2.4
126-----------
Armin Ronacher30b39cd2010-04-13 00:54:14 +0200127(codename Correlation, released on April 13th 2010)
Armin Ronacher559025a2010-02-10 02:23:56 +0100128
Armin Ronacher9165d3e2010-02-16 17:35:59 +0100129- the environment template loading functions now transparently
130 pass through a template object if it was passed to it. This
131 makes it possible to import or extend from a template object
132 that was passed to the template.
Armin Ronacher64b08a02010-03-12 03:17:41 +0100133- added a :class:`ModuleLoader` that can load templates from
134 precompiled sources. The environment now features a method
135 to compile the templates from a configured loader into a zip
136 file or folder.
Georg Brandl05be95a2010-02-21 17:50:32 +0100137- the _speedups C extension now supports Python 3.
Armin Ronacherfe150f32010-03-15 02:42:41 +0100138- added support for autoescaping toggling sections and support
139 for evaluation contexts (:ref:`eval-context`).
Armin Ronacher7d29ec62010-04-12 14:04:35 +0200140- extensions have a priority now.
Georg Brandl05be95a2010-02-21 17:50:32 +0100141
Armin Ronacher549f6b52010-02-19 11:09:28 +0100142Version 2.3.1
143-------------
144(bugfix release, released on February 19th 2010)
145
146- fixed an error reporting bug on all python versions
147- fixed an error reporting bug on Python 2.4
148
Armin Ronacher31bbd9e2010-01-14 00:41:30 +0100149Version 2.3
150-----------
Armin Ronacher559025a2010-02-10 02:23:56 +0100151(3000 Pythons, released on February 10th 2010)
Armin Ronacherf1c421d2009-09-17 00:48:41 +0200152
153- fixes issue with code generator that causes unbound variables
Armin Ronacher31bbd9e2010-01-14 00:41:30 +0100154 to be generated if set was used in if-blocks and other small
155 identifier problems.
156- include tags are now able to select between multiple templates
157 and take the first that exists, if a list of templates is
158 given.
Armin Ronachere0016f52010-01-14 01:20:46 +0100159- fixed a problem with having call blocks in outer scopes that
160 have an argument that is also used as local variable in an
Armin Ronachere614e882010-02-06 15:04:46 +0100161 inner frame (#360).
Armin Ronacher5dcb7242010-02-06 14:01:26 +0100162- greatly improved error message reporting (#339)
Armin Ronachere614e882010-02-06 15:04:46 +0100163- implicit tuple expressions can no longer be totally empty.
164 This change makes ``{% if %}...{% endif %}`` a syntax error
165 now. (#364)
Armin Ronacher531578d2010-02-06 16:34:54 +0100166- added support for translator comments if extracted via babel.
Armin Ronacher9b4cc9f2010-02-07 03:55:15 +0100167- added with-statement extension.
Armin Ronacher0319c662010-02-09 02:09:10 +0100168- experimental Python 3 support.
Armin Ronacherf1c421d2009-09-17 00:48:41 +0200169
Armin Ronacher9e6400e2009-09-14 14:58:01 -0700170Version 2.2.1
171-------------
172(bugfix release, released on September 14th 2009)
173
174- fixes some smaller problems for Jinja2 on Jython.
175
Armin Ronacher37f58ce2008-12-27 13:10:38 +0100176Version 2.2
177-----------
Armin Ronacher2593fd52009-09-13 00:23:57 -0700178(codename Kong, released on September 13th 2009)
Armin Ronacher37f58ce2008-12-27 13:10:38 +0100179
180- Include statements can now be marked with ``ignore missing`` to skip
181 non existing templates.
Armin Ronacherd89f0f32009-02-04 18:57:27 +0100182- Priority of `not` raised. It's now possible to write `not foo in bar`
183 as an alias to `foo not in bar` like in python. Previously the grammar
184 required parentheses (`not (foo in bar)`) which was odd.
Armin Ronacher330fbc02009-02-04 19:13:58 +0100185- Fixed a bug that caused syntax errors when defining macros or using the
186 `{% call %}` tag inside loops.
Armin Ronacheree2d3c42009-02-05 23:13:15 +0100187- Fixed a bug in the parser that made ``{{ foo[1, 2] }}`` impossible.
Armin Ronacher7887a8c2009-02-08 19:11:44 +0100188- Made it possible to refer to names from outer scopes in included templates
189 that were unused in the callers frame (#327)
Armin Ronacher271a0eb2009-02-11 22:49:08 +0100190- Fixed a bug that caused internal errors if names where used as iteration
191 variable and regular variable *after* the loop if that variable was unused
192 *before* the loop. (#331)
Armin Ronacher74a0cd92009-02-19 15:56:53 +0100193- Added support for optional `scoped` modifier to blocks.
Armin Ronacher59b6bd52009-03-30 21:00:16 +0200194- Added support for line-comments.
Armin Ronacher63cf9b82009-07-26 10:33:36 +0200195- Added the `meta` module.
Armin Ronacher98c1fca2009-09-13 00:46:59 -0700196- Renamed (undocumented) attribute "overlay" to "overlayed" on the
197 environment because it was clashing with a method of the same name.
Armin Ronachera93df482009-09-13 10:26:39 -0700198- speedup extension is now disabled by default.
Armin Ronacher37f58ce2008-12-27 13:10:38 +0100199
Armin Ronachercebd8382008-12-25 18:33:46 +0100200Version 2.1.1
201-------------
202(Bugfix release)
203
204- Fixed a translation error caused by looping over empty recursive loops.
Armin Ronachera22a53d2007-03-31 20:44:33 +0200205
Armin Ronacher237cdde2008-07-17 23:34:44 +0200206Version 2.1
207-----------
Armin Ronacher7357f062008-11-23 12:55:23 +0100208(codename Yasuzō, released on November 23rd 2008)
Armin Ronacher237cdde2008-07-17 23:34:44 +0200209
Armin Ronacherff53c782008-08-13 18:55:50 +0200210- fixed a bug with nested loops and the special loop variable. Before the
211 change an inner loop overwrote the loop variable from the outer one after
212 iteration.
213
Armin Ronacher4720c362008-09-06 16:15:38 +0200214- fixed a bug with the i18n extension that caused the explicit pluralization
215 block to look up the wrong variable.
216
Armin Ronachercb1b97f2008-09-10 14:03:53 +0200217- fixed a limitation in the lexer that made ``{{ foo.0.0 }}`` impossible.
218
Armin Ronacher5c3c4702008-09-12 23:12:49 +0200219- index based subscribing of variables with a constant value returns an
220 undefined object now instead of raising an index error. This was a bug
221 caused by eager optimizing.
222
Armin Ronacher32133552008-09-15 14:35:01 +0200223- the i18n extension looks up `foo.ugettext` now followed by `foo.gettext`
224 if an translations object is installed. This makes dealing with custom
225 translations classes easier.
226
227- fixed a confusing behavior with conditional extending. loops were partially
228 executed under some conditions even though they were not part of a visible
229 area.
230
Armin Ronacher205bae52008-09-17 13:57:45 +0200231- added `sort` filter that works like `dictsort` but for arbitrary sequences.
232
Armin Ronacherf40c8842008-09-17 18:51:26 +0200233- fixed a bug with empty statements in macros.
234
Armin Ronachera816bf42008-09-17 21:28:01 +0200235- implemented a bytecode cache system. (:ref:`bytecode-cache`)
236
Armin Ronacherdcc217c2008-09-18 18:38:58 +0200237- the template context is now weakref-able
238
Armin Ronacher673aa882008-10-04 18:06:57 +0200239- inclusions and imports "with context" forward all variables now, not only
240 the initial context.
241
Armin Ronacherd34eb122008-10-13 23:47:51 +0200242- added a cycle helper called `cycler`.
243
244- added a joining helper called `joiner`.
Armin Ronacherccae0552008-10-05 23:08:58 +0200245
Armin Ronacherba6e25a2008-11-02 15:58:14 +0100246- added a `compile_expression` method to the environment that allows compiling
247 of Jinja expressions into callable Python objects.
248
Armin Ronacherd9342dc2008-11-17 00:35:30 +0100249- fixed an escaping bug in urlize
250
Armin Ronacher9d472df2008-05-04 19:56:34 +0200251Version 2.0
Armin Ronacherc689cf12007-11-18 11:23:58 +0100252-----------
Armin Ronacherbf943942008-07-17 23:32:00 +0200253(codename jinjavitus, released on July 17th 2008)
Armin Ronacherc689cf12007-11-18 11:23:58 +0100254
Armin Ronacher6dc6f292008-06-12 08:50:07 +0200255- the subscribing of objects (looking up attributes and items) changed from
256 slightly. It's now possible to give attributes or items a higher priority
257 by either using dot-notation lookup or the bracket syntax. This also
258 changed the AST slightly. `Subscript` is gone and was replaced with
259 :class:`~jinja2.nodes.Getitem` and :class:`~jinja2.nodes.Getattr`.
260
Armin Ronacher53db78e2008-06-25 20:46:22 +0200261 For more information see :ref:`the implementation details <notes-on-subscriptions>`.
Armin Ronacher6dc6f292008-06-12 08:50:07 +0200262
Armin Ronacher9ad96e72008-06-13 22:44:01 +0200263- added support for preprocessing and token stream filtering for extensions.
264 This would allow extensions to allow simplified gettext calls in template
265 data and something similar.
266
Armin Ronacher74b51062008-06-17 11:28:59 +0200267- added :meth:`jinja2.environment.TemplateStream.dump`.
268
Armin Ronacher547d0b62008-07-04 16:35:10 +0200269- added missing support for implicit string literal concatenation.
Armin Ronacher4778bda2008-06-22 12:48:37 +0200270 ``{{ "foo" "bar" }}`` is equivalent to ``{{ "foobar" }}``
271
Armin Ronacher547d0b62008-07-04 16:35:10 +0200272- `else` is optional for conditional expressions. If not given it evaluates
273 to `false`.
274
275- improved error reporting for undefined values by providing a position.
276
Armin Ronacher76f9aa42008-07-12 02:08:29 +0200277- `filesizeformat` filter uses decimal prefixes now per default and can be
278 set to binary mode with the second parameter.
279
Armin Ronacher665bfb82008-07-14 13:41:46 +0200280- fixed bug in finalizer
281
Armin Ronacher6dc6f292008-06-12 08:50:07 +0200282Version 2.0rc1
283--------------
Armin Ronacher0fad0312008-06-27 23:19:09 +0200284(no codename, released on June 9th 2008)
Armin Ronacher6dc6f292008-06-12 08:50:07 +0200285
286- first release of Jinja2