Chameleon 1.2.6

XML-based template compiler.

Overview
--------

Chameleon compiles templates to Python byte-code. It includes a
complete implementation of the Zope Page Templates (ZPT) language
and a partial implementation of the Genshi language.

The engine itself performs 10-15 times better than the reference
implementation and real-world benchmarks show an overall performance
improvement in complex applications of 30-50%.

Compatibility
-------------

Works on Python 2.4, 2.5 and 2.6, including Google App Engine.

Development
-----------

The code is maintained in a subversion repository::

http://svn.repoze.org/chameleon/trunk

If you want to contribute or need support, join #repoze on freenode
irc or write the `mailinglist <mailto:[e-mail]>`_.

Changes
=======

In next release...

- ....


1.2.6 (released 2010-06-21)
---------------------------

- Resolve real path before checking the XInclude registry. This fixes
cache misses when using relative paths.


1.2.5 (released 2010-06-21)
---------------------------

- Use a blacklist to filter python builtins available in expressions. This
fixes the disappearance of many common builtins in the previous release.


1.2.4 (released 2010-06-21)
---------------------------

- Fix in Babel python i18n extractor: correct handling of messages with a
newline before the start of a parameter.

- Drop list of rarely used builtins from scope (such as ``help``);
meanwhile, the builtins that are made available won't be replaced by
arguments passed into the template.

We can change this behavior by adding names to the list of
*transient symbols*; however, this is expensive. The right place to
do it would be the code stream's dictionary of required symbols, but
it's currently a cumbersome solution.

Consider this a temporary fix.

- Fixed issue where an interpolation escape would indeed escape
interpolation, but also display in the output. [sklein]

- Translate attributes that are messages.

1.2.3 (released 2010-04-19)
---------------------------

- Added parameter ``debug`` to template constructor to enable debug
mode. The default value is taken from the ``CHAMELEON_DEBUG``
environment value and defaults to ``False``.

The use of debug mode is recommended during development.

- Improved exception output in debug-mode; for nested usage, sections
now carry the correct filename.

- Fixed an issue where an incorrect expression annotation would be
shown, or none at all.

- When in debug-mode, take steps to ensure traceback is not swallowed
in properties by explicit invocation.

1.2.2 (released 2010-04-17)
---------------------------

- Fixed regression where objects that are not strings or numbers would
not output due to a recent change in policy that subjected such
objects to the translation machinery. However, the default
translation function had a bug that instead returned ``None``.

The new behavior is that such objects are coerced to unicode by
default.

Note that if ``zope.i18n`` is available, an alternative translation
function is used; this function, however, has the correct behavior
already.

- Fixed issue where nested translations would drop named blocks due to
a name clash.

1.2.1 (released 2010-04-07)
---------------------------

- Fixed issue where decorators used internally by the compiler would
be silently dropped during compilation on Python 2.4. This fix
solves an issue with match templates not being processed.

- Objects which are not strings or numbers, and which do not provide
an ``__html__`` method, are now considered i18n messages. This means
that they are automatically translated (using interpolation or
tag-based text insertion or replacement).

- Fixed issue where ``translate`` parameter would not be applicable on
file-based templates.

- Add Babel message extractors for Python, ZPT and Genshi files.

- Correctly handle translations where a msgid has an empty translation.

1.2.0 (released 2010-03-29)
---------------------------

- Fixed issue where nested translations would fail.

- Added support for passing in a translation function to the template
constructor.

- Fixed issue where translation name mappings would conflict with
template function definitions.

- Fixed symbol lookup issue with list comprehensions and lambda
expressions.

- Fixed issue with interpolation flag and CDATA; the effect of this
flag is now recursive, which indirectly means that CDATA elements
will be affected by a setting on a parent tag.

- XML namespace fixes.

- Template instances may now be used as macros; this will use the
template in its entirety, including any XML declarations. This
addresses issue #139.

- Integrated Genshi implementation.

- Allow expression interpolation on any tag which is not part of the
Chameleon or ZPT namespaces (e.g. TAL, METAL, I18N or META).

- Improve XML parsing error handling.

1.1.2 (released 2010-02-24)
---------------------------

- Avoid printing document header strings (XML header and DOCTYPE)
twice; this would previously happen if a template would define these
and use a macro on the top level which also provided them.

- The repeat variable attributes (``odd``, ``even`` etc.) are now
*callable strings*, e.g. legacy users may still call these attributes,
but it is no longer required.

- The ``odd`` and ``even`` attributes now return the English strings
``"odd"`` and ``"even"`` in place of ``True`` and the empty string
``""`` instead of ``False``.

1.1.1 (released 2010-01-26)
---------------------------

- Python 2.5 compatibility fixes (symptom: ``TypeError: default
__new__ takes no parameters`` with the statement generating the
error something like ``ast.Name("econtext", ast.Load())``).

1.1 (released 2010-01-26)
-------------------------

- Made all tests compatible with Python 2.4.

- Use the 2.5 AST for code transformation for compatibility with
Google App Engine. The AST utilities required were copied from
Genshi (license document included).

1.0.8 (released 2010-01-12)
---------------------------

- Use RPL license (http://repoze.org/license.html); include RPL and
copyright notice in software.

1.0.7 (released 2010-01-07)
---------------------------

- Fixed encoding issue of translated attributes. [kobold]

- Fixed translation issue, that would prevent translation of tag
contents with both named and unnamed subtags. [kobold]

- Fixed issue where messages could contain a double space. [kobold]

1.0.6 (released 2009-12-14)
---------------------------

- Fixed white space issue.

- Fixed character encoding issue.

- Fixed issue where macro extension would fail.

1.0.5 (released 2009-12-08)
---------------------------

- Fixed issue where the translation compiler would break on messages
that contained the formatting character '%'.

- Fixed white space issue.

1.0.4 (released 2009-11-15)
---------------------------

- Fixed issue where the file-based template constructor did not accept
the ``encoding`` parameter.

- Use more caution when falling back to dictionary lookup.

1.0.3 (released 2009-11-12)
---------------------------

- Fixed issue where traceback would contain erroneous debugging
information. The source code is now taken directly from the
traceback object.

- Include Python expression in syntax error exception message.

1.0.2 (released 2009-11-10)
---------------------------

- Really fixed ZCA import fallbacks.

1.0.1 (released 2009-11-04)
---------------------------

- Fixed ZCA import fallbacks.

1.0 (released 2009-11-01)
-------------------------

Features:

- HTML5 doctype is now supported.