Allowed Functions

Inline Transformation Functions allow you to apply operations directly inside expressions wrapped with {{ }}. Functions can be chained, and execution happens left to right. The output of one function becomes the input for the next.

Example: {{ 3.response.name.toUpper().startsWith("A").fallback(false) }}

Boolean Functions

toBoolean()

• Converts the current value to a boolean using the Convert utility.

• Allowed Parameters: None

• Structure: toBoolean()

• Examples:

  • {{ "true".toBoolean() }}

  • {{ 1.toBoolean() }}

toggle()

• Toggle the current boolean value (True becomes False, False becomes True).

• Allowed Parameters: None

• Structure: toggle()

• Examples:

  • {{ is_active.toggle() }}

  • {{ true.toggle() }}

and()

• Perform a logical AND between the current boolean value and another value.

• Allowed Parameters: rhs (Any)

• Structure: and(rhs)

• Examples:

  • {{ is_valid.and(is_authenticated) }}

or()

• Perform a logical OR between the current boolean value and another value.

• Allowed Parameters: rhs (Any)

• Structure: or(rhs)

• Examples:

  • {{ is_admin.or(is_editor) }}

String Functions

toUpper()

• Converts the current string value to uppercase.

• Allowed Parameters: None

• Structure: toUpper()

• Examples:

  • {{ user.name.toUpper() }}

toLower()

• Converts the current string value to lowercase.

• Allowed Parameters: None

• Structure: toLower()

• Examples:

  • {{ "HELLO".toLower() }}

trim()

• Remove leading and trailing whitespace from the current string value.

• Allowed Parameters: None

• Structure: trim()

• Examples:

  • {{ " hello ".trim() }}

toString()

• Converts the current value to a string.

• Allowed Parameters: None

• Structure: toString()

• Examples:

  • {{ price.toString() }}

contains()

• Check if the current string value contains the given substring.

• Allowed Parameters: substring (string)

• Structure: contains(substring)

• Examples:

  • {{ email.contains("@") }}

startsWith()

• Check if the current string value starts with the given prefix.

• Allowed Parameters: prefix (string)

• Structure: startsWith(prefix)

• Examples:

  • {{ phone.startsWith("+1") }}

endsWith()

• Check if the current string value ends with the given suffix.

• Allowed Parameters: suffix (string)

• Structure: endsWith(suffix)

• Examples:

  • {{ filename.endsWith(".pdf") }}

replace()

• Replace all occurrences of a substring with a new substring.

• Allowed Parameters: old (string), new (string)

• Structure: replace(old,new)

• Examples:

  • {{ text.replace("bad", "good") }}

slugify()

• Convert the current string value into a slug (lowercase, hyphen-separated).

• Allowed Parameters: None

• Structure: slugify()

• Examples:

  • {{ title.slugify() }}

split()

• Split the current string value into a list using the given separator.

• Allowed Parameters: sep (Any)

• Structure: split(sep)

• Examples:

  • {{ tags.split(",") }}

substring()

• Extract a substring using start and optional end indices.

• Allowed Parameters: start (int), end (int, optional)

• Structure: substring(start,end)

• Examples:

  • {{ "Elephant".substring(0, 3) }}

toTitleCase()

• Convert the current string value to title case (capitalize each word).

• Allowed Parameters: None

• Structure: toTitleCase()

• Examples:

  • {{ "john doe".toTitleCase() }}

toNumber()

• Convert the current string value to a number.

• Allowed Parameters: None

• Structure: toNumber()

• Examples:

  • {{ "42.5".toNumber() }}

padStart()

• Pad the current string on the left until it reaches the given length.

• Allowed Parameters: length (int), char (string, optional)

• Structure: padStart(length,char)

• Examples:

  • {{ "5".padStart(2, "0") }}

padEnd()

• Pad the current string on the right until it reaches the given length.

• Allowed Parameters: length (int), char (string, optional)

• Structure: padEnd(length,char)

• Examples:

  • {{ "5".padEnd(3, "0") }}

parseJSON()

• Parse the current string value as JSON safely.

• Allowed Parameters: None

• Structure: parseJSON()

• Examples:

  • {{ json_string.parseJSON() }}

Numeric Functions

add()

• Add a given number to the current value.

• Allowed Parameters: number (Any)

• Structure: add(number)

• Examples:

  • {{ 10.add(5) }}

subtract()

• Subtract a given number from the current value.

• Allowed Parameters: number (Any)

• Structure: subtract(number)

• Examples:

  • {{ 20.subtract(5) }}

increment()

• Increase the current numeric value by 1.

• Allowed Parameters: None

• Structure: increment()

• Examples:

  • {{ count.increment() }}

decrement()

• Decrease the current numeric value by 1.

• Allowed Parameters: None

• Structure: decrement()

• Examples:

  • {{ count.decrement() }}

round()

• Round the current float value to the specified decimal places.

• Allowed Parameters: decimals (int, optional)

• Structure: round(decimals)

• Examples:

  • {{ 3.14159.round(2) }}

toInteger()

• Convert the current float value to an integer.

• Allowed Parameters: args (Any)

• Structure: toInteger(args)

• Examples:

  • {{ 9.99.toInteger() }}

---

List Functions

length()

• Get the number of items in the current list.

• Allowed Parameters: None

• Structure: length()

• Examples:

  • {{ items.length() }}

push()

• Append an item to the end of the current list.

• Allowed Parameters: item (Any)

• Structure: push(item)

