jinja2 · Python Simple Repository Browser

Project Links

Meta

Author: Armin Ronacher

Maintainer: Pallets

Classifiers

Development Status

5 - Production/Stable

Environment

Web Environment

Intended Audience

Developers

License

OSI Approved :: BSD License

Operating System

OS Independent

Programming Language

Python
Python :: 2
Python :: 2.7
Python :: 3
Python :: 3.5
Python :: 3.6
Python :: 3.7
Python :: Implementation :: CPython
Python :: Implementation :: PyPy

Topic

Internet :: WWW/HTTP :: Dynamic Content
Software Development :: Libraries :: Python Modules
Text Processing :: Markup :: HTML

Jinja is a fast, expressive, extensible templating engine. Special placeholders in the template allow writing code similar to Python syntax. Then the template is passed data to render the final document.

It includes:

Template inheritance and inclusion.
Define and import macros within templates.
HTML templates can use autoescaping to prevent XSS from untrusted user input.
A sandboxed environment can safely render untrusted templates.
AsyncIO support for generating templates and calling async functions.
I18N support with Babel.
Templates are compiled to optimized Python code just-in-time and cached, or can be compiled ahead-of-time.
Exceptions point to the correct line in templates to make debugging easier.
Extensible filters, tests, functions, and even syntax.

Jinja’s philosophy is that while application logic belongs in Python if possible, it shouldn’t make the template designer’s job difficult by restricting functionality too much.

Installing

Install and update using pip:

$ pip install -U Jinja2

In A Nutshell

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