p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Deprecated function-based loaders.

This commit is contained in:
Aymeric Augustin 2014-11-15 19:55:53 +01:00
parent 0bf99193f8
commit 1851dcf377
3 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
django/template/loader.py
View File

@ -37,6 +37,12 @@ def find_template_loader(loader):
if hasattr(TemplateLoader, 'load_template_source'): if hasattr(TemplateLoader, 'load_template_source'):
func = TemplateLoader(*args) func = TemplateLoader(*args)
else: else:
warnings.warn(
"Function-based template loaders are deprecated. Please use "
"class-based template loaders instead. Inherit base.Loader "
"and provide a load_template_source() method.",
RemovedInDjango20Warning, stacklevel=2)
# Try loading module the old way - string is full path to callable # Try loading module the old way - string is full path to callable
if args: if args:
raise ImproperlyConfigured( raise ImproperlyConfigured(

2
docs/internals/deprecation.txt
View File

@ -85,6 +85,8 @@ details on these changes.
* The backwards compatibility alias ``django.template.loader.BaseLoader`` will * The backwards compatibility alias ``django.template.loader.BaseLoader`` will
be removed. be removed.
* Support for function-based template loaders will be removed.
.. _deprecation-removed-in-1.9: .. _deprecation-removed-in-1.9:
1.9 1.9

7
docs/releases/1.8.txt
View File

@ -1040,6 +1040,13 @@ class decorators. As a consequence, when overriding ``setUpClass()`` or
``django.template.loaders.base.Loader``. If you've written a custom template ``django.template.loaders.base.Loader``. If you've written a custom template
loader that inherits ``BaseLoader``, you must inherit ``Loader`` instead. loader that inherits ``BaseLoader``, you must inherit ``Loader`` instead.
Function-based template loaders
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
In addition to the documented class-based API for custom template loaders,
Django still supported to some extent an earlier function-based API. This
private API wasn't maintained or tested. Now it's formally deprecated.
``django.test.utils.TestTemplateLoader`` ``django.test.utils.TestTemplateLoader``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~