DocumentTemplate 3.0b9

.. image:: https://travis-ci.org/zopefoundation/DocumentTemplate.svg?branch=master
:target: https://travis-ci.org/zopefoundation/DocumentTemplate

.. image:: https://coveralls.io/repos/github/zopefoundation/DocumentTemplate/badge.svg?branch=master
:target: https://coveralls.io/github/zopefoundation/DocumentTemplate?branch=master

.. image:: https://img.shields.io/pypi/v/DocumentTemplate.svg
:target: https://pypi-hypernode.com/project/DocumentTemplate/
:alt: Current version on PyPI

.. image:: https://img.shields.io/pypi/pyversions/DocumentTemplate.svg
:target: https://pypi-hypernode.com/project/DocumentTemplate/
:alt: Supported Python versions

DocumentTemplate
================

This package implements the original Document Templating Markup Language
(DTML). It uses custom SGML tags to implement simple programmatic features,
such as variable replacement, conditional logic and loops.

Inside Zope environments page templates and TAL have superseded DTML for most
use cases.


Changelog
=========

3.0b9 (2019-05-01)
------------------

- Be much more careful when setting encoding if it is not passed in

- Only decode input in ``html_quote`` when needed under Python 3
(`Products.PythonScripts#28 <https://github.com/zopefoundation/Products.PythonScripts/issues/28`_>)


3.0b8 (2019-04-26)
------------------

- make sure all JSON-serialized data is text data and not bytes
(`#45 <https://github.com/zopefoundation/DocumentTemplate/issues/45>`_)


3.0b7 (2019-04-25)
------------------

- Add support for Python 3.8

- Make the rendering encoding configurable to fix rendering on Zope 4
(`#43 <https://github.com/zopefoundation/DocumentTemplate/issues/43>`_)

- Add unit tests for ``dtml-if``, ``dtml-unless`` and ``dtml-in`` variables
(`#7 <https://github.com/zopefoundation/DocumentTemplate/issues/7>`_)


3.0b6 (2019-03-01)
------------------

- Fix regression in ``.DT_Util.InstanceDict`` which broke the acquisition
chain of the item it wraps.
(`#38 <https://github.com/zopefoundation/DocumentTemplate/issues/38>`_)


3.0b5 (2018-10-05)
------------------

Breaking changes
++++++++++++++++

- Remove ``VSEval`` module. Please use DT_Util.EVal now.

- Remove ``DTtestExpr`` module. It contained nothing useful.

Features
++++++++

- Add support for Python 3.7.

Bugfixes
++++++++

- Fix regression with exception handling in ``<dtml-except>`` with Python 2.
(`#25 <https://github.com/zopefoundation/DocumentTemplate/issues/25>`_)

- Stabilized TreeTag rendering for objects without ``_p_oid`` values.
(`#26 <https://github.com/zopefoundation/DocumentTemplate/issues/26>`_)

- Remove support for string exceptions in ``<dtml-except>``.
(`#29 <https://github.com/zopefoundation/DocumentTemplate/pull/29>`_)

- Fix handling of parsing a ``ParseError`` in Python 3.
(`#29 <https://github.com/zopefoundation/DocumentTemplate/pull/29>`_)

- Fix bugs with ``<dtml-in>``:

- Raise proper error if prefix is not simple.
- Fix complex multisort in Python 3.
- Fix iteration over list of tuples in Python 3.


3.0b4 (2018-07-12)
------------------

- Drop Python 3.4 support.

- Fix a regression in the Python implementation differing from the C
implementation in ``DocumentTemplate.DT_Util.InstanceDict``.
`#24 <https://github.com/zopefoundation/DocumentTemplate/pull/24>`_

- Improve compatibility with flake8.

- Update deprecated assert method calls.


3.0b3 (2018-04-18)
------------------

- Fixed a problem with Python 3 compatibility when computing the
state strings in tree tags.

- No longer use icons which got deleted in Zope 4.

- Fix sorting in <dtml-in> for duplicate entries in Python 3.


3.0b2 (2017-11-03)
------------------

- Under Python 3, make sure no binary representations end up in the
state string used for the tree tag.


3.0b1 (2017-09-15)
------------------

- No changes since 3.0a4.

3.0a4 (2017-06-06)
------------------

- Further fixes for Python 3 compatibility.

3.0a3 (2017-05-17)
------------------

- Further fixes for Python 3 compatibility.

3.0a2 (2017-05-05)
------------------

- Add support for Python 3.4 up to 3.6.

3.0a1 (2017-01-19)
------------------

- Ensure html_quote is being applied to content.

- Replace C code with a pure-Python implementation.

- Add `__contains__` support to DocumentTemplate.TemplateDict.

2.13.2 (2011-12-12)
-------------------

- Restrict the available functions in `DocumentTemplate.sequence` to public
API's of `zope.sequencesort`.

2.13.1 (2010-07-15)
-------------------

- LP #143273: Enable the dtml-var modifiers url_quote, url_unquote,
url_quote_plus and url_unquote_plus to handle unicode strings.


2.13.0 (2010-06-19)
-------------------

- Released as separate package.