Go Templates

template expressions use the Go Text Template library with some additional functions provided by the gomplate library. In this example we get the current exchange rate:

display-with-gotemplate.yaml
apiVersion: canaries.flanksource.com/v1
kind: Canary
metadata:
  name: http-check
spec:
  http:
    - name: USD
      url: https://api.frankfurter.app/latest?from=USD&to=GBP,EUR,ILS,ZAR
      display:
        template: "$1 = €{{.json.rates.EUR}}, £{{.json.rates.GBP}}, ₪{{.json.rates.ILS}}"

Escaping

In case you might need to pass in a template variable without templating it, then you can put the template inside a string. Example:

{{ .secret }}

To send {{ .secret }} as it is do this

{{`{{ .secret }}`}}

Encoding

Encode

Encode data as a Base64 string. Specifically, this uses the standard Base64 encoding as defined in RFC4648 §4 (and not the URL-safe encoding).

{{ base64.Encode "hello world" }} // aGVsbG8gd29ybGQ=
{{ "hello world" | base64.Encode }} // aGVsbG8gd29ybGQ=

Decode

Decode a Base64 string. This supports both standard (RFC4648 §4) and URL-safe (RFC4648 §5) encodings.

This function outputs the data as a string, so it may not be appropriate for decoding binary data. Use base64.DecodeBytes for binary data.

{{ base64.Decode "aGVsbG8gd29ybGQ=" }} // hello world
{{ "aGVsbG8gd29ybGQ=" | base64.Decode }} // hello world

Implementation Note

For the functions that return an array, a Go []interface{} is returned, regardless of whether or not the input was a different type.

Collection

dict

Dict is a convenience function that creates a map with string keys. Provide arguments as key/value pairs. If an odd number of arguments is provided, the last is used as the key, and an empty string is set as the value.

All keys are converted to strings.

This function is equivalent to Sprig's dict function, as used in Helm templates.

For creating more complex maps, see data.JSON or data.YAML.

For creating arrays, see coll.Slice.

{{ coll.Dict "name" "Frank" "age" 42 | data.ToYAML }}

// age: 42
// name: Frank

{{ dict 1 2 3 | toJSON }} // {"1":2,"3":""}

{{ define "T1" }}Hello {{ .thing }}!{{ end -}} 
{{ template "T1" (dict "thing" "world")}}
{{ template "T1" (dict "thing" "everybody")}}

// Hello world!
// Hello everybody!

slice

Creates a slice (like an array or list). Useful when needing to range over a bunch of variables.

{{ range slice "Bart" "Lisa" "Maggie" }}Hello, {{ . }}{{ end }}

// Hello, Bart
// Hello, Lisa
// Hello, Maggie

has

Reports whether a given object has a property with the given key, or whether a given array/slice contains the given value. Can be used with if to prevent the template from trying to access a non-existent property in an object.

{{ $l := slice "foo" "bar" "baz" }}there is {{ if has $l "bar" }}a{{else}}no{{end}} bar // there is a bar

{{ $o := dict "foo" "bar" "baz" "qux" }}
{{ if has $o "foo" }}{{ $o.foo }}{{ else }}THERE IS NO FOO{{ end }} // bar

jsonpath

Extracts portions of an input object or list using a JSONPath expression.

Any object or list may be used as input. The output depends somewhat on the expression; if multiple items are matched, an array is returned.

JSONPath expressions can be validated at https://jsonpath.com

{{ .books | jsonpath `$..works[?( @.edition_count > 400 )].title` }} // [Alice's Adventures in Wonderland Gulliver's Travels]

jq

Filters an input object or list using the jq language, as implemented by gojq.

Any JSON datatype may be used as input (NOTE: strings are not JSON-parsed but passed in as is). If the expression results in multiple items (no matter if streamed or as an array) they are wrapped in an array. Otherwise a single item is returned (even if resulting in an array with a single contained element).

JQ filter expressions can be tested at https://jqplay.org/

Keys

Return a list of keys in one or more maps.

The keys will be ordered first by map position (if multiple maps are given), then alphabetically.

Values

Return a list of values in one or more maps.

The values will be ordered first by map position (if multiple maps are given), then alphabetically by key.