Startseite › Entwickler-Tools › Jinja2 Template-Tester

Jinja2 Template-Tester

Füge ein Jinja2-Template und seine Variablen in YAML oder JSON ein und sieh das gerenderte Ergebnis schon beim Tippen. Es läuft die echte Jinja2-Bibliothek (Python, über Pyodide) in deinem Browser, daher stimmen Leerzeichen, Filter und Fehlermeldungen mit Ansible, Flask oder Salt überein.

Zuletzt aktualisiert:

Umgebung
Strg + Eingabe rendert


Anzeige
Anzeige

Anleitung: Jinja2 Template-Tester

  1. Wähle ein Beispiel oder füge dein Template ein – in das Feld „Template“ (zum Beispiel eine Ansible-.j2-Datei).
  2. Gib die Variablen als YAML oder JSON in das Feld „Variablen“ ein. Die oberste Ebene muss aus Schlüssel-Wert-Paaren (key: value) bestehen.
  3. Wähle die Variante: Plain Jinja2, Ansible (zusätzliche Filter, strict undefined, trim_blocks) oder Flask (Autoescape).
  4. Lies die Ausgabe ab. Sie aktualisiert sich beim Tippen; aktiviere „Leerzeichen anzeigen“, um überzählige Leerzeichen und Leerzeilen zu sehen.
  5. Behebe Fehler anhand der markierten Zeilennummer und des Hinweises, dann kopiere den gerenderten Text oder lade ihn herunter.

Jinja2-Syntax auf einen Blick

SyntaxWas es machtBeispiel
{{ … }}Einen Ausdruck ausgeben{{ user.name | upper }}
{% … %}Anweisung: if, for, set, macro, block{% if port == 443 %}ssl{% endif %}
{# … #}Kommentar, wird nicht ausgegeben{# TODO: IPv6 ergänzen #}
{%- … -%}Leerraum vor / nach dem Tag entfernen{%- for x in xs -%}
| filterEinen Wert umwandeln, Filter lassen sich verketten{{ hosts | sort | join(', ') }}
is testEinen Wert prüfen{% if port is number %}, is defined
loop.*Schleifenhelfer innerhalb von forloop.index, loop.first, loop.last, loop.cycle('a','b')
namespace()Einen Wert behalten, der sich in einer Schleife ändert{% set ns = namespace(total=0) %}
~Werte als Strings verbinden{{ 'v' ~ version }}

Nützliche eingebaute Filter

FilterBeispielErgebnis
default{{ port | default(8080) }}8080, wenn port undefiniert ist
join{{ ['a','b'] | join('-') }}a-b
map / selectattr{{ users | selectattr('active') | map(attribute='name') | list }}Namen der aktiven Benutzer
groupby{% for k, items in rows | groupby('region') %}Zeilen gruppiert nach region
dictsort{% for k, v in cfg | dictsort %}Dictionary-Einträge nach Schlüssel sortiert
format{{ '%.2f' | format(3.14159) }}3.14
indent{{ block | indent(4) }}rückt jede Zeile nach der ersten um 4 Leerzeichen ein
tojson{{ data | tojson }}HTML-sicheres JSON für Skripte
truncate / wordcount{{ text | truncate(20) }}gekürzter Text, der mit ... endet

Tipps zum Debuggen von Templates

  • Aktiviere beim Testen strict undefined. Eine falsch geschriebene Variable löst dann einen Fehler mit Zeilennummer aus, statt nichts auszugeben.
  • Vorsicht bei Namen von Dict-Methoden. Schlüssel namens items, keys, values oder get müssen mit eckigen Klammern gelesen werden: data['items'].
  • In einer Schleife gesetzte Variablen überleben die Schleife nicht. Verwende namespace() für Zähler und Summen.
  • Verwende | int oder | float vor Berechnungen mit Werten, die aus YAML-Strings oder Ansible-Facts stammen.
  • Markiere nur vertrauenswürdiges HTML als sicher. Bei aktivem Autoescape gibt | safe rohes HTML aus, wodurch nicht vertrauenswürdige Eingaben Markup einschleusen können.

Häufige Fragen

Ist das echtes Jinja2 oder eine JavaScript-Nachbildung?

Es ist die echte Jinja2-Python-Bibliothek. Die Seite lädt Pyodide, eine Python-Version für den Browser, zusammen mit den offiziellen Paketen Jinja2 und PyYAML und rendert dein Template damit. Beim ersten Laden werden etwa 10 MB von einem öffentlichen CDN heruntergeladen; danach speichert dein Browser sie im Cache. Dein Template und deine Variablen verlassen nie dein Gerät.

Kann ich hier Ansible-Templates testen?

Ja. Wähle die Ansible-Variante: Sie aktiviert trim_blocks und keep_trailing_newline wie das template-Modul, macht undefinierte Variablen zum Fehler und ergänzt gängige Ansible-Filter wie to_nice_yaml, to_json, regex_replace, regex_search, combine, dict2items, ternary, bool, b64encode, basename und flatten. Ansible-Lookups, Facts und Plugins sind nicht verfügbar, definiere Facts wie ansible_hostname also selbst in den Variablen.

Warum enthält meine Ausgabe zusätzliche Leerzeilen?

Jedes {% … %}-Tag hinterlässt den Zeilenumbruch, der darauf folgt. Aktiviere trim_blocks, um den ersten Zeilenumbruch nach einem Block-Tag zu entfernen, lstrip_blocks, um die Einrückung davor zu entfernen, oder setze ein Minuszeichen in das Tag, wie bei {%- if x -%}, um Leerraum auf dieser Seite zu entfernen. „Leerzeichen anzeigen“ markiert Leerzeichen mit Punkten und Zeilenenden mit ¶.

Was passiert mit undefinierten Variablen?

In der Standardeinstellung wird eine undefinierte Variable als leerer String gerendert, was Tippfehler verbergen kann. Strict löst einen UndefinedError mit Zeilennummer aus, wie Ansible es tut. Chainable erlaubt a.b.c auf fehlenden Werten ohne Fehler, und Debug gibt den Platzhalter aus, zum Beispiel {{ missing_var }}. Die Chips unter der Ausgabe listen jede Variable auf, die das Template verwendet, und markieren die, die du nicht definiert hast.

Warum erhalte ich 'builtin_function_or_method' object is not iterable?

Deine Daten haben einen Schlüssel namens items, keys oder values, und order.items findet die Python-Dict-Methode statt deiner Liste. Schreib stattdessen order['items'] oder benenne den Schlüssel um. Dasselbe gilt für andere Dict-Methodennamen wie update, get oder pop.

Warum wird YAML yes oder on zu true?

Die Variablen werden mit PyYAML gelesen, das YAML 1.1 folgt – denselben Regeln, die Ansible verwendet. In YAML 1.1 sind yes, no, on und off Booleans. Setze den Wert in Anführungszeichen ("yes"), wenn du den Text brauchst.

Werden Makros, Includes und Template-Vererbung unterstützt?

Makros, call-Blöcke, Filter, Tests, Schleifen mit loop.index, set mit namespace(), do und break/continue funktionieren alle in dem einen Template, das du testest. include, import und extends brauchen andere Template-Dateien, die dieser Tester nicht hat – setze Makros also in dasselbe Template oder füge den Inhalt des Eltern-Templates ein.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Code-Generatoren & Builder ansehen →