Encode a string with the given encoding.

value - any expression. The result of the expression will be coerced to a string if needed and then encoded with the specified encoding.
encoding - The encoding to be used. Encoding must be one of the following string literals:

• "base64" - Base64 encodes the value.
• "percent-simple" - Percent encodes every ASCII character less than hexidecimal 20 and greater than 7E.
• "percent-query" - Percent encodes every ASCII character less than hexidecimal 20 and greater than 7E in addition to , ", #, > and < (space, doublequote, hash, greater than, and less than).
• "percent" - Percent encodes every ASCII character less than hexidecimal 20 and greater than 7E in addition to , ", #, >, <, `, ?, { and } (space, doublequote, hash, greater than, less than, backtick, question mark, open curly brace and close curly brace).
• "percent-path" - Percent encodes every ASCII character less than hexidecimal 20 and greater than 7E in addition to , ", #, >, <, `, ?, {, }, % and / (space, doublequote, hash, greater than, less than, backtick, question mark, open curly brace, close curly brace, percent and forward slash).
• "percent-userinfo" - Percent encodes every ASCII character less than hexidecimal 20 and greater than 7E in addition to , ", #, >, <, `, ?, {, }, /, :, ;, =, @, \, [, ], ^, and | (space, doublequote, hash, greater than, less than, backtick, question mark, open curly brace, close curly brace, forward slash, colon, semi-colon, equal sign, at sign, backslash, open square bracket, close square bracket, caret and pipe).
  
  
• "non-alphanumeric" - Non-Alphanumeric encodes every ASCII character that is not an ASCII letter or digit.

Example: with the value foo=bar from a provider named baz, then the template https://localhost/abc?${x:encode(${p:baz}, "percent-userinfo")} would resolve to https://localhost/abc?foo%3Dbar.

Pads a string or number to be minimum length. Any added padding will be added to the end of the string.

value - An expression whose value will be coerced to a string if needed.
min_length - the minimum length, as a positive integer, that the returned string should be. If the first parameter in string format is less than this amount then padding will be added to it.
pad_string - The padding string to use. If the amount of padding needed is less than the length of this string then it will be truncated from the right. If the needed padding is more than the length of this string, then this string is repeated until it is long enough.

Example: with the value "Jones" from a provider named lastName, then the string ${x:end_pad(${p:lastName}, 8, "-")} would resolve to Jones---.

Returns the "entries" which make up value. For an object this will yield the object's key/value pairs. For an array it yields the array's indices and elements. For a string it yields the indices and the characters. For boolean and null types it yields back those same values.

Examples

With the value {"a": {"foo": "bar", "baz": 123}, "b": ["abc", "def"], "c": "xyz", "d": null } coming from a provider named test:

entries(${p:test}.a)

would return [["foo", "bar"], ["baz", 123]].

entries(${p:test}.b)

would return [[0, "abc"], [1, "def"]].

entries(${p:test}.c)

would return [[0, "x"], [1, "y"], [2, "z"]].

entries(${p:test}.d)

would return null.

or

epoch(unit, dummy)

Returns time since the unix epoch.

unit - A string literal of "s" (seconds), "ms" (milliseconds), "mu" (microseconds), or "ns" (nanoseconds).
dummy - Optional dummy parameter. Use ${p:null} when calling epoch() in declare blocks to ensure it's evaluated per-request. Not needed in URLs, headers, body, or loggers (automatically handled in v0.6.1+).

Example:

• In declare: timestamp: !x '${x:epoch("ms", ${p:null})}'
• In URL: url: 'http://localhost:8080/?ts=${x:epoch("ms")}'

join(value, separator)

or

join(value, separator, separator2)

Turns an array of values into a string or turns an object into a string.

value - any expression. When the expression resolves to an array, the elements of the array are coerced to a string if needed and are then joined together to a single string using the specified separator. When the value resolves to an object and the three argument variant is used then the object will be turned into a string with the specified separators. In any other case value is coerced to a string and returned.
separator - a string literal which will be used between each element in the array. In the case of the three argument variant when the first argument is an object separator is used to separate key/value pairs.
separator2 - a string literal which is used to separate keys and values in an object.

Examples

With the value ["foo", "bar", "baz"] from a provider named qux, then the template https://localhost/some/thing?a=${x:join(${p:qux}, "-")} would resolve to https://localhost/some/thing?a=foo-bar-baz.