• Examples:

  • {{ cart.push("apple") }}

prepend()

• Insert an item at the beginning of the current list.

• Allowed Parameters: item (Any)

• Structure: prepend(item)

• Examples:

  • {{ history.prepend("new_event") }}

pop()

• Remove the last item from the current list.

• Allowed Parameters: None

• Structure: pop()

• Examples:

  • {{ stack.pop() }}

removeAt()

• Remove the item at the specified index.

• Allowed Parameters: index (int)

• Structure: removeAt(index)

• Examples:

  • {{ list.removeAt(0) }}

extend()

• Extend the list by appending all items from another list.

• Allowed Parameters: items (Any)

• Structure: extend(items)

• Examples:

  • {{ list_a.extend(list_b) }}

unique()

• Remove duplicate items from the current list.

• Allowed Parameters: None

• Structure: unique()

• Examples:

  • {{ categories.unique() }}

join()

• Join all items in the list into a string.

• Allowed Parameters: sep (Any)

• Structure: join(sep)

• Examples:

  • {{ words.join(" ") }}

pluck()

• Extract values for a given key from each dictionary in the list.

• Allowed Parameters: key (Any)

• Structure: pluck(key)

• Examples:

  • {{ users.pluck("id") }}

filter()

• Filter items based on a condition (use 'element' as context).

• Allowed Parameters: condition (string)

• Structure: filter(condition)

• Examples:

  • {{ numbers.filter("element > 10") }}

---

JSON Functions (Objects and Arrays)

setKey()

• Set a key in the JSON object to the given value.

• Allowed Parameters: key (Any), value (Any)

• Structure: setKey(key,value)

• Examples:

  • {{ user.setKey("status", "active") }}

removeKey()

• Remove a key from the JSON object.

• Allowed Parameters: key (Any)

• Structure: removeKey(key)

• Examples:

  • {{ user.removeKey("password") }}

merge()

• Merge another dictionary into the current object.

• Allowed Parameters: obj (Any)

• Structure: merge(obj)

• Examples:

  • {{ settings.merge(default_settings) }}

pick()

• Create a new object containing only the specified keys.

• Allowed Parameters: keys (Any)

• Structure: pick(keys)

• Examples:

  • {{ profile.pick(["name", "email"]) }}

---

DateTime Functions

fromTimestamp()

• Convert a Unix timestamp into a UTC datetime value.

• Allowed Parameters: ts (int)

• Structure: fromTimestamp(ts)

• Examples:

  • {{ 1704067200.fromTimestamp() }}

toTimestamp()

• Convert the current datetime value into a Unix timestamp.

• Allowed Parameters: None

• Structure: toTimestamp()

• Examples:

  • {{ now.toTimestamp() }}

format()

• Format the datetime into a string with optional timezone.

• Allowed Parameters: format (string, optional), tz (string, optional)

• Structure: format(format,tz)

• Examples:

  • {{ event.date.format("%Y-%m-%d", "UTC") }}

addDays()

• Add a given number of days to the current datetime.

• Allowed Parameters: number (int)

• Structure: addDays(number)

• Examples:

  • {{ today.addDays(7) }}

subtractDays()

• Subtract a given number of days from the current datetime.

• Allowed Parameters: number (int)

• Structure: subtractDays(number)

• Examples:

  • {{ today.subtractDays(1) }}

addHours()

• Add a given number of hours to the current datetime.

• Allowed Parameters: number (int)

• Structure: addHours(number)

• Examples:

  • {{ now.addHours(2) }}

diffDays()

• Calculate the difference in days between two datetimes.

• Allowed Parameters: other (Any)

• Structure: diffDays(other)

• Examples:

  • {{ deadline.diffDays(now) }}

isAfter()

• Check if the current datetime is after another datetime.

• Allowed Parameters: other (Any)

• Structure: isAfter(other)

• Examples:

  • {{ delivery_date.isAfter(order_date) }}

isBefore()

• Check if the current datetime is before another datetime.

• Allowed Parameters: other (Any)

• Structure: isBefore(other)

• Examples:

  • {{ start_date.isBefore(end_date) }}

startOfDay()

• Set the datetime to 00:00:00.

• Allowed Parameters: None

• Structure: startOfDay()

• Examples:

  • {{ now.startOfDay() }}

endOfDay()

• Set the datetime to 23:59:59.999999.

• Allowed Parameters: None

• Structure: endOfDay()

• Examples:

  • {{ now.endOfDay() }}

getDate()

• Extract the date portion as an ISO string (YYYY-MM-DD).

• Allowed Parameters: None

• Structure: getDate()

• Examples:

  • {{ event.getDate() }}

getTime()

• Extract the time portion as an ISO string (HH:MM:SS).

• Allowed Parameters: None

• Structure: getTime()

• Examples:

  • {{ now.getTime() }}

toISO()

• Convert the datetime into an ISO 8601 string.

• Allowed Parameters: None

• Structure: toISO()

• Examples:

  • {{ updated_at.toISO() }}

toRFC2822()

• Convert the datetime into an RFC 2822 string.

• Allowed Parameters: None

• Structure: toRFC2822()

• Examples:

  • {{ created_at.toRFC2822() }}

Utility Functions

fallback()

• Returns the specified fallback value if a runtime error occurs during execution.

• Allowed Parameters: Any (accepts fallback value in syntax)

• Structure: fallback("Fallback Value")

• Examples:

  • {{ user.address.city.fallback("N/A") }}