| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384 |
- Metadata-Version: 2.4
- Name: Jinja2
- Version: 3.1.6
- Summary: A very fast and expressive template engine.
- Maintainer-email: Pallets <contact@palletsprojects.com>
- Requires-Python: >=3.7
- Description-Content-Type: text/markdown
- Classifier: Development Status :: 5 - Production/Stable
- Classifier: Environment :: Web Environment
- Classifier: Intended Audience :: Developers
- Classifier: License :: OSI Approved :: BSD License
- Classifier: Operating System :: OS Independent
- Classifier: Programming Language :: Python
- Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
- Classifier: Topic :: Text Processing :: Markup :: HTML
- Classifier: Typing :: Typed
- License-File: LICENSE.txt
- Requires-Dist: MarkupSafe>=2.0
- Requires-Dist: Babel>=2.7 ; extra == "i18n"
- Project-URL: Changes, https://jinja.palletsprojects.com/changes/
- Project-URL: Chat, https://discord.gg/pallets
- Project-URL: Documentation, https://jinja.palletsprojects.com/
- Project-URL: Donate, https://palletsprojects.com/donate
- Project-URL: Source, https://github.com/pallets/jinja/
- Provides-Extra: i18n
- # 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
- ```jinja
- {% 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][].
- [please donate today]: https://palletsprojects.com/donate
- ## Contributing
- See our [detailed contributing documentation][contrib] for many ways to
- contribute, including reporting issues, requesting features, asking or answering
- questions, and making PRs.
- [contrib]: https://palletsprojects.com/contributing/
|
