mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-10-24 06:06:09 +00:00
Code Issues 32 Releases Wiki Activity

[1.6.x] Fixed #20962 -- Documented that template tag render() may raise exceptions.

Browse Source 
Thanks Keryn Knight for the report.

Backport of e077224f4a from master
This commit is contained in:
Bouke Haarsma
2013-10-14 14:43:55 +02:00
committed by Tim Graham
parent 8222a48253
commit 7f566fdb4c
2 changed files with 7 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/howto/custom-template-tags.txt
View File

@@ -477,8 +477,12 @@ Notes:
* The ``render()`` method is where the work actually happens.
* ``render()`` should never raise ``TemplateSyntaxError`` or any other
exception. It should fail silently, just as template filters should.
* ``render()`` should generally fail silently, particularly in a production
environment where :setting:`DEBUG` and :setting:`TEMPLATE_DEBUG` are
``False``. In some cases however, particularly if :setting:`TEMPLATE_DEBUG` is
``True``, this method may raise an exception to make debugging easier. For
example, several core tags raise ``django.template.TemplateSyntaxError``
if they receive the wrong number or type of arguments.
Ultimately, this decoupling of compilation and rendering results in an
efficient template system, because a template can render multiple contexts