Skip to main content

Generic interface for Python template engines

Project description

Introduction

collective.templateengines is an pluggable template language backend manager for Python. It defines generic interfaces which abstracts template language basic interfaction.

Template Backend helps you to achieve

  • Easy, pluggable, template language switching
  • Clean your codebase from template language dependencies

Motivation

All template engines have their shortcomings. Sooner or later you want to try yet another of them, or someone else wants to use another template engine with your project. This product is aimed to make that transition as smooth as possible, maybe just one line change.

Features

Usage

The following example shows how one can switch between Django and Cheetah template engines with one line of change. Naturally, the templates themselves need to be refactored.

Cheetah:

from collective.templateengines.backends import cheetah

engine = cheetah.Engine()
context = DictionaryContext({"foo":"bar"})
template, syntax_errors = engine.loadString("Show variable $foo", False)
result, evaluation_errors = template.evaluate(context)

Django:

from collective.templateengines.backends import djangotemplates

engine = djangotemplates.Engine()
context = DictionaryContext({"foo":"bar"})
template, syntax_errors = engine.loadString("Show variable {{ foo", False)
result, evaluation_errors = template.evaluate(context)

TODO

  • Generic mechanism to register template tags
  • Secure context support (Zope, Plone)

Problems

  • Cheetah architecture lacks separate exposed compiling and evaluating phases
  • Cheetah exposes the full Python namespace to templates by default, making it hard to secure it
  • Cheetah cannot traverse Zope functions or attributes

Examples

Python Template Engines is used in

Author

Mikko Ohtamaa

Red Innovation Oy, Oulu, Finland - High quality Python hackers for hire

Changelog

0.1 - Unreleased

  • Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collective.templateengines-0.1.tar.gz (7.5 kB view hashes)

Uploaded source

Built Distribution

collective.templateengines-0.1-py2.5.egg (26.5 kB view hashes)

Uploaded 2 5

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page