venv/lib/python3.11/site-packages/Jinja2-3.1.2.dist-info/METADATA

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