blob: 3510b37697b197c175a1e63ff49161c66de569de [file] [log] [blame]
Armin Ronacherde478f62007-02-28 22:35:04 +01001# -*- coding: utf-8 -*-
Armin Ronacher58293062008-02-11 15:36:22 +01002"""
Armin Ronacher203bfcb2008-04-24 21:54:44 +02003Jinja2
4~~~~~~
Armin Ronacher58293062008-02-11 15:36:22 +01005
Armin Ronacher203bfcb2008-04-24 21:54:44 +02006Jinja2 is a template engine written in pure Python. It provides a
7`Django`_ inspired non-XML syntax but supports inline expressions and
8an optional `sandboxed`_ environment.
Armin Ronacher58293062008-02-11 15:36:22 +01009
10Nutshell
11--------
12
13Here a small example of a Jinja template::
14
15 {% extends 'base.html' %}
16 {% block title %}Memberlist{% endblock %}
17 {% block content %}
18 <ul>
19 {% for user in users %}
Armin Ronacher203bfcb2008-04-24 21:54:44 +020020 <li><a href="{{ user.url }}">{{ user.username }}</a></li>
Armin Ronacher58293062008-02-11 15:36:22 +010021 {% endfor %}
22 </ul>
23 {% endblock %}
24
25Philosophy
26----------
27
28Application logic is for the controller but don't try to make the life
29for the template designer too hard by giving him too few functionality.
30
Armin Ronacherf4e1fb42008-06-09 18:54:56 +020031For more informations visit the new `Jinja2 webpage`_ and `documentation`_.
Armin Ronacher58293062008-02-11 15:36:22 +010032
Jon Dufresne3b1ddea2017-04-09 15:18:38 -070033.. _sandboxed: https://en.wikipedia.org/wiki/Sandbox_(computer_security)
34.. _Django: https://www.djangoproject.com/
Armin Ronacherf4e1fb42008-06-09 18:54:56 +020035.. _Jinja2 webpage: http://jinja.pocoo.org/
Armin Ronacher1a12c8a2008-06-09 18:49:14 +020036.. _documentation: http://jinja.pocoo.org/2/documentation/
Armin Ronacher58293062008-02-11 15:36:22 +010037"""
Cory Benfield447d3d22013-05-18 10:35:04 +010038from setuptools import setup
Armin Ronacher10c34da2010-08-17 12:10:27 +020039
Armin Ronacherde478f62007-02-28 22:35:04 +010040
Armin Ronacherde478f62007-02-28 22:35:04 +010041setup(
Armin Ronacher203bfcb2008-04-24 21:54:44 +020042 name='Jinja2',
David Lordc4c40882019-04-06 11:02:53 -070043 version='2.10.1',
Armin Ronacher015b0c92007-11-11 00:10:17 +010044 url='http://jinja.pocoo.org/',
45 license='BSD',
46 author='Armin Ronacher',
47 author_email='[email protected]',
48 description='A small but fast and easy to use stand-alone template '
49 'engine written in pure python.',
Armin Ronacherbd33f112008-04-18 09:17:32 +020050 long_description=__doc__,
Armin Ronacher86b5cb52009-09-13 00:23:27 -070051 # jinja is egg safe. But we hate eggs
Armin Ronacher015b0c92007-11-11 00:10:17 +010052 zip_safe=False,
53 classifiers=[
Armin Ronachera9d59222008-07-18 00:41:37 +020054 'Development Status :: 5 - Production/Stable',
Armin Ronacherde478f62007-02-28 22:35:04 +010055 'Environment :: Web Environment',
56 'Intended Audience :: Developers',
57 'License :: OSI Approved :: BSD License',
58 'Operating System :: OS Independent',
59 'Programming Language :: Python',
Markus Unterwaditzer62f57f42015-06-01 17:12:56 +020060 'Programming Language :: Python :: 2',
61 'Programming Language :: Python :: 2.6',
62 'Programming Language :: Python :: 2.7',
Armin Ronacherd9599c82010-02-10 02:19:17 +010063 'Programming Language :: Python :: 3',
Markus Unterwaditzer62f57f42015-06-01 17:12:56 +020064 'Programming Language :: Python :: 3.3',
Sebastian Noack6c54ccd2015-10-06 16:13:45 +020065 'Programming Language :: Python :: 3.4',
66 'Programming Language :: Python :: 3.5',
Jon Dufresne27fffd42017-04-09 14:24:33 -070067 'Programming Language :: Python :: 3.6',
Armin Ronacher8ebf1f92007-03-03 11:22:18 +010068 'Topic :: Internet :: WWW/HTTP :: Dynamic Content',
69 'Topic :: Software Development :: Libraries :: Python Modules',
70 'Topic :: Text Processing :: Markup :: HTML'
71 ],
Kartheek Lenkala9d4afa12015-03-22 15:28:54 +053072 packages=['jinja2'],
Armin Ronacher5453db12017-01-06 13:00:34 +010073 install_requires=['MarkupSafe>=0.23'],
Armin Ronacher2b60fe52008-04-21 08:23:59 +020074 extras_require={'i18n': ['Babel>=0.8']},
Armin Ronacher790b8a82010-02-10 00:05:46 +010075 include_package_data=True,
Armin Ronacherf59bac22008-04-20 13:11:43 +020076 entry_points="""
77 [babel.extractors]
Armin Ronacher7962ce72008-05-20 17:52:52 +020078 jinja2 = jinja2.ext:babel_extract[i18n]
Cory Benfield447d3d22013-05-18 10:35:04 +010079 """
Armin Ronacherde478f62007-02-28 22:35:04 +010080)