-Jinja Changelog
-===============
+Jinja2 Changelog
+================
-Version 1.3
+Version 2.4
-----------
-(codename to be selected, release around February 2007)
+(codename to be selected, release date unknown)
-Version 1.2
------------
-(codename to be hatsuyuki, released Nov 17th 2007)
-
-.. admonition:: Backwards Incompatible Changes
-
- - `call` is a keyword now
- - the internal parser AST changed
- - `extends` must be the first tag in a template
- - the tuple literal yields tuples now, instead of lists.
-
-- environments now have a `translator_factory` parameter that allows
- to change the translator without subclassing the environment.
-
-- fixed bug in buffet plugin regarding the package loader
-
-- once again improved debugger.
-
-- added `groupby` filter.
-
-- added `sameas` test function.
-
-- standalone parser. Jinja does not use the python parser any more and will
- continue having the same semantics in any future python versions. This
- was done in order to simplify updating Jinja to 2.6 and 3.0 and to support
- non python syntax.
-
-- added support for ``expr1 if test else expr2`` (conditional expressions)
-
-- ``foo.0`` as alias for ``foo[0]`` is possible now. This is mainly for
- django compatibility.
-
-- the filter operators has a much higher priority now which makes it
- possible to do ``foo|filter + bar|filter``.
-
-- new AST. the return value of `Environment.parse` is now a Jinja AST and not
- a Jinja-Python AST. This is also the only backwards incompatible change but
- should not affect many users because this feature is more or less
- undocumented and has few use cases.
-
-- tuple syntax returns tuples now and not lists any more.
-
-- the print directive and ``{{ variable }}`` syntax now accepts and implicit
- tuple like the `for` and `cycle` tags. (``{{ 1, 2 }}`` is an implicit alias
- for ``{{ (1, 2) }}` like ``{% for a, b in seq %}`` is for
- ``{% for (a, b) in seq %}``.
-
-- tests called with *one* parameter don't need parentheses. This gives a more
- natural syntax for the `sameas` test and some others:
- ``{{ foo is sameas bar }}`` instead of ``{{ foo is sameas(bar) }}``. If you
- however want to pass more than one argument you have to use parentheses
- because ``{{ foo is sometest bar, baz }}`` is handled as
- ``{{ (foo is sometest(bar), baz) }}``, so as tuple expression.
-
-- removed support for octal character definitions in strings such as
- ``'\14'``, use ``'\x0c'`` now.
-
-- added regular expression literal. ``@/expr/flags`` equals
- ``re.compile(r'(?flags)expr')``. This is useful for the `matching` test and
- probably some others.
-
-- added set literal. We do not use python3's {1, 2} syntax because
- this conflicts with the dict literal. To be compatible with the regex
- literal we use ``@(1, 2)`` instead.
-
-- fixed bug in `get_attribute` that disallowed retreiving attributes of objects
- without a `__class__` such as `_sre.SRE_Pattern`.
-
-- addded `django.contrib.jinja` which provides advanced support for django.
- (thanks Bryan McLemore)
-
-- debugger is now able to rewrite the whole traceback, not only the first
- frame. (requires the optional debugger c module which is compiled
- automatically on installation if possible)
-
-- if the set that is postfixed with a bang (!) it acts like the python 3
- "nonlocal" keyword. This means that you can now override variables
- defined in the outer scope from within a loop.
-
-- ``foo ~ bar`` is now a simpler alternative to ``foo|string + bar|string``
+- the environment template loading functions now transparently
+ pass through a template object if it was passed to it. This
+ makes it possible to import or extend from a template object
+ that was passed to the template.
+- added a :class:`ModuleLoader` that can load templates from
+ precompiled sources. The environment now features a method
+ to compile the templates from a configured loader into a zip
+ file or folder.
-- `PackageLoader` can now work without pkg_resources too
+- the _speedups C extension now supports Python 3.
-- added `getattribute` and `getitem` filter.
+Version 2.3.1
+-------------
+(bugfix release, released on February 19th 2010)
-- added support for the `pretty` library.
+- fixed an error reporting bug on all python versions
+- fixed an error reporting bug on Python 2.4
-- changed the way the `MemcachedLoaderMixin` creates the class so that it's
- possible to hook your own client in.
-
-
-Version 1.1
+Version 2.3
-----------
-(codename: sinka, released Jun 1, 2007)
-
-- blocks now support ``{{ super() }}`` to render the parent output.
-
-- debugging system improved, smaller filesize for the cached files.
- Debugging works now well for any module using linecache.
-
-- ``{{ debug() }}`` can now be used to get a list of filters and
- tags.
-
-- the template lexer keeps not track of brace, parenthesis and
- bracket balance in order to not break variable tags apart if they
- are configured to look like this: ``${expr}``. This also fixes
- the problem with nested dicts in variable expressions.
-
-- it's now possible to configure the variable blocks to look the
- same as the block delimiters. Thus you can set the syntax to something
- like ``{ / }`` for both blocks and variables.
-
-- added whitespace management system for the template designer.
-
-- some small bugfixes.
-
-- improved security system regarding function calls and variable
- assignment in for loops.
-
-- added `lipsum` function to generate random text.
-
-- strings without unicode characters are processed as binary strings now
- to workaround problems with `datetime.strftime` which only accepts
- binary strings.
-
-- it's now possible to use newlines in string literals
-
-- developer friendly traceback is now toggleable
-
-- the variable failure is now pluggable by replacing the undefined
- singleton for an environment instance
-
-- fixed issue with old-style classes not implementing `__getitem__`
- (thanks to Axel Böhm for discovering that bug)
-
-- added a bunch of new docstrings to the Jinja classes. Makes fun now to
- use pydoc :-)
-
-- fixed severe memcaching bug. Formerly it wasn't possible to use memcaching
- without enabling disk cache.
-
-- fixed a bug that allowed users to override the special names `_`, `true` etc.
+(3000 Pythons, released on February 10th 2010)
+
+- fixes issue with code generator that causes unbound variables
+ to be generated if set was used in if-blocks and other small
+ identifier problems.
+- include tags are now able to select between multiple templates
+ and take the first that exists, if a list of templates is
+ given.
+- fixed a problem with having call blocks in outer scopes that
+ have an argument that is also used as local variable in an
+ inner frame (#360).
+- greatly improved error message reporting (#339)
+- implicit tuple expressions can no longer be totally empty.
+ This change makes ``{% if %}...{% endif %}`` a syntax error
+ now. (#364)
+- added support for translator comments if extracted via babel.
+- added with-statement extension.
+- experimental Python 3 support.
+
+Version 2.2.1
+-------------
+(bugfix release, released on September 14th 2009)
+
+- fixes some smaller problems for Jinja2 on Jython.
+
+Version 2.2
+-----------
+(codename Kong, released on September 13th 2009)
+
+- Include statements can now be marked with ``ignore missing`` to skip
+ non existing templates.
+- Priority of `not` raised. It's now possible to write `not foo in bar`
+ as an alias to `foo not in bar` like in python. Previously the grammar
+ required parentheses (`not (foo in bar)`) which was odd.
+- Fixed a bug that caused syntax errors when defining macros or using the
+ `{% call %}` tag inside loops.
+- Fixed a bug in the parser that made ``{{ foo[1, 2] }}`` impossible.
+- Made it possible to refer to names from outer scopes in included templates
+ that were unused in the callers frame (#327)
+- Fixed a bug that caused internal errors if names where used as iteration
+ variable and regular variable *after* the loop if that variable was unused
+ *before* the loop. (#331)
+- Added support for optional `scoped` modifier to blocks.
+- Added support for line-comments.
+- Added the `meta` module.
+- Renamed (undocumented) attribute "overlay" to "overlayed" on the
+ environment because it was clashing with a method of the same name.
+- speedup extension is now disabled by default.
+
+Version 2.1.1
+-------------
+(Bugfix release)
+
+- Fixed a translation error caused by looping over empty recursive loops.
+
+Version 2.1
+-----------
+(codename Yasuzō, released on November 23rd 2008)
-- added `batch` and `slice` filters for batching or slicing sequences
+- fixed a bug with nested loops and the special loop variable. Before the
+ change an inner loop overwrote the loop variable from the outer one after
+ iteration.
-- added `sum`, `abs`, `round` and `sort` filters. This fixes #238
+- fixed a bug with the i18n extension that caused the explicit pluralization
+ block to look up the wrong variable.
-- added `striptags` and `xmlattr` filters for easier SGML/XML processing
+- fixed a limitation in the lexer that made ``{{ foo.0.0 }}`` impossible.
-- the trans tag does not need explicit naming for variables with the same
- name any more. You can now use ``{% trans foo %}`` instead of the verbose
- version ``{% trans foo=foo %}``.
+- index based subscribing of variables with a constant value returns an
+ undefined object now instead of raising an index error. This was a bug
+ caused by eager optimizing.
-- reimplemented Buffet plugin so that it works at least for pylons
+- the i18n extension looks up `foo.ugettext` now followed by `foo.gettext`
+ if an translations object is installed. This makes dealing with custom
+ translations classes easier.
-- added `Environment.get_translations_for_string`
+- fixed a confusing behavior with conditional extending. loops were partially
+ executed under some conditions even though they were not part of a visible
+ area.
-- fixed a bug in the parser that didn't unescape keyword arguments. (thanks
- to Alexey Melchakov for reporting)
+- added `sort` filter that works like `dictsort` but for arbitrary sequences.
-- You can now use the environment to just tokenize a template. This can
- be useful for syntax highlighting or other purposes.
+- fixed a bug with empty statements in macros.
-- added optional C-implementation of the context baseclass.
+- implemented a bytecode cache system. (:ref:`bytecode-cache`)
-- you can now use optional parentheses around macro defintions. Thus it's
- possible to write ``{% macro foo(a, b, c) %}`` instead of ``{% macro
- foo a, b, c %}``.
+- the template context is now weakref-able
-- additional macro arguments now end up in `varargs`.
+- inclusions and imports "with context" forward all variables now, not only
+ the initial context.
-- implemented the `{% call %}` block. `call` and `endcall` can still be used
- as identifiers until Jinja 1.3
+- added a cycle helper called `cycler`.
-- it's now possible to stream templates.
+- added a joining helper called `joiner`.
-- fixed a corner case when defining a block inside of a condition
+- added a `compile_expression` method to the environment that allows compiling
+ of Jinja expressions into callable Python objects.
-- the cached loader mixin is now able to cache multiple templates from
- different loaders in the same cache folder.
+- fixed an escaping bug in urlize
-- Translatable strings returned by ``_()`` will leave their string formatting
- signs untouched. Thanks to Stefan Ebner for reporting.
+Version 2.0
+-----------
+(codename jinjavitus, released on July 17th 2008)
-- ``{% block name "data" %}`` is now an alias for
- ``{% block name %}data{% endblock %}``. Note that the second argument can
- be an expression. As soon as you specify an expression as second argument
- the closing tag has to be omitted.
+- the subscribing of objects (looking up attributes and items) changed from
+ slightly. It's now possible to give attributes or items a higher priority
+ by either using dot-notation lookup or the bracket syntax. This also
+ changed the AST slightly. `Subscript` is gone and was replaced with
+ :class:`~jinja2.nodes.Getitem` and :class:`~jinja2.nodes.Getattr`.
-- It's now possible to iterate over iterators additionally to sequences.
- If the iterator is inifite it will crash however, so makes sure you don't
- pass something like that to a template!
+ For more information see :ref:`the implementation details <notes-on-subscriptions>`.
-- added `rendetemplate` to render included templates in an isolated
- environment and get the outout back.
+- added support for preprocessing and token stream filtering for extensions.
+ This would allow extensions to allow simplified gettext calls in template
+ data and something similar.
-- added `simplefilter` decorator.
+- added :meth:`jinja2.environment.TemplateStream.dump`.
-- improved ChoiceLoader error reporting (thanks to Bryan McLemore)
+- added missing support for implicit string literal concatenation.
+ ``{{ "foo" "bar" }}`` is equivalent to ``{{ "foobar" }}``
-- fixed extended slicing
+- `else` is optional for conditional expressions. If not given it evaluates
+ to `false`.
-- reworked loader layer. All the cached loaders now have "private" non cached
- baseclasses so that you can easily mix your own caching layers in.
+- improved error reporting for undefined values by providing a position.
-- added `MemcachedLoaderMixin` and `MemcachedFileSystemLoader` contributed
- by Bryan McLemore.
+- `filesizeformat` filter uses decimal prefixes now per default and can be
+ set to binary mode with the second parameter.
+- fixed bug in finalizer
-Version 1.0
------------
-(codename: siyutusan, released Mar 23, 2007)
+Version 2.0rc1
+--------------
+(no codename, released on June 9th 2008)
-- Initial release
+- first release of Jinja2