Skip to main content
https://github.com/zopefoundation/DocumentTemplate/actions/workflows/tests.yml/badge.svg https://coveralls.io/repos/github/zopefoundation/DocumentTemplate/badge.svg?branch=master Current version on PyPI 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

5.2 (2026-02-23)

  • Prevent builtins shadowing in DTML Var. (Zope#1285)

5.1 (2026-01-19)

  • Move package metadata from setup.py to pyproject.toml.

  • Fix Zope test failures accessing sequence wrappers introduced in #76 from untrusted code. (#81)

5.0 (2025-11-27)

  • Add support for Python 3.13, 3.14.

  • Drop support for Python 3.7, 3.8, 3.9.

  • Support lazy batching again, support general iterators (#75)

4.6 (2023-11-13)

  • Add official support for Python 3.12.

4.5 (2023-09-18)

  • Add preliminary support for Python 3.12rc1.

  • Be more resilient on sorting if the getter returns None. (#72)

4.4 (2022-01-12)

  • Drop support for Python 3.6.

4.3 (2022-12-21)

  • Fix restructured-text format specification. Tests were silently skipped.

4.2 (2022-12-16)

  • Fix insidious buildout configuration bug for tests against Zope 4.

  • Add support for Python 3.11.

4.1 (2022-09-20)

  • Set the tree-s cookie for dtml-tree tags with SameSite=Lax. The tree tag never set this attribute. That causes modern browsers to show warnings in the browser console and break tree displays in the future. See https://hacks.mozilla.org/2020/08/changes-to-samesite-cookie-behavior/ for information about the SameSite cookie attribute and why its handling in browsers is changing.

  • Add support for Python 3.10.

  • Drop support for Python 3.5.

4.0 (2020-11-12)

  • Make ustr.ustr Python 3 compatible (Zope#921)

  • Add support for Python 3.9

  • Restore sql_quote behavior of always returning native strings (#54)

  • Fix broken tree tag (#52)

  • Drop support for Python 2.

  • Eventually drop BBB code leading to a deprecation warning in version 3.2+. (#42)

  • Update isort to version 5.

3.2.2 (2020-02-04)

  • de-fang sql_quote even more as quoting is too database-specific. (#48)

3.2.1 (2020-02-03)

  • prevent a really strange AccessControl test failure when running Zope’s alltests script by importing deprecated names from zope.sequencesort.ssort instead of sequence/SortEx.py in sequence/__init__.py

3.2 (2020-02-03)

  • no longer escape double quotes in sql_quote - that breaks PostgreSQL (#48)

  • Added DeprecationWarnings for all deprecated files and names (#42)

  • Import sorting done like Zope itself

  • Applied extended linting configuration similar to Zope’s own

3.1 (2020-01-31)

  • Escape more characters in sql_quote. Taken over from PloneHotfix20200121.

3.1b2 (2019-05-16)

  • Fix broken handling of SyntaxError under Python 3

3.1b1 (2019-05-13)

  • Don’t call HTTPExceptions that are looked up in TemplateDicts

3.0 (2019-05-09)

Changes since 2.13.2:

Breaking changes

  • Replace C code with a pure-Python implementation.

  • Remove VSEval module. Please use DT_Util.EVal now.

  • Remove DTtestExpr module. It contained nothing useful.

  • Remove support for string exceptions in <dtml-except>. (#29)

Features

  • Add support for Python 3.5, 3.6, 3.7, 3.8.

  • Make the rendering encoding configurable to fix rendering on Zope 4. (#43)

  • Add __contains__ support to DocumentTemplate.TemplateDict.

Bug fixes

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

  • Make sure all JSON-serialized data is text data and not bytes. (#45)

  • Fix regression with exception handling in <dtml-except> with Python 2. (#25)

  • Stabilized TreeTag rendering for objects without _p_oid values. (#26)

  • 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.

  • Ensure html_quote is being applied to content.

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.

Metadata

Release files for DocumentTemplate 5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for DocumentTemplate 5.2
File Size Uploaded Provenance Actions
documenttemplate-5.2.tar.gz 72.8 kB Without provenance Details for documenttemplate-5.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for DocumentTemplate 5.2
File Interpreter ABI Platform Actions
documenttemplate-5.2-py3-none-any.whl Python 3 none any Details for documenttemplate-5.2-py3-none-any.whl

Total release size: 161.6 kB

Release files / documenttemplate-5.2.tar.gz

Download URL documenttemplate-5.2.tar.gz
Size 72.8 kB
Tags Source
SHA-256 checksum
How to use checksums
522fea8796a632cf98a796aea6572204e01c5a0d7f6c2e64bdc222422e629d14
BLAKE2b-256 checksum
How to use checksums
f8d6023e4e230b614e8b4f4303b2b195e6c9685c2b86508df89962e987a08f5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release files / documenttemplate-5.2-py3-none-any.whl

Download URL documenttemplate-5.2-py3-none-any.whl
Size 88.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
28a2689f4aa9b8d8c5ce544be8c70cef87bf552b5fc36dae36a9e96a18de558d
BLAKE2b-256 checksum
How to use checksums
71d70648ea9ee80579e9e0bca646463754919a3aa9d9b038ef54a7ed9c05c5d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Security for DocumentTemplate 5.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

5.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page