Intro to Jinja

Overview

Rewst uses the Jinja2 templating language, also known as Jinja, in text fields to enable more powerful processing of the data that exists in a workflow. Jinja is a Python-based templating engine that allows you to generate dynamic HTML, XML, or other markup formats. It provides a syntax for embedding Python code within markup, allowing you to create templates that can be customized based on input data.

Jinja language is meant to be extensible. Within Rewst there are many filters that extend functionality, including an ever-growing list that Rewst adds to the platform. This means that if you search the web for help with Jinja, the answers you find may or may not be 100% applicable to the Rewst environment. When in doubt, you can always ask the Rewst support for assistance.

Types of Jinja

Variable expressions

Variable expressions are encapsulated by double curly braces ({{ and }}) and will output the value of the variable or expression as they are evaluated.

{{ CTX.my_var }}

Control flow statements

These are used for decision-making functions such as sets, if statements and for eaches. They are encapsulated by curly+percent signs ({% %})

{% set x = 100 %}

These statements typically do not output anything.

Comments

Comments do nothing. In the Rewst Monaco editor, you can use the hotkey CTRL-/ to comment blocks of code.

{# COMMENT #}

Whitespace

By default, when Jinja begins a statement block, it preserves any whitespace characters (spaces, carriage returns, etc) before or after the block. In many cases, you will want to remove any spaces you did not explicitly intend to have, so the addition of the - character in the open and closing braces will remove the whitespace before or after the statement, respectively.

{%- for part in parts_list -%}
  {{- part.name -}}
{%- endfor -%}

Jinja resources

Below are some resources, external to Rewst, that can be used to assist during the use of Jinja.

• Jinja Docs and Jinja syntax examples

• Jinja's official documentation examples

• What is Jinja - Pushmetrics

Note that whilst right now Jinja is required, the plan is to create actions to make this easier for everyday users to manipulate their data and not have to worry about using Jinja at all.

Want more practice?

Want to learn more? Search for Jinja in Cluck University to find related courses.