python (3.12.0)
1 """Different kinds of SAX Exceptions"""
2
3 # ===== SAXEXCEPTION =====
4
5 class ESC[4;38;5;81mSAXException(ESC[4;38;5;149mException):
6 """Encapsulate an XML error or warning. This class can contain
7 basic error or warning information from either the XML parser or
8 the application: you can subclass it to provide additional
9 functionality, or to add localization. Note that although you will
10 receive a SAXException as the argument to the handlers in the
11 ErrorHandler interface, you are not actually required to raise
12 the exception; instead, you can simply read the information in
13 it."""
14
15 def __init__(self, msg, exception=None):
16 """Creates an exception. The message is required, but the exception
17 is optional."""
18 self._msg = msg
19 self._exception = exception
20 Exception.__init__(self, msg)
21
22 def getMessage(self):
23 "Return a message for this exception."
24 return self._msg
25
26 def getException(self):
27 "Return the embedded exception, or None if there was none."
28 return self._exception
29
30 def __str__(self):
31 "Create a string representation of the exception."
32 return self._msg
33
34 def __getitem__(self, ix):
35 """Avoids weird error messages if someone does exception[ix] by
36 mistake, since Exception has __getitem__ defined."""
37 raise AttributeError("__getitem__")
38
39
40 # ===== SAXPARSEEXCEPTION =====
41
42 class ESC[4;38;5;81mSAXParseException(ESC[4;38;5;149mSAXException):
43 """Encapsulate an XML parse error or warning.
44
45 This exception will include information for locating the error in
46 the original XML document. Note that although the application will
47 receive a SAXParseException as the argument to the handlers in the
48 ErrorHandler interface, the application is not actually required
49 to raise the exception; instead, it can simply read the
50 information in it and take a different action.
51
52 Since this exception is a subclass of SAXException, it inherits
53 the ability to wrap another exception."""
54
55 def __init__(self, msg, exception, locator):
56 "Creates the exception. The exception parameter is allowed to be None."
57 SAXException.__init__(self, msg, exception)
58 self._locator = locator
59
60 # We need to cache this stuff at construction time.
61 # If this exception is raised, the objects through which we must
62 # traverse to get this information may be deleted by the time
63 # it gets caught.
64 self._systemId = self._locator.getSystemId()
65 self._colnum = self._locator.getColumnNumber()
66 self._linenum = self._locator.getLineNumber()
67
68 def getColumnNumber(self):
69 """The column number of the end of the text where the exception
70 occurred."""
71 return self._colnum
72
73 def getLineNumber(self):
74 "The line number of the end of the text where the exception occurred."
75 return self._linenum
76
77 def getPublicId(self):
78 "Get the public identifier of the entity where the exception occurred."
79 return self._locator.getPublicId()
80
81 def getSystemId(self):
82 "Get the system identifier of the entity where the exception occurred."
83 return self._systemId
84
85 def __str__(self):
86 "Create a string representation of the exception."
87 sysid = self.getSystemId()
88 if sysid is None:
89 sysid = "<unknown>"
90 linenum = self.getLineNumber()
91 if linenum is None:
92 linenum = "?"
93 colnum = self.getColumnNumber()
94 if colnum is None:
95 colnum = "?"
96 return "%s:%s:%s: %s" % (sysid, linenum, colnum, self._msg)
97
98
99 # ===== SAXNOTRECOGNIZEDEXCEPTION =====
100
101 class ESC[4;38;5;81mSAXNotRecognizedException(ESC[4;38;5;149mSAXException):
102 """Exception class for an unrecognized identifier.
103
104 An XMLReader will raise this exception when it is confronted with an
105 unrecognized feature or property. SAX applications and extensions may
106 use this class for similar purposes."""
107
108
109 # ===== SAXNOTSUPPORTEDEXCEPTION =====
110
111 class ESC[4;38;5;81mSAXNotSupportedException(ESC[4;38;5;149mSAXException):
112 """Exception class for an unsupported operation.
113
114 An XMLReader will raise this exception when a service it cannot
115 perform is requested (specifically setting a state or value). SAX
116 applications and extensions may use this class for similar
117 purposes."""
118
119 # ===== SAXNOTSUPPORTEDEXCEPTION =====
120
121 class ESC[4;38;5;81mSAXReaderNotAvailable(ESC[4;38;5;149mSAXNotSupportedException):
122 """Exception class for a missing driver.
123
124 An XMLReader module (driver) should raise this exception when it
125 is first imported, e.g. when a support module cannot be imported.
126 It also may be raised during parsing, e.g. if executing an external
127 program is not permitted."""
Browse
Usage
Versions