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