1 # -*- coding: utf-8 -*-
6 Jinja is a `sandboxed`_ template engine written in pure Python. It
7 provides a `Django`_ like non-XML syntax and compiles templates into
8 executable python code. It's basically a combination of Django templates
14 Here a small example of a Jinja template::
16 {% extends 'base.html' %}
17 {% block title %}Memberlist{% endblock %}
20 {% for user in users %}
21 <li><a href="{{ user.url|e }}">{{ user.username|e }}</a></li>
29 Application logic is for the controller but don't try to make the life
30 for the template designer too hard by giving him too few functionality.
32 For more informations visit the new `jinja webpage`_ and `documentation`_.
37 This is the Jinja 1.0 release which is completely incompatible with the
38 old "pre 1.0" branch. The old branch will still receive security updates
39 and bugfixes but the 1.0 branch will be the only version that receives
42 If you have an application that uses Jinja 0.9 and won't be updated in
43 the near future the best idea is to ship a Jinja 0.9 checkout together
46 The `Jinja tip`_ is installable via `easy_install` with ``easy_install
49 .. _sandboxed: http://en.wikipedia.org/wiki/Sandbox_(computer_security)
50 .. _Django: http://www.djangoproject.com/
51 .. _jinja webpage: http://jinja.pocoo.org/
52 .. _documentation: http://jinja.pocoo.org/documentation/index.html
53 .. _Jinja tip: http://dev.pocoo.org/hg/jinja-main/archive/tip.tar.gz#egg=Jinja-dev
58 ez_setup.use_setuptools()
60 from setuptools import setup, Extension, Feature
61 from distutils.command.build_ext import build_ext
62 from distutils.errors import CCompilerError, DistutilsPlatformError
66 for fn in os.listdir(path):
67 if fn.startswith('.'):
69 fn = os.path.join(path, fn)
70 if os.path.isfile(fn):
74 class optional_build_ext(build_ext):
75 """This class allows C extension building to fail."""
80 except DistutilsPlatformError:
83 def build_extension(self, ext):
85 build_ext.build_extension(self, ext)
86 except CCompilerError, x:
89 def _unavailable(self):
92 An optional C extension could not be compiled, speedups will not be
100 url='http://jinja.pocoo.org/',
102 author='Armin Ronacher',
103 author_email='armin.ronacher@active-4.com',
104 description='A small but fast and easy to use stand-alone template '
105 'engine written in pure python.',
106 long_description=__doc__,
107 # jinja is egg safe. But because we distribute the documentation
108 # in form of html and txt files it's a better idea to extract the files
111 'Development Status :: 1 - Alpha',
112 'Environment :: Web Environment',
113 'Intended Audience :: Developers',
114 'License :: OSI Approved :: BSD License',
115 'Operating System :: OS Independent',
116 'Programming Language :: Python',
117 'Topic :: Internet :: WWW/HTTP :: Dynamic Content',
118 'Topic :: Software Development :: Libraries :: Python Modules',
119 'Topic :: Text Processing :: Markup :: HTML'
123 ('docs/html', list(list_files('docs/html'))),
124 ('docs/txt', list(list_files('docs/src')))
127 'speedups': Feature("optional C speed-enhancements",
130 Extension('jinja2._speedups', ['jinja2/_speedups.c'])
134 extras_require={'plugin': ['setuptools>=0.6a2']}