Combining and nesting templating functions

Combine and nest templating functions in Hoverfly Cloud simulations for complex and dynamic API response generation.

With all functions that take parameters the convention is as follows:

• String literal parameters and number literal parameters are enclosed in single quotes.

• When calling a function from within a function the inner function should be enclosed in parenthesis (round brackets) not handlebars.

• When using variables and arrays, their names are string based parameters and are normally enclosed in single quotes, unless they are the result of a nested function (this can be useful)

• Boolean flag parameters are not enclosed in single quotes.

• Iterator instance parameters (this, or this.<<some-variable>>) are not enclosed in single quotes

• Function names are not enclosed in single quotes.

Examples:

{{ putValue 'id' (Request.Body 'jsonpath' '$.id') true }}
{{ multiply '5' '2' '0.00' }}
{{ multiply this.quantity this.price '0.00' }}

Many functions can be nested inside other functions. In some cases it makes sense to nest multiple levels of functions. It is conventional to enclose the inner functions with round brackets instead of handlebars.

Example 1:

Consider the following 3 functions:

{{ sum <array> '<format>' }}
{{ split <delimited-string> '<delimiter>' }}
{{ Request.Body '<querylanguage>' '<query>' }}

As an example they can be combined together in the following way:

{{ sum(split (Request.Body 'jsonpath' '$.price[*]') ' ') '0.00' }}

Example 2:

Consider the following 3 functions:

{{ putValue '<variablename>' <value> <outputtotemplate?> }}
{{ multiply <number1> <number2> '<format>' }}
{{ csv '<data-source-name>' '<key-column>' '<key-value>' '<return-column>' }}

As an example they can be combined together in the following way:

{{ putValue 'linetotalsbeforediscounts' (multiply (this.quantity) (csv 'products' 'upc' 'this.upc' 'price') '') false}}