1997-10-06 17:19:59 -03:00
|
|
|
"""Class based built-in exception hierarchy.
|
|
|
|
|
|
|
|
This is a new feature whereby all the standard built-in exceptions,
|
|
|
|
traditionally string objects, are replaced with classes. This gives
|
|
|
|
Python's exception handling mechanism a more object-oriented feel.
|
|
|
|
|
|
|
|
Most existing code should continue to work with class based
|
|
|
|
exceptions. Some tricky uses of IOError may break, but the most
|
|
|
|
common uses should work.
|
|
|
|
|
|
|
|
To disable this feature, start the Python executable with the -X option.
|
|
|
|
|
|
|
|
Here is a rundown of the class hierarchy. You can change this by
|
|
|
|
editing this file, but it isn't recommended. The classes with a `*'
|
|
|
|
are new with this feature. They are defined as tuples containing the
|
|
|
|
derived exceptions when string-based exceptions are used.
|
|
|
|
|
|
|
|
Exception(*)
|
|
|
|
|
|
|
|
|
+-- StandardError(*)
|
|
|
|
|
|
|
|
|
+-- SystemExit
|
|
|
|
+-- KeyboardInterrupt
|
|
|
|
+-- ImportError
|
|
|
|
+-- IOError
|
|
|
|
+-- EOFError
|
|
|
|
+-- RuntimeError
|
|
|
|
+-- NameError
|
|
|
|
+-- AttributeError
|
|
|
|
+-- SyntaxError
|
|
|
|
+-- TypeError
|
|
|
|
+-- AssertionError
|
|
|
|
+-- LookupError(*)
|
|
|
|
| |
|
|
|
|
| +-- IndexError
|
|
|
|
| +-- KeyError
|
|
|
|
|
|
|
|
|
+-- ArithmeticError(*)
|
|
|
|
| |
|
|
|
|
| +-- OverflowError
|
|
|
|
| +-- ZeroDivisionError
|
|
|
|
| +-- FloatingPointError
|
|
|
|
|
|
|
|
|
+-- ValueError
|
|
|
|
+-- SystemError
|
|
|
|
+-- MemoryError
|
|
|
|
"""
|
|
|
|
|
|
|
|
class Exception:
|
|
|
|
def __init__(self, *args):
|
1998-03-26 18:14:20 -04:00
|
|
|
self.args = args
|
1997-10-06 17:19:59 -03:00
|
|
|
|
|
|
|
def __str__(self):
|
|
|
|
if not self.args:
|
|
|
|
return ''
|
1998-03-26 18:14:20 -04:00
|
|
|
elif len(self.args) == 1:
|
|
|
|
return str(self.args[0])
|
|
|
|
else:
|
|
|
|
return str(self.args)
|
1997-10-06 17:19:59 -03:00
|
|
|
|
|
|
|
def __getitem__(self, i):
|
1998-03-26 18:14:20 -04:00
|
|
|
return self.args[i]
|
1997-10-06 17:19:59 -03:00
|
|
|
|
|
|
|
class StandardError(Exception):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class SyntaxError(StandardError):
|
|
|
|
filename = lineno = offset = text = None
|
|
|
|
msg = ""
|
|
|
|
def __init__(self, *args):
|
1998-03-26 18:14:20 -04:00
|
|
|
self.args = args
|
|
|
|
if len(self.args) >= 1:
|
|
|
|
self.msg = self.args[0]
|
|
|
|
if len(self.args) == 2:
|
|
|
|
info = self.args[1]
|
|
|
|
try:
|
|
|
|
self.filename, self.lineno, self.offset, self.text = info
|
|
|
|
except:
|
|
|
|
pass
|
1997-10-06 17:19:59 -03:00
|
|
|
def __str__(self):
|
|
|
|
return str(self.msg)
|
|
|
|
|
1998-08-11 23:38:11 -03:00
|
|
|
class EnvironmentError(StandardError):
|
|
|
|
"""Base class for exceptions that occur outside the Python system.
|
|
|
|
Primarily used as a base class for OSError and IOError."""
|
1997-10-06 17:19:59 -03:00
|
|
|
def __init__(self, *args):
|
1998-03-26 18:14:20 -04:00
|
|
|
self.args = args
|
1997-10-06 17:19:59 -03:00
|
|
|
self.errno = None
|
|
|
|
self.strerror = None
|
1998-08-11 23:38:11 -03:00
|
|
|
self.filename = None
|
|
|
|
if len(args) == 3:
|
|
|
|
# open() errors give third argument which is the filename. BUT,
|
|
|
|
# so common in-place unpacking doesn't break, e.g.:
|
|
|
|
#
|
|
|
|
# except IOError, (errno, strerror):
|
|
|
|
#
|
|
|
|
# we hack args so that it only contains two items. This also
|
|
|
|
# means we need our own __str__() which prints out the filename
|
|
|
|
# when it was supplied.
|
|
|
|
self.errno, self.strerror, self.filename = args
|
|
|
|
self.args = args[0:2]
|
1997-10-06 17:19:59 -03:00
|
|
|
if len(args) == 2:
|
|
|
|
# common case: PyErr_SetFromErrno()
|
1998-08-11 23:38:11 -03:00
|
|
|
self.errno, self.strerror = args
|
|
|
|
|
|
|
|
def __str__(self):
|
|
|
|
if self.filename is not None:
|
|
|
|
return '[Errno %s] %s: %s' % (self.errno, self.strerror,
|
|
|
|
repr(self.filename))
|
|
|
|
elif self.errno and self.strerror:
|
|
|
|
return '[Errno %s] %s' % (self.errno, self.strerror)
|
|
|
|
else:
|
|
|
|
return StandardError.__str__(self)
|
|
|
|
|
|
|
|
class IOError(EnvironmentError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class OSError(EnvironmentError):
|
|
|
|
"""Used by the posix module."""
|
|
|
|
pass
|
1997-10-06 17:19:59 -03:00
|
|
|
|
|
|
|
class RuntimeError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class SystemError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class EOFError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class ImportError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class TypeError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class ValueError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class KeyboardInterrupt(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class AssertionError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class ArithmeticError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class OverflowError(ArithmeticError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class FloatingPointError(ArithmeticError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class ZeroDivisionError(ArithmeticError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class LookupError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class IndexError(LookupError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class KeyError(LookupError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class AttributeError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class NameError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class MemoryError(StandardError):
|
|
|
|
pass
|
|
|
|
|
|
|
|
class SystemExit(Exception):
|
|
|
|
def __init__(self, *args):
|
1998-03-26 18:14:20 -04:00
|
|
|
self.args = args
|
1997-10-06 17:19:59 -03:00
|
|
|
if len(args) == 0:
|
|
|
|
self.code = None
|
|
|
|
elif len(args) == 1:
|
|
|
|
self.code = args[0]
|
|
|
|
else:
|
|
|
|
self.code = args
|