1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
|
"""
This file contains the default classes that are used to receive events
from the XML parser. All these classes are meant to be subclassed (or
imitated) by clients that want to handle these functions themselves.
Application is the class that receives document data from the parser,
and is probably the one most people want.
$Id: xmlapp.py,v 1.9 2000/09/26 14:43:10 loewis Exp $
"""
import sys,urllib
from xmlutils import *
# ==============================
# The default application class
# ==============================
class Application:
"""This is the class that represents the application that receives
parsed data from the parser. It is meant to be subclassed by users."""
def __init__(self):
self.locator=None
def set_locator(self,locator):
"""Gives the application an object to ask for the current location.
Called automagically by the parser."""
self.locator=locator
def doc_start(self):
"Notifies the application of the start of the document."
pass
def doc_end(self):
"Notifies the application of the end of the document."
pass
def handle_comment(self,data):
"Notifies the application of comments."
pass
def handle_start_tag(self,name,attrs):
"Notifies the application of start tags (and empty element tags)."
pass
def handle_end_tag(self,name):
"Notifies the application of end tags (and empty element tags)."
pass
def handle_data(self,data,start,end):
"Notifies the application of character data."
pass
def handle_ignorable_data(self,data,start,end):
"Notifies the application of character data that can be ignored."
pass
def handle_pi(self,target,data):
"Notifies the application of processing instructions."
pass
def handle_doctype(self,root,pubID,sysID):
"Notifies the application of the document type declaration."
pass
def set_entity_info(self,xmlver,enc,sddecl):
"""Notifies the application of information about the current entity
supplied by an XML or text declaration. All three parameters will be
None, if they weren't present."""
pass
# ==============================
# The public identifier resolver
# ==============================
class PubIdResolver:
"""An application class that resolves public identifiers to system
identifiers."""
def resolve_pe_pubid(self,pubid,sysid):
"""Maps the public identifier of a parameter entity to a system
identifier. The default implementation just returns the system
identifier."""
return sysid
def resolve_doctype_pubid(self,pubid,sysid):
"""Maps the public identifier of the DOCTYPE declaration to a system
identifier. The default implementation just returns the system
identifier."""
return sysid
def resolve_entity_pubid(self,pubid,sysid):
"""Maps the public identifier of an external entity to a system
identifier. The default implementation just returns the system
identifier."""
return sysid
# ==============================
# The default error handler
# ==============================
class ErrorHandler:
"""An error handler for the parser. This class can be subclassed by clients
that want to use their own error handlers."""
def __init__(self,locator):
self.locator=locator
def set_locator(self,loc):
self.locator=loc
def get_locator(self):
return self.locator
def warning(self,msg):
"Handles a non-fatal error message."
pass
def error(self,msg):
self.fatal(msg)
# "The reports of the error's fatality are much exaggerated"
# --Paul Prescod
def fatal(self,msg):
"Handles a fatal error message."
if self.locator==None:
print "ERROR: "+msg
else:
print "ERROR: "+msg+" at %s:%d:%d" % (self.locator.get_current_sysid(),\
self.locator.get_line(),\
self.locator.get_column())
print "TEXT: '%s'" % (self.locator.data[self.locator.pos:\
self.locator.pos+10])
sys.exit(1)
# ==============================
# The default entity handler
# ==============================
class EntityHandler:
"An entity handler for the parser."
def __init__(self,parser):
self.parser=parser
def resolve_ent_ref(self,entname):
"""Resolves a general entity reference and returns its contents. The
default method only resolves the predefined entities. Returns a
2-tuple (n,m) where n is true if the entity is internal. For internal
entities m is the value, for external ones it is the system id."""
try:
return (1,predef_ents[entname])
except KeyError,e:
self.parser.report_error(3021,entname)
return (1,"")
# ==============================
# A DTD event handler
# ==============================
class DTDConsumer:
"""Represents an XML DTD. This class can be subclassed by applications
which want to handle the DTD information themselves."""
def __init__(self,parser):
self.parser=parser
def dtd_start(self):
"Called when DTD parsing starts."
pass
def dtd_end(self):
"Called when the DTD is completely parsed."
pass
def new_general_entity(self,name,val):
"Receives internal general entity declarations."
pass
def new_external_entity(self,ent_name,pub_id,sys_id,ndata):
"""Receives external general entity declarations. 'ndata' is the
empty string if the entity is parsed."""
pass
def new_parameter_entity(self,name,val):
"Receives internal parameter entity declarations."
pass
def new_external_pe(self,name,pubid,sysid):
"Receives external parameter entity declarations."
pass
def new_notation(self,name,pubid,sysid):
"Receives notation declarations."
pass
def new_element_type(self,elem_name,elem_cont):
"Receives the declaration of an element type."
pass
def new_attribute(self,elem,attr,a_type,a_decl,a_def):
"Receives the declaration of a new attribute."
pass
def handle_comment(self,contents):
"Receives the contents of a comment."
pass
def handle_pi(self,target,data):
"Receives the target and data of processing instructions."
pass
# ==============================
# An inputsource factory
# ==============================
class InputSourceFactory:
"A class that creates file-like objects from system identifiers."
def create_input_source(self,sysid):
if sysid[1:3]==":\\":
return open(sysid)
else:
return urllib.urlopen(sysid)
|