With the value {"a": 1, "b": 2} from a provider named foo, then the expression join(${p:foo}, "\n", ": ") would resolve to the following string:

a: 1
b: 2

or for an alternative, json-ified view: "a: 1\nb: 2"

Provides the ability to execute a json path query against an object and returns an array of values. The query must be a string literal.

Example: json_path(response, "$.body.ships.*.ids")

Allows matching a string against a regex. Returns an object with the matches from the regex. Named matches are supported though any unnamed matches will be a number based on their position. Match 0 is always the portion of the string which the regex matched against. If the regex does not match null is returned.

If the first parameter is not a string it will be coerced into a string.

Regex look arounds are not supported.

Example:

If a response body were the following:

<html>
<body>
Hello, Jean! Today's date is 2038-01-19. So glad you made it!
</body>
</html>

Then the following expression:

match(response.body, "Hello, (?P<name>\w+).*(?P<y>\d{4})-(?P<m>\d{2})-(?P<d>\d{2})")

Would return:

{
  "0": "Hello, Jean! Today's date is 2038-01-19",
  "name": Jean",
  "y": "2038",
  "m": "01",
  "d": "19"
}

Converts a string or other value into an integer (i64). If the value cannot be converted to a number, then null will be returned.

value - any expression. The result of the expression will be coerced to a string if needed and then converted.

Converts a string or other value into an floating point number (f64). If the value cannot be converted to a number, then null will be returned.

value - any expression. The result of the expression will be coerced to a string if needed and then converted.

random(start, end)

or

random(start, end, dummy)

Generates a random number between start (inclusive) and end (exclusive). Both start and end must be number literals. If both numbers are integers only integers will be generated within the specified range. If either number is a floating point number then a floating point number will be generated within the specified range.

dummy - Optional dummy parameter. Use ${p:null} when calling random() in declare blocks to ensure it's evaluated per-request. Not needed in URLs, headers, body, or loggers (automatically handled in v0.6.1+).

Example:

• In declare: randomValue: !x '${x:random(0, 100, ${p:null})}'
• In body: "randomId": ${x:random(1000, 9999)}

1.0 is still considered an int

range(start, end)

Creates an array of numeric values in the specified range.

start - any expression resolving to a whole number. Represents the starting number for the range (inclusive).

end - any expression resolving to a whole number. Represents the end number for the range (exclusive).

Examples:

range(1, 10)

range(50, 1)

repeat(n)

or

repeat(min, max)

Creates an array of null values. The single argument version creates an array with a length of n. The three argument form creates an array with a randomly selected size between min (inclusive) and max (exclusive). This is mainly useful when used within a for_each to have the select expression evaluated multiple times.

Example: repeat(10)

Replaces any instance of a string (needle) within a JSON value (haystack) with another string (replacer). This function will recursively check the JSON for any string value of needle and replace it with replacer. This includes checking within a nested object's key and value pairs, within arrays and within strings.

needle - an expression whose value will be coerced to a string if needed.
haystack - the JSON value to search
replacer - an expression whose value will be coerced to a string if needed.

Example: with the value {"foo": "baz", "zed": ["abc", 123, "fooo"]} from a provider named a, then the expression replace("foo", ${p:a}, "bar") would resolve to {"bar": "baz", "zed": ["abc", 123, "baro"]}.

Pads a string or number to be minimum length. Any added padding will be added to the start of the string.

value - an expression whose value will be coerced to a string if needed.
min_length - the minimum length, as a positive integer, that the returned string should be. If the first parameter in string format is less than this amount then padding will be added to it.
pad_string - The padding string to use. If the amount of padding needed is less than the length of this string then it will be truncated from the right. If the needed padding is more than the length of this string, then this string is repeated until it is long enough.

Example: with the value 83 from a provider named foo, then the string id=${x:start_pad(${p:foo}, 6, "0")} would resolve to id=000083.

String Wrap. "Wraps" a String by adding a " to each end. ${x:_} interpolations inside of an R-Template will insert the raw value of a String. This function can be used if surrounding "" are desired, particularly if the resulting string is to be placed in a context that would be interpreted as JSON.

Performs by-value equality comparison of the two values.

In Javascript, Array and Object types are compared by reference, so [] == [] becomes false. This function compares by value, so val_eq([], []) will return true.