1Metadata-Version: 2.1
2Name: Jinja2
3Version: 3.0.1
4Summary: A very fast and expressive template engine.
5Home-page: https://palletsprojects.com/p/jinja/
6Author: Armin Ronacher
7Author-email: armin.ronacher@active-4.com
8Maintainer: Pallets
9Maintainer-email: contact@palletsprojects.com
10License: BSD-3-Clause
11Project-URL: Donate, https://palletsprojects.com/donate
12Project-URL: Documentation, https://jinja.palletsprojects.com/
13Project-URL: Changes, https://jinja.palletsprojects.com/changes/
14Project-URL: Source Code, https://github.com/pallets/jinja/
15Project-URL: Issue Tracker, https://github.com/pallets/jinja/issues/
16Project-URL: Twitter, https://twitter.com/PalletsTeam
17Project-URL: Chat, https://discord.gg/pallets
18Platform: UNKNOWN
19Classifier: Development Status :: 5 - Production/Stable
20Classifier: Environment :: Web Environment
21Classifier: Intended Audience :: Developers
22Classifier: License :: OSI Approved :: BSD License
23Classifier: Operating System :: OS Independent
24Classifier: Programming Language :: Python
25Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
26Classifier: Topic :: Text Processing :: Markup :: HTML
27Requires-Python: >=3.6
28Description-Content-Type: text/x-rst
29Provides-Extra: i18n
30License-File: LICENSE.rst
31
32Jinja
33=====
34
35Jinja is a fast, expressive, extensible templating engine. Special
36placeholders in the template allow writing code similar to Python
37syntax. Then the template is passed data to render the final document.
38
39It includes:
40
41-   Template inheritance and inclusion.
42-   Define and import macros within templates.
43-   HTML templates can use autoescaping to prevent XSS from untrusted
44    user input.
45-   A sandboxed environment can safely render untrusted templates.
46-   AsyncIO support for generating templates and calling async
47    functions.
48-   I18N support with Babel.
49-   Templates are compiled to optimized Python code just-in-time and
50    cached, or can be compiled ahead-of-time.
51-   Exceptions point to the correct line in templates to make debugging
52    easier.
53-   Extensible filters, tests, functions, and even syntax.
54
55Jinja's philosophy is that while application logic belongs in Python if
56possible, it shouldn't make the template designer's job difficult by
57restricting functionality too much.
58
59
60Installing
61----------
62
63Install and update using `pip`_:
64
65.. code-block:: text
66
67    $ pip install -U Jinja2
68
69.. _pip: https://pip.pypa.io/en/stable/quickstart/
70
71
72In A Nutshell
73-------------
74
75.. code-block:: jinja
76
77    {% extends "base.html" %}
78    {% block title %}Members{% endblock %}
79    {% block content %}
80      <ul>
81      {% for user in users %}
82        <li><a href="{{ user.url }}">{{ user.username }}</a></li>
83      {% endfor %}
84      </ul>
85    {% endblock %}
86
87
88Donate
89------
90
91The Pallets organization develops and supports Jinja and other popular
92packages. In order to grow the community of contributors and users, and
93allow the maintainers to devote more time to the projects, `please
94donate today`_.
95
96.. _please donate today: https://palletsprojects.com/donate
97
98
99Links
100-----
101
102-   Documentation: https://jinja.palletsprojects.com/
103-   Changes: https://jinja.palletsprojects.com/changes/
104-   PyPI Releases: https://pypi.org/project/Jinja2/
105-   Source Code: https://github.com/pallets/jinja/
106-   Issue Tracker: https://github.com/pallets/jinja/issues/
107-   Website: https://palletsprojects.com/p/jinja/
108-   Twitter: https://twitter.com/PalletsTeam
109-   Chat: https://discord.gg/pallets
110
111
112