-Jinja Changelog
+Jinja2 Changelog
===============
-Version 1.1
+Version 2.1
-----------
-(codename to be selected, release date unknown)
+(codename Yasuzō, released on November 23rd 2008)
-- blocks now support ``{{ super() }}`` to render the parent output.
+- 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.
-- debugging system improved, smaller filesize for the cached files.
- Debugging works now well for any module using linecache.
+- fixed a bug with the i18n extension that caused the explicit pluralization
+ block to look up the wrong variable.
-- ``{{ debug() }}`` can now be used to get a list of filters and
- tags.
+- fixed a limitation in the lexer that made ``{{ foo.0.0 }}`` impossible.
-- 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.
+- 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.
-- added whitespace management system for the template designer.
+- 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.
-- some small bugfixes.
+- fixed a confusing behavior with conditional extending. loops were partially
+ executed under some conditions even though they were not part of a visible
+ area.
-- improved security system regarding function calls and variable
- assignment in for loops.
+- added `sort` filter that works like `dictsort` but for arbitrary sequences.
-- added `lipsum` function to generate random text.
+- fixed a bug with empty statements in macros.
-- strings without unicode characters are processed as binary strings now
- to workaround problems with `datetime.strftime` which only accepts
- binary strings.
+- implemented a bytecode cache system. (:ref:`bytecode-cache`)
-- it's now possible to use newlines in string literals
+- the template context is now weakref-able
-- developer friendly traceback is now toggleable
+- inclusions and imports "with context" forward all variables now, not only
+ the initial context.
-- the variable failure is now pluggable by replacing the undefined
- singleton for an environment instance
+- added a cycle helper called `cycler`.
-- fixed issue with old-style classes not implementing `__getitem__`
- (thanks to Axel Böhm for discovering that bug)
+- added a joining helper called `joiner`.
-- added a bunch of new docstrings to the Jinja classes. Makes fun now to
- use pydoc :-)
+- added a `compile_expression` method to the environment that allows compiling
+ of Jinja expressions into callable Python objects.
-- fixed severe memcaching bug. Formerly it wasn't possible to use memcaching
- without enabling disk cache.
+- fixed an escaping bug in urlize
-- fixed a bug that allowed users to override the special names `_`, `true` etc.
-
-- added `batch` and `slice` filters for batching or slicing sequences
-
-- added `sum`, `abs` and `round` filters. This fixes #238
-
-- added `striptags` and `xmlattr` filters for easier SGML/XML processing
-
-- 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 %}``.
-
-- reimplemented Buffet plugin so that it works at least for pylons
-
-- added `Environment.get_translations_for_string`
-
-- fixed a bug in the parser that didn't unescape keyword arguments. (thanks
- to Alexey Melchakov for reporting)
-
-- You can now use the environment to just tokenize a template. This can
- be useful for syntax highlighting or other purposes.
+Version 2.0
+-----------
+(codename jinjavitus, released on July 17th 2008)
-- added optional C-implementation of the context baseclass.
+- 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`.
-- 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 %}``.
+ For more information see :ref:`the implementation details <notes-on-subscriptions>`.
-- additional macro arguments now end up in `varargs`.
+- 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.
-- implemented `{% call %}` - unsure if this makes it into the final release.
+- added :meth:`jinja2.environment.TemplateStream.dump`.
-- it's not possible to stream templates.
+- added missing support for implicit string literal concatenation.
+ ``{{ "foo" "bar" }}`` is equivalent to ``{{ "foobar" }}``
-- fixed a corner case when defining a block inside of a condition
+- `else` is optional for conditional expressions. If not given it evaluates
+ to `false`.
-- the cached loader mixin is now able to cache multiple templates from
- different loaders in the same cache folder.
+- improved error reporting for undefined values by providing a position.
-- Translatable strings returned by ``_()`` will leave their string formatting
- signs untouched. Thanks to Stefan Ebner for reporting.
+- `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
------------
-(released Mar 23, 2007)
+Version 2.0rc1
+--------------
+(no codename, released on June 9th 2008)
-- Initial release
+- first release of Jinja2