pyforma 0.5.0

A python template engine

PyForma

A Python template engine featuring partial substitution.

Example

from pyforma import Template

template = Template("Hello, {{ subject }}! This is {{ lib_name }}.")
assert template.unresolved_identifiers() == {"subject", "lib_name"}

template = template.substitute({"lib_name": "PyForma"})
assert template.unresolved_identifiers() == {"subject"}

print(template.render({"subject": "World"}))  # Prints "Hello, World! This is PyForma."

Features

• 100% Python
• Python-like expressions in templates
• Special-purpose environments for more expressive templates
• Templates can be inspected for what variables need to be substituted
• Can partially substitute variables within templates
• Rendering with undefined variables results in an error
• Fully statically typed

Documentation

• API Documentation
• Template Syntax Documentation

Alternatives

• Jinja2: The de-facto standard Python template engine. It's popular, fast, expressive and extensible, but doesn't support partial template substitution.
• Mako: Compiles templates to Python bytecode.
• Chameleon: HTML/XML-compatible template engine.
• string.Template: The actual standard Python template engine. Pretty limited functionality.