OLD | NEW |
(Empty) | |
| 1 # -*- coding: utf-8 -*- |
| 2 """ |
| 3 jinja2.exceptions |
| 4 ~~~~~~~~~~~~~~~~~ |
| 5 |
| 6 Jinja exceptions. |
| 7 |
| 8 :copyright: (c) 2010 by the Jinja Team. |
| 9 :license: BSD, see LICENSE for more details. |
| 10 """ |
| 11 |
| 12 |
| 13 class TemplateError(Exception): |
| 14 """Baseclass for all template errors.""" |
| 15 |
| 16 def __init__(self, message=None): |
| 17 if message is not None: |
| 18 message = unicode(message).encode('utf-8') |
| 19 Exception.__init__(self, message) |
| 20 |
| 21 @property |
| 22 def message(self): |
| 23 if self.args: |
| 24 message = self.args[0] |
| 25 if message is not None: |
| 26 return message.decode('utf-8', 'replace') |
| 27 |
| 28 |
| 29 class TemplateNotFound(IOError, LookupError, TemplateError): |
| 30 """Raised if a template does not exist.""" |
| 31 |
| 32 # looks weird, but removes the warning descriptor that just |
| 33 # bogusly warns us about message being deprecated |
| 34 message = None |
| 35 |
| 36 def __init__(self, name, message=None): |
| 37 IOError.__init__(self) |
| 38 if message is None: |
| 39 message = name |
| 40 self.message = message |
| 41 self.name = name |
| 42 self.templates = [name] |
| 43 |
| 44 def __str__(self): |
| 45 return self.message.encode('utf-8') |
| 46 |
| 47 # unicode goes after __str__ because we configured 2to3 to rename |
| 48 # __unicode__ to __str__. because the 2to3 tree is not designed to |
| 49 # remove nodes from it, we leave the above __str__ around and let |
| 50 # it override at runtime. |
| 51 def __unicode__(self): |
| 52 return self.message |
| 53 |
| 54 |
| 55 class TemplatesNotFound(TemplateNotFound): |
| 56 """Like :class:`TemplateNotFound` but raised if multiple templates |
| 57 are selected. This is a subclass of :class:`TemplateNotFound` |
| 58 exception, so just catching the base exception will catch both. |
| 59 |
| 60 .. versionadded:: 2.2 |
| 61 """ |
| 62 |
| 63 def __init__(self, names=(), message=None): |
| 64 if message is None: |
| 65 message = u'non of the templates given were found: ' + \ |
| 66 u', '.join(map(unicode, names)) |
| 67 TemplateNotFound.__init__(self, names and names[-1] or None, message) |
| 68 self.templates = list(names) |
| 69 |
| 70 |
| 71 class TemplateSyntaxError(TemplateError): |
| 72 """Raised to tell the user that there is a problem with the template.""" |
| 73 |
| 74 def __init__(self, message, lineno, name=None, filename=None): |
| 75 TemplateError.__init__(self, message) |
| 76 self.lineno = lineno |
| 77 self.name = name |
| 78 self.filename = filename |
| 79 self.source = None |
| 80 |
| 81 # this is set to True if the debug.translate_syntax_error |
| 82 # function translated the syntax error into a new traceback |
| 83 self.translated = False |
| 84 |
| 85 def __str__(self): |
| 86 return unicode(self).encode('utf-8') |
| 87 |
| 88 # unicode goes after __str__ because we configured 2to3 to rename |
| 89 # __unicode__ to __str__. because the 2to3 tree is not designed to |
| 90 # remove nodes from it, we leave the above __str__ around and let |
| 91 # it override at runtime. |
| 92 def __unicode__(self): |
| 93 # for translated errors we only return the message |
| 94 if self.translated: |
| 95 return self.message |
| 96 |
| 97 # otherwise attach some stuff |
| 98 location = 'line %d' % self.lineno |
| 99 name = self.filename or self.name |
| 100 if name: |
| 101 location = 'File "%s", %s' % (name, location) |
| 102 lines = [self.message, ' ' + location] |
| 103 |
| 104 # if the source is set, add the line to the output |
| 105 if self.source is not None: |
| 106 try: |
| 107 line = self.source.splitlines()[self.lineno - 1] |
| 108 except IndexError: |
| 109 line = None |
| 110 if line: |
| 111 lines.append(' ' + line.strip()) |
| 112 |
| 113 return u'\n'.join(lines) |
| 114 |
| 115 |
| 116 class TemplateAssertionError(TemplateSyntaxError): |
| 117 """Like a template syntax error, but covers cases where something in the |
| 118 template caused an error at compile time that wasn't necessarily caused |
| 119 by a syntax error. However it's a direct subclass of |
| 120 :exc:`TemplateSyntaxError` and has the same attributes. |
| 121 """ |
| 122 |
| 123 |
| 124 class TemplateRuntimeError(TemplateError): |
| 125 """A generic runtime error in the template engine. Under some situations |
| 126 Jinja may raise this exception. |
| 127 """ |
| 128 |
| 129 |
| 130 class UndefinedError(TemplateRuntimeError): |
| 131 """Raised if a template tries to operate on :class:`Undefined`.""" |
| 132 |
| 133 |
| 134 class SecurityError(TemplateRuntimeError): |
| 135 """Raised if a template tries to do something insecure if the |
| 136 sandbox is enabled. |
| 137 """ |
| 138 |
| 139 |
| 140 class FilterArgumentError(TemplateRuntimeError): |
| 141 """This error is raised if a filter was called with inappropriate |
| 142 arguments |
| 143 """ |
OLD | NEW |