.. _spkg_jinja2:

jinja2: General purpose template engine for Python
==================================================

Description
-----------

Jinja2 is a library for Python 2.4 and onwards that is designed to be
flexible, fast and secure.

If you have any exposure to other text-based template languages, such as
Smarty or Django, you should feel right at home with Jinja2. It's both
designer and developer friendly by sticking to Python's principles and
adding functionality useful for templating environments.

License
-------

Modified BSD License


Upstream Contact
----------------

Author: Pocoo Team <http://pocoo.org>

Homepage: http://jinja.pocoo.org/

Special Update/Build Instructions
---------------------------------

None. (Just make sure its prerequisites are new enough in Sage, to avoid
downloads during the build / installation.)

Type
----

standard


Dependencies
------------

- $(PYTHON)
- :ref:`spkg_markupsafe`
- :ref:`spkg_docutils`
- $(PYTHON_TOOLCHAIN)

Version Information
-------------------

package-version.txt::

    3.1.2

install-requires.txt::

    jinja2 >=2.11.2


Equivalent System Packages
--------------------------

conda:

.. CODE-BLOCK:: bash

    $ conda install  jinja2


macports:
install the following packages: py-jinja2

opensuse:

.. CODE-BLOCK:: bash

    $ sudo zypper install python3-Jinja2


void:

.. CODE-BLOCK:: bash

    $ sudo xbps-install  python3-Jinja2


See https://repology.org/project/python:jinja2/versions


However, these system packages will not be used for building Sage
because using Python site-packages is not supported by the Sage distribution;
see :trac:`29023`

