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