tmpl8

tmpl8

Generic (and Kubernetes-friendly) Templating Engine using the go text/template and Sprig functions

Features

• Import multiple JSON and/or YAML documents
• Using the Go text/template engine
• Supports the Mastermind/sprig package for extra template functions
• Can import templates (and data) from Kuberentes ConfigMap

Usage / Help

Supported input formats: JSON and YAML

tmpl8 [--input INPUT] [--output FILE] [--verbose] [--trace] [--raw] [--split] [--noinput] TEMPLATE [TEMPLATE ...]

Options

define/block support

Any define/block helpers are useable in templates in all following template sources (and can be overridden)

Examples

$ tmpl8 <input.json t1.yaml t2.yaml
# Reads input.json and apply that to the templates t1.yaml and t2.yaml (in that order)

Equivalent commands

$ tmpl8 <input.json t1.yaml t2.yaml >output.txt
$ tmpl8 -i input.json t1.yaml t2.yaml -o output.txt
$ cat input.json | tmpl8 @t.lst  >output.txt

where t.lst contains

t1.yaml
t2.yaml

Inline data

Adding a '?' character to an input or output will use the remaining text as raw data.

$ tmpl8 -i '?name: alpha' '?{{ .name | upper }}'
ALPHA

Kubernetes support

To import data from a Kubernetes Configmap you only need to use a filename like 'k8s:namespace/configmap' All values within will be imported as templates (or inputs if used with '-i')