render_partial()

Render a partial template to an HTML fragment.

Usage

render_partial(
    template_file,
    **template_data,
)

Looks up template_file in the folder registered with register_extensions and renders it with the supplied keyword arguments as its model. render_partial is injected into the model automatically, so a partial can render further nested partials. The fragment is rendered as text (str); any bytes values in the model are decoded as UTF-8.

Parameters

template_file: str: Path to the partial, relative to the registered templates folder, for example shared/partials/video_image.pt.
**template_data: Any: Keyword arguments passed to the template as its model (the variables the template can reference). Values may be any Python objects your template expressions use. The name encoding is reserved and cannot be used; translate, target_language, and repeat have special meaning to Chameleon.

Returns

HTML: An HTML wrapper whose __html__ method yields the rendered markup as safe, pre-escaped HTML.

Raises

PartialsException: If register_extensions has not been called yet.
ValueError: Propagated from Chameleon if template_file does not exist under the registered folder.

Examples

import chameleon_partials

chameleon_partials.register_extensions('path/to/templates')
html = chameleon_partials.render_partial('shared/partials/user_card.pt', name='Sarah', age=32)
print(html.html_text)