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