Go to file
Kevin Brown-Silva ee832194cd
Add support for namespaces in tuple assignment
This fixes a bug that existed because namespaces within `{% set %}`
were treated as a special case. This special case had the side-effect
of bypassing the code which allows for tuples to be assigned to.

The solution was to make tuple handling (and by extension, primary token
handling) aware of namespaces so that namespace tokens can be handled
appropriately. This is handled in a backwards-compatible way which
ensures that we do not try to parse namespace tokens when we otherwise
would be expecting to parse out name tokens with attributes.

Namespace instance checks are moved earlier, and deduplicated, so that
all checks are done before the assignment. Otherwise, the check could be
emitted in the middle of the tuple.
2024-12-20 14:09:40 -08:00
.devcontainer update project files (#5457) 2024-04-23 09:28:57 -07:00
.github update test workflow trigger 2024-10-24 14:13:40 -07:00
artwork documentation style updates, added print css 2008-05-06 12:14:23 +02:00
docs Add support for namespaces in tuple assignment 2024-12-20 14:09:40 -08:00
examples/basic fix Jinja syntax in example 2024-12-18 09:44:30 -08:00
requirements update dev dependencies 2024-10-24 14:13:23 -07:00
scripts address flake8 findings 2023-03-07 06:55:44 -08:00
src/jinja2 Add support for namespaces in tuple assignment 2024-12-20 14:09:40 -08:00
tests Add support for namespaces in tuple assignment 2024-12-20 14:09:40 -08:00
.editorconfig update project files (#5457) 2024-04-23 09:28:57 -07:00
.gitignore update project files (#5457) 2024-04-23 09:28:57 -07:00
.pre-commit-config.yaml update dev dependencies 2024-10-24 14:13:23 -07:00
.readthedocs.yaml update project files (#5457) 2024-04-23 09:28:57 -07:00
CHANGES.rst Add support for namespaces in tuple assignment 2024-12-20 14:09:40 -08:00
CONTRIBUTING.rst Improve the contributing guide 2021-05-25 08:51:55 +08:00
LICENSE.txt update project files (#5457) 2024-04-23 09:28:57 -07:00
pyproject.toml apply ruff fixes 2024-08-23 16:49:44 -07:00
README.md Convert rST code block to Markdown in README 2024-05-19 09:51:33 -04:00
tox.ini refactor 3.7 test pins 2024-08-23 17:15:36 -07:00

Jinja

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.

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 %}

Donate

The Pallets organization develops and supports Jinja and other popular packages. In order to grow the community of contributors and users, and allow the maintainers to devote more time to the projects, please donate today.