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