|
39275
|
1 """W3C Document Object Model implementation for Python.
|
|
|
2
|
|
|
3 The Python mapping of the Document Object Model is documented in the
|
|
|
4 Python Library Reference in the section on the xml.dom package.
|
|
|
5
|
|
|
6 This package contains the following modules:
|
|
|
7
|
|
|
8 minidom -- A simple implementation of the Level 1 DOM with namespace
|
|
|
9 support added (based on the Level 2 specification) and other
|
|
|
10 minor Level 2 functionality.
|
|
|
11
|
|
|
12 pulldom -- DOM builder supporting on-demand tree-building for selected
|
|
|
13 subtrees of the document.
|
|
|
14
|
|
|
15 """
|
|
|
16
|
|
|
17
|
|
|
18 class Node:
|
|
|
19 """Class giving the NodeType constants."""
|
|
|
20
|
|
|
21 # DOM implementations may use this as a base class for their own
|
|
|
22 # Node implementations. If they don't, the constants defined here
|
|
|
23 # should still be used as the canonical definitions as they match
|
|
|
24 # the values given in the W3C recommendation. Client code can
|
|
|
25 # safely refer to these values in all tests of Node.nodeType
|
|
|
26 # values.
|
|
|
27
|
|
|
28 ELEMENT_NODE = 1
|
|
|
29 ATTRIBUTE_NODE = 2
|
|
|
30 TEXT_NODE = 3
|
|
|
31 CDATA_SECTION_NODE = 4
|
|
|
32 ENTITY_REFERENCE_NODE = 5
|
|
|
33 ENTITY_NODE = 6
|
|
|
34 PROCESSING_INSTRUCTION_NODE = 7
|
|
|
35 COMMENT_NODE = 8
|
|
|
36 DOCUMENT_NODE = 9
|
|
|
37 DOCUMENT_TYPE_NODE = 10
|
|
|
38 DOCUMENT_FRAGMENT_NODE = 11
|
|
|
39 NOTATION_NODE = 12
|
|
|
40
|
|
|
41
|
|
|
42 #ExceptionCode
|
|
|
43 INDEX_SIZE_ERR = 1
|
|
|
44 DOMSTRING_SIZE_ERR = 2
|
|
|
45 HIERARCHY_REQUEST_ERR = 3
|
|
|
46 WRONG_DOCUMENT_ERR = 4
|
|
|
47 INVALID_CHARACTER_ERR = 5
|
|
|
48 NO_DATA_ALLOWED_ERR = 6
|
|
|
49 NO_MODIFICATION_ALLOWED_ERR = 7
|
|
|
50 NOT_FOUND_ERR = 8
|
|
|
51 NOT_SUPPORTED_ERR = 9
|
|
|
52 INUSE_ATTRIBUTE_ERR = 10
|
|
|
53 INVALID_STATE_ERR = 11
|
|
|
54 SYNTAX_ERR = 12
|
|
|
55 INVALID_MODIFICATION_ERR = 13
|
|
|
56 NAMESPACE_ERR = 14
|
|
|
57 INVALID_ACCESS_ERR = 15
|
|
|
58 VALIDATION_ERR = 16
|
|
|
59
|
|
|
60
|
|
|
61 class DOMException(Exception):
|
|
|
62 """Abstract base class for DOM exceptions.
|
|
|
63 Exceptions with specific codes are specializations of this class."""
|
|
|
64
|
|
|
65 def __init__(self, *args, **kw):
|
|
|
66 if self.__class__ is DOMException:
|
|
|
67 raise RuntimeError(
|
|
|
68 "DOMException should not be instantiated directly")
|
|
|
69 Exception.__init__(self, *args, **kw)
|
|
|
70
|
|
|
71 def _get_code(self):
|
|
|
72 return self.code
|
|
|
73
|
|
|
74
|
|
|
75 class IndexSizeErr(DOMException):
|
|
|
76 code = INDEX_SIZE_ERR
|
|
|
77
|
|
|
78 class DomstringSizeErr(DOMException):
|
|
|
79 code = DOMSTRING_SIZE_ERR
|
|
|
80
|
|
|
81 class HierarchyRequestErr(DOMException):
|
|
|
82 code = HIERARCHY_REQUEST_ERR
|
|
|
83
|
|
|
84 class WrongDocumentErr(DOMException):
|
|
|
85 code = WRONG_DOCUMENT_ERR
|
|
|
86
|
|
|
87 class InvalidCharacterErr(DOMException):
|
|
|
88 code = INVALID_CHARACTER_ERR
|
|
|
89
|
|
|
90 class NoDataAllowedErr(DOMException):
|
|
|
91 code = NO_DATA_ALLOWED_ERR
|
|
|
92
|
|
|
93 class NoModificationAllowedErr(DOMException):
|
|
|
94 code = NO_MODIFICATION_ALLOWED_ERR
|
|
|
95
|
|
|
96 class NotFoundErr(DOMException):
|
|
|
97 code = NOT_FOUND_ERR
|
|
|
98
|
|
|
99 class NotSupportedErr(DOMException):
|
|
|
100 code = NOT_SUPPORTED_ERR
|
|
|
101
|
|
|
102 class InuseAttributeErr(DOMException):
|
|
|
103 code = INUSE_ATTRIBUTE_ERR
|
|
|
104
|
|
|
105 class InvalidStateErr(DOMException):
|
|
|
106 code = INVALID_STATE_ERR
|
|
|
107
|
|
|
108 class SyntaxErr(DOMException):
|
|
|
109 code = SYNTAX_ERR
|
|
|
110
|
|
|
111 class InvalidModificationErr(DOMException):
|
|
|
112 code = INVALID_MODIFICATION_ERR
|
|
|
113
|
|
|
114 class NamespaceErr(DOMException):
|
|
|
115 code = NAMESPACE_ERR
|
|
|
116
|
|
|
117 class InvalidAccessErr(DOMException):
|
|
|
118 code = INVALID_ACCESS_ERR
|
|
|
119
|
|
|
120 class ValidationErr(DOMException):
|
|
|
121 code = VALIDATION_ERR
|
|
|
122
|
|
|
123 class UserDataHandler:
|
|
|
124 """Class giving the operation constants for UserDataHandler.handle()."""
|
|
|
125
|
|
|
126 # Based on DOM Level 3 (WD 9 April 2002)
|
|
|
127
|
|
|
128 NODE_CLONED = 1
|
|
|
129 NODE_IMPORTED = 2
|
|
|
130 NODE_DELETED = 3
|
|
|
131 NODE_RENAMED = 4
|
|
|
132
|
|
|
133 XML_NAMESPACE = "http://www.w3.org/XML/1998/namespace"
|
|
|
134 XMLNS_NAMESPACE = "http://www.w3.org/2000/xmlns/"
|
|
|
135 XHTML_NAMESPACE = "http://www.w3.org/1999/xhtml"
|
|
|
136 EMPTY_NAMESPACE = None
|
|
|
137 EMPTY_PREFIX = None
|
|
|
138
|
|
|
139 from domreg import getDOMImplementation,registerDOMImplementation
|
