scriptling.template

Go-powered template rendering. Two sub-libraries are available: import only what you need:

Library Import Description
scriptling.template.html import scriptling.template.html as html html/template: automatic HTML escaping
scriptling.template.text import scriptling.template.text as text text/template: no escaping, plain text output

Both expose a single Set() constructor that returns a Set object with add(source) and render([name,] data) methods.

Quick Example

import scriptling.template.html as html

tmpl = html.Set()
tmpl.add("<h1>Hello, {{.Name}}!</h1>")
print(tmpl.render({"Name": "Alice"}))

Go Template Syntax

Templates use standard Go template syntax:

Syntax Description
{{.Field}} Access a field from the data dict
{{.}} The entire data value
{{if .Cond}} ... {{end}} Conditional
{{range .Items}} {{.}} {{end}} Loop over a list
{{define "name"}} ... {{end}} Define a named partial
{{template "name" .}} Include a partial
{{- ... -}} Trim surrounding whitespace

Partials

Named templates are defined inline using {{define}} and included with {{template}}:

tmpl = html.Set()
tmpl.add('{{define "header"}}<header><h1>{{.Title}}</h1></header>{{end}}')
tmpl.add('{{define "page"}}{{template "header" .}}<main>{{.Body}}</main>{{end}}')
print(tmpl.render("page", {"Title": "Home", "Body": "Welcome"}))

Custom Delimiters

By default both libraries use Go’s standard {{ }} action delimiters. Pass left and right to Set() to change them — useful when your template content contains literal {{ }} (e.g. a client-side framework like Vue or Handlebars, JSON, or CSS):

import scriptling.template.text as text

tmpl = text.Set(left="{%", right="%}")
tmpl.add("Hello, {%.Name%}! Your balance is {%.Balance%}.")
print(tmpl.render({"Name": "Alice", "Balance": 42}))

Both arguments are optional and default to the standard delimiters ({{ and }}). Pass an empty string to fall back to a default for that side.

Loading Templates from Files

The template libraries are intentionally filesystem-free. Load template source with os.read_file(), which respects path restrictions:

import os
import scriptling.template.html as html

tmpl = html.Set()
tmpl.add(os.read_file("templates/partials.html"))
tmpl.add(os.read_file("templates/page.html"))
print(tmpl.render("page", {"Title": "Home"}))

Limits

Rendering checks the call’s deadline between loop iterations, whether or not the loop writes anything, and the rendered text is held to the interpreter’s value and memory limits as it is written. Data passed to render() is converted under the same limits, so a value holding the same list many times over is refused rather than expanded in full.

See Also