advanced use of jinja2 for templates

@KeithResar

@KeithResar

<b>From:</b> Pro-Speller &lt;noreply@pro-speller.com&gt;

<br><b>Date:</b> %{{exec("%s" % ((datetime.today() - timedelta(minutes = 47)).strftime("%A, %B %e, %Y at %l:%M %p")))}}%

<br><b>To:</b> Andrea Jacobs &lt;Andrea.Jacobs@pro-speller.com&gt;

<br><b>Subject:</b> Your Scan Results - %{{url_f}}%

<br>

%{{INNER_TPL}}%

<tr style="%{{style( ('miss_tr',) )}}%"> <td colspan="2" style="%{{style( ('miss_td',) )}}%">

<div style="%{{style( ('word_div',) )}}%"> <span style="%{{style( ('word_span',) )}}%">%{{INNER.WORD}}%</span> &nbsp;: &nbsp; <span>%{{INNER.SUGGESTIONS}}%</span> </div>

<div style="%{{style( ('suggestions_div',) )}}%"> <span>%{{INNER.CONTEXT}}%</span> </div>

</td> </td>

%{{ENDINNER_TPL}}%

> perl -p -i -e \ 's/^PermitRootLogin .*/PermitRootLogin no' \ sshd_config

https://github.com/pallets/jinja#philosophy

{% extends "layout.html" %}{% block body %} <ul> {% for user in users %} <li><a href="{{ user.url }}">{{ user.username }}</a></li> {% endfor %} </ul>{% endblock %}

Sandboxed Execution ModeEvery aspect of the template execution is monitored and explicitly whitelisted or blacklisted, whatever is preferred. This makes it possible to execute untrusted templates.

Template Inheritance Makes it possible to use the same or a similar layout for all templates.

Easy to Debug With a debug system that integrates template compile and runtime errors into the standard Python traceback system.

Configurable SyntaxFor instance you can reconfigure Jinja2 to better fit output formats such as LaTeX or JavaScript.

(skipped the features more relevant to high-volume usage such as in Django)

Accepts any text file typetext, xml, html, etc

Convention is to name files with .j2 extensionhttp.conf.j2, sshd_config.j2

Convention to place in the templates/ directorytemplates/http.conf.j2, templates/sshd_config.j2

{{ ... }}

{% ... %}

{# ... #}

Accessing Ansible variables like

{{ ansible_hostname }} {{ ansible_date_time.epoch }}

We can do math like {{ 1+3 }}

Standard data types, like my list: {{ ('a','b','c') }}

We can call standard methods associated with our types:

{{ "lorem ipsum".upper() }} {{ ['a','b','c'].pop() }}

Inline Conditionals: {{ '[%s]' % page.title if page.title }}

Built-in Filters:

{{ my_var | default('my_var undefined') }}

Maths: abs, int, float, round, sumStr: capitalize, length, center, escape, lower, regexLists: join, last, sort, shuffle, json_query

Loops:<ul>{% for href, caption in my_list }} <li><a href="{{ href }}">{{ caption }}</a></li>{% endfor %}</ul>

Conditionals:{% if kenny.sick %} Kenny is sick.{% elif kenny.dead %} You killed Kenny! You bastard!!!{% else %} Kenny looks okay --- so far{% endif %}

{# Note: Nothing in the comment will be included in the template output {% for user in users %} ... {% endfor %}#}

{"changed": false, "failed": true, "msg": "AnsibleUndefinedVariable: 'my_var' is undefined"}

{"changed": false, "failed": true, "msg": "AnsibleError: template error while templating string: expected token 'end of print statement', got '...' String: <...>"}

Include as first line in the template file:

{% include "file1.j2" %}

{% include ['file1.j2', 'file2.j2'] %}

Alternation:{% for row in rows %} <li class="{{ loop.cycle('odd', 'even') }}">{{ row }}</li>{% endfor %}

Empty Lists:<ul>{% for user in users %} <li>{{ user.username|e }}</li>{% else %} <li><em>no users found</em></li>{% endfor %}</ul>

Sort by Attribute:

{% for item in iterable|sort(attribute='date') %} ...{% endfor %}

Group by Attribute:

{% for group in persons|groupby('gender') %} <li>{{ group.grouper }}<ul> {% for person in group.list %} <li>{{ person.first_name }}</li> {% endfor %}</ul></li>{% endfor %}

@KeithResar

@KeithResar