openstack/deb-python-jingo
Code Issues Proposed changes

Version 0.9

Browse Source
This commit is contained in:
James Socol 2016-05-30 14:31:52 -04:00
parent 2c00f82b81
commit fee58b2b89
3 changed files with 22 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
README.rst
View File

@ -12,22 +12,32 @@ Jingo
Jingo is an adapter for using Jinja2_ templates within Django. Jingo is an adapter for using Jinja2_ templates within Django.
NB: Django 1.8 and django-jinja Jingo is DEPRECATED
------------------------------- -------------------
In version 1.8, Django added support for multiple template engines, and In version 1.8, Django added support for multiple template engines, and provided
the django-jinja_ project leverages that to support Jinja2_, while Jingo a Jinja2 backend. The django-jinja_ project leverages that to support Jinja2,
does not. while Jingo does not.
**django-jinja is recommended for new projects.** Jingo supports Django **django-jinja is recommended for new projects.** Jingo >=0.8 supports Django
1.8, but it is not clear that its method will continue work beyond that. 1.8, but it will not be maintained beyond version 0.9, and **will not** support
If you're already using Jingo, and not ready to make `the switch`_, Django 1.9 or above. If you're already using Jingo, and not ready to make `the
Jingo will continue to work for now, but is undecided about continuing switch`_, Jingo should continue to work for now, though not without some effort.
to support new Django versions.
0.9_ will be the last release of Jingo, unless a new maintainer comes along with
a new direction.
As of 0.9, Jingo's built-in helpers are provided via a `Jinja2 extension`_ to
simplify moving away from Jingo. The entire ``jingo/ext.py`` file can be copied
into another project, or referenced as ``'jingo.ext.JingoExtension'``. Used in
this way, Jingo plays nicely with django-jinja (and theoretically Django's
built-in Jinja2 backend).
.. _django-jinja: https://github.com/niwinz/django-jinja .. _django-jinja: https://github.com/niwinz/django-jinja
.. _the switch: http://bluesock.org/~willkg/blog/mozilla/input_django_1_8_upgrade.html#switching-from-jingo-to-django-jinja .. _the switch: http://bluesock.org/~willkg/blog/mozilla/input_django_1_8_upgrade.html#switching-from-jingo-to-django-jinja
.. _Jinja2: http://jinja.pocoo.org/2/ .. _Jinja2: http://jinja.pocoo.org/2/
.. _0.9: https://https://pypi.python.org/pypi/jingo/0.9.0
.. _Jinja2 extension: https://github.com/jbalogh/jingo/blob/master/jingo/ext.py
.. _usage: .. _usage:

2
jingo/__init__.py
View File

@ -58,7 +58,7 @@ except ImportError:
from django.template.context import get_standard_processors from django.template.context import get_standard_processors
has_engine = False has_engine = False
VERSION = (0, 8, 2) VERSION = (0, 9, 0)
__version__ = '.'.join(map(str, VERSION)) __version__ = '.'.join(map(str, VERSION))
EXCLUDE_APPS = ( EXCLUDE_APPS = (

2
setup.py
View File

@ -3,7 +3,7 @@ from setuptools import setup
setup( setup(
name='jingo', name='jingo',
version='0.8.2', version='0.9.0',
description='An adapter for using Jinja2 templates with Django.', description='An adapter for using Jinja2 templates with Django.',
long_description=open('README.rst').read(), long_description=open('README.rst').read(),
author='James Socol', author='James Socol',