Version 2.10.3
- Fix a typo in Babel entry point in ``setup.py`` that was preventing
installation.
Version 2.10.2
- Fix Python 3.7 deprecation warnings.
- Using ``range`` in the sandboxed environment uses ``xrange`` on
Python 2 to avoid memory use.
- Use Python 3.7's better traceback support to avoid a core dump when
using debug builds of Python 3.7.
Version 2.10.1
- SandboxedEnvironment securely handles str.format_map in
order to prevent code execution through untrusted format strings.
The sandbox already handled str.format.
Version 2.10:
- Added a new extension node called OverlayScope which can be used to
create an unoptimized scope that will look up all variables from a
derived context.
- Added an in test that works like the in operator. This can be used
in combination with reject and select.
- Added previtem and nextitem to loop contexts, providing access to the
previous/next item in the loop. If such an item does not exist, the value is
undefined.
- Added changed(*values) to loop contexts, providing an easy way of
checking whether a value has changed since the last iteration (or rather
since the last call of the method)
- Added a namespace function that creates a special object which allows
attribute assignment using the set tag. This can be used to carry data
across scopes, e.g. from a loop body to code that comes after the loop.
- Added a trimmed modifier to {% trans %} to strip linebreaks and
surrounding whitespace. Also added a new policy to enable this for all
trans blocks.
- The random filter is no longer incorrectly constant folded and will
produce a new random choice each time the template is rendered.
- Added a unique filter.
- Added min and max filters.
- Added tests for all comparison operators: eq, ne, lt, le,
gt, ge.
- import statement cannot end with a trailing comma.
- indent filter will not indent blank lines by default.
- Add reverse argument for dictsort filter.
- Add a NativeEnvironment that renders templates to native Python types
instead of strings.
- Added filter support to the block set tag.
- tojson filter marks output as safe to match documented behavior.
- Resolved a bug where getting debug locals for tracebacks could
modify template context.
- Fixed a bug where having many {% elif ... %} blocks resulted in a
"too many levels of indentation" error. These blocks now compile to
native elif ..: instead of else: if ..:
-----------
(codename Replacement, released on July 26th 2015)
- Added `target` parameter to urlize function.
- Added support for `followsymlinks` to the file system loader.
- The truncate filter now counts the length.
- Added equalto filter that helps with select filters.
- Changed cache keys to use absolute file names if available
instead of load names.
- Fixed loop length calculation for some iterators.
- Changed how Jinja2 enforces strings to be native strings in
Python 2 to work when people break their default encoding.
- Added :func:`make_logging_undefined` which returns an undefined
object that logs failures into a logger.
- If unmarshalling of cached data fails the template will be
reloaded now.
- Implemented a block ``set`` tag.
- Default cache size was incrased to 400 from a low 50.
- Fixed ``is number`` test to accept long integers in all Python versions.
- Changed ``is number`` to accept Decimal as a number.
- Added a check for default arguments followed by non-default arguments. This
change makes ``{% macro m(x, y=1, z) %}...{% endmacro %}`` a syntax error. The
previous behavior for this code was broken anyway (resulting in the default
value being applied to `y`).
- Add ability to use custom subclasses of ``jinja2.compiler.CodeGenerator`` and
``jinja2.runtime.Context`` by adding two new attributes to the environment
(`code_generator_class` and `context_class`) (pull request ``404``).
- added support for context/environment/evalctx decorator functions on
the finalize callback of the environment.
- escape query strings for urlencode properly. Previously slashes were not
escaped in that place.
- Add 'base' parameter to 'int' filter.
Problems found locating distfiles:
Package cabocha: missing distfile cabocha-0.68.tar.bz2
Package convertlit: missing distfile clit18src.zip
Package php-enchant: missing distfile php-enchant/enchant-1.1.0.tgz
Otherwise, existing SHA1 digests verified and found to be the same on
the machine holding the existing distfiles (morden). All existing
SHA1 digests retained for now as an audit trail.
Version 2.7.3
-------------
(bugfix release, released on June 6th 2014)
- Security issue: Corrected the security fix for the cache folder. This
fix was provided by RedHat.
this version. From CHANGES:
Version 2.7.2
-------------
(bugfix release, released on January 10th 2014)
- Prefix loader was not forwarding the locals properly to
inner loaders. This is now fixed.
- Security issue: Changed the default folder for the filesystem cache to be
user specific and read and write protected on UNIX systems. See `Debian bug
734747`_ for more information.
.. _Debian bug 734747: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734747
- Fixed a bug with ``call_filter`` not working properly on environment
and context filters.
- Fixed lack of Python 3 support for bytecode caches.
- Reverted support for defining blocks in included templates as this
broke existing templates for users.
- Fixed some warnings with hashing of undefineds and nodes if Python
is run with warnings for Python 3.
- Added support for properly hashing undefined objects.
- Fixed a bug with the title filter not working on already uppercase
strings.
Version 2.7
-----------
(codename Translation, released on May 20th 2013)
- Choice and prefix loaders now dispatch source and template lookup
separately in order to work in combination with module loaders as
advertised.
- Fixed filesizeformat.
- Added a non-silent option for babel extraction.
- Added `urlencode` filter that automatically quotes values for
URL safe usage with utf-8 as only supported encoding. If applications
want to change this encoding they can override the filter.
- Added `keep-trailing-newline` configuration to environments and
templates to optionally preserve the final trailing newline.
- Accessing `last` on the loop context no longer causes the iterator
to be consumed into a list.
- Python requirement changed: 2.6, 2.7 or >= 3.3 are required now,
supported by same source code, using the "six" compatibility library.
- Allow `contextfunction` and other decorators to be applied to `__call__`.
- Added support for changing from newline to different signs in the `wordwrap`
filter.
- Added support for ignoring memcache errors silently.
- Added support for keeping the trailing newline in templates.
- Added finer grained support for stripping whitespace on the left side
of blocks.
- Added `map`, `select`, `reject`, `selectattr` and `rejectattr`
filters.
- Added support for `loop.depth` to figure out how deep inside a recursive
loop the code is.
- Disabled py_compile for pypy and python 3.
* internal attributes now raise an internal attribute error now instead
of returning an undefined. This fixes problems when passing undefined
objects to Python semantics expecting APIs.
* traceback support now works properly for PyPy. (Tested with 1.4)
* implemented operator intercepting for sandboxed environments. This
allows application developers to disable builtin operators for better
security. (For instance limit the mathematical operators to actual
integers instead of longs)
* groupby filter now supports dotted notation for grouping by attributes
of attributes.
* scoped blocks not properly treat toplevel assignments and imports.
Previously an import suddenly "disappeared" in a scoped block.
* automatically detect newer Python interpreter versions before loading code
from bytecode caches to prevent segfaults on invalid opcodes. The segfault
in earlier Jinja2 versions here was not a Jinja2 bug but a limitation in
the underlying Python interpreter. If you notice Jinja2 segfaulting in
earlier versions after an upgrade of the Python interpreter you don't have
to upgrade, it's enough to flush the bytecode cache. This just no longer
makes this necessary, Jinja2 will automatically detect these cases now.
* the sum filter can now sum up values by attribute. This is a backwards
incompatible change. The argument to the filter previously was the
optional starting index which defaultes to zero. This now became the
second argument to the function because it's rarely used.
* like sum, sort now also makes it possible to order items by attribute.
* like sum and sort, join now also is able to join attributes of objects
as string.
* the internal eval context now has a reference to the environment.
* added a mapping test to see if an object is a dict or an object with
a similar interface.
* built documentation is no longer part of release.
Changes 2.5.4:
* Fixed extensions not loading properly with overlays.
* Work around a bug in cpython for the debugger that causes segfaults
on 64bit big-endian architectures.
Changes 2.5.3:
* fixed an operator precedence error introduced in 2.5.2. Statements
like "-foo.bar" had their implicit parentheses applied around the
first part of the expression ("(-foo).bar") instead of the more
correct "-(foo.bar)".
Changes 2.5.2:
* improved setup.py script to better work with assumptions people
might still have from it (``--with-speedups``).
* fixed a packaging error that excluded the new debug support.
drop maintainership.
Version 2.5
* improved the sort filter (should have worked like this for a long time) by
adding support for case insensitive searches.
* fixed a bug for getattribute constant folding.
* support for newstyle gettext translations which result in a nicer
in-template user interface and more consistent catalogs. (Newstyle Gettext)
* it's now possible to register extensions after an environment was created.
Version 2.4.1
* fixed an error reporting bug for undefineds.
Version 2.4
* 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 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.
* the _speedups C extension now supports Python 3.
* added support for autoescaping toggling sections and support for evaluation
contexts (Evaluation Context).
* extensions have a priority now.
Version 2.3.1
* fixed an error reporting bug on all python versions
* fixed an error reporting bug on Python 2.4
Version 2.3
* 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
* greatly improved error message reporting
* implicit tuple expressions can no longer be totally empty. This change
makes {% if %}...{% endif %} a syntax error now.
* added support for translator comments if extracted via babel.
* added with-statement extension.
* experimental Python 3 support.
Version 2.2.1
* fixes some smaller problems for Jinja2 on Jython.
Version 2.2
* 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
* 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.
* 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.
Jinja2 is a template engine written in pure Python. It provides a Django
inspired non-XML syntax but supports inline expressions and an optional
sandboxed environment.