U
e5d� � @ s, d Z ddlZddlT eejd< eejd< dS )z1Interface to the Expat non-validating XML parser.� N)�*zxml.parsers.expat.modelzxml.parsers.expat.errors)�__doc__�sysZpyexpatZmodel�modules�errors� r r �)/usr/lib64/python3.8/xml/parsers/expat.py�<module> s
U
e5d� � @ s d S )N� r r r �,/usr/lib64/python3.8/xml/parsers/__init__.py�<module> � U
e5d� � @ s, d Z ddlZddlT eejd< eejd< dS )z1Interface to the Expat non-validating XML parser.� N)�*zxml.parsers.expat.modelzxml.parsers.expat.errors)�__doc__�sysZpyexpatZmodel�modules�errors� r r �)/usr/lib64/python3.8/xml/parsers/expat.py�<module> s
U
e5d� � @ s d Z dS )z�Python interfaces to XML parsers.
This package contains one module:
expat -- Python wrapper for James Clark's Expat parser, with namespace
support.
N)�__doc__� r r �,/usr/lib64/python3.8/xml/parsers/__init__.py�<module> � U
e5d� � @ s d Z dS )z�Python interfaces to XML parsers.
This package contains one module:
expat -- Python wrapper for James Clark's Expat parser, with namespace
support.
N)�__doc__� r r �,/usr/lib64/python3.8/xml/parsers/__init__.py�<module> � U
e5d� � @ s( d dl Z d dlT ee jd< ee jd< dS )� N)�*zxml.parsers.expat.modelzxml.parsers.expat.errors)�sysZpyexpatZmodel�modules�errors� r r �)/usr/lib64/python3.8/xml/parsers/expat.py�<module> s
"""Interface to the Expat non-validating XML parser."""
import sys
from pyexpat import *
# provide pyexpat submodules as xml.parsers.expat submodules
sys.modules['xml.parsers.expat.model'] = model
sys.modules['xml.parsers.expat.errors'] = errors
"""Python interfaces to XML parsers.
This package contains one module:
expat -- Python wrapper for James Clark's Expat parser, with namespace
support.
"""
"""Simple implementation of the Level 1 DOM.
Namespaces and other minor Level 2 features are also supported.
parse("foo.xml")
parseString("<foo><bar/></foo>")
Todo:
=====
* convenience methods for getting elements and text.
* more testing
* bring some of the writer and linearizer code into conformance with this
interface
* SAX 2 namespaces
"""
import io
import xml.dom
from xml.dom import EMPTY_NAMESPACE, EMPTY_PREFIX, XMLNS_NAMESPACE, domreg
from xml.dom.minicompat import *
from xml.dom.xmlbuilder import DOMImplementationLS, DocumentLS
# This is used by the ID-cache invalidation checks; the list isn't
# actually complete, since the nodes being checked will never be the
# DOCUMENT_NODE or DOCUMENT_FRAGMENT_NODE. (The node being checked is
# the node being added or removed, not the node being modified.)
#
_nodeTypes_with_children = (xml.dom.Node.ELEMENT_NODE,
xml.dom.Node.ENTITY_REFERENCE_NODE)
class Node(xml.dom.Node):
namespaceURI = None # this is non-null only for elements and attributes
parentNode = None
ownerDocument = None
nextSibling = None
previousSibling = None
prefix = EMPTY_PREFIX # non-null only for NS elements and attributes
def __bool__(self):
return True
def toxml(self, encoding=None):
return self.toprettyxml("", "", encoding)
def toprettyxml(self, indent="\t", newl="\n", encoding=None):
if encoding is None:
writer = io.StringIO()
else:
writer = io.TextIOWrapper(io.BytesIO(),
encoding=encoding,
errors="xmlcharrefreplace",
newline='\n')
if self.nodeType == Node.DOCUMENT_NODE:
# Can pass encoding only to document, to put it into XML header
self.writexml(writer, "", indent, newl, encoding)
else:
self.writexml(writer, "", indent, newl)
if encoding is None:
return writer.getvalue()
else:
return writer.detach().getvalue()
def hasChildNodes(self):
return bool(self.childNodes)
def _get_childNodes(self):
return self.childNodes
def _get_firstChild(self):
if self.childNodes:
return self.childNodes[0]
def _get_lastChild(self):
if self.childNodes:
return self.childNodes[-1]
def insertBefore(self, newChild, refChild):
if newChild.nodeType == self.DOCUMENT_FRAGMENT_NODE:
for c in tuple(newChild.childNodes):
self.insertBefore(c, refChild)
### The DOM does not clearly specify what to return in this case
return newChild
if newChild.nodeType not in self._child_node_types:
raise xml.dom.HierarchyRequestErr(
"%s cannot be child of %s" % (repr(newChild), repr(self)))
if newChild.parentNode is not None:
newChild.parentNode.removeChild(newChild)
if refChild is None:
self.appendChild(newChild)
else:
try:
index = self.childNodes.index(refChild)
except ValueError:
raise xml.dom.NotFoundErr()
if newChild.nodeType in _nodeTypes_with_children:
_clear_id_cache(self)
self.childNodes.insert(index, newChild)
newChild.nextSibling = refChild
refChild.previousSibling = newChild
if index:
node = self.childNodes[index-1]
node.nextSibling = newChild
newChild.previousSibling = node
else:
newChild.previousSibling = None
newChild.parentNode = self
return newChild
def appendChild(self, node):
if node.nodeType == self.DOCUMENT_FRAGMENT_NODE:
for c in tuple(node.childNodes):
self.appendChild(c)
### The DOM does not clearly specify what to return in this case
return node
if node.nodeType not in self._child_node_types:
raise xml.dom.HierarchyRequestErr(
"%s cannot be child of %s" % (repr(node), repr(self)))
elif node.nodeType in _nodeTypes_with_children:
_clear_id_cache(self)
if node.parentNode is not None:
node.parentNode.removeChild(node)
_append_child(self, node)
node.nextSibling = None
return node
def replaceChild(self, newChild, oldChild):
if newChild.nodeType == self.DOCUMENT_FRAGMENT_NODE:
refChild = oldChild.nextSibling
self.removeChild(oldChild)
return self.insertBefore(newChild, refChild)
if newChild.nodeType not in self._child_node_types:
raise xml.dom.HierarchyRequestErr(
"%s cannot be child of %s" % (repr(newChild), repr(self)))
if newChild is oldChild:
return
if newChild.parentNode is not None:
newChild.parentNode.removeChild(newChild)
try:
index = self.childNodes.index(oldChild)
except ValueError:
raise xml.dom.NotFoundErr()
self.childNodes[index] = newChild
newChild.parentNode = self
oldChild.parentNode = None
if (newChild.nodeType in _nodeTypes_with_children
or oldChild.nodeType in _nodeTypes_with_children):
_clear_id_cache(self)
newChild.nextSibling = oldChild.nextSibling
newChild.previousSibling = oldChild.previousSibling
oldChild.nextSibling = None
oldChild.previousSibling = None
if newChild.previousSibling:
newChild.previousSibling.nextSibling = newChild
if newChild.nextSibling:
newChild.nextSibling.previousSibling = newChild
return oldChild
def removeChild(self, oldChild):
try:
self.childNodes.remove(oldChild)
except ValueError:
raise xml.dom.NotFoundErr()
if oldChild.nextSibling is not None:
oldChild.nextSibling.previousSibling = oldChild.previousSibling
if oldChild.previousSibling is not None:
oldChild.previousSibling.nextSibling = oldChild.nextSibling
oldChild.nextSibling = oldChild.previousSibling = None
if oldChild.nodeType in _nodeTypes_with_children:
_clear_id_cache(self)
oldChild.parentNode = None
return oldChild
def normalize(self):
L = []
for child in self.childNodes:
if child.nodeType == Node.TEXT_NODE:
if not child.data:
# empty text node; discard
if L:
L[-1].nextSibling = child.nextSibling
if child.nextSibling:
child.nextSibling.previousSibling = child.previousSibling
child.unlink()
elif L and L[-1].nodeType == child.nodeType:
# collapse text node
node = L[-1]
node.data = node.data + child.data
node.nextSibling = child.nextSibling
if child.nextSibling:
child.nextSibling.previousSibling = node
child.unlink()
else:
L.append(child)
else:
L.append(child)
if child.nodeType == Node.ELEMENT_NODE:
child.normalize()
self.childNodes[:] = L
def cloneNode(self, deep):
return _clone_node(self, deep, self.ownerDocument or self)
def isSupported(self, feature, version):
return self.ownerDocument.implementation.hasFeature(feature, version)
def _get_localName(self):
# Overridden in Element and Attr where localName can be Non-Null
return None
# Node interfaces from Level 3 (WD 9 April 2002)
def isSameNode(self, other):
return self is other
def getInterface(self, feature):
if self.isSupported(feature, None):
return self
else:
return None
# The "user data" functions use a dictionary that is only present
# if some user data has been set, so be careful not to assume it
# exists.
def getUserData(self, key):
try:
return self._user_data[key][0]
except (AttributeError, KeyError):
return None
def setUserData(self, key, data, handler):
old = None
try:
d = self._user_data
except AttributeError:
d = {}
self._user_data = d
if key in d:
old = d[key][0]
if data is None:
# ignore handlers passed for None
handler = None
if old is not None:
del d[key]
else:
d[key] = (data, handler)
return old
def _call_user_data_handler(self, operation, src, dst):
if hasattr(self, "_user_data"):
for key, (data, handler) in list(self._user_data.items()):
if handler is not None:
handler.handle(operation, key, data, src, dst)
# minidom-specific API:
def unlink(self):
self.parentNode = self.ownerDocument = None
if self.childNodes:
for child in self.childNodes:
child.unlink()
self.childNodes = NodeList()
self.previousSibling = None
self.nextSibling = None
# A Node is its own context manager, to ensure that an unlink() call occurs.
# This is similar to how a file object works.
def __enter__(self):
return self
def __exit__(self, et, ev, tb):
self.unlink()
defproperty(Node, "firstChild", doc="First child node, or None.")
defproperty(Node, "lastChild", doc="Last child node, or None.")
defproperty(Node, "localName", doc="Namespace-local name of this node.")
def _append_child(self, node):
# fast path with less checks; usable by DOM builders if careful
childNodes = self.childNodes
if childNodes:
last = childNodes[-1]
node.previousSibling = last
last.nextSibling = node
childNodes.append(node)
node.parentNode = self
def _in_document(node):
# return True iff node is part of a document tree
while node is not None:
if node.nodeType == Node.DOCUMENT_NODE:
return True
node = node.parentNode
return False
def _write_data(writer, data):
"Writes datachars to writer."
if data:
data = data.replace("&", "&").replace("<", "<"). \
replace("\"", """).replace(">", ">")
writer.write(data)
def _get_elements_by_tagName_helper(parent, name, rc):
for node in parent.childNodes:
if node.nodeType == Node.ELEMENT_NODE and \
(name == "*" or node.tagName == name):
rc.append(node)
_get_elements_by_tagName_helper(node, name, rc)
return rc
def _get_elements_by_tagName_ns_helper(parent, nsURI, localName, rc):
for node in parent.childNodes:
if node.nodeType == Node.ELEMENT_NODE:
if ((localName == "*" or node.localName == localName) and
(nsURI == "*" or node.namespaceURI == nsURI)):
rc.append(node)
_get_elements_by_tagName_ns_helper(node, nsURI, localName, rc)
return rc
class DocumentFragment(Node):
nodeType = Node.DOCUMENT_FRAGMENT_NODE
nodeName = "#document-fragment"
nodeValue = None
attributes = None
parentNode = None
_child_node_types = (Node.ELEMENT_NODE,
Node.TEXT_NODE,
Node.CDATA_SECTION_NODE,
Node.ENTITY_REFERENCE_NODE,
Node.PROCESSING_INSTRUCTION_NODE,
Node.COMMENT_NODE,
Node.NOTATION_NODE)
def __init__(self):
self.childNodes = NodeList()
class Attr(Node):
__slots__=('_name', '_value', 'namespaceURI',
'_prefix', 'childNodes', '_localName', 'ownerDocument', 'ownerElement')
nodeType = Node.ATTRIBUTE_NODE
attributes = None
specified = False
_is_id = False
_child_node_types = (Node.TEXT_NODE, Node.ENTITY_REFERENCE_NODE)
def __init__(self, qName, namespaceURI=EMPTY_NAMESPACE, localName=None,
prefix=None):
self.ownerElement = None
self._name = qName
self.namespaceURI = namespaceURI
self._prefix = prefix
self.childNodes = NodeList()
# Add the single child node that represents the value of the attr
self.childNodes.append(Text())
# nodeValue and value are set elsewhere
def _get_localName(self):
try:
return self._localName
except AttributeError:
return self.nodeName.split(":", 1)[-1]
def _get_specified(self):
return self.specified
def _get_name(self):
return self._name
def _set_name(self, value):
self._name = value
if self.ownerElement is not None:
_clear_id_cache(self.ownerElement)
nodeName = name = property(_get_name, _set_name)
def _get_value(self):
return self._value
def _set_value(self, value):
self._value = value
self.childNodes[0].data = value
if self.ownerElement is not None:
_clear_id_cache(self.ownerElement)
self.childNodes[0].data = value
nodeValue = value = property(_get_value, _set_value)
def _get_prefix(self):
return self._prefix
def _set_prefix(self, prefix):
nsuri = self.namespaceURI
if prefix == "xmlns":
if nsuri and nsuri != XMLNS_NAMESPACE:
raise xml.dom.NamespaceErr(
"illegal use of 'xmlns' prefix for the wrong namespace")
self._prefix = prefix
if prefix is None:
newName = self.localName
else:
newName = "%s:%s" % (prefix, self.localName)
if self.ownerElement:
_clear_id_cache(self.ownerElement)
self.name = newName
prefix = property(_get_prefix, _set_prefix)
def unlink(self):
# This implementation does not call the base implementation
# since most of that is not needed, and the expense of the
# method call is not warranted. We duplicate the removal of
# children, but that's all we needed from the base class.
elem = self.ownerElement
if elem is not None:
del elem._attrs[self.nodeName]
del elem._attrsNS[(self.namespaceURI, self.localName)]
if self._is_id:
self._is_id = False
elem._magic_id_nodes -= 1
self.ownerDocument._magic_id_count -= 1
for child in self.childNodes:
child.unlink()
del self.childNodes[:]
def _get_isId(self):
if self._is_id:
return True
doc = self.ownerDocument
elem = self.ownerElement
if doc is None or elem is None:
return False
info = doc._get_elem_info(elem)
if info is None:
return False
if self.namespaceURI:
return info.isIdNS(self.namespaceURI, self.localName)
else:
return info.isId(self.nodeName)
def _get_schemaType(self):
doc = self.ownerDocument
elem = self.ownerElement
if doc is None or elem is None:
return _no_type
info = doc._get_elem_info(elem)
if info is None:
return _no_type
if self.namespaceURI:
return info.getAttributeTypeNS(self.namespaceURI, self.localName)
else:
return info.getAttributeType(self.nodeName)
defproperty(Attr, "isId", doc="True if this attribute is an ID.")
defproperty(Attr, "localName", doc="Namespace-local name of this attribute.")
defproperty(Attr, "schemaType", doc="Schema type for this attribute.")
class NamedNodeMap(object):
"""The attribute list is a transient interface to the underlying
dictionaries. Mutations here will change the underlying element's
dictionary.
Ordering is imposed artificially and does not reflect the order of
attributes as found in an input document.
"""
__slots__ = ('_attrs', '_attrsNS', '_ownerElement')
def __init__(self, attrs, attrsNS, ownerElement):
self._attrs = attrs
self._attrsNS = attrsNS
self._ownerElement = ownerElement
def _get_length(self):
return len(self._attrs)
def item(self, index):
try:
return self[list(self._attrs.keys())[index]]
except IndexError:
return None
def items(self):
L = []
for node in self._attrs.values():
L.append((node.nodeName, node.value))
return L
def itemsNS(self):
L = []
for node in self._attrs.values():
L.append(((node.namespaceURI, node.localName), node.value))
return L
def __contains__(self, key):
if isinstance(key, str):
return key in self._attrs
else:
return key in self._attrsNS
def keys(self):
return self._attrs.keys()
def keysNS(self):
return self._attrsNS.keys()
def values(self):
return self._attrs.values()
def get(self, name, value=None):
return self._attrs.get(name, value)
__len__ = _get_length
def _cmp(self, other):
if self._attrs is getattr(other, "_attrs", None):
return 0
else:
return (id(self) > id(other)) - (id(self) < id(other))
def __eq__(self, other):
return self._cmp(other) == 0
def __ge__(self, other):
return self._cmp(other) >= 0
def __gt__(self, other):
return self._cmp(other) > 0
def __le__(self, other):
return self._cmp(other) <= 0
def __lt__(self, other):
return self._cmp(other) < 0
def __getitem__(self, attname_or_tuple):
if isinstance(attname_or_tuple, tuple):
return self._attrsNS[attname_or_tuple]
else:
return self._attrs[attname_or_tuple]
# same as set
def __setitem__(self, attname, value):
if isinstance(value, str):
try:
node = self._attrs[attname]
except KeyError:
node = Attr(attname)
node.ownerDocument = self._ownerElement.ownerDocument
self.setNamedItem(node)
node.value = value
else:
if not isinstance(value, Attr):
raise TypeError("value must be a string or Attr object")
node = value
self.setNamedItem(node)
def getNamedItem(self, name):
try:
return self._attrs[name]
except KeyError:
return None
def getNamedItemNS(self, namespaceURI, localName):
try:
return self._attrsNS[(namespaceURI, localName)]
except KeyError:
return None
def removeNamedItem(self, name):
n = self.getNamedItem(name)
if n is not None:
_clear_id_cache(self._ownerElement)
del self._attrs[n.nodeName]
del self._attrsNS[(n.namespaceURI, n.localName)]
if hasattr(n, 'ownerElement'):
n.ownerElement = None
return n
else:
raise xml.dom.NotFoundErr()
def removeNamedItemNS(self, namespaceURI, localName):
n = self.getNamedItemNS(namespaceURI, localName)
if n is not None:
_clear_id_cache(self._ownerElement)
del self._attrsNS[(n.namespaceURI, n.localName)]
del self._attrs[n.nodeName]
if hasattr(n, 'ownerElement'):
n.ownerElement = None
return n
else:
raise xml.dom.NotFoundErr()
def setNamedItem(self, node):
if not isinstance(node, Attr):
raise xml.dom.HierarchyRequestErr(
"%s cannot be child of %s" % (repr(node), repr(self)))
old = self._attrs.get(node.name)
if old:
old.unlink()
self._attrs[node.name] = node
self._attrsNS[(node.namespaceURI, node.localName)] = node
node.ownerElement = self._ownerElement
_clear_id_cache(node.ownerElement)
return old
def setNamedItemNS(self, node):
return self.setNamedItem(node)
def __delitem__(self, attname_or_tuple):
node = self[attname_or_tuple]
_clear_id_cache(node.ownerElement)
node.unlink()
def __getstate__(self):
return self._attrs, self._attrsNS, self._ownerElement
def __setstate__(self, state):
self._attrs, self._attrsNS, self._ownerElement = state
defproperty(NamedNodeMap, "length",
doc="Number of nodes in the NamedNodeMap.")
AttributeList = NamedNodeMap
class TypeInfo(object):
__slots__ = 'namespace', 'name'
def __init__(self, namespace, name):
self.namespace = namespace
self.name = name
def __repr__(self):
if self.namespace:
return "<%s %r (from %r)>" % (self.__class__.__name__, self.name,
self.namespace)
else:
return "<%s %r>" % (self.__class__.__name__, self.name)
def _get_name(self):
return self.name
def _get_namespace(self):
return self.namespace
_no_type = TypeInfo(None, None)
class Element(Node):
__slots__=('ownerDocument', 'parentNode', 'tagName', 'nodeName', 'prefix',
'namespaceURI', '_localName', 'childNodes', '_attrs', '_attrsNS',
'nextSibling', 'previousSibling')
nodeType = Node.ELEMENT_NODE
nodeValue = None
schemaType = _no_type
_magic_id_nodes = 0
_child_node_types = (Node.ELEMENT_NODE,
Node.PROCESSING_INSTRUCTION_NODE,
Node.COMMENT_NODE,
Node.TEXT_NODE,
Node.CDATA_SECTION_NODE,
Node.ENTITY_REFERENCE_NODE)
def __init__(self, tagName, namespaceURI=EMPTY_NAMESPACE, prefix=None,
localName=None):
self.parentNode = None
self.tagName = self.nodeName = tagName
self.prefix = prefix
self.namespaceURI = namespaceURI
self.childNodes = NodeList()
self.nextSibling = self.previousSibling = None
# Attribute dictionaries are lazily created
# attributes are double-indexed:
# tagName -> Attribute
# URI,localName -> Attribute
# in the future: consider lazy generation
# of attribute objects this is too tricky
# for now because of headaches with
# namespaces.
self._attrs = None
self._attrsNS = None
def _ensure_attributes(self):
if self._attrs is None:
self._attrs = {}
self._attrsNS = {}
def _get_localName(self):
try:
return self._localName
except AttributeError:
return self.tagName.split(":", 1)[-1]
def _get_tagName(self):
return self.tagName
def unlink(self):
if self._attrs is not None:
for attr in list(self._attrs.values()):
attr.unlink()
self._attrs = None
self._attrsNS = None
Node.unlink(self)
def getAttribute(self, attname):
if self._attrs is None:
return ""
try:
return self._attrs[attname].value
except KeyError:
return ""
def getAttributeNS(self, namespaceURI, localName):
if self._attrsNS is None:
return ""
try:
return self._attrsNS[(namespaceURI, localName)].value
except KeyError:
return ""
def setAttribute(self, attname, value):
attr = self.getAttributeNode(attname)
if attr is None:
attr = Attr(attname)
attr.value = value # also sets nodeValue
attr.ownerDocument = self.ownerDocument
self.setAttributeNode(attr)
elif value != attr.value:
attr.value = value
if attr.isId:
_clear_id_cache(self)
def setAttributeNS(self, namespaceURI, qualifiedName, value):
prefix, localname = _nssplit(qualifiedName)
attr = self.getAttributeNodeNS(namespaceURI, localname)
if attr is None:
attr = Attr(qualifiedName, namespaceURI, localname, prefix)
attr.value = value
attr.ownerDocument = self.ownerDocument
self.setAttributeNode(attr)
else:
if value != attr.value:
attr.value = value
if attr.isId:
_clear_id_cache(self)
if attr.prefix != prefix:
attr.prefix = prefix
attr.nodeName = qualifiedName
def getAttributeNode(self, attrname):
if self._attrs is None:
return None
return self._attrs.get(attrname)
def getAttributeNodeNS(self, namespaceURI, localName):
if self._attrsNS is None:
return None
return self._attrsNS.get((namespaceURI, localName))
def setAttributeNode(self, attr):
if attr.ownerElement not in (None, self):
raise xml.dom.InuseAttributeErr("attribute node already owned")
self._ensure_attributes()
old1 = self._attrs.get(attr.name, None)
if old1 is not None:
self.removeAttributeNode(old1)
old2 = self._attrsNS.get((attr.namespaceURI, attr.localName), None)
if old2 is not None and old2 is not old1:
self.removeAttributeNode(old2)
_set_attribute_node(self, attr)
if old1 is not attr:
# It might have already been part of this node, in which case
# it doesn't represent a change, and should not be returned.
return old1
if old2 is not attr:
return old2
setAttributeNodeNS = setAttributeNode
def removeAttribute(self, name):
if self._attrsNS is None:
raise xml.dom.NotFoundErr()
try:
attr = self._attrs[name]
except KeyError:
raise xml.dom.NotFoundErr()
self.removeAttributeNode(attr)
def removeAttributeNS(self, namespaceURI, localName):
if self._attrsNS is None:
raise xml.dom.NotFoundErr()
try:
attr = self._attrsNS[(namespaceURI, localName)]
except KeyError:
raise xml.dom.NotFoundErr()
self.removeAttributeNode(attr)
def removeAttributeNode(self, node):
if node is None:
raise xml.dom.NotFoundErr()
try:
self._attrs[node.name]
except KeyError:
raise xml.dom.NotFoundErr()
_clear_id_cache(self)
node.unlink()
# Restore this since the node is still useful and otherwise
# unlinked
node.ownerDocument = self.ownerDocument
return node
removeAttributeNodeNS = removeAttributeNode
def hasAttribute(self, name):
if self._attrs is None:
return False
return name in self._attrs
def hasAttributeNS(self, namespaceURI, localName):
if self._attrsNS is None:
return False
return (namespaceURI, localName) in self._attrsNS
def getElementsByTagName(self, name):
return _get_elements_by_tagName_helper(self, name, NodeList())
def getElementsByTagNameNS(self, namespaceURI, localName):
return _get_elements_by_tagName_ns_helper(
self, namespaceURI, localName, NodeList())
def __repr__(self):
return "<DOM Element: %s at %#x>" % (self.tagName, id(self))
def writexml(self, writer, indent="", addindent="", newl=""):
# indent = current indentation
# addindent = indentation to add to higher levels
# newl = newline string
writer.write(indent+"<" + self.tagName)
attrs = self._get_attributes()
for a_name in attrs.keys():
writer.write(" %s=\"" % a_name)
_write_data(writer, attrs[a_name].value)
writer.write("\"")
if self.childNodes:
writer.write(">")
if (len(self.childNodes) == 1 and
self.childNodes[0].nodeType in (
Node.TEXT_NODE, Node.CDATA_SECTION_NODE)):
self.childNodes[0].writexml(writer, '', '', '')
else:
writer.write(newl)
for node in self.childNodes:
node.writexml(writer, indent+addindent, addindent, newl)
writer.write(indent)
writer.write("</%s>%s" % (self.tagName, newl))
else:
writer.write("/>%s"%(newl))
def _get_attributes(self):
self._ensure_attributes()
return NamedNodeMap(self._attrs, self._attrsNS, self)
def hasAttributes(self):
if self._attrs:
return True
else:
return False
# DOM Level 3 attributes, based on the 22 Oct 2002 draft
def setIdAttribute(self, name):
idAttr = self.getAttributeNode(name)
self.setIdAttributeNode(idAttr)
def setIdAttributeNS(self, namespaceURI, localName):
idAttr = self.getAttributeNodeNS(namespaceURI, localName)
self.setIdAttributeNode(idAttr)
def setIdAttributeNode(self, idAttr):
if idAttr is None or not self.isSameNode(idAttr.ownerElement):
raise xml.dom.NotFoundErr()
if _get_containing_entref(self) is not None:
raise xml.dom.NoModificationAllowedErr()
if not idAttr._is_id:
idAttr._is_id = True
self._magic_id_nodes += 1
self.ownerDocument._magic_id_count += 1
_clear_id_cache(self)
defproperty(Element, "attributes",
doc="NamedNodeMap of attributes on the element.")
defproperty(Element, "localName",
doc="Namespace-local name of this element.")
def _set_attribute_node(element, attr):
_clear_id_cache(element)
element._ensure_attributes()
element._attrs[attr.name] = attr
element._attrsNS[(attr.namespaceURI, attr.localName)] = attr
# This creates a circular reference, but Element.unlink()
# breaks the cycle since the references to the attribute
# dictionaries are tossed.
attr.ownerElement = element
class Childless:
"""Mixin that makes childless-ness easy to implement and avoids
the complexity of the Node methods that deal with children.
"""
__slots__ = ()
attributes = None
childNodes = EmptyNodeList()
firstChild = None
lastChild = None
def _get_firstChild(self):
return None
def _get_lastChild(self):
return None
def appendChild(self, node):
raise xml.dom.HierarchyRequestErr(
self.nodeName + " nodes cannot have children")
def hasChildNodes(self):
return False
def insertBefore(self, newChild, refChild):
raise xml.dom.HierarchyRequestErr(
self.nodeName + " nodes do not have children")
def removeChild(self, oldChild):
raise xml.dom.NotFoundErr(
self.nodeName + " nodes do not have children")
def normalize(self):
# For childless nodes, normalize() has nothing to do.
pass
def replaceChild(self, newChild, oldChild):
raise xml.dom.HierarchyRequestErr(
self.nodeName + " nodes do not have children")
class ProcessingInstruction(Childless, Node):
nodeType = Node.PROCESSING_INSTRUCTION_NODE
__slots__ = ('target', 'data')
def __init__(self, target, data):
self.target = target
self.data = data
# nodeValue is an alias for data
def _get_nodeValue(self):
return self.data
def _set_nodeValue(self, value):
self.data = value
nodeValue = property(_get_nodeValue, _set_nodeValue)
# nodeName is an alias for target
def _get_nodeName(self):
return self.target
def _set_nodeName(self, value):
self.target = value
nodeName = property(_get_nodeName, _set_nodeName)
def writexml(self, writer, indent="", addindent="", newl=""):
writer.write("%s<?%s %s?>%s" % (indent,self.target, self.data, newl))
class CharacterData(Childless, Node):
__slots__=('_data', 'ownerDocument','parentNode', 'previousSibling', 'nextSibling')
def __init__(self):
self.ownerDocument = self.parentNode = None
self.previousSibling = self.nextSibling = None
self._data = ''
Node.__init__(self)
def _get_length(self):
return len(self.data)
__len__ = _get_length
def _get_data(self):
return self._data
def _set_data(self, data):
self._data = data
data = nodeValue = property(_get_data, _set_data)
def __repr__(self):
data = self.data
if len(data) > 10:
dotdotdot = "..."
else:
dotdotdot = ""
return '<DOM %s node "%r%s">' % (
self.__class__.__name__, data[0:10], dotdotdot)
def substringData(self, offset, count):
if offset < 0:
raise xml.dom.IndexSizeErr("offset cannot be negative")
if offset >= len(self.data):
raise xml.dom.IndexSizeErr("offset cannot be beyond end of data")
if count < 0:
raise xml.dom.IndexSizeErr("count cannot be negative")
return self.data[offset:offset+count]
def appendData(self, arg):
self.data = self.data + arg
def insertData(self, offset, arg):
if offset < 0:
raise xml.dom.IndexSizeErr("offset cannot be negative")
if offset >= len(self.data):
raise xml.dom.IndexSizeErr("offset cannot be beyond end of data")
if arg:
self.data = "%s%s%s" % (
self.data[:offset], arg, self.data[offset:])
def deleteData(self, offset, count):
if offset < 0:
raise xml.dom.IndexSizeErr("offset cannot be negative")
if offset >= len(self.data):
raise xml.dom.IndexSizeErr("offset cannot be beyond end of data")
if count < 0:
raise xml.dom.IndexSizeErr("count cannot be negative")
if count:
self.data = self.data[:offset] + self.data[offset+count:]
def replaceData(self, offset, count, arg):
if offset < 0:
raise xml.dom.IndexSizeErr("offset cannot be negative")
if offset >= len(self.data):
raise xml.dom.IndexSizeErr("offset cannot be beyond end of data")
if count < 0:
raise xml.dom.IndexSizeErr("count cannot be negative")
if count:
self.data = "%s%s%s" % (
self.data[:offset], arg, self.data[offset+count:])
defproperty(CharacterData, "length", doc="Length of the string data.")
class Text(CharacterData):
__slots__ = ()
nodeType = Node.TEXT_NODE
nodeName = "#text"
attributes = None
def splitText(self, offset):
if offset < 0 or offset > len(self.data):
raise xml.dom.IndexSizeErr("illegal offset value")
newText = self.__class__()
newText.data = self.data[offset:]
newText.ownerDocument = self.ownerDocument
next = self.nextSibling
if self.parentNode and self in self.parentNode.childNodes:
if next is None:
self.parentNode.appendChild(newText)
else:
self.parentNode.insertBefore(newText, next)
self.data = self.data[:offset]
return newText
def writexml(self, writer, indent="", addindent="", newl=""):
_write_data(writer, "%s%s%s" % (indent, self.data, newl))
# DOM Level 3 (WD 9 April 2002)
def _get_wholeText(self):
L = [self.data]
n = self.previousSibling
while n is not None:
if n.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE):
L.insert(0, n.data)
n = n.previousSibling
else:
break
n = self.nextSibling
while n is not None:
if n.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE):
L.append(n.data)
n = n.nextSibling
else:
break
return ''.join(L)
def replaceWholeText(self, content):
# XXX This needs to be seriously changed if minidom ever
# supports EntityReference nodes.
parent = self.parentNode
n = self.previousSibling
while n is not None:
if n.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE):
next = n.previousSibling
parent.removeChild(n)
n = next
else:
break
n = self.nextSibling
if not content:
parent.removeChild(self)
while n is not None:
if n.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE):
next = n.nextSibling
parent.removeChild(n)
n = next
else:
break
if content:
self.data = content
return self
else:
return None
def _get_isWhitespaceInElementContent(self):
if self.data.strip():
return False
elem = _get_containing_element(self)
if elem is None:
return False
info = self.ownerDocument._get_elem_info(elem)
if info is None:
return False
else:
return info.isElementContent()
defproperty(Text, "isWhitespaceInElementContent",
doc="True iff this text node contains only whitespace"
" and is in element content.")
defproperty(Text, "wholeText",
doc="The text of all logically-adjacent text nodes.")
def _get_containing_element(node):
c = node.parentNode
while c is not None:
if c.nodeType == Node.ELEMENT_NODE:
return c
c = c.parentNode
return None
def _get_containing_entref(node):
c = node.parentNode
while c is not None:
if c.nodeType == Node.ENTITY_REFERENCE_NODE:
return c
c = c.parentNode
return None
class Comment(CharacterData):
nodeType = Node.COMMENT_NODE
nodeName = "#comment"
def __init__(self, data):
CharacterData.__init__(self)
self._data = data
def writexml(self, writer, indent="", addindent="", newl=""):
if "--" in self.data:
raise ValueError("'--' is not allowed in a comment node")
writer.write("%s<!--%s-->%s" % (indent, self.data, newl))
class CDATASection(Text):
__slots__ = ()
nodeType = Node.CDATA_SECTION_NODE
nodeName = "#cdata-section"
def writexml(self, writer, indent="", addindent="", newl=""):
if self.data.find("]]>") >= 0:
raise ValueError("']]>' not allowed in a CDATA section")
writer.write("<![CDATA[%s]]>" % self.data)
class ReadOnlySequentialNamedNodeMap(object):
__slots__ = '_seq',
def __init__(self, seq=()):
# seq should be a list or tuple
self._seq = seq
def __len__(self):
return len(self._seq)
def _get_length(self):
return len(self._seq)
def getNamedItem(self, name):
for n in self._seq:
if n.nodeName == name:
return n
def getNamedItemNS(self, namespaceURI, localName):
for n in self._seq:
if n.namespaceURI == namespaceURI and n.localName == localName:
return n
def __getitem__(self, name_or_tuple):
if isinstance(name_or_tuple, tuple):
node = self.getNamedItemNS(*name_or_tuple)
else:
node = self.getNamedItem(name_or_tuple)
if node is None:
raise KeyError(name_or_tuple)
return node
def item(self, index):
if index < 0:
return None
try:
return self._seq[index]
except IndexError:
return None
def removeNamedItem(self, name):
raise xml.dom.NoModificationAllowedErr(
"NamedNodeMap instance is read-only")
def removeNamedItemNS(self, namespaceURI, localName):
raise xml.dom.NoModificationAllowedErr(
"NamedNodeMap instance is read-only")
def setNamedItem(self, node):
raise xml.dom.NoModificationAllowedErr(
"NamedNodeMap instance is read-only")
def setNamedItemNS(self, node):
raise xml.dom.NoModificationAllowedErr(
"NamedNodeMap instance is read-only")
def __getstate__(self):
return [self._seq]
def __setstate__(self, state):
self._seq = state[0]
defproperty(ReadOnlySequentialNamedNodeMap, "length",
doc="Number of entries in the NamedNodeMap.")
class Identified:
"""Mix-in class that supports the publicId and systemId attributes."""
__slots__ = 'publicId', 'systemId'
def _identified_mixin_init(self, publicId, systemId):
self.publicId = publicId
self.systemId = systemId
def _get_publicId(self):
return self.publicId
def _get_systemId(self):
return self.systemId
class DocumentType(Identified, Childless, Node):
nodeType = Node.DOCUMENT_TYPE_NODE
nodeValue = None
name = None
publicId = None
systemId = None
internalSubset = None
def __init__(self, qualifiedName):
self.entities = ReadOnlySequentialNamedNodeMap()
self.notations = ReadOnlySequentialNamedNodeMap()
if qualifiedName:
prefix, localname = _nssplit(qualifiedName)
self.name = localname
self.nodeName = self.name
def _get_internalSubset(self):
return self.internalSubset
def cloneNode(self, deep):
if self.ownerDocument is None:
# it's ok
clone = DocumentType(None)
clone.name = self.name
clone.nodeName = self.name
operation = xml.dom.UserDataHandler.NODE_CLONED
if deep:
clone.entities._seq = []
clone.notations._seq = []
for n in self.notations._seq:
notation = Notation(n.nodeName, n.publicId, n.systemId)
clone.notations._seq.append(notation)
n._call_user_data_handler(operation, n, notation)
for e in self.entities._seq:
entity = Entity(e.nodeName, e.publicId, e.systemId,
e.notationName)
entity.actualEncoding = e.actualEncoding
entity.encoding = e.encoding
entity.version = e.version
clone.entities._seq.append(entity)
e._call_user_data_handler(operation, e, entity)
self._call_user_data_handler(operation, self, clone)
return clone
else:
return None
def writexml(self, writer, indent="", addindent="", newl=""):
writer.write("<!DOCTYPE ")
writer.write(self.name)
if self.publicId:
writer.write("%s PUBLIC '%s'%s '%s'"
% (newl, self.publicId, newl, self.systemId))
elif self.systemId:
writer.write("%s SYSTEM '%s'" % (newl, self.systemId))
if self.internalSubset is not None:
writer.write(" [")
writer.write(self.internalSubset)
writer.write("]")
writer.write(">"+newl)
class Entity(Identified, Node):
attributes = None
nodeType = Node.ENTITY_NODE
nodeValue = None
actualEncoding = None
encoding = None
version = None
def __init__(self, name, publicId, systemId, notation):
self.nodeName = name
self.notationName = notation
self.childNodes = NodeList()
self._identified_mixin_init(publicId, systemId)
def _get_actualEncoding(self):
return self.actualEncoding
def _get_encoding(self):
return self.encoding
def _get_version(self):
return self.version
def appendChild(self, newChild):
raise xml.dom.HierarchyRequestErr(
"cannot append children to an entity node")
def insertBefore(self, newChild, refChild):
raise xml.dom.HierarchyRequestErr(
"cannot insert children below an entity node")
def removeChild(self, oldChild):
raise xml.dom.HierarchyRequestErr(
"cannot remove children from an entity node")
def replaceChild(self, newChild, oldChild):
raise xml.dom.HierarchyRequestErr(
"cannot replace children of an entity node")
class Notation(Identified, Childless, Node):
nodeType = Node.NOTATION_NODE
nodeValue = None
def __init__(self, name, publicId, systemId):
self.nodeName = name
self._identified_mixin_init(publicId, systemId)
class DOMImplementation(DOMImplementationLS):
_features = [("core", "1.0"),
("core", "2.0"),
("core", None),
("xml", "1.0"),
("xml", "2.0"),
("xml", None),
("ls-load", "3.0"),
("ls-load", None),
]
def hasFeature(self, feature, version):
if version == "":
version = None
return (feature.lower(), version) in self._features
def createDocument(self, namespaceURI, qualifiedName, doctype):
if doctype and doctype.parentNode is not None:
raise xml.dom.WrongDocumentErr(
"doctype object owned by another DOM tree")
doc = self._create_document()
add_root_element = not (namespaceURI is None
and qualifiedName is None
and doctype is None)
if not qualifiedName and add_root_element:
# The spec is unclear what to raise here; SyntaxErr
# would be the other obvious candidate. Since Xerces raises
# InvalidCharacterErr, and since SyntaxErr is not listed
# for createDocument, that seems to be the better choice.
# XXX: need to check for illegal characters here and in
# createElement.
# DOM Level III clears this up when talking about the return value
# of this function. If namespaceURI, qName and DocType are
# Null the document is returned without a document element
# Otherwise if doctype or namespaceURI are not None
# Then we go back to the above problem
raise xml.dom.InvalidCharacterErr("Element with no name")
if add_root_element:
prefix, localname = _nssplit(qualifiedName)
if prefix == "xml" \
and namespaceURI != "http://www.w3.org/XML/1998/namespace":
raise xml.dom.NamespaceErr("illegal use of 'xml' prefix")
if prefix and not namespaceURI:
raise xml.dom.NamespaceErr(
"illegal use of prefix without namespaces")
element = doc.createElementNS(namespaceURI, qualifiedName)
if doctype:
doc.appendChild(doctype)
doc.appendChild(element)
if doctype:
doctype.parentNode = doctype.ownerDocument = doc
doc.doctype = doctype
doc.implementation = self
return doc
def createDocumentType(self, qualifiedName, publicId, systemId):
doctype = DocumentType(qualifiedName)
doctype.publicId = publicId
doctype.systemId = systemId
return doctype
# DOM Level 3 (WD 9 April 2002)
def getInterface(self, feature):
if self.hasFeature(feature, None):
return self
else:
return None
# internal
def _create_document(self):
return Document()
class ElementInfo(object):
"""Object that represents content-model information for an element.
This implementation is not expected to be used in practice; DOM
builders should provide implementations which do the right thing
using information available to it.
"""
__slots__ = 'tagName',
def __init__(self, name):
self.tagName = name
def getAttributeType(self, aname):
return _no_type
def getAttributeTypeNS(self, namespaceURI, localName):
return _no_type
def isElementContent(self):
return False
def isEmpty(self):
"""Returns true iff this element is declared to have an EMPTY
content model."""
return False
def isId(self, aname):
"""Returns true iff the named attribute is a DTD-style ID."""
return False
def isIdNS(self, namespaceURI, localName):
"""Returns true iff the identified attribute is a DTD-style ID."""
return False
def __getstate__(self):
return self.tagName
def __setstate__(self, state):
self.tagName = state
def _clear_id_cache(node):
if node.nodeType == Node.DOCUMENT_NODE:
node._id_cache.clear()
node._id_search_stack = None
elif _in_document(node):
node.ownerDocument._id_cache.clear()
node.ownerDocument._id_search_stack= None
class Document(Node, DocumentLS):
__slots__ = ('_elem_info', 'doctype',
'_id_search_stack', 'childNodes', '_id_cache')
_child_node_types = (Node.ELEMENT_NODE, Node.PROCESSING_INSTRUCTION_NODE,
Node.COMMENT_NODE, Node.DOCUMENT_TYPE_NODE)
implementation = DOMImplementation()
nodeType = Node.DOCUMENT_NODE
nodeName = "#document"
nodeValue = None
attributes = None
parentNode = None
previousSibling = nextSibling = None
# Document attributes from Level 3 (WD 9 April 2002)
actualEncoding = None
encoding = None
standalone = None
version = None
strictErrorChecking = False
errorHandler = None
documentURI = None
_magic_id_count = 0
def __init__(self):
self.doctype = None
self.childNodes = NodeList()
# mapping of (namespaceURI, localName) -> ElementInfo
# and tagName -> ElementInfo
self._elem_info = {}
self._id_cache = {}
self._id_search_stack = None
def _get_elem_info(self, element):
if element.namespaceURI:
key = element.namespaceURI, element.localName
else:
key = element.tagName
return self._elem_info.get(key)
def _get_actualEncoding(self):
return self.actualEncoding
def _get_doctype(self):
return self.doctype
def _get_documentURI(self):
return self.documentURI
def _get_encoding(self):
return self.encoding
def _get_errorHandler(self):
return self.errorHandler
def _get_standalone(self):
return self.standalone
def _get_strictErrorChecking(self):
return self.strictErrorChecking
def _get_version(self):
return self.version
def appendChild(self, node):
if node.nodeType not in self._child_node_types:
raise xml.dom.HierarchyRequestErr(
"%s cannot be child of %s" % (repr(node), repr(self)))
if node.parentNode is not None:
# This needs to be done before the next test since this
# may *be* the document element, in which case it should
# end up re-ordered to the end.
node.parentNode.removeChild(node)
if node.nodeType == Node.ELEMENT_NODE \
and self._get_documentElement():
raise xml.dom.HierarchyRequestErr(
"two document elements disallowed")
return Node.appendChild(self, node)
def removeChild(self, oldChild):
try:
self.childNodes.remove(oldChild)
except ValueError:
raise xml.dom.NotFoundErr()
oldChild.nextSibling = oldChild.previousSibling = None
oldChild.parentNode = None
if self.documentElement is oldChild:
self.documentElement = None
return oldChild
def _get_documentElement(self):
for node in self.childNodes:
if node.nodeType == Node.ELEMENT_NODE:
return node
def unlink(self):
if self.doctype is not None:
self.doctype.unlink()
self.doctype = None
Node.unlink(self)
def cloneNode(self, deep):
if not deep:
return None
clone = self.implementation.createDocument(None, None, None)
clone.encoding = self.encoding
clone.standalone = self.standalone
clone.version = self.version
for n in self.childNodes:
childclone = _clone_node(n, deep, clone)
assert childclone.ownerDocument.isSameNode(clone)
clone.childNodes.append(childclone)
if childclone.nodeType == Node.DOCUMENT_NODE:
assert clone.documentElement is None
elif childclone.nodeType == Node.DOCUMENT_TYPE_NODE:
assert clone.doctype is None
clone.doctype = childclone
childclone.parentNode = clone
self._call_user_data_handler(xml.dom.UserDataHandler.NODE_CLONED,
self, clone)
return clone
def createDocumentFragment(self):
d = DocumentFragment()
d.ownerDocument = self
return d
def createElement(self, tagName):
e = Element(tagName)
e.ownerDocument = self
return e
def createTextNode(self, data):
if not isinstance(data, str):
raise TypeError("node contents must be a string")
t = Text()
t.data = data
t.ownerDocument = self
return t
def createCDATASection(self, data):
if not isinstance(data, str):
raise TypeError("node contents must be a string")
c = CDATASection()
c.data = data
c.ownerDocument = self
return c
def createComment(self, data):
c = Comment(data)
c.ownerDocument = self
return c
def createProcessingInstruction(self, target, data):
p = ProcessingInstruction(target, data)
p.ownerDocument = self
return p
def createAttribute(self, qName):
a = Attr(qName)
a.ownerDocument = self
a.value = ""
return a
def createElementNS(self, namespaceURI, qualifiedName):
prefix, localName = _nssplit(qualifiedName)
e = Element(qualifiedName, namespaceURI, prefix)
e.ownerDocument = self
return e
def createAttributeNS(self, namespaceURI, qualifiedName):
prefix, localName = _nssplit(qualifiedName)
a = Attr(qualifiedName, namespaceURI, localName, prefix)
a.ownerDocument = self
a.value = ""
return a
# A couple of implementation-specific helpers to create node types
# not supported by the W3C DOM specs:
def _create_entity(self, name, publicId, systemId, notationName):
e = Entity(name, publicId, systemId, notationName)
e.ownerDocument = self
return e
def _create_notation(self, name, publicId, systemId):
n = Notation(name, publicId, systemId)
n.ownerDocument = self
return n
def getElementById(self, id):
if id in self._id_cache:
return self._id_cache[id]
if not (self._elem_info or self._magic_id_count):
return None
stack = self._id_search_stack
if stack is None:
# we never searched before, or the cache has been cleared
stack = [self.documentElement]
self._id_search_stack = stack
elif not stack:
# Previous search was completed and cache is still valid;
# no matching node.
return None
result = None
while stack:
node = stack.pop()
# add child elements to stack for continued searching
stack.extend([child for child in node.childNodes
if child.nodeType in _nodeTypes_with_children])
# check this node
info = self._get_elem_info(node)
if info:
# We have to process all ID attributes before
# returning in order to get all the attributes set to
# be IDs using Element.setIdAttribute*().
for attr in node.attributes.values():
if attr.namespaceURI:
if info.isIdNS(attr.namespaceURI, attr.localName):
self._id_cache[attr.value] = node
if attr.value == id:
result = node
elif not node._magic_id_nodes:
break
elif info.isId(attr.name):
self._id_cache[attr.value] = node
if attr.value == id:
result = node
elif not node._magic_id_nodes:
break
elif attr._is_id:
self._id_cache[attr.value] = node
if attr.value == id:
result = node
elif node._magic_id_nodes == 1:
break
elif node._magic_id_nodes:
for attr in node.attributes.values():
if attr._is_id:
self._id_cache[attr.value] = node
if attr.value == id:
result = node
if result is not None:
break
return result
def getElementsByTagName(self, name):
return _get_elements_by_tagName_helper(self, name, NodeList())
def getElementsByTagNameNS(self, namespaceURI, localName):
return _get_elements_by_tagName_ns_helper(
self, namespaceURI, localName, NodeList())
def isSupported(self, feature, version):
return self.implementation.hasFeature(feature, version)
def importNode(self, node, deep):
if node.nodeType == Node.DOCUMENT_NODE:
raise xml.dom.NotSupportedErr("cannot import document nodes")
elif node.nodeType == Node.DOCUMENT_TYPE_NODE:
raise xml.dom.NotSupportedErr("cannot import document type nodes")
return _clone_node(node, deep, self)
def writexml(self, writer, indent="", addindent="", newl="", encoding=None):
if encoding is None:
writer.write('<?xml version="1.0" ?>'+newl)
else:
writer.write('<?xml version="1.0" encoding="%s"?>%s' % (
encoding, newl))
for node in self.childNodes:
node.writexml(writer, indent, addindent, newl)
# DOM Level 3 (WD 9 April 2002)
def renameNode(self, n, namespaceURI, name):
if n.ownerDocument is not self:
raise xml.dom.WrongDocumentErr(
"cannot rename nodes from other documents;\n"
"expected %s,\nfound %s" % (self, n.ownerDocument))
if n.nodeType not in (Node.ELEMENT_NODE, Node.ATTRIBUTE_NODE):
raise xml.dom.NotSupportedErr(
"renameNode() only applies to element and attribute nodes")
if namespaceURI != EMPTY_NAMESPACE:
if ':' in name:
prefix, localName = name.split(':', 1)
if ( prefix == "xmlns"
and namespaceURI != xml.dom.XMLNS_NAMESPACE):
raise xml.dom.NamespaceErr(
"illegal use of 'xmlns' prefix")
else:
if ( name == "xmlns"
and namespaceURI != xml.dom.XMLNS_NAMESPACE
and n.nodeType == Node.ATTRIBUTE_NODE):
raise xml.dom.NamespaceErr(
"illegal use of the 'xmlns' attribute")
prefix = None
localName = name
else:
prefix = None
localName = None
if n.nodeType == Node.ATTRIBUTE_NODE:
element = n.ownerElement
if element is not None:
is_id = n._is_id
element.removeAttributeNode(n)
else:
element = None
n.prefix = prefix
n._localName = localName
n.namespaceURI = namespaceURI
n.nodeName = name
if n.nodeType == Node.ELEMENT_NODE:
n.tagName = name
else:
# attribute node
n.name = name
if element is not None:
element.setAttributeNode(n)
if is_id:
element.setIdAttributeNode(n)
# It's not clear from a semantic perspective whether we should
# call the user data handlers for the NODE_RENAMED event since
# we're re-using the existing node. The draft spec has been
# interpreted as meaning "no, don't call the handler unless a
# new node is created."
return n
defproperty(Document, "documentElement",
doc="Top-level element of this document.")
def _clone_node(node, deep, newOwnerDocument):
"""
Clone a node and give it the new owner document.
Called by Node.cloneNode and Document.importNode
"""
if node.ownerDocument.isSameNode(newOwnerDocument):
operation = xml.dom.UserDataHandler.NODE_CLONED
else:
operation = xml.dom.UserDataHandler.NODE_IMPORTED
if node.nodeType == Node.ELEMENT_NODE:
clone = newOwnerDocument.createElementNS(node.namespaceURI,
node.nodeName)
for attr in node.attributes.values():
clone.setAttributeNS(attr.namespaceURI, attr.nodeName, attr.value)
a = clone.getAttributeNodeNS(attr.namespaceURI, attr.localName)
a.specified = attr.specified
if deep:
for child in node.childNodes:
c = _clone_node(child, deep, newOwnerDocument)
clone.appendChild(c)
elif node.nodeType == Node.DOCUMENT_FRAGMENT_NODE:
clone = newOwnerDocument.createDocumentFragment()
if deep:
for child in node.childNodes:
c = _clone_node(child, deep, newOwnerDocument)
clone.appendChild(c)
elif node.nodeType == Node.TEXT_NODE:
clone = newOwnerDocument.createTextNode(node.data)
elif node.nodeType == Node.CDATA_SECTION_NODE:
clone = newOwnerDocument.createCDATASection(node.data)
elif node.nodeType == Node.PROCESSING_INSTRUCTION_NODE:
clone = newOwnerDocument.createProcessingInstruction(node.target,
node.data)
elif node.nodeType == Node.COMMENT_NODE:
clone = newOwnerDocument.createComment(node.data)
elif node.nodeType == Node.ATTRIBUTE_NODE:
clone = newOwnerDocument.createAttributeNS(node.namespaceURI,
node.nodeName)
clone.specified = True
clone.value = node.value
elif node.nodeType == Node.DOCUMENT_TYPE_NODE:
assert node.ownerDocument is not newOwnerDocument
operation = xml.dom.UserDataHandler.NODE_IMPORTED
clone = newOwnerDocument.implementation.createDocumentType(
node.name, node.publicId, node.systemId)
clone.ownerDocument = newOwnerDocument
if deep:
clone.entities._seq = []
clone.notations._seq = []
for n in node.notations._seq:
notation = Notation(n.nodeName, n.publicId, n.systemId)
notation.ownerDocument = newOwnerDocument
clone.notations._seq.append(notation)
if hasattr(n, '_call_user_data_handler'):
n._call_user_data_handler(operation, n, notation)
for e in node.entities._seq:
entity = Entity(e.nodeName, e.publicId, e.systemId,
e.notationName)
entity.actualEncoding = e.actualEncoding
entity.encoding = e.encoding
entity.version = e.version
entity.ownerDocument = newOwnerDocument
clone.entities._seq.append(entity)
if hasattr(e, '_call_user_data_handler'):
e._call_user_data_handler(operation, e, entity)
else:
# Note the cloning of Document and DocumentType nodes is
# implementation specific. minidom handles those cases
# directly in the cloneNode() methods.
raise xml.dom.NotSupportedErr("Cannot clone node %s" % repr(node))
# Check for _call_user_data_handler() since this could conceivably
# used with other DOM implementations (one of the FourThought
# DOMs, perhaps?).
if hasattr(node, '_call_user_data_handler'):
node._call_user_data_handler(operation, node, clone)
return clone
def _nssplit(qualifiedName):
fields = qualifiedName.split(':', 1)
if len(fields) == 2:
return fields
else:
return (None, fields[0])
def _do_pulldom_parse(func, args, kwargs):
events = func(*args, **kwargs)
toktype, rootNode = events.getEvent()
events.expandNode(rootNode)
events.clear()
return rootNode
def parse(file, parser=None, bufsize=None):
"""Parse a file into a DOM by filename or file object."""
if parser is None and not bufsize:
from xml.dom import expatbuilder
return expatbuilder.parse(file)
else:
from xml.dom import pulldom
return _do_pulldom_parse(pulldom.parse, (file,),
{'parser': parser, 'bufsize': bufsize})
def parseString(string, parser=None):
"""Parse a file into a DOM from a string."""
if parser is None:
from xml.dom import expatbuilder
return expatbuilder.parseString(string)
else:
from xml.dom import pulldom
return _do_pulldom_parse(pulldom.parseString, (string,),
{'parser': parser})
def getDOMImplementation(features=None):
if features:
if isinstance(features, str):
features = domreg._parse_feature_string(features)
for f, v in features:
if not Document.implementation.hasFeature(f, v):
return None
return Document.implementation
"""Python version compatibility support for minidom.
This module contains internal implementation details and
should not be imported; use xml.dom.minidom instead.
"""
# This module should only be imported using "import *".
#
# The following names are defined:
#
# NodeList -- lightest possible NodeList implementation
#
# EmptyNodeList -- lightest possible NodeList that is guaranteed to
# remain empty (immutable)
#
# StringTypes -- tuple of defined string types
#
# defproperty -- function used in conjunction with GetattrMagic;
# using these together is needed to make them work
# as efficiently as possible in both Python 2.2+
# and older versions. For example:
#
# class MyClass(GetattrMagic):
# def _get_myattr(self):
# return something
#
# defproperty(MyClass, "myattr",
# "return some value")
#
# For Python 2.2 and newer, this will construct a
# property object on the class, which avoids
# needing to override __getattr__(). It will only
# work for read-only attributes.
#
# For older versions of Python, inheriting from
# GetattrMagic will use the traditional
# __getattr__() hackery to achieve the same effect,
# but less efficiently.
#
# defproperty() should be used for each version of
# the relevant _get_<property>() function.
__all__ = ["NodeList", "EmptyNodeList", "StringTypes", "defproperty"]
import xml.dom
StringTypes = (str,)
class NodeList(list):
__slots__ = ()
def item(self, index):
if 0 <= index < len(self):
return self[index]
def _get_length(self):
return len(self)
def _set_length(self, value):
raise xml.dom.NoModificationAllowedErr(
"attempt to modify read-only attribute 'length'")
length = property(_get_length, _set_length,
doc="The number of nodes in the NodeList.")
# For backward compatibility
def __setstate__(self, state):
if state is None:
state = []
self[:] = state
class EmptyNodeList(tuple):
__slots__ = ()
def __add__(self, other):
NL = NodeList()
NL.extend(other)
return NL
def __radd__(self, other):
NL = NodeList()
NL.extend(other)
return NL
def item(self, index):
return None
def _get_length(self):
return 0
def _set_length(self, value):
raise xml.dom.NoModificationAllowedErr(
"attempt to modify read-only attribute 'length'")
length = property(_get_length, _set_length,
doc="The number of nodes in the NodeList.")
def defproperty(klass, name, doc):
get = getattr(klass, ("_get_" + name))
def set(self, value, name=name):
raise xml.dom.NoModificationAllowedErr(
"attempt to modify read-only attribute " + repr(name))
assert not hasattr(klass, "_set_" + name), \
"expected not to find _set_" + name
prop = property(get, set, doc=doc)
setattr(klass, name, prop)
"""Implementation of the DOM Level 3 'LS-Load' feature."""
import copy
import warnings
import xml.dom
from xml.dom.NodeFilter import NodeFilter
__all__ = ["DOMBuilder", "DOMEntityResolver", "DOMInputSource"]
class Options:
"""Features object that has variables set for each DOMBuilder feature.
The DOMBuilder class uses an instance of this class to pass settings to
the ExpatBuilder class.
"""
# Note that the DOMBuilder class in LoadSave constrains which of these
# values can be set using the DOM Level 3 LoadSave feature.
namespaces = 1
namespace_declarations = True
validation = False
external_parameter_entities = True
external_general_entities = True
external_dtd_subset = True
validate_if_schema = False
validate = False
datatype_normalization = False
create_entity_ref_nodes = True
entities = True
whitespace_in_element_content = True
cdata_sections = True
comments = True
charset_overrides_xml_encoding = True
infoset = False
supported_mediatypes_only = False
errorHandler = None
filter = None
class DOMBuilder:
entityResolver = None
errorHandler = None
filter = None
ACTION_REPLACE = 1
ACTION_APPEND_AS_CHILDREN = 2
ACTION_INSERT_AFTER = 3
ACTION_INSERT_BEFORE = 4
_legal_actions = (ACTION_REPLACE, ACTION_APPEND_AS_CHILDREN,
ACTION_INSERT_AFTER, ACTION_INSERT_BEFORE)
def __init__(self):
self._options = Options()
def _get_entityResolver(self):
return self.entityResolver
def _set_entityResolver(self, entityResolver):
self.entityResolver = entityResolver
def _get_errorHandler(self):
return self.errorHandler
def _set_errorHandler(self, errorHandler):
self.errorHandler = errorHandler
def _get_filter(self):
return self.filter
def _set_filter(self, filter):
self.filter = filter
def setFeature(self, name, state):
if self.supportsFeature(name):
state = state and 1 or 0
try:
settings = self._settings[(_name_xform(name), state)]
except KeyError:
raise xml.dom.NotSupportedErr(
"unsupported feature: %r" % (name,)) from None
else:
for name, value in settings:
setattr(self._options, name, value)
else:
raise xml.dom.NotFoundErr("unknown feature: " + repr(name))
def supportsFeature(self, name):
return hasattr(self._options, _name_xform(name))
def canSetFeature(self, name, state):
key = (_name_xform(name), state and 1 or 0)
return key in self._settings
# This dictionary maps from (feature,value) to a list of
# (option,value) pairs that should be set on the Options object.
# If a (feature,value) setting is not in this dictionary, it is
# not supported by the DOMBuilder.
#
_settings = {
("namespace_declarations", 0): [
("namespace_declarations", 0)],
("namespace_declarations", 1): [
("namespace_declarations", 1)],
("validation", 0): [
("validation", 0)],
("external_general_entities", 0): [
("external_general_entities", 0)],
("external_general_entities", 1): [
("external_general_entities", 1)],
("external_parameter_entities", 0): [
("external_parameter_entities", 0)],
("external_parameter_entities", 1): [
("external_parameter_entities", 1)],
("validate_if_schema", 0): [
("validate_if_schema", 0)],
("create_entity_ref_nodes", 0): [
("create_entity_ref_nodes", 0)],
("create_entity_ref_nodes", 1): [
("create_entity_ref_nodes", 1)],
("entities", 0): [
("create_entity_ref_nodes", 0),
("entities", 0)],
("entities", 1): [
("entities", 1)],
("whitespace_in_element_content", 0): [
("whitespace_in_element_content", 0)],
("whitespace_in_element_content", 1): [
("whitespace_in_element_content", 1)],
("cdata_sections", 0): [
("cdata_sections", 0)],
("cdata_sections", 1): [
("cdata_sections", 1)],
("comments", 0): [
("comments", 0)],
("comments", 1): [
("comments", 1)],
("charset_overrides_xml_encoding", 0): [
("charset_overrides_xml_encoding", 0)],
("charset_overrides_xml_encoding", 1): [
("charset_overrides_xml_encoding", 1)],
("infoset", 0): [],
("infoset", 1): [
("namespace_declarations", 0),
("validate_if_schema", 0),
("create_entity_ref_nodes", 0),
("entities", 0),
("cdata_sections", 0),
("datatype_normalization", 1),
("whitespace_in_element_content", 1),
("comments", 1),
("charset_overrides_xml_encoding", 1)],
("supported_mediatypes_only", 0): [
("supported_mediatypes_only", 0)],
("namespaces", 0): [
("namespaces", 0)],
("namespaces", 1): [
("namespaces", 1)],
}
def getFeature(self, name):
xname = _name_xform(name)
try:
return getattr(self._options, xname)
except AttributeError:
if name == "infoset":
options = self._options
return (options.datatype_normalization
and options.whitespace_in_element_content
and options.comments
and options.charset_overrides_xml_encoding
and not (options.namespace_declarations
or options.validate_if_schema
or options.create_entity_ref_nodes
or options.entities
or options.cdata_sections))
raise xml.dom.NotFoundErr("feature %s not known" % repr(name))
def parseURI(self, uri):
if self.entityResolver:
input = self.entityResolver.resolveEntity(None, uri)
else:
input = DOMEntityResolver().resolveEntity(None, uri)
return self.parse(input)
def parse(self, input):
options = copy.copy(self._options)
options.filter = self.filter
options.errorHandler = self.errorHandler
fp = input.byteStream
if fp is None and options.systemId:
import urllib.request
fp = urllib.request.urlopen(input.systemId)
return self._parse_bytestream(fp, options)
def parseWithContext(self, input, cnode, action):
if action not in self._legal_actions:
raise ValueError("not a legal action")
raise NotImplementedError("Haven't written this yet...")
def _parse_bytestream(self, stream, options):
import xml.dom.expatbuilder
builder = xml.dom.expatbuilder.makeBuilder(options)
return builder.parseFile(stream)
def _name_xform(name):
return name.lower().replace('-', '_')
class DOMEntityResolver(object):
__slots__ = '_opener',
def resolveEntity(self, publicId, systemId):
assert systemId is not None
source = DOMInputSource()
source.publicId = publicId
source.systemId = systemId
source.byteStream = self._get_opener().open(systemId)
# determine the encoding if the transport provided it
source.encoding = self._guess_media_encoding(source)
# determine the base URI is we can
import posixpath, urllib.parse
parts = urllib.parse.urlparse(systemId)
scheme, netloc, path, params, query, fragment = parts
# XXX should we check the scheme here as well?
if path and not path.endswith("/"):
path = posixpath.dirname(path) + "/"
parts = scheme, netloc, path, params, query, fragment
source.baseURI = urllib.parse.urlunparse(parts)
return source
def _get_opener(self):
try:
return self._opener
except AttributeError:
self._opener = self._create_opener()
return self._opener
def _create_opener(self):
import urllib.request
return urllib.request.build_opener()
def _guess_media_encoding(self, source):
info = source.byteStream.info()
if "Content-Type" in info:
for param in info.getplist():
if param.startswith("charset="):
return param.split("=", 1)[1].lower()
class DOMInputSource(object):
__slots__ = ('byteStream', 'characterStream', 'stringData',
'encoding', 'publicId', 'systemId', 'baseURI')
def __init__(self):
self.byteStream = None
self.characterStream = None
self.stringData = None
self.encoding = None
self.publicId = None
self.systemId = None
self.baseURI = None
def _get_byteStream(self):
return self.byteStream
def _set_byteStream(self, byteStream):
self.byteStream = byteStream
def _get_characterStream(self):
return self.characterStream
def _set_characterStream(self, characterStream):
self.characterStream = characterStream
def _get_stringData(self):
return self.stringData
def _set_stringData(self, data):
self.stringData = data
def _get_encoding(self):
return self.encoding
def _set_encoding(self, encoding):
self.encoding = encoding
def _get_publicId(self):
return self.publicId
def _set_publicId(self, publicId):
self.publicId = publicId
def _get_systemId(self):
return self.systemId
def _set_systemId(self, systemId):
self.systemId = systemId
def _get_baseURI(self):
return self.baseURI
def _set_baseURI(self, uri):
self.baseURI = uri
class DOMBuilderFilter:
"""Element filter which can be used to tailor construction of
a DOM instance.
"""
# There's really no need for this class; concrete implementations
# should just implement the endElement() and startElement()
# methods as appropriate. Using this makes it easy to only
# implement one of them.
FILTER_ACCEPT = 1
FILTER_REJECT = 2
FILTER_SKIP = 3
FILTER_INTERRUPT = 4
whatToShow = NodeFilter.SHOW_ALL
def _get_whatToShow(self):
return self.whatToShow
def acceptNode(self, element):
return self.FILTER_ACCEPT
def startContainer(self, element):
return self.FILTER_ACCEPT
del NodeFilter
class DocumentLS:
"""Mixin to create documents that conform to the load/save spec."""
async_ = False
def _get_async(self):
return False
def _set_async(self, flag):
if flag:
raise xml.dom.NotSupportedErr(
"asynchronous document loading is not supported")
def abort(self):
# What does it mean to "clear" a document? Does the
# documentElement disappear?
raise NotImplementedError(
"haven't figured out what this means yet")
def load(self, uri):
raise NotImplementedError("haven't written this yet")
def loadXML(self, source):
raise NotImplementedError("haven't written this yet")
def saveXML(self, snode):
if snode is None:
snode = self
elif snode.ownerDocument is not self:
raise xml.dom.WrongDocumentErr()
return snode.toxml()
class DOMImplementationLS:
MODE_SYNCHRONOUS = 1
MODE_ASYNCHRONOUS = 2
def createDOMBuilder(self, mode, schemaType):
if schemaType is not None:
raise xml.dom.NotSupportedErr(
"schemaType not yet supported")
if mode == self.MODE_SYNCHRONOUS:
return DOMBuilder()
if mode == self.MODE_ASYNCHRONOUS:
raise xml.dom.NotSupportedErr(
"asynchronous builders are not supported")
raise ValueError("unknown value for mode")
def createDOMWriter(self):
raise NotImplementedError(
"the writer interface hasn't been written yet!")
def createDOMInputSource(self):
return DOMInputSource()
"""Facility to use the Expat parser to load a minidom instance
from a string or file.
This avoids all the overhead of SAX and pulldom to gain performance.
"""
# Warning!
#
# This module is tightly bound to the implementation details of the
# minidom DOM and can't be used with other DOM implementations. This
# is due, in part, to a lack of appropriate methods in the DOM (there is
# no way to create Entity and Notation nodes via the DOM Level 2
# interface), and for performance. The latter is the cause of some fairly
# cryptic code.
#
# Performance hacks:
#
# - .character_data_handler() has an extra case in which continuing
# data is appended to an existing Text node; this can be a
# speedup since pyexpat can break up character data into multiple
# callbacks even though we set the buffer_text attribute on the
# parser. This also gives us the advantage that we don't need a
# separate normalization pass.
#
# - Determining that a node exists is done using an identity comparison
# with None rather than a truth test; this avoids searching for and
# calling any methods on the node object if it exists. (A rather
# nice speedup is achieved this way as well!)
from xml.dom import xmlbuilder, minidom, Node
from xml.dom import EMPTY_NAMESPACE, EMPTY_PREFIX, XMLNS_NAMESPACE
from xml.parsers import expat
from xml.dom.minidom import _append_child, _set_attribute_node
from xml.dom.NodeFilter import NodeFilter
TEXT_NODE = Node.TEXT_NODE
CDATA_SECTION_NODE = Node.CDATA_SECTION_NODE
DOCUMENT_NODE = Node.DOCUMENT_NODE
FILTER_ACCEPT = xmlbuilder.DOMBuilderFilter.FILTER_ACCEPT
FILTER_REJECT = xmlbuilder.DOMBuilderFilter.FILTER_REJECT
FILTER_SKIP = xmlbuilder.DOMBuilderFilter.FILTER_SKIP
FILTER_INTERRUPT = xmlbuilder.DOMBuilderFilter.FILTER_INTERRUPT
theDOMImplementation = minidom.getDOMImplementation()
# Expat typename -> TypeInfo
_typeinfo_map = {
"CDATA": minidom.TypeInfo(None, "cdata"),
"ENUM": minidom.TypeInfo(None, "enumeration"),
"ENTITY": minidom.TypeInfo(None, "entity"),
"ENTITIES": minidom.TypeInfo(None, "entities"),
"ID": minidom.TypeInfo(None, "id"),
"IDREF": minidom.TypeInfo(None, "idref"),
"IDREFS": minidom.TypeInfo(None, "idrefs"),
"NMTOKEN": minidom.TypeInfo(None, "nmtoken"),
"NMTOKENS": minidom.TypeInfo(None, "nmtokens"),
}
class ElementInfo(object):
__slots__ = '_attr_info', '_model', 'tagName'
def __init__(self, tagName, model=None):
self.tagName = tagName
self._attr_info = []
self._model = model
def __getstate__(self):
return self._attr_info, self._model, self.tagName
def __setstate__(self, state):
self._attr_info, self._model, self.tagName = state
def getAttributeType(self, aname):
for info in self._attr_info:
if info[1] == aname:
t = info[-2]
if t[0] == "(":
return _typeinfo_map["ENUM"]
else:
return _typeinfo_map[info[-2]]
return minidom._no_type
def getAttributeTypeNS(self, namespaceURI, localName):
return minidom._no_type
def isElementContent(self):
if self._model:
type = self._model[0]
return type not in (expat.model.XML_CTYPE_ANY,
expat.model.XML_CTYPE_MIXED)
else:
return False
def isEmpty(self):
if self._model:
return self._model[0] == expat.model.XML_CTYPE_EMPTY
else:
return False
def isId(self, aname):
for info in self._attr_info:
if info[1] == aname:
return info[-2] == "ID"
return False
def isIdNS(self, euri, ename, auri, aname):
# not sure this is meaningful
return self.isId((auri, aname))
def _intern(builder, s):
return builder._intern_setdefault(s, s)
def _parse_ns_name(builder, name):
assert ' ' in name
parts = name.split(' ')
intern = builder._intern_setdefault
if len(parts) == 3:
uri, localname, prefix = parts
prefix = intern(prefix, prefix)
qname = "%s:%s" % (prefix, localname)
qname = intern(qname, qname)
localname = intern(localname, localname)
elif len(parts) == 2:
uri, localname = parts
prefix = EMPTY_PREFIX
qname = localname = intern(localname, localname)
else:
raise ValueError("Unsupported syntax: spaces in URIs not supported: %r" % name)
return intern(uri, uri), localname, prefix, qname
class ExpatBuilder:
"""Document builder that uses Expat to build a ParsedXML.DOM document
instance."""
def __init__(self, options=None):
if options is None:
options = xmlbuilder.Options()
self._options = options
if self._options.filter is not None:
self._filter = FilterVisibilityController(self._options.filter)
else:
self._filter = None
# This *really* doesn't do anything in this case, so
# override it with something fast & minimal.
self._finish_start_element = id
self._parser = None
self.reset()
def createParser(self):
"""Create a new parser object."""
return expat.ParserCreate()
def getParser(self):
"""Return the parser object, creating a new one if needed."""
if not self._parser:
self._parser = self.createParser()
self._intern_setdefault = self._parser.intern.setdefault
self._parser.buffer_text = True
self._parser.ordered_attributes = True
self._parser.specified_attributes = True
self.install(self._parser)
return self._parser
def reset(self):
"""Free all data structures used during DOM construction."""
self.document = theDOMImplementation.createDocument(
EMPTY_NAMESPACE, None, None)
self.curNode = self.document
self._elem_info = self.document._elem_info
self._cdata = False
def install(self, parser):
"""Install the callbacks needed to build the DOM into the parser."""
# This creates circular references!
parser.StartDoctypeDeclHandler = self.start_doctype_decl_handler
parser.StartElementHandler = self.first_element_handler
parser.EndElementHandler = self.end_element_handler
parser.ProcessingInstructionHandler = self.pi_handler
if self._options.entities:
parser.EntityDeclHandler = self.entity_decl_handler
parser.NotationDeclHandler = self.notation_decl_handler
if self._options.comments:
parser.CommentHandler = self.comment_handler
if self._options.cdata_sections:
parser.StartCdataSectionHandler = self.start_cdata_section_handler
parser.EndCdataSectionHandler = self.end_cdata_section_handler
parser.CharacterDataHandler = self.character_data_handler_cdata
else:
parser.CharacterDataHandler = self.character_data_handler
parser.ExternalEntityRefHandler = self.external_entity_ref_handler
parser.XmlDeclHandler = self.xml_decl_handler
parser.ElementDeclHandler = self.element_decl_handler
parser.AttlistDeclHandler = self.attlist_decl_handler
def parseFile(self, file):
"""Parse a document from a file object, returning the document
node."""
parser = self.getParser()
first_buffer = True
try:
while 1:
buffer = file.read(16*1024)
if not buffer:
break
parser.Parse(buffer, 0)
if first_buffer and self.document.documentElement:
self._setup_subset(buffer)
first_buffer = False
parser.Parse("", True)
except ParseEscape:
pass
doc = self.document
self.reset()
self._parser = None
return doc
def parseString(self, string):
"""Parse a document from a string, returning the document node."""
parser = self.getParser()
try:
parser.Parse(string, True)
self._setup_subset(string)
except ParseEscape:
pass
doc = self.document
self.reset()
self._parser = None
return doc
def _setup_subset(self, buffer):
"""Load the internal subset if there might be one."""
if self.document.doctype:
extractor = InternalSubsetExtractor()
extractor.parseString(buffer)
subset = extractor.getSubset()
self.document.doctype.internalSubset = subset
def start_doctype_decl_handler(self, doctypeName, systemId, publicId,
has_internal_subset):
doctype = self.document.implementation.createDocumentType(
doctypeName, publicId, systemId)
doctype.ownerDocument = self.document
_append_child(self.document, doctype)
self.document.doctype = doctype
if self._filter and self._filter.acceptNode(doctype) == FILTER_REJECT:
self.document.doctype = None
del self.document.childNodes[-1]
doctype = None
self._parser.EntityDeclHandler = None
self._parser.NotationDeclHandler = None
if has_internal_subset:
if doctype is not None:
doctype.entities._seq = []
doctype.notations._seq = []
self._parser.CommentHandler = None
self._parser.ProcessingInstructionHandler = None
self._parser.EndDoctypeDeclHandler = self.end_doctype_decl_handler
def end_doctype_decl_handler(self):
if self._options.comments:
self._parser.CommentHandler = self.comment_handler
self._parser.ProcessingInstructionHandler = self.pi_handler
if not (self._elem_info or self._filter):
self._finish_end_element = id
def pi_handler(self, target, data):
node = self.document.createProcessingInstruction(target, data)
_append_child(self.curNode, node)
if self._filter and self._filter.acceptNode(node) == FILTER_REJECT:
self.curNode.removeChild(node)
def character_data_handler_cdata(self, data):
childNodes = self.curNode.childNodes
if self._cdata:
if ( self._cdata_continue
and childNodes[-1].nodeType == CDATA_SECTION_NODE):
childNodes[-1].appendData(data)
return
node = self.document.createCDATASection(data)
self._cdata_continue = True
elif childNodes and childNodes[-1].nodeType == TEXT_NODE:
node = childNodes[-1]
value = node.data + data
node.data = value
return
else:
node = minidom.Text()
node.data = data
node.ownerDocument = self.document
_append_child(self.curNode, node)
def character_data_handler(self, data):
childNodes = self.curNode.childNodes
if childNodes and childNodes[-1].nodeType == TEXT_NODE:
node = childNodes[-1]
node.data = node.data + data
return
node = minidom.Text()
node.data = node.data + data
node.ownerDocument = self.document
_append_child(self.curNode, node)
def entity_decl_handler(self, entityName, is_parameter_entity, value,
base, systemId, publicId, notationName):
if is_parameter_entity:
# we don't care about parameter entities for the DOM
return
if not self._options.entities:
return
node = self.document._create_entity(entityName, publicId,
systemId, notationName)
if value is not None:
# internal entity
# node *should* be readonly, but we'll cheat
child = self.document.createTextNode(value)
node.childNodes.append(child)
self.document.doctype.entities._seq.append(node)
if self._filter and self._filter.acceptNode(node) == FILTER_REJECT:
del self.document.doctype.entities._seq[-1]
def notation_decl_handler(self, notationName, base, systemId, publicId):
node = self.document._create_notation(notationName, publicId, systemId)
self.document.doctype.notations._seq.append(node)
if self._filter and self._filter.acceptNode(node) == FILTER_ACCEPT:
del self.document.doctype.notations._seq[-1]
def comment_handler(self, data):
node = self.document.createComment(data)
_append_child(self.curNode, node)
if self._filter and self._filter.acceptNode(node) == FILTER_REJECT:
self.curNode.removeChild(node)
def start_cdata_section_handler(self):
self._cdata = True
self._cdata_continue = False
def end_cdata_section_handler(self):
self._cdata = False
self._cdata_continue = False
def external_entity_ref_handler(self, context, base, systemId, publicId):
return 1
def first_element_handler(self, name, attributes):
if self._filter is None and not self._elem_info:
self._finish_end_element = id
self.getParser().StartElementHandler = self.start_element_handler
self.start_element_handler(name, attributes)
def start_element_handler(self, name, attributes):
node = self.document.createElement(name)
_append_child(self.curNode, node)
self.curNode = node
if attributes:
for i in range(0, len(attributes), 2):
a = minidom.Attr(attributes[i], EMPTY_NAMESPACE,
None, EMPTY_PREFIX)
value = attributes[i+1]
a.value = value
a.ownerDocument = self.document
_set_attribute_node(node, a)
if node is not self.document.documentElement:
self._finish_start_element(node)
def _finish_start_element(self, node):
if self._filter:
# To be general, we'd have to call isSameNode(), but this
# is sufficient for minidom:
if node is self.document.documentElement:
return
filt = self._filter.startContainer(node)
if filt == FILTER_REJECT:
# ignore this node & all descendents
Rejecter(self)
elif filt == FILTER_SKIP:
# ignore this node, but make it's children become
# children of the parent node
Skipper(self)
else:
return
self.curNode = node.parentNode
node.parentNode.removeChild(node)
node.unlink()
# If this ever changes, Namespaces.end_element_handler() needs to
# be changed to match.
#
def end_element_handler(self, name):
curNode = self.curNode
self.curNode = curNode.parentNode
self._finish_end_element(curNode)
def _finish_end_element(self, curNode):
info = self._elem_info.get(curNode.tagName)
if info:
self._handle_white_text_nodes(curNode, info)
if self._filter:
if curNode is self.document.documentElement:
return
if self._filter.acceptNode(curNode) == FILTER_REJECT:
self.curNode.removeChild(curNode)
curNode.unlink()
def _handle_white_text_nodes(self, node, info):
if (self._options.whitespace_in_element_content
or not info.isElementContent()):
return
# We have element type information and should remove ignorable
# whitespace; identify for text nodes which contain only
# whitespace.
L = []
for child in node.childNodes:
if child.nodeType == TEXT_NODE and not child.data.strip():
L.append(child)
# Remove ignorable whitespace from the tree.
for child in L:
node.removeChild(child)
def element_decl_handler(self, name, model):
info = self._elem_info.get(name)
if info is None:
self._elem_info[name] = ElementInfo(name, model)
else:
assert info._model is None
info._model = model
def attlist_decl_handler(self, elem, name, type, default, required):
info = self._elem_info.get(elem)
if info is None:
info = ElementInfo(elem)
self._elem_info[elem] = info
info._attr_info.append(
[None, name, None, None, default, 0, type, required])
def xml_decl_handler(self, version, encoding, standalone):
self.document.version = version
self.document.encoding = encoding
# This is still a little ugly, thanks to the pyexpat API. ;-(
if standalone >= 0:
if standalone:
self.document.standalone = True
else:
self.document.standalone = False
# Don't include FILTER_INTERRUPT, since that's checked separately
# where allowed.
_ALLOWED_FILTER_RETURNS = (FILTER_ACCEPT, FILTER_REJECT, FILTER_SKIP)
class FilterVisibilityController(object):
"""Wrapper around a DOMBuilderFilter which implements the checks
to make the whatToShow filter attribute work."""
__slots__ = 'filter',
def __init__(self, filter):
self.filter = filter
def startContainer(self, node):
mask = self._nodetype_mask[node.nodeType]
if self.filter.whatToShow & mask:
val = self.filter.startContainer(node)
if val == FILTER_INTERRUPT:
raise ParseEscape
if val not in _ALLOWED_FILTER_RETURNS:
raise ValueError(
"startContainer() returned illegal value: " + repr(val))
return val
else:
return FILTER_ACCEPT
def acceptNode(self, node):
mask = self._nodetype_mask[node.nodeType]
if self.filter.whatToShow & mask:
val = self.filter.acceptNode(node)
if val == FILTER_INTERRUPT:
raise ParseEscape
if val == FILTER_SKIP:
# move all child nodes to the parent, and remove this node
parent = node.parentNode
for child in node.childNodes[:]:
parent.appendChild(child)
# node is handled by the caller
return FILTER_REJECT
if val not in _ALLOWED_FILTER_RETURNS:
raise ValueError(
"acceptNode() returned illegal value: " + repr(val))
return val
else:
return FILTER_ACCEPT
_nodetype_mask = {
Node.ELEMENT_NODE: NodeFilter.SHOW_ELEMENT,
Node.ATTRIBUTE_NODE: NodeFilter.SHOW_ATTRIBUTE,
Node.TEXT_NODE: NodeFilter.SHOW_TEXT,
Node.CDATA_SECTION_NODE: NodeFilter.SHOW_CDATA_SECTION,
Node.ENTITY_REFERENCE_NODE: NodeFilter.SHOW_ENTITY_REFERENCE,
Node.ENTITY_NODE: NodeFilter.SHOW_ENTITY,
Node.PROCESSING_INSTRUCTION_NODE: NodeFilter.SHOW_PROCESSING_INSTRUCTION,
Node.COMMENT_NODE: NodeFilter.SHOW_COMMENT,
Node.DOCUMENT_NODE: NodeFilter.SHOW_DOCUMENT,
Node.DOCUMENT_TYPE_NODE: NodeFilter.SHOW_DOCUMENT_TYPE,
Node.DOCUMENT_FRAGMENT_NODE: NodeFilter.SHOW_DOCUMENT_FRAGMENT,
Node.NOTATION_NODE: NodeFilter.SHOW_NOTATION,
}
class FilterCrutch(object):
__slots__ = '_builder', '_level', '_old_start', '_old_end'
def __init__(self, builder):
self._level = 0
self._builder = builder
parser = builder._parser
self._old_start = parser.StartElementHandler
self._old_end = parser.EndElementHandler
parser.StartElementHandler = self.start_element_handler
parser.EndElementHandler = self.end_element_handler
class Rejecter(FilterCrutch):
__slots__ = ()
def __init__(self, builder):
FilterCrutch.__init__(self, builder)
parser = builder._parser
for name in ("ProcessingInstructionHandler",
"CommentHandler",
"CharacterDataHandler",
"StartCdataSectionHandler",
"EndCdataSectionHandler",
"ExternalEntityRefHandler",
):
setattr(parser, name, None)
def start_element_handler(self, *args):
self._level = self._level + 1
def end_element_handler(self, *args):
if self._level == 0:
# restore the old handlers
parser = self._builder._parser
self._builder.install(parser)
parser.StartElementHandler = self._old_start
parser.EndElementHandler = self._old_end
else:
self._level = self._level - 1
class Skipper(FilterCrutch):
__slots__ = ()
def start_element_handler(self, *args):
node = self._builder.curNode
self._old_start(*args)
if self._builder.curNode is not node:
self._level = self._level + 1
def end_element_handler(self, *args):
if self._level == 0:
# We're popping back out of the node we're skipping, so we
# shouldn't need to do anything but reset the handlers.
self._builder._parser.StartElementHandler = self._old_start
self._builder._parser.EndElementHandler = self._old_end
self._builder = None
else:
self._level = self._level - 1
self._old_end(*args)
# framework document used by the fragment builder.
# Takes a string for the doctype, subset string, and namespace attrs string.
_FRAGMENT_BUILDER_INTERNAL_SYSTEM_ID = \
"http://xml.python.org/entities/fragment-builder/internal"
_FRAGMENT_BUILDER_TEMPLATE = (
'''\
<!DOCTYPE wrapper
%%s [
<!ENTITY fragment-builder-internal
SYSTEM "%s">
%%s
]>
<wrapper %%s
>&fragment-builder-internal;</wrapper>'''
% _FRAGMENT_BUILDER_INTERNAL_SYSTEM_ID)
class FragmentBuilder(ExpatBuilder):
"""Builder which constructs document fragments given XML source
text and a context node.
The context node is expected to provide information about the
namespace declarations which are in scope at the start of the
fragment.
"""
def __init__(self, context, options=None):
if context.nodeType == DOCUMENT_NODE:
self.originalDocument = context
self.context = context
else:
self.originalDocument = context.ownerDocument
self.context = context
ExpatBuilder.__init__(self, options)
def reset(self):
ExpatBuilder.reset(self)
self.fragment = None
def parseFile(self, file):
"""Parse a document fragment from a file object, returning the
fragment node."""
return self.parseString(file.read())
def parseString(self, string):
"""Parse a document fragment from a string, returning the
fragment node."""
self._source = string
parser = self.getParser()
doctype = self.originalDocument.doctype
ident = ""
if doctype:
subset = doctype.internalSubset or self._getDeclarations()
if doctype.publicId:
ident = ('PUBLIC "%s" "%s"'
% (doctype.publicId, doctype.systemId))
elif doctype.systemId:
ident = 'SYSTEM "%s"' % doctype.systemId
else:
subset = ""
nsattrs = self._getNSattrs() # get ns decls from node's ancestors
document = _FRAGMENT_BUILDER_TEMPLATE % (ident, subset, nsattrs)
try:
parser.Parse(document, 1)
except:
self.reset()
raise
fragment = self.fragment
self.reset()
## self._parser = None
return fragment
def _getDeclarations(self):
"""Re-create the internal subset from the DocumentType node.
This is only needed if we don't already have the
internalSubset as a string.
"""
doctype = self.context.ownerDocument.doctype
s = ""
if doctype:
for i in range(doctype.notations.length):
notation = doctype.notations.item(i)
if s:
s = s + "\n "
s = "%s<!NOTATION %s" % (s, notation.nodeName)
if notation.publicId:
s = '%s PUBLIC "%s"\n "%s">' \
% (s, notation.publicId, notation.systemId)
else:
s = '%s SYSTEM "%s">' % (s, notation.systemId)
for i in range(doctype.entities.length):
entity = doctype.entities.item(i)
if s:
s = s + "\n "
s = "%s<!ENTITY %s" % (s, entity.nodeName)
if entity.publicId:
s = '%s PUBLIC "%s"\n "%s"' \
% (s, entity.publicId, entity.systemId)
elif entity.systemId:
s = '%s SYSTEM "%s"' % (s, entity.systemId)
else:
s = '%s "%s"' % (s, entity.firstChild.data)
if entity.notationName:
s = "%s NOTATION %s" % (s, entity.notationName)
s = s + ">"
return s
def _getNSattrs(self):
return ""
def external_entity_ref_handler(self, context, base, systemId, publicId):
if systemId == _FRAGMENT_BUILDER_INTERNAL_SYSTEM_ID:
# this entref is the one that we made to put the subtree
# in; all of our given input is parsed in here.
old_document = self.document
old_cur_node = self.curNode
parser = self._parser.ExternalEntityParserCreate(context)
# put the real document back, parse into the fragment to return
self.document = self.originalDocument
self.fragment = self.document.createDocumentFragment()
self.curNode = self.fragment
try:
parser.Parse(self._source, 1)
finally:
self.curNode = old_cur_node
self.document = old_document
self._source = None
return -1
else:
return ExpatBuilder.external_entity_ref_handler(
self, context, base, systemId, publicId)
class Namespaces:
"""Mix-in class for builders; adds support for namespaces."""
def _initNamespaces(self):
# list of (prefix, uri) ns declarations. Namespace attrs are
# constructed from this and added to the element's attrs.
self._ns_ordered_prefixes = []
def createParser(self):
"""Create a new namespace-handling parser."""
parser = expat.ParserCreate(namespace_separator=" ")
parser.namespace_prefixes = True
return parser
def install(self, parser):
"""Insert the namespace-handlers onto the parser."""
ExpatBuilder.install(self, parser)
if self._options.namespace_declarations:
parser.StartNamespaceDeclHandler = (
self.start_namespace_decl_handler)
def start_namespace_decl_handler(self, prefix, uri):
"""Push this namespace declaration on our storage."""
self._ns_ordered_prefixes.append((prefix, uri))
def start_element_handler(self, name, attributes):
if ' ' in name:
uri, localname, prefix, qname = _parse_ns_name(self, name)
else:
uri = EMPTY_NAMESPACE
qname = name
localname = None
prefix = EMPTY_PREFIX
node = minidom.Element(qname, uri, prefix, localname)
node.ownerDocument = self.document
_append_child(self.curNode, node)
self.curNode = node
if self._ns_ordered_prefixes:
for prefix, uri in self._ns_ordered_prefixes:
if prefix:
a = minidom.Attr(_intern(self, 'xmlns:' + prefix),
XMLNS_NAMESPACE, prefix, "xmlns")
else:
a = minidom.Attr("xmlns", XMLNS_NAMESPACE,
"xmlns", EMPTY_PREFIX)
a.value = uri
a.ownerDocument = self.document
_set_attribute_node(node, a)
del self._ns_ordered_prefixes[:]
if attributes:
node._ensure_attributes()
_attrs = node._attrs
_attrsNS = node._attrsNS
for i in range(0, len(attributes), 2):
aname = attributes[i]
value = attributes[i+1]
if ' ' in aname:
uri, localname, prefix, qname = _parse_ns_name(self, aname)
a = minidom.Attr(qname, uri, localname, prefix)
_attrs[qname] = a
_attrsNS[(uri, localname)] = a
else:
a = minidom.Attr(aname, EMPTY_NAMESPACE,
aname, EMPTY_PREFIX)
_attrs[aname] = a
_attrsNS[(EMPTY_NAMESPACE, aname)] = a
a.ownerDocument = self.document
a.value = value
a.ownerElement = node
if __debug__:
# This only adds some asserts to the original
# end_element_handler(), so we only define this when -O is not
# used. If changing one, be sure to check the other to see if
# it needs to be changed as well.
#
def end_element_handler(self, name):
curNode = self.curNode
if ' ' in name:
uri, localname, prefix, qname = _parse_ns_name(self, name)
assert (curNode.namespaceURI == uri
and curNode.localName == localname
and curNode.prefix == prefix), \
"element stack messed up! (namespace)"
else:
assert curNode.nodeName == name, \
"element stack messed up - bad nodeName"
assert curNode.namespaceURI == EMPTY_NAMESPACE, \
"element stack messed up - bad namespaceURI"
self.curNode = curNode.parentNode
self._finish_end_element(curNode)
class ExpatBuilderNS(Namespaces, ExpatBuilder):
"""Document builder that supports namespaces."""
def reset(self):
ExpatBuilder.reset(self)
self._initNamespaces()
class FragmentBuilderNS(Namespaces, FragmentBuilder):
"""Fragment builder that supports namespaces."""
def reset(self):
FragmentBuilder.reset(self)
self._initNamespaces()
def _getNSattrs(self):
"""Return string of namespace attributes from this element and
ancestors."""
# XXX This needs to be re-written to walk the ancestors of the
# context to build up the namespace information from
# declarations, elements, and attributes found in context.
# Otherwise we have to store a bunch more data on the DOM
# (though that *might* be more reliable -- not clear).
attrs = ""
context = self.context
L = []
while context:
if hasattr(context, '_ns_prefix_uri'):
for prefix, uri in context._ns_prefix_uri.items():
# add every new NS decl from context to L and attrs string
if prefix in L:
continue
L.append(prefix)
if prefix:
declname = "xmlns:" + prefix
else:
declname = "xmlns"
if attrs:
attrs = "%s\n %s='%s'" % (attrs, declname, uri)
else:
attrs = " %s='%s'" % (declname, uri)
context = context.parentNode
return attrs
class ParseEscape(Exception):
"""Exception raised to short-circuit parsing in InternalSubsetExtractor."""
pass
class InternalSubsetExtractor(ExpatBuilder):
"""XML processor which can rip out the internal document type subset."""
subset = None
def getSubset(self):
"""Return the internal subset as a string."""
return self.subset
def parseFile(self, file):
try:
ExpatBuilder.parseFile(self, file)
except ParseEscape:
pass
def parseString(self, string):
try:
ExpatBuilder.parseString(self, string)
except ParseEscape:
pass
def install(self, parser):
parser.StartDoctypeDeclHandler = self.start_doctype_decl_handler
parser.StartElementHandler = self.start_element_handler
def start_doctype_decl_handler(self, name, publicId, systemId,
has_internal_subset):
if has_internal_subset:
parser = self.getParser()
self.subset = []
parser.DefaultHandler = self.subset.append
parser.EndDoctypeDeclHandler = self.end_doctype_decl_handler
else:
raise ParseEscape()
def end_doctype_decl_handler(self):
s = ''.join(self.subset).replace('\r\n', '\n').replace('\r', '\n')
self.subset = s
raise ParseEscape()
def start_element_handler(self, name, attrs):
raise ParseEscape()
def parse(file, namespaces=True):
"""Parse a document, returning the resulting Document node.
'file' may be either a file name or an open file object.
"""
if namespaces:
builder = ExpatBuilderNS()
else:
builder = ExpatBuilder()
if isinstance(file, str):
with open(file, 'rb') as fp:
result = builder.parseFile(fp)
else:
result = builder.parseFile(file)
return result
def parseString(string, namespaces=True):
"""Parse a document from a string, returning the resulting
Document node.
"""
if namespaces:
builder = ExpatBuilderNS()
else:
builder = ExpatBuilder()
return builder.parseString(string)
def parseFragment(file, context, namespaces=True):
"""Parse a fragment of a document, given the context from which it
was originally extracted. context should be the parent of the
node(s) which are in the fragment.
'file' may be either a file name or an open file object.
"""
if namespaces:
builder = FragmentBuilderNS(context)
else:
builder = FragmentBuilder(context)
if isinstance(file, str):
with open(file, 'rb') as fp:
result = builder.parseFile(fp)
else:
result = builder.parseFile(file)
return result
def parseFragmentString(string, context, namespaces=True):
"""Parse a fragment of a document from a string, given the context
from which it was originally extracted. context should be the
parent of the node(s) which are in the fragment.
"""
if namespaces:
builder = FragmentBuilderNS(context)
else:
builder = FragmentBuilder(context)
return builder.parseString(string)
def makeBuilder(options):
"""Create a builder based on an Options object."""
if options.namespaces:
return ExpatBuilderNS(options)
else:
return ExpatBuilder(options)
import xml.sax
import xml.sax.handler
START_ELEMENT = "START_ELEMENT"
END_ELEMENT = "END_ELEMENT"
COMMENT = "COMMENT"
START_DOCUMENT = "START_DOCUMENT"
END_DOCUMENT = "END_DOCUMENT"
PROCESSING_INSTRUCTION = "PROCESSING_INSTRUCTION"
IGNORABLE_WHITESPACE = "IGNORABLE_WHITESPACE"
CHARACTERS = "CHARACTERS"
class PullDOM(xml.sax.ContentHandler):
_locator = None
document = None
def __init__(self, documentFactory=None):
from xml.dom import XML_NAMESPACE
self.documentFactory = documentFactory
self.firstEvent = [None, None]
self.lastEvent = self.firstEvent
self.elementStack = []
self.push = self.elementStack.append
try:
self.pop = self.elementStack.pop
except AttributeError:
# use class' pop instead
pass
self._ns_contexts = [{XML_NAMESPACE:'xml'}] # contains uri -> prefix dicts
self._current_context = self._ns_contexts[-1]
self.pending_events = []
def pop(self):
result = self.elementStack[-1]
del self.elementStack[-1]
return result
def setDocumentLocator(self, locator):
self._locator = locator
def startPrefixMapping(self, prefix, uri):
if not hasattr(self, '_xmlns_attrs'):
self._xmlns_attrs = []
self._xmlns_attrs.append((prefix or 'xmlns', uri))
self._ns_contexts.append(self._current_context.copy())
self._current_context[uri] = prefix or None
def endPrefixMapping(self, prefix):
self._current_context = self._ns_contexts.pop()
def startElementNS(self, name, tagName , attrs):
# Retrieve xml namespace declaration attributes.
xmlns_uri = 'http://www.w3.org/2000/xmlns/'
xmlns_attrs = getattr(self, '_xmlns_attrs', None)
if xmlns_attrs is not None:
for aname, value in xmlns_attrs:
attrs._attrs[(xmlns_uri, aname)] = value
self._xmlns_attrs = []
uri, localname = name
if uri:
# When using namespaces, the reader may or may not
# provide us with the original name. If not, create
# *a* valid tagName from the current context.
if tagName is None:
prefix = self._current_context[uri]
if prefix:
tagName = prefix + ":" + localname
else:
tagName = localname
if self.document:
node = self.document.createElementNS(uri, tagName)
else:
node = self.buildDocument(uri, tagName)
else:
# When the tagname is not prefixed, it just appears as
# localname
if self.document:
node = self.document.createElement(localname)
else:
node = self.buildDocument(None, localname)
for aname,value in attrs.items():
a_uri, a_localname = aname
if a_uri == xmlns_uri:
if a_localname == 'xmlns':
qname = a_localname
else:
qname = 'xmlns:' + a_localname
attr = self.document.createAttributeNS(a_uri, qname)
node.setAttributeNodeNS(attr)
elif a_uri:
prefix = self._current_context[a_uri]
if prefix:
qname = prefix + ":" + a_localname
else:
qname = a_localname
attr = self.document.createAttributeNS(a_uri, qname)
node.setAttributeNodeNS(attr)
else:
attr = self.document.createAttribute(a_localname)
node.setAttributeNode(attr)
attr.value = value
self.lastEvent[1] = [(START_ELEMENT, node), None]
self.lastEvent = self.lastEvent[1]
self.push(node)
def endElementNS(self, name, tagName):
self.lastEvent[1] = [(END_ELEMENT, self.pop()), None]
self.lastEvent = self.lastEvent[1]
def startElement(self, name, attrs):
if self.document:
node = self.document.createElement(name)
else:
node = self.buildDocument(None, name)
for aname,value in attrs.items():
attr = self.document.createAttribute(aname)
attr.value = value
node.setAttributeNode(attr)
self.lastEvent[1] = [(START_ELEMENT, node), None]
self.lastEvent = self.lastEvent[1]
self.push(node)
def endElement(self, name):
self.lastEvent[1] = [(END_ELEMENT, self.pop()), None]
self.lastEvent = self.lastEvent[1]
def comment(self, s):
if self.document:
node = self.document.createComment(s)
self.lastEvent[1] = [(COMMENT, node), None]
self.lastEvent = self.lastEvent[1]
else:
event = [(COMMENT, s), None]
self.pending_events.append(event)
def processingInstruction(self, target, data):
if self.document:
node = self.document.createProcessingInstruction(target, data)
self.lastEvent[1] = [(PROCESSING_INSTRUCTION, node), None]
self.lastEvent = self.lastEvent[1]
else:
event = [(PROCESSING_INSTRUCTION, target, data), None]
self.pending_events.append(event)
def ignorableWhitespace(self, chars):
node = self.document.createTextNode(chars)
self.lastEvent[1] = [(IGNORABLE_WHITESPACE, node), None]
self.lastEvent = self.lastEvent[1]
def characters(self, chars):
node = self.document.createTextNode(chars)
self.lastEvent[1] = [(CHARACTERS, node), None]
self.lastEvent = self.lastEvent[1]
def startDocument(self):
if self.documentFactory is None:
import xml.dom.minidom
self.documentFactory = xml.dom.minidom.Document.implementation
def buildDocument(self, uri, tagname):
# Can't do that in startDocument, since we need the tagname
# XXX: obtain DocumentType
node = self.documentFactory.createDocument(uri, tagname, None)
self.document = node
self.lastEvent[1] = [(START_DOCUMENT, node), None]
self.lastEvent = self.lastEvent[1]
self.push(node)
# Put everything we have seen so far into the document
for e in self.pending_events:
if e[0][0] == PROCESSING_INSTRUCTION:
_,target,data = e[0]
n = self.document.createProcessingInstruction(target, data)
e[0] = (PROCESSING_INSTRUCTION, n)
elif e[0][0] == COMMENT:
n = self.document.createComment(e[0][1])
e[0] = (COMMENT, n)
else:
raise AssertionError("Unknown pending event ",e[0][0])
self.lastEvent[1] = e
self.lastEvent = e
self.pending_events = None
return node.firstChild
def endDocument(self):
self.lastEvent[1] = [(END_DOCUMENT, self.document), None]
self.pop()
def clear(self):
"clear(): Explicitly release parsing structures"
self.document = None
class ErrorHandler:
def warning(self, exception):
print(exception)
def error(self, exception):
raise exception
def fatalError(self, exception):
raise exception
class DOMEventStream:
def __init__(self, stream, parser, bufsize):
self.stream = stream
self.parser = parser
self.bufsize = bufsize
if not hasattr(self.parser, 'feed'):
self.getEvent = self._slurp
self.reset()
def reset(self):
self.pulldom = PullDOM()
# This content handler relies on namespace support
self.parser.setFeature(xml.sax.handler.feature_namespaces, 1)
self.parser.setContentHandler(self.pulldom)
def __getitem__(self, pos):
import warnings
warnings.warn(
"DOMEventStream's __getitem__ method ignores 'pos' parameter. "
"Use iterator protocol instead.",
DeprecationWarning,
stacklevel=2
)
rc = self.getEvent()
if rc:
return rc
raise IndexError
def __next__(self):
rc = self.getEvent()
if rc:
return rc
raise StopIteration
def __iter__(self):
return self
def expandNode(self, node):
event = self.getEvent()
parents = [node]
while event:
token, cur_node = event
if cur_node is node:
return
if token != END_ELEMENT:
parents[-1].appendChild(cur_node)
if token == START_ELEMENT:
parents.append(cur_node)
elif token == END_ELEMENT:
del parents[-1]
event = self.getEvent()
def getEvent(self):
# use IncrementalParser interface, so we get the desired
# pull effect
if not self.pulldom.firstEvent[1]:
self.pulldom.lastEvent = self.pulldom.firstEvent
while not self.pulldom.firstEvent[1]:
buf = self.stream.read(self.bufsize)
if not buf:
self.parser.close()
return None
self.parser.feed(buf)
rc = self.pulldom.firstEvent[1][0]
self.pulldom.firstEvent[1] = self.pulldom.firstEvent[1][1]
return rc
def _slurp(self):
""" Fallback replacement for getEvent() using the
standard SAX2 interface, which means we slurp the
SAX events into memory (no performance gain, but
we are compatible to all SAX parsers).
"""
self.parser.parse(self.stream)
self.getEvent = self._emit
return self._emit()
def _emit(self):
""" Fallback replacement for getEvent() that emits
the events that _slurp() read previously.
"""
rc = self.pulldom.firstEvent[1][0]
self.pulldom.firstEvent[1] = self.pulldom.firstEvent[1][1]
return rc
def clear(self):
"""clear(): Explicitly release parsing objects"""
self.pulldom.clear()
del self.pulldom
self.parser = None
self.stream = None
class SAX2DOM(PullDOM):
def startElementNS(self, name, tagName , attrs):
PullDOM.startElementNS(self, name, tagName, attrs)
curNode = self.elementStack[-1]
parentNode = self.elementStack[-2]
parentNode.appendChild(curNode)
def startElement(self, name, attrs):
PullDOM.startElement(self, name, attrs)
curNode = self.elementStack[-1]
parentNode = self.elementStack[-2]
parentNode.appendChild(curNode)
def processingInstruction(self, target, data):
PullDOM.processingInstruction(self, target, data)
node = self.lastEvent[0][1]
parentNode = self.elementStack[-1]
parentNode.appendChild(node)
def ignorableWhitespace(self, chars):
PullDOM.ignorableWhitespace(self, chars)
node = self.lastEvent[0][1]
parentNode = self.elementStack[-1]
parentNode.appendChild(node)
def characters(self, chars):
PullDOM.characters(self, chars)
node = self.lastEvent[0][1]
parentNode = self.elementStack[-1]
parentNode.appendChild(node)
default_bufsize = (2 ** 14) - 20
def parse(stream_or_string, parser=None, bufsize=None):
if bufsize is None:
bufsize = default_bufsize
if isinstance(stream_or_string, str):
stream = open(stream_or_string, 'rb')
else:
stream = stream_or_string
if not parser:
parser = xml.sax.make_parser()
return DOMEventStream(stream, parser, bufsize)
def parseString(string, parser=None):
from io import StringIO
bufsize = len(string)
buf = StringIO(string)
if not parser:
parser = xml.sax.make_parser()
return DOMEventStream(buf, parser, bufsize)
"""Registration facilities for DOM. This module should not be used
directly. Instead, the functions getDOMImplementation and
registerDOMImplementation should be imported from xml.dom."""
# This is a list of well-known implementations. Well-known names
# should be published by posting to xml-sig@python.org, and are
# subsequently recorded in this file.
import sys
well_known_implementations = {
'minidom':'xml.dom.minidom',
'4DOM': 'xml.dom.DOMImplementation',
}
# DOM implementations not officially registered should register
# themselves with their
registered = {}
def registerDOMImplementation(name, factory):
"""registerDOMImplementation(name, factory)
Register the factory function with the name. The factory function
should return an object which implements the DOMImplementation
interface. The factory function can either return the same object,
or a new one (e.g. if that implementation supports some
customization)."""
registered[name] = factory
def _good_enough(dom, features):
"_good_enough(dom, features) -> Return 1 if the dom offers the features"
for f,v in features:
if not dom.hasFeature(f,v):
return 0
return 1
def getDOMImplementation(name=None, features=()):
"""getDOMImplementation(name = None, features = ()) -> DOM implementation.
Return a suitable DOM implementation. The name is either
well-known, the module name of a DOM implementation, or None. If
it is not None, imports the corresponding module and returns
DOMImplementation object if the import succeeds.
If name is not given, consider the available implementations to
find one with the required feature set. If no implementation can
be found, raise an ImportError. The features list must be a sequence
of (feature, version) pairs which are passed to hasFeature."""
import os
creator = None
mod = well_known_implementations.get(name)
if mod:
mod = __import__(mod, {}, {}, ['getDOMImplementation'])
return mod.getDOMImplementation()
elif name:
return registered[name]()
elif not sys.flags.ignore_environment and "PYTHON_DOM" in os.environ:
return getDOMImplementation(name = os.environ["PYTHON_DOM"])
# User did not specify a name, try implementations in arbitrary
# order, returning the one that has the required features
if isinstance(features, str):
features = _parse_feature_string(features)
for creator in registered.values():
dom = creator()
if _good_enough(dom, features):
return dom
for creator in well_known_implementations.keys():
try:
dom = getDOMImplementation(name = creator)
except Exception: # typically ImportError, or AttributeError
continue
if _good_enough(dom, features):
return dom
raise ImportError("no suitable DOM implementation found")
def _parse_feature_string(s):
features = []
parts = s.split()
i = 0
length = len(parts)
while i < length:
feature = parts[i]
if feature[0] in "0123456789":
raise ValueError("bad feature name: %r" % (feature,))
i = i + 1
version = None
if i < length:
v = parts[i]
if v[0] in "0123456789":
i = i + 1
version = v
features.append((feature, version))
return tuple(features)
U
e5d{
� @ s< d dl Z ddd�Zi Zdd� Zdd� Zdd
d �Zd d
� ZdS )� Nzxml.dom.minidomzxml.dom.DOMImplementation)ZminidomZ4DOMc C s |t | < d S )N)�
registered)�name�factory� r �&/usr/lib64/python3.8/xml/dom/domreg.py�registerDOMImplementation s r c C s$ |D ]\}}| � ||�s dS qdS )Nr � )Z
hasFeature)�dom�features�f�vr r r � _good_enough s r
r c C s� dd l }d }t�| �}|r2t|i i dg�}|�� S | r@t| � S tjjsbd|j krbt|j d d�S t
|t �rtt |�}t�
� D ] }|� }t||�r|| S q|t�� D ]>}zt|d�}W n tk
r� Y q�Y nX t||�r�| S q�td��d S )Nr �getDOMImplementationZ
PYTHON_DOM)r z$no suitable DOM implementation found)�os�well_known_implementations�get�
__import__r r �sys�flags�ignore_environment�environ�
isinstance�str�_parse_feature_string�valuesr
�keys� Exception� ImportError)r r
r Zcreator�modr r r r r ' s0
r c C s� g }| � � }d}t|�}||k r�|| }|d dkrBtd|f ��|d }d }||k rv|| }|d dkrv|d }|}|�||f� qt|�S )Nr �
0123456789zbad feature name: %rr )�split�len�
ValueError�append�tuple)�sr
�parts�iZlengthZfeature�versionr r r r r R s" r )Nr )r r r r r
r r r r r r �<module> s �
+U
e5d{
� @ s@ d Z ddlZddd�Zi Zdd� Zdd � Zdd d �Zd
d� ZdS )z�Registration facilities for DOM. This module should not be used
directly. Instead, the functions getDOMImplementation and
registerDOMImplementation should be imported from xml.dom.� Nzxml.dom.minidomzxml.dom.DOMImplementation)ZminidomZ4DOMc C s |t | < dS )aI registerDOMImplementation(name, factory)
Register the factory function with the name. The factory function
should return an object which implements the DOMImplementation
interface. The factory function can either return the same object,
or a new one (e.g. if that implementation supports some
customization).N)�
registered)�name�factory� r �&/usr/lib64/python3.8/xml/dom/domreg.py�registerDOMImplementation s r c C s$ |D ]\}}| � ||�s dS qdS )zF_good_enough(dom, features) -> Return 1 if the dom offers the featuresr � )Z
hasFeature)�dom�features�f�vr r r � _good_enough s r
r c C s� ddl }d}t�| �}|r2t|i i dg�}|�� S | r@t| � S tjjsbd|j krbt|j d d�S t
|t �rtt |�}t�
� D ] }|� }t||�r|| S q|t�� D ]>}zt|d�}W n tk
r� Y q�Y nX t||�r�| S q�td��dS )aS getDOMImplementation(name = None, features = ()) -> DOM implementation.
Return a suitable DOM implementation. The name is either
well-known, the module name of a DOM implementation, or None. If
it is not None, imports the corresponding module and returns
DOMImplementation object if the import succeeds.
If name is not given, consider the available implementations to
find one with the required feature set. If no implementation can
be found, raise an ImportError. The features list must be a sequence
of (feature, version) pairs which are passed to hasFeature.r N�getDOMImplementationZ
PYTHON_DOM)r z$no suitable DOM implementation found)�os�well_known_implementations�get�
__import__r r �sys�flags�ignore_environment�environ�
isinstance�str�_parse_feature_string�valuesr
�keys� Exception� ImportError)r r
r Zcreator�modr r r r r ' s0
r c C s� g }| � � }d}t|�}||k r�|| }|d dkrBtd|f ��|d }d }||k rv|| }|d dkrv|d }|}|�||f� qt|�S )Nr �
0123456789zbad feature name: %rr )�split�len�
ValueError�append�tuple)�sr
�parts�iZlengthZfeature�versionr r r r r R s" r )Nr )�__doc__r r r r r
r r r r r r �<module> s �
+U
e5d) � @ s� d Z ddlZddlZddlmZmZmZmZ ddlT ddl m
Z
m Z ej j
jej j
jfZG dd� dej j
�Z
ee
dd d
� ee
d d d
� ee
d
dd
� dd� Zdd� Zdd� Zdd� Zdd� ZG dd� de
�ZG dd � d e
�Zeed d d
� eed
d d
� eed d!d
� G d"d#� d#e�Zeed$d%d
� eZG d&d'� d'e�Z e dd�Z G d(d)� d)e
�Z ee d*d+d
� ee d
d,d
� d-d.� Z G d/d0� d0�Z G d1d2� d2e e
�Z!G d3d4� d4e e
�Z"ee"d$d5d
� G d6d7� d7e"�Z#ee#d8d9d
� ee#d:d;d
� d<d=� Z$d>d?� Z%G d@dA� dAe"�Z&G dBdC� dCe#�Z'G dDdE� dEe�Z(ee(d$dFd
� G dGdH� dH�Z)G dIdJ� dJe)e e
�Z*G dKdL� dLe)e
�Z+G dMdN� dNe)e e
�Z,G dOdP� dPe
�Z-G dQdR� dRe�Z.dSdT� Z/G dUdV� dVe
e �Z0ee0dWdXd
� dYdZ� Z1d[d\� Z2d]d^� Z3ded_d`�Z4dfdadb�Z5dgdcdd�Z6dS )hac Simple implementation of the Level 1 DOM.
Namespaces and other minor Level 2 features are also supported.
parse("foo.xml")
parseString("<foo><bar/></foo>")
Todo:
=====
* convenience methods for getting elements and text.
* more testing
* bring some of the writer and linearizer code into conformance with this
interface
* SAX 2 namespaces
� N)�EMPTY_NAMESPACE� EMPTY_PREFIX�XMLNS_NAMESPACE�domreg)�*)�DOMImplementationLS�
DocumentLSc @ s� e Zd ZdZdZdZdZdZeZ dd� Z
d2dd�Z d3dd �Z d
d � Z
d d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Z d*d+� Z d,d-� Z d.d/� Z d0d1� Z dS )4�NodeNc C s dS )NT� ��selfr
r
�'/usr/lib64/python3.8/xml/dom/minidom.py�__bool__+ s z
Node.__bool__c C s | � dd|�S �N� )� toprettyxml)r �encodingr
r
r
�toxml. s z
Node.toxml� �
c C sx |d krt �� }nt jt �� |ddd�}| jtjkrH| �|d|||� n| �|d||� |d krh|�� S |� � �� S d S )N�xmlcharrefreplacer )r �errors�newliner )
�io�StringIO�
TextIOWrapper�BytesIO�nodeTyper �
DOCUMENT_NODE�writexml�getvalue�detach)r �indent�newlr �writerr
r
r
r 1 s
� zNode.toprettyxmlc C s
t | j�S �N)�bool�
childNodesr r
r
r
�
hasChildNodesC s zNode.hasChildNodesc C s | j S r% �r' r r
r
r
�_get_childNodesF s zNode._get_childNodesc C s | j r| j d S d S �Nr r) r r
r
r
�_get_firstChildI s zNode._get_firstChildc C s | j r| j d S d S �N���r) r r
r
r
�_get_lastChildM s zNode._get_lastChildc C s
|j | jkr,t|j�D ]}| �||� q|S |j | jkrTtj�dt |�t | �f ��|j
d k rj|j
� |� |d kr~| � |� n�z| j�
|�}W n tk
r� tj�� �Y nX |j tkr�t| � | j�||� ||_||_|r�| j|d }||_||_nd |_| |_
|S )N�%s cannot be child of %s� )r �DOCUMENT_FRAGMENT_NODE�tupler' � insertBefore�_child_node_types�xml�dom�HierarchyRequestErr�repr�
parentNode� removeChild� appendChild�index�
ValueError� NotFoundErr�_nodeTypes_with_children�_clear_id_cache�insert� nextSibling�previousSibling)r �newChild�refChild�cr= �noder
r
r
r4 Q s8 �
zNode.insertBeforec C s� |j | jkr*t|j�D ]}| �|� q|S |j | jkrTtj�dt |�t | �f ��n|j t
krft | � |j d k r||j �
|� t| |� d |_|S �Nr0 )r r2 r3 r' r< r5 r6 r7 r8 r9 r@ rA r: r; �
_append_childrC )r rH rG r
r
r
r< q s �
zNode.appendChildc C s |j | jkr(|j}| �|� | �||�S |j | jkrPtj�dt |�t | �f ��||kr\d S |j
d k rr|j
�|� z| j � |�}W n t
k
r� tj�� �Y nX || j |< | |_
d |_
|j tks�|j tkr�t| � |j|_|j|_d |_d |_|jr�||j_|j�r||j_|S rI )r r2 rC r; r4 r5 r6 r7 r8 r9 r: r' r= r> r? r@ rA rD )r rE �oldChildrF r= r
r
r
� replaceChild� s@
�
�zNode.replaceChildc C s� z| j �|� W n tk
r. tj�� �Y nX |jd k rD|j|j_|jd k rX|j|j_d |_|_|jt krvt
| � d |_ |S r% ) r' �remover> r6 r7 r? rC rD r r@ rA r: �r rK r
r
r
r; � s
zNode.removeChildc C s� g }| j D ]�}|jtjkr�|jsJ|r0|j|d _|jr@|j|j_|�� q�|r�|d j|jkr�|d }|j|j |_|j|_|jr�||j_|�� q�|�|� q
|�|� |jtj kr
|�
� q
|| j d d �< d S r- ) r' r r � TEXT_NODE�datarC rD �unlink�append� ELEMENT_NODE� normalize)r �L�childrH r
r
r
rT � s*
zNode.normalizec C s t | || jp| �S r% )� _clone_node�
ownerDocument)r �deepr
r
r
� cloneNode� s zNode.cloneNodec C s | j j�||�S r% )rX �implementation�
hasFeature�r �feature�versionr
r
r
� isSupported� s zNode.isSupportedc C s d S r% r
r r
r
r
�_get_localName� s zNode._get_localNamec C s | |kS r% r
�r �otherr
r
r
�
isSameNode� s zNode.isSameNodec C s | � |d �r| S d S d S r% )r` �r r^ r
r
r
� getInterface� s zNode.getInterfacec C s0 z| j | d W S ttfk
r* Y d S X d S r+ )�
_user_data�AttributeError�KeyError�r �keyr
r
r
� getUserData� s zNode.getUserDatac C sn d }z
| j }W n tk
r, i }|| _ Y nX ||krB|| d }|d kr^d }|d k rj||= n ||f||< |S r+ )rg rh )r rk rP �handler�old�dr
r
r
� setUserData� s
zNode.setUserDatac C sD t | d�r@t| j�� �D ]&\}\}}|d k r|�|||||� qd S )Nrg )�hasattr�listrg �itemsZhandle)r � operation�srcZdstrk rP rm r
r
r
�_call_user_data_handler� s
z Node._call_user_data_handlerc C s> d | _ | _| jr.| jD ] }|�� qt� | _d | _d | _d S r% )r: rX r' rQ �NodeListrD rC )r rV r
r
r
rQ s
z Node.unlinkc C s | S r% r
r r
r
r
� __enter__ s zNode.__enter__c C s | � � d S r% )rQ )r ZetZev�tbr
r
r
�__exit__ s z
Node.__exit__)N)r r N)!�__name__�
__module__� __qualname__� namespaceURIr: rX rC rD r �prefixr r r r( r* r, r/ r4 r< rL r; rT rZ r` ra rd rf rl rp rv rQ rx rz r
r
r
r
r " s:
r �
firstChildzFirst child node, or None.)�doc� lastChildzLast child node, or None.� localNamez"Namespace-local name of this node.c C s2 | j }|r |d }||_||_|�|� | |_d S r- )r' rD rC rR r: )r rH r' Zlastr
r
r
rJ s
rJ c C s$ | d k r | j tjkrdS | j} q dS �NTF)r r r r: �rH r
r
r
� _in_document& s
r� c C s6 |r2|� dd�� dd�� dd�� dd�}| �|� d S )
zWrites datachars to writer.�&z&�<z<�"z"�>z>N)�replace�write)r$ rP r
r
r
� _write_data. s � �r� c C sD | j D ]8}|jtjkr2|dks(|j|kr2|�|� t|||� q|S �Nr )r' r r rS �tagNamerR � _get_elements_by_tagName_helper)�parent�name�rcrH r
r
r
r� 5 s
��
r� c C sX | j D ]L}|jtjkr|dks(|j|krD|dks:|j|krD|�|� t||||� q|S r� )r' r r rS r� r~ rR �"_get_elements_by_tagName_ns_helper)r� ZnsURIr� r� rH r
r
r
r� = s
��
r� c @ sJ e Zd ZejZdZdZdZdZ ej
ej ej ej
ejejejfZdd� ZdS )�DocumentFragmentz#document-fragmentNc C s t � | _d S r% )rw r' r r
r
r
�__init__T s zDocumentFragment.__init__)r{ r| r} r r2 r �nodeName� nodeValue�
attributesr: rS rO �CDATA_SECTION_NODE�ENTITY_REFERENCE_NODE�PROCESSING_INSTRUCTION_NODE� COMMENT_NODE�
NOTATION_NODEr5 r� r
r
r
r
r� F s �r� c @ s� e Zd ZdZejZdZdZdZ ej
ej fZ e
ddfdd�Zdd� Zdd � Zd
d � Zd d
� Zeee� ZZdd� Zdd� Zeee� ZZdd� Zdd� Zeee�Z dd� Z dd� Z dd� Z dS ) �Attr)�_name�_valuer~ �_prefixr' �
_localNamerX � ownerElementNFc C s2 d | _ || _|| _|| _t� | _| j�t� � d S r% )r� r� r~ r� rw r' rR �Text)r �qNamer~ r� r r
r
r
r� b s z
Attr.__init__c C s4 z| j W S tk
r. | j�dd�d Y S X d S �N�:r1 r. )r� rh r� �splitr r
r
r
ra o s zAttr._get_localNamec C s | j S r% )� specifiedr r
r
r
�_get_specifiedu s zAttr._get_specifiedc C s | j S r% )r� r r
r
r
� _get_namex s zAttr._get_namec C s || _ | jd k rt| j� d S r% )r� r� rA �r �valuer
r
r
� _set_name{ s
zAttr._set_namec C s | j S r% )r� r r
r
r
�
_get_value� s zAttr._get_valuec C s6 || _ || jd _| jd k r&t| j� || jd _d S r+ )r� r' rP r� rA r� r
r
r
�
_set_value� s
zAttr._set_valuec C s | j S r% )r� r r
r
r
� _get_prefix� s zAttr._get_prefixc C sd | j }|dkr&|r&|tkr&tj�d��|| _|d kr<| j}nd|| jf }| jrZt| j� || _ d S )N�xmlnsz5illegal use of 'xmlns' prefix for the wrong namespacez%s:%s)
r~ r r6 r7 � NamespaceErrr� r� r� rA r� )r r ZnsuriZnewNamer
r
r
� _set_prefix� s �
zAttr._set_prefixc C sv | j }|d k rR|j| j= |j| j| jf= | jrRd| _| jd8 _| j j d8 _ | j
D ] }|� � qX| j
d d �= d S )NFr1 ) r� �_attrsr� �_attrsNSr~ r� �_is_id�_magic_id_nodesrX �_magic_id_countr' rQ )r �elemrV r
r
r
rQ � s
z Attr.unlinkc C sf | j r
dS | j}| j}|d ks&|d kr*dS |�|�}|d kr@dS | jrV|�| j| j�S |�| j�S d S r� ) r� rX r� �_get_elem_infor~ �isIdNSr� �isIdr� �r r� r� �infor
r
r
� _get_isId� s
zAttr._get_isIdc C s\ | j }| j}|d ks |d kr tS |�|�}|d kr6tS | jrL|�| j| j�S |�| j�S d S r% ) rX r� �_no_typer� r~ �getAttributeTypeNSr� �getAttributeTyper� r� r
r
r
�_get_schemaType� s
zAttr._get_schemaType) r{ r| r} � __slots__r �ATTRIBUTE_NODEr r� r� r� rO r� r5 r r� ra r� r� r� �propertyr� r� r� r� r� r� r� r� r rQ r� r� r
r
r
r
r� X s. �
r� r� z True if this attribute is an ID.z'Namespace-local name of this attribute.�
schemaTypez Schema type for this attribute.c @ s� e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
d:dd�ZeZdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Z d2d3� Z d4d5� Z d6d7� Z d8d9� Z dS );� NamedNodeMapa The attribute list is a transient interface to the underlying
dictionaries. Mutations here will change the underlying element's
dictionary.
Ordering is imposed artificially and does not reflect the order of
attributes as found in an input document.
�r� r� �
_ownerElementc C s || _ || _|| _d S r% r� )r �attrsZattrsNSr� r
r
r
r� � s zNamedNodeMap.__init__c C s
t | j�S r% )�lenr� r r
r
r
� _get_length� s zNamedNodeMap._get_lengthc C s4 z| t | j�� �| W S tk
r. Y d S X d S r% )rr r� �keys�
IndexError�r r= r
r
r
�item� s zNamedNodeMap.itemc C s* g }| j �� D ]}|�|j|jf� q|S r% )r� �valuesrR r� r� �r rU rH r
r
r
rs � s zNamedNodeMap.itemsc C s0 g }| j �� D ] }|�|j|jf|jf� q|S r% )r� r� rR r~ r� r� r� r
r
r
�itemsNS� s zNamedNodeMap.itemsNSc C s" t |t�r|| jkS || jkS d S r% )�
isinstance�strr� r� rj r
r
r
� __contains__� s
zNamedNodeMap.__contains__c C s
| j �� S r% )r� r� r r
r
r
r� s zNamedNodeMap.keysc C s
| j �� S r% )r� r� r r
r
r
�keysNS s zNamedNodeMap.keysNSc C s
| j �� S r% )r� r� r r
r
r
r� s zNamedNodeMap.valuesNc C s | j �||�S r% �r� �get)r r� r� r
r
r
r�
s zNamedNodeMap.getc C s: | j t|dd �krdS t| �t|�kt| �t|�k S d S )Nr� r )r� �getattr�idrb r
r
r
�_cmp s zNamedNodeMap._cmpc C s | � |�dkS r+ �r� rb r
r
r
�__eq__ s zNamedNodeMap.__eq__c C s | � |�dkS r+ r� rb r
r
r
�__ge__ s zNamedNodeMap.__ge__c C s | � |�dkS r+ r� rb r
r
r
�__gt__ s zNamedNodeMap.__gt__c C s | � |�dkS r+ r� rb r
r
r
�__le__ s zNamedNodeMap.__le__c C s | � |�dk S r+ r� rb r
r
r
�__lt__! s zNamedNodeMap.__lt__c C s" t |t�r| j| S | j| S d S r% )r� r3 r� r� )r �attname_or_tupler
r
r
� __getitem__$ s
zNamedNodeMap.__getitem__c C sv t |t�rRz| j| }W n0 tk
rH t|�}| jj|_| �|� Y nX ||_n t |t�sdt d��|}| �|� d S )Nz%value must be a string or Attr object)
r� r� r� ri r� r� rX � setNamedItemr� � TypeError)r �attnamer� rH r
r
r
� __setitem__+ s
zNamedNodeMap.__setitem__c C s( z | j | W S tk
r" Y d S X d S r% )r� ri �r r� r
r
r
� getNamedItem: s zNamedNodeMap.getNamedItemc C s, z| j ||f W S tk
r& Y d S X d S r% )r� ri �r r~ r� r
r
r
�getNamedItemNS@ s zNamedNodeMap.getNamedItemNSc C sX | � |�}|d k rJt| j� | j|j= | j|j|jf= t|d�rFd |_ |S t
j � � �d S �Nr� )
r� rA r� r� r� r� r~ r� rq r� r6 r7 r? �r r� �nr
r
r
�removeNamedItemF s
z NamedNodeMap.removeNamedItemc C sZ | � ||�}|d k rLt| j� | j|j|jf= | j|j= t|d�rHd |_ |S t
j � � �d S r� )
r� rA r� r� r~ r� r� r� rq r� r6 r7 r? �r r~ r� r� r
r
r
�removeNamedItemNSR s
z NamedNodeMap.removeNamedItemNSc C st t |t�s&tj�dt|�t| �f ��| j�|j�}|r@|� � || j|j< || j
|j |j f< | j
|_t|j� |S rI )r� r� r6 r7 r8 r9 r� r� r� rQ r� r~ r� r� r� rA )r rH rn r
r
r
r� ^ s
�
zNamedNodeMap.setNamedItemc C s
| � |�S r% )r� �r rH r
r
r
�setNamedItemNSk s zNamedNodeMap.setNamedItemNSc C s | | }t |j� |�� d S r% )rA r� rQ )r r� rH r
r
r
� __delitem__n s
zNamedNodeMap.__delitem__c C s | j | j| jfS r% r� r r
r
r
� __getstate__s s zNamedNodeMap.__getstate__c C s |\| _ | _| _d S r% r� �r �stater
r
r
� __setstate__v s zNamedNodeMap.__setstate__)N)!r{ r| r} �__doc__r� r� r� r� rs r� r� r� r� r� r� �__len__r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r
r
r
r
r� � s<
r� Zlengthz$Number of nodes in the NamedNodeMap.c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) �TypeInfo�� namespacer� c C s || _ || _d S r% r )r r r� r
r
r
r� � s zTypeInfo.__init__c C s2 | j r d| jj| j| j f S d| jj| jf S d S )Nz<%s %r (from %r)>z<%s %r>)r � __class__r{ r� r r
r
r
�__repr__� s
�zTypeInfo.__repr__c C s | j S r% )r� r r
r
r
r� � s zTypeInfo._get_namec C s | j S r% )r r r
r
r
�_get_namespace� s zTypeInfo._get_namespaceN)r{ r| r} r� r� r r� r r
r
r
r
r� s
r� c @ s e Zd ZdZejZdZeZ dZ
ejej ej ej
ejejfZeddfdd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Z dd� Z e Z d d � Z d d � Z d d!� Z!e!Z"d"d#� Z#d$d%� Z$d&d'� Z%d(d)� Z&d*d+� Z'd9d-d.�Z(d/d0� Z)d1d2� Z*d3d4� Z+d5d6� Z,d7d8� Z-dS ):�Element) rX r: r� r� r r~ r� r' r� r� rC rD Nr c C sB d | _ | | _| _|| _|| _t� | _d | _| _d | _ d | _
d S r% ) r: r� r� r r~ rw r' rC rD r� r� )r r� r~ r r� r
r
r
r� � s
zElement.__init__c C s | j d kri | _ i | _d S r% )r� r� r r
r
r
�_ensure_attributes� s
zElement._ensure_attributesc C s4 z| j W S tk
r. | j�dd�d Y S X d S r� )r� rh r� r� r r
r
r
ra � s zElement._get_localNamec C s | j S r% �r� r r
r
r
� _get_tagName� s zElement._get_tagNamec C s@ | j d k r&t| j �� �D ] }|�� qd | _ d | _t�| � d S r% )r� rr r� rQ r� r )r �attrr
r
r
rQ � s
zElement.unlinkc C s8 | j d krdS z| j | jW S tk
r2 Y dS X d S r )r� r� ri )r r� r
r
r
� getAttribute� s
zElement.getAttributec C s< | j d krdS z| j ||f jW S tk
r6 Y dS X d S r )r� r� ri r� r
r
r
�getAttributeNS� s
zElement.getAttributeNSc C sV | � |�}|d kr4t|�}||_| j|_| �|� n ||jkrR||_|jrRt| � d S r% )�getAttributeNoder� r� rX �setAttributeNoder� rA )r r� r� r r
r
r
� setAttribute� s
zElement.setAttributec C s� t |�\}}| �||�}|d krHt||||�}||_| j|_| �|� n4||jkrf||_|jrft| � |j|kr|||_||_ d S r% )
�_nssplit�getAttributeNodeNSr� r� rX r
r� rA r r� )r r~ �
qualifiedNamer� r � localnamer r
r
r
�setAttributeNS� s
zElement.setAttributeNSc C s | j d krd S | j �|�S r% r� )r �attrnamer
r
r
r � s
zElement.getAttributeNodec C s | j d krd S | j �||f�S r% )r� r� r� r
r
r
r s
zElement.getAttributeNodeNSc C s� |j d | fkrtj�d��| �� | j�|jd �}|d k rD| �|� | j �|j
|j fd �}|d k rt||k rt| �|� t | |� ||k r�|S ||k r�|S d S )Nz attribute node already owned)
r� r6 r7 ZInuseAttributeErrr r� r� r� �removeAttributeNoder� r~ r� �_set_attribute_node)r r Zold1Zold2r
r
r
r
s
zElement.setAttributeNodec C sP | j d krtj�� �z| j| }W n tk
r@ tj�� �Y nX | �|� d S r% )r� r6 r7 r? r� ri r )r r� r r
r
r
�removeAttribute s
zElement.removeAttributec C sT | j d krtj�� �z| j ||f }W n tk
rD tj�� �Y nX | �|� d S r% )r� r6 r7 r? ri r )r r~ r� r r
r
r
�removeAttributeNS% s
zElement.removeAttributeNSc C s^ |d krt j�� �z| j|j W n tk
r@ t j�� �Y nX t| � |�� | j|_|S r% ) r6 r7 r? r� r� ri rA rQ rX r� r
r
r
r . s
zElement.removeAttributeNodec C s | j d krdS || j kS �NF�r� r� r
r
r
� hasAttribute> s
zElement.hasAttributec C s | j d krdS ||f| j kS r )r� r� r
r
r
�hasAttributeNSC s
zElement.hasAttributeNSc C s t | |t� �S r% �r� rw r� r
r
r
�getElementsByTagNameH s z Element.getElementsByTagNamec C s t | ||t� �S r% �r� rw r� r
r
r
�getElementsByTagNameNSK s �z Element.getElementsByTagNameNSc C s d| j t| �f S )Nz<DOM Element: %s at %#x>)r� r� r r
r
r
r O s zElement.__repr__r c C s� |� |d | j � | �� }|�� D ],}|� d| � t||| j� |� d� q$| jr�|� d� t| j�dkr�| jd jt j
t j fkr�| jd � |ddd� n4|� |� | jD ]}|� ||| ||� q�|� |� |� d| j|f � n|� d | � d S )
Nr� z %s="r� r� r1 r r z</%s>%sz/>%s)
r� r� �_get_attributesr� r� r� r' r� r r rO r� r )r r$ r" � addindentr# r� Za_namerH r
r
r
r R s*
��
zElement.writexmlc C s | � � t| j| j| �S r% )r r� r� r� r r
r
r
r! m s zElement._get_attributesc C s | j r
dS dS d S r� r r r
r
r
�
hasAttributesq s zElement.hasAttributesc C s | � |�}| �|� d S r% )r �setIdAttributeNode)r r� �idAttrr
r
r
�setIdAttributey s
zElement.setIdAttributec C s | � ||�}| �|� d S r% )r r$ )r r~ r� r% r
r
r
�setIdAttributeNS} s zElement.setIdAttributeNSc C sj |d ks| � |j�s tj�� �t| �d k r4tj�� �|jsfd|_| jd7 _| j j
d7 _
t | � d S )NTr1 ) rd r� r6 r7 r? �_get_containing_entref�NoModificationAllowedErrr� r� rX r� rA )r r% r
r
r
r$ � s
zElement.setIdAttributeNode)r r r ).r{ r| r} r� r rS r r� r� r� r� r� r� rO r� r� r5 r r� r ra r rQ r
r r r r r r
ZsetAttributeNodeNSr r r ZremoveAttributeNodeNSr r r r r r r! r# r& r' r$ r
r
r
r
r � sT ��
r r� z*NamedNodeMap of attributes on the element.z%Namespace-local name of this element.c C s8 t | � | �� || j|j< || j|j|jf< | |_d S r% )rA r r� r� r� r~ r� r� )�elementr r
r
r
r � s
r c @ sf e Zd ZdZdZdZe� ZdZdZ dd� Z
dd� Z dd � Z d
d � Z
d d
� Zdd� Zdd� Zdd� ZdS )� Childlessz�Mixin that makes childless-ness easy to implement and avoids
the complexity of the Node methods that deal with children.
r
Nc C s d S r% r
r r
r
r
r, � s zChildless._get_firstChildc C s d S r% r
r r
r
r
r/ � s zChildless._get_lastChildc C s t j�| jd ��d S )Nz nodes cannot have children�r6 r7 r8 r� r� r
r
r
r< � s �zChildless.appendChildc C s dS r r
r r
r
r
r( � s zChildless.hasChildNodesc C s t j�| jd ��d S �Nz nodes do not have childrenr, �r rE rF r
r
r
r4 � s �zChildless.insertBeforec C s t j�| jd ��d S r- )r6 r7 r? r� rN r
r
r
r; � s �zChildless.removeChildc C s d S r% r
r r
r
r
rT � s zChildless.normalizec C s t j�| jd ��d S r- r, �r rE rK r
r
r
rL � s �zChildless.replaceChild)r{ r| r} r� r� r� Z
EmptyNodeListr' r� r� r, r/ r< r( r4 r; rT rL r
r
r
r
r+ � s r+ c @ s\ e Zd ZejZdZdd� Zdd� Zdd� Z e
ee �Z dd � Z d
d � Z
e
e e
�Zdd
d�ZdS )�ProcessingInstruction��targetrP c C s || _ || _d S r% r1 )r r2 rP r
r
r
r� � s z ProcessingInstruction.__init__c C s | j S r% �rP r r
r
r
�_get_nodeValue� s z$ProcessingInstruction._get_nodeValuec C s
|| _ d S r% r3 r� r
r
r
�_set_nodeValue� s z$ProcessingInstruction._set_nodeValuec C s | j S r% �r2 r r
r
r
�
_get_nodeName� s z#ProcessingInstruction._get_nodeNamec C s
|| _ d S r% r6 r� r
r
r
�
_set_nodeName� s z#ProcessingInstruction._set_nodeNamer c C s |� d|| j| j|f � d S )Nz
%s<?%s %s?>%s)r� r2 rP �r r$ r" r" r# r
r
r
r � s z ProcessingInstruction.writexmlN)r r r )r{ r| r} r r� r r� r� r4 r5 r� r� r7 r8 r� r r
r
r
r
r0 � s
r0 c @ sr e Zd ZdZdd� Zdd� ZeZdd� Zdd � Ze ee� Z
Z d
d � Z d d
� Z
dd� Zdd� Zdd� Zdd� ZdS )�
CharacterData)�_datarX r: rD rC c C s, d | _ | _d | _| _d| _t�| � d S r )rX r: rD rC r; r r� r r
r
r
r� � s zCharacterData.__init__c C s
t | j�S r% )r� rP r r
r
r
r� � s zCharacterData._get_lengthc C s | j S r% �r; r r
r
r
� _get_data� s zCharacterData._get_datac C s
|| _ d S r% r< �r rP r
r
r
� _set_data� s zCharacterData._set_datac C s6 | j }t|�dkrd}nd}d| jj|dd� |f S )N�
z...r z<DOM %s node "%r%s">r )rP r� r r{ )r rP Z dotdotdotr
r
r
r � s
�zCharacterData.__repr__c C sT |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��| j||| � S �Nr �offset cannot be negative�#offset cannot be beyond end of data�count cannot be negative�r6 r7 � IndexSizeErrr� rP �r �offset�countr
r
r
�
substringData� s zCharacterData.substringDatac C s | j | | _ d S r% r3 )r �argr
r
r
�
appendData s zCharacterData.appendDatac C sZ |dk rt j�d��|t| j�kr.t j�d��|rVd| jd |� || j|d � f | _d S )Nr rB rC �%s%s%srE )r rH rK r
r
r
�
insertData s �zCharacterData.insertDatac C sl |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��|rh| jd |� | j|| d � | _d S rA rE rG r
r
r
�
deleteData s zCharacterData.deleteDatac C sr |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��|rnd| jd |� || j|| d � f | _d S )Nr rB rC rD rM rE )r rH rI rK r
r
r
� replaceData s �zCharacterData.replaceDataN)r{ r| r} r� r� r� r� r= r? r� rP r� r rJ rL rN rO rP r
r
r
r
r: � s
r: zLength of the string data.c @ sH e Zd ZdZejZdZdZdd� Z ddd�Z
d d
� Z d d � Z d
d� Z
dS )r� r
z#textNc C s� |dk s|t | j�kr"tj�d��| �� }| j|d � |_| j|_| j}| jr~| | jj kr~|d krp| j�
|� n| j� ||� | jd |� | _|S )Nr zillegal offset value) r� rP r6 r7 rF r rX rC r: r' r< r4 )r rH ZnewText�nextr
r
r
� splitText1 s zText.splitTextr c C s t |d|| j|f � d S )NrM )r� rP r9 r
r
r
r @ s z
Text.writexmlc C s� | j g}| j}|d k rB|jtjtjfkrB|�d|j � |j}qqBq| j}|d k rz|jtjtjfkrz|�|j � |j}qHqzqHd� |�S )Nr r )
rP rD r r rO r� rB rC rR �join)r rU r� r
r
r
�_get_wholeTextE s zText._get_wholeTextc C s� | j }| j}|d k r@|jtjtjfkr@|j}|�|� |}q q@q | j}|sT|�| � |d k r�|jtjtjfkr�|j}|�|� |}qTq�qT|r�|| _| S d S d S r% ) r: rD r r rO r� r; rC rP )r Zcontentr� r� rQ r
r
r
�replaceWholeTextW s*
zText.replaceWholeTextc C sF | j �� rdS t| �}|d kr"dS | j�|�}|d kr:dS |�� S d S r )rP �strip�_get_containing_elementrX r� �isElementContent)r r� r� r
r
r
�!_get_isWhitespaceInElementContents s
z&Text._get_isWhitespaceInElementContent)r r r )r{ r| r} r� r rO r r� r� rR r rT rU rY r
r
r
r
r� * s
r� Z isWhitespaceInElementContentzKTrue iff this text node contains only whitespace and is in element content.Z wholeTextz.The text of all logically-adjacent text nodes.c C s* | j }|d k r&|jtjkr |S |j }qd S r% )r: r r rS �rH rG r
r
r
rW � s rW c C s* | j }|d k r&|jtjkr |S |j }qd S r% )r: r r r� rZ r
r
r
r( � s r( c @ s( e Zd ZejZdZdd� Zddd�ZdS ) �Commentz#commentc C s t �| � || _d S r% )r: r� r; r> r
r
r
r� � s
zComment.__init__r c C s, d| j krtd��|�d|| j |f � d S )Nz--z%'--' is not allowed in a comment nodez
%s<!--%s-->%s)rP r> r� r9 r
r
r
r � s
zComment.writexmlN)r r r ) r{ r| r} r r� r r� r� r r
r
r
r
r[ � s r[ c @ s$ e Zd ZdZejZdZddd�ZdS )� CDATASectionr
z#cdata-sectionr c C s, | j �d�dkrtd��|�d| j � d S )Nz]]>r z$']]>' not allowed in a CDATA sectionz<![CDATA[%s]]>)rP �findr> r� r9 r
r
r
r � s zCDATASection.writexmlN)r r r ) r{ r| r} r� r r� r r� r r
r
r
r
r\ � s r\ c @ sz e Zd ZdZd dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd S ) � ReadOnlySequentialNamedNodeMap��_seqr
c C s
|| _ d S r% r_ )r �seqr
r
r
r� � s z'ReadOnlySequentialNamedNodeMap.__init__c C s
t | j�S r% �r� r` r r
r
r
r� � s z&ReadOnlySequentialNamedNodeMap.__len__c C s
t | j�S r% rb r r
r
r
r� � s z*ReadOnlySequentialNamedNodeMap._get_lengthc C s" | j D ]}|j|kr| S qd S r% )r` r� r� r
r
r
r� � s
z+ReadOnlySequentialNamedNodeMap.getNamedItemc C s, | j D ] }|j|kr|j|kr| S qd S r% )r` r~ r� r� r
r
r
r� � s
z-ReadOnlySequentialNamedNodeMap.getNamedItemNSc C s4 t |t�r| j|� }n
| �|�}|d kr0t|��|S r% )r� r3 r� r� ri )r Z
name_or_tuplerH r
r
r
r� � s
z*ReadOnlySequentialNamedNodeMap.__getitem__c C s4 |dk r d S z | j | W S tk
r. Y d S X d S r+ )r` r� r� r
r
r
r� � s z#ReadOnlySequentialNamedNodeMap.itemc C s t j�d��d S �Nz"NamedNodeMap instance is read-only�r6 r7 r) r� r
r
r
r� � s �z.ReadOnlySequentialNamedNodeMap.removeNamedItemc C s t j�d��d S rc rd r� r
r
r
r� � s �z0ReadOnlySequentialNamedNodeMap.removeNamedItemNSc C s t j�d��d S rc rd r� r
r
r
r� � s �z+ReadOnlySequentialNamedNodeMap.setNamedItemc C s t j�d��d S rc rd r� r
r
r
r� � s �z-ReadOnlySequentialNamedNodeMap.setNamedItemNSc C s | j gS r% r_ r r
r
r
r� � s z+ReadOnlySequentialNamedNodeMap.__getstate__c C s |d | _ d S r+ r_ r� r
r
r
r� � s z+ReadOnlySequentialNamedNodeMap.__setstate__N)r
)r{ r| r} r� r� r� r� r� r� r� r� r� r� r� r� r� r� r
r
r
r
r^ � s
r^ z&Number of entries in the NamedNodeMap.c @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S )
�
Identifiedz@Mix-in class that supports the publicId and systemId attributes.��publicId�systemIdc C s || _ || _d S r% rf )r rg rh r
r
r
�_identified_mixin_init� s z!Identified._identified_mixin_initc C s | j S r% )rg r r
r
r
�
_get_publicId� s zIdentified._get_publicIdc C s | j S r% )rh r r
r
r
�
_get_systemId� s zIdentified._get_systemIdN)r{ r| r} r� r� ri rj rk r
r
r
r
re � s
re c @ sH e Zd ZejZdZdZdZdZ dZ
dd� Z dd� Z dd� Z
d d d
�ZdS ) � DocumentTypeNc C s2 t � | _t � | _|r&t|�\}}|| _| j| _d S r% )r^ �entities� notationsr r� r� )r r r r r
r
r
r�
s zDocumentType.__init__c C s | j S r% )�internalSubsetr r
r
r
�_get_internalSubset s z DocumentType._get_internalSubsetc C s� | j d kr�td �}| j|_| j|_tjjj}|r�g |j_ g |j
_ | j
j D ]2}t |j|j |j
�}|j
j �|� |�|||� qH| jj D ]N}t|j|j |j
|j�}|j|_|j|_|j|_|jj �|� |�|||� q�| �|| |� |S d S d S r% )rX rl r� r� r6 r7 �UserDataHandler� NODE_CLONEDrm r` rn �Notationrg rh rR rv �Entity� notationName�actualEncodingr r_ )r rY �clonert r� �notation�e�entityr
r
r
rZ s0
�zDocumentType.cloneNoder c C s� |� d� |� | j� | jr8|� d|| j|| jf � n| jrR|� d|| jf � | jd k r||� d� |� | j� |� d� |� d| � d S )Nz
<!DOCTYPE z%s PUBLIC '%s'%s '%s'z%s SYSTEM '%s'z [�]r� )r� r� rg rh ro r9 r
r
r
r 0 s
�
zDocumentType.writexml)r r r )r{ r| r} r �DOCUMENT_TYPE_NODEr r� r� rg rh ro r� rp rZ r r
r
r
r
rl s rl c @ sf e Zd ZdZejZdZdZdZ dZ
dd� Z dd� Z dd� Z
dd � Zd
d � Zd d
� Zdd� Zdd� ZdS )rt Nc C s$ || _ || _t� | _| �||� d S r% )r� ru rw r' ri )r r� rg rh rx r
r
r
r� G s zEntity.__init__c C s | j S r% �rv r r
r
r
�_get_actualEncodingM s zEntity._get_actualEncodingc C s | j S r% �r r r
r
r
�
_get_encodingP s zEntity._get_encodingc C s | j S r% �r_ r r
r
r
� _get_versionS s zEntity._get_versionc C s t j�d��d S )Nz(cannot append children to an entity node�r6 r7 r8 )r rE r
r
r
r< V s �zEntity.appendChildc C s t j�d��d S )Nz+cannot insert children below an entity noder� r. r
r
r
r4 Z s �zEntity.insertBeforec C s t j�d��d S )Nz*cannot remove children from an entity noder� rN r
r
r
r; ^ s �zEntity.removeChildc C s t j�d��d S )Nz)cannot replace children of an entity noder� r/ r
r
r
rL b s �zEntity.replaceChild)r{ r| r} r� r Z ENTITY_NODEr r� rv r r_ r� r~ r� r� r< r4 r; rL r
r
r
r
rt > s rt c @ s e Zd ZejZdZdd� ZdS )rs Nc C s || _ | �||� d S r% )r� ri )r r� rg rh r
r
r
r� j s zNotation.__init__)r{ r| r} r r� r r� r� r
r
r
r
rs f s rs c @ sH e Zd ZddddddddgZd d
� Zd d � Zd
d� Zdd� Zdd� ZdS )�DOMImplementation)�core�1.0)r� �2.0)r� N)r6 r� )r6 r� )r6 N)�ls-loadz3.0)r� Nc C s |dkr d }|� � |f| jkS r )�lower� _featuresr] r
r
r
r\ z s z DOMImplementation.hasFeaturec C s� |r|j d k rtj�d��| �� }|d ko8|d ko8|d k }|sP|rPtj�d��|r�t|�\}}|dkr||dkr|tj�d��|r�|s�tj�d��|�||�}|r�|� |� |� |� |r�| |_ |_
||_ | |_ |S )Nz(doctype object owned by another DOM treezElement with no namer6 z$http://www.w3.org/XML/1998/namespacezillegal use of 'xml' prefixz(illegal use of prefix without namespaces)
r: r6 r7 �WrongDocumentErr�_create_documentZInvalidCharacterErrr r� �createElementNSr< rX �doctyper[ ) r r~ r r� r� Zadd_root_elementr r r* r
r
r
�createDocument s> ���
� �
z DOMImplementation.createDocumentc C s t |�}||_||_|S r% )rl rg rh )r r rg rh r� r
r
r
�createDocumentType� s z$DOMImplementation.createDocumentTypec C s | � |d �r| S d S d S r% )r\ re r
r
r
rf � s z DOMImplementation.getInterfacec C s t � S r% )�Documentr r
r
r
r� � s z"DOMImplementation._create_documentN) r{ r| r} r� r\ r� r� rf r� r
r
r
r
r� o s �
-r� c @ s\ e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
dS )� ElementInfoz�Object that represents content-model information for an element.
This implementation is not expected to be used in practice; DOM
builders should provide implementations which do the right thing
using information available to it.
r c C s
|| _ d S r% r r� r
r
r
r� � s zElementInfo.__init__c C s t S r% �r� �r Zanamer
r
r
r� � s z ElementInfo.getAttributeTypec C s t S r% r� r� r
r
r
r� � s z ElementInfo.getAttributeTypeNSc C s dS r r
r r
r
r
rX � s z ElementInfo.isElementContentc C s dS )zQReturns true iff this element is declared to have an EMPTY
content model.Fr
r r
r
r
�isEmpty� s zElementInfo.isEmptyc C s dS )z7Returns true iff the named attribute is a DTD-style ID.Fr
r� r
r
r
r� � s zElementInfo.isIdc C s dS )z<Returns true iff the identified attribute is a DTD-style ID.Fr
r� r
r
r
r� � s zElementInfo.isIdNSc C s | j S r% r r r
r
r
r� � s zElementInfo.__getstate__c C s
|| _ d S r% r r� r
r
r
r� � s zElementInfo.__setstate__N)r{ r| r} r� r� r� r� r� rX r� r� r� r� r� r
r
r
r
r� � s r� c C s> | j tjkr | j�� d | _n t| �r:| jj�� d | j_d S r% )r r r � _id_cache�clear�_id_search_stackr� rX r� r
r
r
rA � s
rA c @ sr e Zd ZdZejejejejfZ e
� Z ej Z
dZdZdZdZd ZZdZdZdZdZdZdZdZdZdd� Z dd � Z d
d � Z d d
� Z dd� Z dd� Z!dd� Z"dd� Z#dd� Z$dd� Z%dd� Z&d d � Z'd d � Z(d d!� Z)d"d#� Z*d$d%� Z+d&d'� Z,d(d)� Z-d*d+� Z.d,d-� Z/d.d/� Z0d0d1� Z1d2d3� Z2d4d5� Z3d6d7� Z4d8d9� Z5d:d;� Z6d<d=� Z7d>d?� Z8d@dA� Z9dBdC� Z:dIdEdF�Z;dGdH� Z<dS )Jr� )�
_elem_infor� r� r' r� z #documentNFr c C s$ d | _ t� | _i | _i | _d | _d S r% )r� rw r' r� r� r� r r
r
r
r� s
zDocument.__init__c C s& |j r|j |jf}n|j}| j�|�S r% )r~ r� r� r� r� )r r* rk r
r
r
r� s zDocument._get_elem_infoc C s | j S r% r} r r
r
r
r~ s z Document._get_actualEncodingc C s | j S r% )r� r r
r
r
� _get_doctype s zDocument._get_doctypec C s | j S r% )� documentURIr r
r
r
�_get_documentURI! s zDocument._get_documentURIc C s | j S r% r r r
r
r
r� $ s zDocument._get_encodingc C s | j S r% )� errorHandlerr r
r
r
�_get_errorHandler' s zDocument._get_errorHandlerc C s | j S r% )�
standaloner r
r
r
�_get_standalone* s zDocument._get_standalonec C s | j S r% )�strictErrorCheckingr r
r
r
�_get_strictErrorChecking- s z!Document._get_strictErrorCheckingc C s | j S r% r� r r
r
r
r� 0 s zDocument._get_versionc C sj |j | jkr(tj�dt|�t| �f ��|jd k r>|j�|� |j tj kr^| �
� r^tj�d��t� | |�S )Nr0 z two document elements disallowed) r r5 r6 r7 r8 r9 r: r; r rS �_get_documentElementr< r� r
r
r
r< 3 s �
��zDocument.appendChildc C sV z| j �|� W n tk
r. tj�� �Y nX d |_|_d |_| j |krRd | _ |S r% )
r' rM r> r6 r7 r? rC rD r: �documentElementrN r
r
r
r; C s
zDocument.removeChildc C s$ | j D ]}|jtjkr| S qd S r% )r' r r rS r� r
r
r
r� O s
z Document._get_documentElementc C s( | j d k r| j �� d | _ t�| � d S r% )r� rQ r r r
r
r
rQ T s
zDocument.unlinkc C s� |sd S | j �d d d �}| j|_| j|_| j|_| jD ]B}t|||�}|j�|� |jt j
kr`n|jt j krr||_ ||_
q6| �tjjj| |� |S r% )r[ r� r r� r_ r' rW rR r r r r| r� r: rv r6 r7 rq rr )r rY rw r� Z
childcloner
r
r
rZ Z s&
�zDocument.cloneNodec C s t � }| |_|S r% )r� rX )r ro r
r
r
�createDocumentFragmento s z Document.createDocumentFragmentc C s t |�}| |_|S r% )r rX )r r� ry r
r
r
�
createElementt s zDocument.createElementc C s( t |t�std��t� }||_| |_|S �Nz node contents must be a string)r� r� r� r� rP rX )r rP �tr
r
r
�createTextNodey s
zDocument.createTextNodec C s( t |t�std��t� }||_| |_|S r� )r� r� r� r\ rP rX �r rP rG r
r
r
�createCDATASection� s
zDocument.createCDATASectionc C s t |�}| |_|S r% )r[ rX r� r
r
r
�
createComment� s zDocument.createCommentc C s t ||�}| |_|S r% )r0 rX )r r2 rP �pr
r
r
�createProcessingInstruction� s
z$Document.createProcessingInstructionc C s t |�}| |_d|_|S r )r� rX r� )r r� �ar
r
r
�createAttribute� s zDocument.createAttributec C s" t |�\}}t|||�}| |_|S r% )r r rX )r r~ r r r� ry r
r
r
r� � s zDocument.createElementNSc C s* t |�\}}t||||�}| |_d|_|S r )r r� rX r� )r r~ r r r� r� r
r
r
�createAttributeNS� s
zDocument.createAttributeNSc C s t ||||�}| |_|S r% )rt rX )r r� rg rh ru ry r
r
r
�_create_entity� s zDocument._create_entityc C s t |||�}| |_|S r% )rs rX )r r� rg rh r� r
r
r
�_create_notation� s zDocument._create_notationc C s� || j kr| j | S | js$| js$d S | j}|d krB| jg}|| _n|sJd S d }|�r�|�� }|�dd� |jD �� | �|�}|�rB|j �
� D ]�}|j r�|� |j |j
�r�|| j |j< |j|kr�|}n |js� �q�q�|�|j��r
|| j |j< |j|kr�|}n|j�s> �q�q�|jr�|| j |j< |j|k�r.|}q�|jdkr� �q�q�n>|j�r�|j �
� D ]*}|j�rT|| j |j< |j|k�rT|}�qT|d k rN�q�qN|S )Nc S s g | ]}|j tkr|�qS r
)r r@ )�.0rV r
r
r
�
<listcomp>� s
�z+Document.getElementById.<locals>.<listcomp>r1 )r� r� r� r� r� �pop�extendr' r� r� r� r~ r� r� r� r� r� r� r� )r r� �stack�resultrH r� r r
r
r
�getElementById� sZ
zDocument.getElementByIdc C s t | |t� �S r% r r� r
r
r
r � s z Document.getElementsByTagNamec C s t | ||t� �S r% r r� r
r
r
r � s �z Document.getElementsByTagNameNSc C s | j �||�S r% )r[ r\ r] r
r
r
r` � s zDocument.isSupportedc C s> |j tjkrtj�d��n|j tjkr2tj�d��t||| �S )Nz cannot import document nodesz!cannot import document type nodes)r r r r6 r7 �NotSupportedErrr| rW )r rH rY r
r
r
�
importNode� s
zDocument.importNoder c C sJ |d kr|� d| � n|� d||f � | jD ]}|�||||� q0d S )Nz<?xml version="1.0" ?>z%<?xml version="1.0" encoding="%s"?>%s)r� r' r )r r$ r" r" r# r rH r
r
r
r � s �
zDocument.writexmlc C sJ |j | k r tj�d| |j f ��|jtjtjfkr>tj�d��|t kr�d|kr�|�
dd�\}}|dkr�|tjj kr�tj� d��q�|dkr�|tjj kr�|jtjkr�tj� d��d }|}nd }d }|jtjkr�|j
}|d k r�|j}|�|� nd }||_||_||_||_|jtjk�r ||_n*||_|d k �rF|�|� |�rF|�|� |S )Nz?cannot rename nodes from other documents;
expected %s,
found %sz8renameNode() only applies to element and attribute nodesr� r1 r� z illegal use of 'xmlns' prefixz$illegal use of the 'xmlns' attribute)rX r6 r7 r� r r rS r� r� r r� r r� r� r� r r r� r~ r� r� r� r
r$ )r r� r~ r� r r� r* Zis_idr
r
r
�
renameNode sb
���
��
�
��
zDocument.renameNode)r r r N)=r{ r| r} r� r rS r� r� r| r5 r� r[ r r r� r� r� r: rD rC rv r r� r_ r� r� r� r� r� r� r~ r� r� r� r� r� r� r� r< r; r� rQ rZ r� r� r� r� r� r� r� r� r� r� r� r� r r r` r� r r� r
r
r
r
r� � sj �
:
r� r� z#Top-level element of this document.c
C s� | j �|�rtjjj}n
tjjj}| jtj kr�|�
| j | j �}| j
�� D ]0}|�|j |j |j� |�|j |j�}|j|_qH|r�| jD ]}t|||�}|�|� q��n| jtjkr�|�� }|r�| jD ]}t|||�}|�|� qn�| jtjkr�|�| j�}�n�| jtj k�r |� | j�}�n�| jtj k�r>|� | j | j�}�nj| jtj!k�r\|�"| j�}�nL| jtj#k�r�|�$| j | j �}d|_| j|_�n | jtj%k�r�tjjj}|j&�'| j(| j)| j*�}||_ |�r�g |j+_,g |j-_,| j-j,D ]F} t.| j | j)| j*�}
||
_ |j-j,�/|
� t0| d��r�| �1|| |
� �q�| j+j,D ]b} t2| j | j)| j*| j3�} | j4| _4| j5| _5| j6| _6|| _ |j+j,�/| � t0| d��r.| �1|| | � �q.ntj�7dt8| � ��t0| d��r�| �1|| |� |S )zo
Clone a node and give it the new owner document.
Called by Node.cloneNode and Document.importNode
Trv zCannot clone node %s)9rX rd r6 r7 rq rr Z
NODE_IMPORTEDr r rS r� r~ r� r� r� r r� r r� r� r' rW r< r2 r� rO r� rP r� r� r� r� r2 r� r� r� r� r| r[ r� r� rg rh rm r` rn rs rR rq rv rt ru rv r r_ r� r9 )
rH rY ZnewOwnerDocumentrt rw r r� rV rG r� rx ry rz r
r
r
rW B s�
�
��
� � rW c C s, | � dd�}t|�dkr |S d |d fS d S )Nr� r1 � r )r� r� )r Zfieldsr
r
r
r � s r c C s, | ||�}|� � \}}|�|� |�� |S r% )ZgetEventZ
expandNoder� )�func�args�kwargsZeventsZtoktypeZrootNoder
r
r
�_do_pulldom_parse� s
r� c C sH |dkr"|s"ddl m} |�| �S ddl m} t|j| f||d��S dS )z3Parse a file into a DOM by filename or file object.Nr �� expatbuilder��pulldom)�parser�bufsize)�xml.domr� �parser� r� )�filer� r� r� r� r
r
r
r� � s
�r� c C sB |dkr ddl m} |�| �S ddl m} t|j| fd|i�S dS )z&Parse a file into a DOM from a string.Nr r� r� r� )r� r� � parseStringr� r� )�stringr� r� r� r
r
r
r� � s
�r� c C s@ | r:t | t�rt�| �} | D ] \}}tj�||�s d S q tjS r% )r� r� r Z_parse_feature_stringr� r[ r\ )Zfeatures�f�vr
r
r
�getDOMImplementation� s
r� )NN)N)N)7r� r r� r6 r r r r Zxml.dom.minicompatZxml.dom.xmlbuilderr r r7 r rS r� r@ Z defpropertyrJ r� r� r� r� r� r� �objectr� Z
AttributeListr� r� r r r+ r0 r: r� rW r( r[ r\ r^ re rl rt rs r� r� rA r� rW r r� r� r� r� r
r
r
r
�<module> s� � v
y $�
x�� )GU�� >�<( O* P�R
U
e5d� � @ s� G d d� d�Z dZdZdZdZdZdZdZd Zd
Z d Z
d Z d
Z dZ
dZdZdZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG d d � d e�ZG d d � d e�ZG d d!� d!e�ZG d"d#� d#e�ZG d$d%� d%e�ZG d&d'� d'e�Z G d(d)� d)e�Z G d*d+� d+e�Z G d,d-� d-e�Z G d.d/� d/e�Z G d0d1� d1e�Z!G d2d3� d3e�Z"G d4d5� d5�Z#d6Z$d7Z%d8Z&d9Z'd9Z(dd:l)m*Z*m+Z+ d9S );c @ s@ e Zd ZdZdZdZdZdZdZdZ dZ
d Z d
Z d Z
d Zd
ZdS )�Node� � � � � � � � � � �
� � N)�__name__�
__module__� __qualname__� __slots__Z ELEMENT_NODEZATTRIBUTE_NODEZ TEXT_NODEZCDATA_SECTION_NODEZENTITY_REFERENCE_NODEZ ENTITY_NODEZPROCESSING_INSTRUCTION_NODEZ COMMENT_NODEZ
DOCUMENT_NODEZDOCUMENT_TYPE_NODEZDOCUMENT_FRAGMENT_NODEZ
NOTATION_NODEr r r �(/usr/lib64/python3.8/xml/dom/__init__.pyr s r r r r r r r r r
r r r
r �
� � � c @ s e Zd Zdd� Zdd� ZdS )� DOMExceptionc O s( | j tkrtd��tj| f|�|� d S )Nz0DOMException should not be instantiated directly)� __class__r � RuntimeError� Exception�__init__)�self�args�kwr r r r B s
�zDOMException.__init__c C s | j S )N)�code)r r r r � _get_codeH s zDOMException._get_codeN)r r r r r! r r r r r > s r c @ s e Zd ZeZdS )� IndexSizeErrN)r r r �INDEX_SIZE_ERRr r r r r r" L s r" c @ s e Zd ZeZdS )�DomstringSizeErrN)r r r �DOMSTRING_SIZE_ERRr r r r r r$ O s r$ c @ s e Zd ZeZdS )�HierarchyRequestErrN)r r r �HIERARCHY_REQUEST_ERRr r r r r r& R s r& c @ s e Zd ZeZdS )�WrongDocumentErrN)r r r �WRONG_DOCUMENT_ERRr r r r r r( U s r( c @ s e Zd ZeZdS )�InvalidCharacterErrN)r r r �INVALID_CHARACTER_ERRr r r r r r* X s r* c @ s e Zd ZeZdS )�NoDataAllowedErrN)r r r �NO_DATA_ALLOWED_ERRr r r r r r, [ s r, c @ s e Zd ZeZdS )�NoModificationAllowedErrN)r r r �NO_MODIFICATION_ALLOWED_ERRr r r r r r. ^ s r. c @ s e Zd ZeZdS )� NotFoundErrN)r r r �
NOT_FOUND_ERRr r r r r r0 a s r0 c @ s e Zd ZeZdS )�NotSupportedErrN)r r r �NOT_SUPPORTED_ERRr r r r r r2 d s r2 c @ s e Zd ZeZdS )�InuseAttributeErrN)r r r �INUSE_ATTRIBUTE_ERRr r r r r r4 g s r4 c @ s e Zd ZeZdS )�InvalidStateErrN)r r r �INVALID_STATE_ERRr r r r r r6 j s r6 c @ s e Zd ZeZdS )� SyntaxErrN)r r r �
SYNTAX_ERRr r r r r r8 m s r8 c @ s e Zd ZeZdS )�InvalidModificationErrN)r r r �INVALID_MODIFICATION_ERRr r r r r r: p s r: c @ s e Zd ZeZdS )� NamespaceErrN)r r r �
NAMESPACE_ERRr r r r r r< s s r< c @ s e Zd ZeZdS )�InvalidAccessErrN)r r r �INVALID_ACCESS_ERRr r r r r r> v s r> c @ s e Zd ZeZdS )�
ValidationErrN)r r r �VALIDATION_ERRr r r r r r@ y s r@ c @ s e Zd ZdZdZdZdZdS )�UserDataHandlerr r r r N)r r r Z NODE_CLONEDZ
NODE_IMPORTEDZ NODE_DELETEDZ NODE_RENAMEDr r r r rB | s rB z$http://www.w3.org/XML/1998/namespacez http://www.w3.org/2000/xmlns/z http://www.w3.org/1999/xhtmlN)�getDOMImplementation�registerDOMImplementation),r r# r% r' r) r+ r- r/ r1 r3 r5 r7 r9 r; r= r? rA r r r" r$ r& r( r* r, r. r0 r2 r4 r6 r8 r: r< r> r@ rB Z
XML_NAMESPACEZXMLNS_NAMESPACEZXHTML_NAMESPACEZEMPTY_NAMESPACEZ EMPTY_PREFIXZdomregrC rD r r r r �<module> sP
U
e5d'
� @ sJ d Z ddddgZddlZefZG dd� de�ZG dd� de�Z d d� Z
dS )
z�Python version compatibility support for minidom.
This module contains internal implementation details and
should not be imported; use xml.dom.minidom instead.
�NodeList�
EmptyNodeList� StringTypes� defproperty� Nc @ s> e Zd ZdZdd� Zdd� Zdd� Zeeedd �Zd
d � Z d S )
r � c C s( d| krt | �k r$n n| | S d S �Nr ��len��self�indexr r �*/usr/lib64/python3.8/xml/dom/minicompat.py�item5 s z
NodeList.itemc C s t | �S �Nr �r r r r
� _get_length9 s zNodeList._get_lengthc C s t j�d��d S �Nz.attempt to modify read-only attribute 'length'��xml�dom�NoModificationAllowedErr�r �valuer r r
� _set_length< s �zNodeList._set_length�$The number of nodes in the NodeList.��docc C s |d kr g }|| d d �< d S r r )r �stater r r
� __setstate__D s zNodeList.__setstate__N)
�__name__�
__module__� __qualname__� __slots__r r r �property�lengthr r r r r
r 2 s �c @ sF e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Ze eed d
�Z
dS )r r c C s t � }|�|� |S r �r �extend�r �other�NLr r r
�__add__M s
zEmptyNodeList.__add__c C s t � }|�|� |S r r% r' r r r
�__radd__R s
zEmptyNodeList.__radd__c C s d S r r r
r r r
r W s zEmptyNodeList.itemc C s dS r r r r r r
r Z s zEmptyNodeList._get_lengthc C s t j�d��d S r r r r r r
r ] s �zEmptyNodeList._set_lengthr r N) r r r! r" r* r+ r r r r# r$ r r r r
r J s �c C s8 t | d| �}|fdd�}t|||d�}t| ||� d S )NZ_get_c S s t j�dt|� ��d S )Nz&attempt to modify read-only attribute )r r r �repr)r r �namer r r
�setg s
�zdefproperty.<locals>.setr )�getattrr# �setattr)�klassr- r �getr. Zpropr r r
r e s ) �__doc__�__all__Zxml.domr �strr �listr �tupler r r r r r
�<module> s * U
e5ds0 � @ s� d Z ddlZddlZddlZddlmZ dddgZG dd� d�ZG d d� d�Z d
d � Z
G d d� de �Z G d
d� de �Z
G dd� d�Z[G dd� d�ZG dd� d�ZdS )z4Implementation of the DOM Level 3 'LS-Load' feature.� N)�
NodeFilter�
DOMBuilder�DOMEntityResolver�DOMInputSourcec @ s\ e Zd ZdZdZdZdZdZdZdZ dZ
dZ dZ dZ
dZdZdZdZdZdZdZdZdZdS )�Optionsz�Features object that has variables set for each DOMBuilder feature.
The DOMBuilder class uses an instance of this class to pass settings to
the ExpatBuilder class.
� TFN)�__name__�
__module__� __qualname__�__doc__�
namespaces�namespace_declarations�
validation�external_parameter_entities�external_general_entitiesZexternal_dtd_subset�validate_if_schemaZvalidate�datatype_normalization�create_entity_ref_nodes�entities� whitespace_in_element_content�cdata_sections�comments� charset_overrides_xml_encoding�infoset�supported_mediatypes_only� errorHandler�filter� r r �*/usr/lib64/python3.8/xml/dom/xmlbuilder.pyr
s( r c @ s& e Zd ZdZdZdZdZdZdZdZ eeee fZ
dd� Z dd � Z d
d � Z
d d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdgdgd gd gd gd gd gd!gd"gd#gd"d$gd%gd&gd'gd(gd)gd*gd+gd,gd-gg dd!d"d$d(d.d'd+d-g d/gd0gd1gd2�Zd3d4� Zd5d6� Zd7d8� Zd9d:� Zd;d<� ZdS )=r Nr � � � c C s t � | _d S �N)r �_options��selfr r r �__init__: s zDOMBuilder.__init__c C s | j S r" ��entityResolverr$ r r r �_get_entityResolver= s z DOMBuilder._get_entityResolverc C s
|| _ d S r" r' )r% r( r r r �_set_entityResolver? s z DOMBuilder._set_entityResolverc C s | j S r" �r r$ r r r �_get_errorHandlerB s z DOMBuilder._get_errorHandlerc C s
|| _ d S r" r+ )r% r r r r �_set_errorHandlerD s z DOMBuilder._set_errorHandlerc C s | j S r" �r r$ r r r � _get_filterG s zDOMBuilder._get_filterc C s
|| _ d S r" r. )r% r r r r � _set_filterI s zDOMBuilder._set_filterc C s� | � |�rt|rdpd}z| jt|�|f }W n( tk
rT tj�d|f �d �Y q�X |D ]\}}t| j||� qZntj� dt
|� ��d S )Nr r zunsupported feature: %rzunknown feature: ) �supportsFeature� _settings� _name_xform�KeyError�xml�dom�NotSupportedErr�setattrr# � NotFoundErr�repr)r% �name�stateZsettings�valuer r r �
setFeatureL s
�� zDOMBuilder.setFeaturec C s t | jt|��S r" )�hasattrr# r3 )r% r; r r r r1 Z s zDOMBuilder.supportsFeaturec C s t |�|rdpdf}|| jkS )Nr r )r3 r2 )r% r; r< �keyr r r �
canSetFeature] s zDOMBuilder.canSetFeature�r
r �r
r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r )r r �r r �r r �r r )rB rC rD rE rF rG rH rI rJ rK rL rM rN rO rP rQ rR rS rT rU )r r )r r rV rW rX c C s� t |�}zt| j|�W S tk
r� |dkrp| j}|joj|joj|joj|joj|jph|j ph|j
ph|j ph|j Y S t
j�dt|� ��Y nX d S )Nr zfeature %s not known)r3 �getattrr# �AttributeErrorr r r r r
r r r r r5 r6 r9 r: )r% r; Zxname�optionsr r r �
getFeature� s0 �������� zDOMBuilder.getFeaturec C s. | j r| j �d |�}nt� �d |�}| �|�S r" )r( �
resolveEntityr �parse)r% �uri�inputr r r �parseURI� s zDOMBuilder.parseURIc C sR t � | j�}| j|_| j|_|j}|d krF|jrFdd l}|j�|j�}| � ||�S �Nr )
�copyr# r r �
byteStream�systemId�urllib.request�requestZurlopen�_parse_bytestream)r% r` r[ �fp�urllibr r r r^ � s zDOMBuilder.parsec C s || j krtd��td��d S )Nznot a legal actionzHaven't written this yet...)�_legal_actions�
ValueError�NotImplementedError)r% r` Zcnode�actionr r r �parseWithContext� s
zDOMBuilder.parseWithContextc C s dd l }|jj�|�}|�|�S rb )Zxml.dom.expatbuilderr6 Z expatbuilderZ makeBuilderZ parseFile)r% �streamr[ r5 Zbuilderr r r rh � s z DOMBuilder._parse_bytestream)r r r
r( r r ZACTION_REPLACEZACTION_APPEND_AS_CHILDRENZACTION_INSERT_AFTERZACTION_INSERT_BEFORErk r& r) r* r, r- r/ r0 r> r1 rA r2 r\ ra r^ ro rh r r r r r - s� � ��������������������� ����=
c C s | � � �dd�S )N�-�_)�lower�replace)r; r r r r3 � s r3 c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r )�_openerc
C s� t � }||_||_| �� �|�|_| �|�|_dd l}dd l }|j
� |�}|\}}} }
} } | r�| � d�s�|�
| �d } ||| |
| | f}|j
�|�|_|S )Nr �/)r �publicIdre � _get_opener�openrd �_guess_media_encoding�encoding� posixpathZ urllib.parser^ Zurlparse�endswith�dirnameZ
urlunparse�baseURI)
r% rw re �sourcer| rj �partsZschemeZnetloc�pathZparamsZqueryZfragmentr r r r] � s z DOMEntityResolver.resolveEntityc C s2 z| j W S tk
r, | �� | _ | j Y S X d S r" )ru rZ �_create_openerr$ r r r rx � s
z DOMEntityResolver._get_openerc C s dd l }|j�� S rb )rf rg Z build_opener)r% rj r r r r� � s z DOMEntityResolver._create_openerc C sF |j �� }d|krB|�� D ]&}|�d�r|�dd�d �� S qd S )Nz Content-Typezcharset=�=r )rd �infoZgetplist�
startswith�splitrs )r% r� r� Zparamr r r rz � s
z'DOMEntityResolver._guess_media_encodingN)r r r
� __slots__r] rx r� rz r r r r r � s
c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd d � Zd d � Zd S )!r �rd �characterStream�
stringDatar{ rw re r c C s. d | _ d | _d | _d | _d | _d | _d | _d S r" r� r$ r r r r& s zDOMInputSource.__init__c C s | j S r" �rd r$ r r r �_get_byteStream s z DOMInputSource._get_byteStreamc C s
|| _ d S r" r� )r% rd r r r �_set_byteStream s z DOMInputSource._set_byteStreamc C s | j S r" �r� r$ r r r �_get_characterStream s z#DOMInputSource._get_characterStreamc C s
|| _ d S r" r� )r% r� r r r �_set_characterStream s z#DOMInputSource._set_characterStreamc C s | j S r" �r� r$ r r r �_get_stringData s z DOMInputSource._get_stringDatac C s
|| _ d S r" r� )r% �datar r r �_set_stringData s z DOMInputSource._set_stringDatac C s | j S r" �r{ r$ r r r �
_get_encoding s z DOMInputSource._get_encodingc C s
|| _ d S r" r� )r% r{ r r r �
_set_encoding s z DOMInputSource._set_encodingc C s | j S r" �rw r$ r r r �
_get_publicId" s z DOMInputSource._get_publicIdc C s
|| _ d S r" r� )r% rw r r r �
_set_publicId$ s z DOMInputSource._set_publicIdc C s | j S r" �re r$ r r r �
_get_systemId' s z DOMInputSource._get_systemIdc C s
|| _ d S r" r� )r% re r r r �
_set_systemId) s z DOMInputSource._set_systemIdc C s | j S r" �r r$ r r r � _get_baseURI, s zDOMInputSource._get_baseURIc C s
|| _ d S r" r� �r% r_ r r r � _set_baseURI. s zDOMInputSource._set_baseURIN)r r r
r� r& r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r s c @ s> e Zd ZdZdZdZdZdZej Z
dd� Z dd � Z d
d � Z
d S )
�DOMBuilderFilterzSElement filter which can be used to tailor construction of
a DOM instance.
r r r r! c C s | j S r" )�
whatToShowr$ r r r �_get_whatToShowC s z DOMBuilderFilter._get_whatToShowc C s | j S r" ��
FILTER_ACCEPT�r% Zelementr r r �
acceptNodeF s zDOMBuilderFilter.acceptNodec C s | j S r" r� r� r r r �startContainerI s z DOMBuilderFilter.startContainerN)r r r
r r� Z
FILTER_REJECTZ FILTER_SKIPZFILTER_INTERRUPTr ZSHOW_ALLr� r� r� r� r r r r r� 2 s r� c @ sD e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dS )�
DocumentLSz=Mixin to create documents that conform to the load/save spec.Fc C s dS )NFr r$ r r r �
_get_asyncT s zDocumentLS._get_asyncc C s |rt j�d��d S )Nz.asynchronous document loading is not supported)r5 r6 r7 )r% �flagr r r �
_set_asyncW s �zDocumentLS._set_asyncc C s t d��d S )Nz'haven't figured out what this means yet�rm r$ r r r �abort\ s �zDocumentLS.abortc C s t d��d S �Nzhaven't written this yetr� r� r r r �loadb s zDocumentLS.loadc C s t d��d S r� r� )r% r� r r r �loadXMLe s zDocumentLS.loadXMLc C s* |d kr| }n|j | k r"tj�� �|�� S r" )Z
ownerDocumentr5 r6 ZWrongDocumentErrZtoxml)r% Zsnoder r r �saveXMLh s
zDocumentLS.saveXMLN) r r r
r Zasync_r� r� r� r� r� r� r r r r r� O s r� c @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S )
�DOMImplementationLSr r c C sF |d k rt j�d��|| jkr$t� S || jkr:t j�d��td��d S )Nz schemaType not yet supportedz'asynchronous builders are not supportedzunknown value for mode)r5 r6 r7 �MODE_SYNCHRONOUSr �MODE_ASYNCHRONOUSrl )r% �modeZ
schemaTyper r r �createDOMBuildert s �
�z$DOMImplementationLS.createDOMBuilderc C s t d��d S )Nz-the writer interface hasn't been written yet!r� r$ r r r �createDOMWriter s �z#DOMImplementationLS.createDOMWriterc C s t � S r" )r r$ r r r �createDOMInputSource� s z(DOMImplementationLS.createDOMInputSourceN)r r r
r� r� r� r� r� r r r r r� p s
r� )r rc �warningsZxml.domr5 Zxml.dom.NodeFilterr �__all__r r r3 �objectr r r� r� r� r r r r �<module> s
%,1!U
e5d{
� @ s@ d Z ddlZddd�Zi Zdd� Zdd � Zdd d �Zd
d� ZdS )z�Registration facilities for DOM. This module should not be used
directly. Instead, the functions getDOMImplementation and
registerDOMImplementation should be imported from xml.dom.� Nzxml.dom.minidomzxml.dom.DOMImplementation)ZminidomZ4DOMc C s |t | < dS )aI registerDOMImplementation(name, factory)
Register the factory function with the name. The factory function
should return an object which implements the DOMImplementation
interface. The factory function can either return the same object,
or a new one (e.g. if that implementation supports some
customization).N)�
registered)�name�factory� r �&/usr/lib64/python3.8/xml/dom/domreg.py�registerDOMImplementation s r c C s$ |D ]\}}| � ||�s dS qdS )zF_good_enough(dom, features) -> Return 1 if the dom offers the featuresr � )Z
hasFeature)�dom�features�f�vr r r � _good_enough s r
r c C s� ddl }d}t�| �}|r2t|i i dg�}|�� S | r@t| � S tjjsbd|j krbt|j d d�S t
|t �rtt |�}t�
� D ] }|� }t||�r|| S q|t�� D ]>}zt|d�}W n tk
r� Y q�Y nX t||�r�| S q�td��dS )aS getDOMImplementation(name = None, features = ()) -> DOM implementation.
Return a suitable DOM implementation. The name is either
well-known, the module name of a DOM implementation, or None. If
it is not None, imports the corresponding module and returns
DOMImplementation object if the import succeeds.
If name is not given, consider the available implementations to
find one with the required feature set. If no implementation can
be found, raise an ImportError. The features list must be a sequence
of (feature, version) pairs which are passed to hasFeature.r N�getDOMImplementationZ
PYTHON_DOM)r z$no suitable DOM implementation found)�os�well_known_implementations�get�
__import__r r �sys�flags�ignore_environment�environ�
isinstance�str�_parse_feature_string�valuesr
�keys� Exception� ImportError)r r
r Zcreator�modr r r r r ' s0
r c C s� g }| � � }d}t|�}||k r�|| }|d dkrBtd|f ��|d }d }||k rv|| }|d dkrv|d }|}|�||f� qt|�S )Nr �
0123456789zbad feature name: %rr )�split�len�
ValueError�append�tuple)�sr
�parts�iZlengthZfeature�versionr r r r r R s" r )Nr )�__doc__r r r r r
r r r r r r �<module> s �
+U
e5d�. � @ s� d dl Zd dlZdZdZdZdZdZdZdZ d Z
G d
d � d ej j �Z
G d d
� d
�ZG dd� d�ZG dd� de
�ZdZddd�Zddd�ZdS )� N�
START_ELEMENT� END_ELEMENT�COMMENT�START_DOCUMENT� END_DOCUMENT�PROCESSING_INSTRUCTION�IGNORABLE_WHITESPACE�
CHARACTERSc @ s� e Zd ZdZdZd$dd�Zdd� Zdd� Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� ZdS )%�PullDOMNc C sz ddl m} || _d d g| _| j| _g | _| jj| _z| jj| _W n t k
rV Y nX |dig| _
| j
d | _ g | _ d S )Nr )�
XML_NAMESPACE�xml���)
Zxml.domr �documentFactory�
firstEvent� lastEvent� elementStack�append�push�pop�AttributeError� _ns_contexts�_current_context�pending_events)�selfr r � r �'/usr/lib64/python3.8/xml/dom/pulldom.py�__init__ s
zPullDOM.__init__c C s | j d }| j d= |S �Nr
)r )r �resultr r r r ! s
z PullDOM.popc C s
|| _ d S �N)�_locator)r Zlocatorr r r �setDocumentLocator& s zPullDOM.setDocumentLocatorc C sH t | d�sg | _| j�|p d|f� | j�| j�� � |p<d | j|< d S )N� _xmlns_attrs�xmlns)�hasattrr" r r r �copy)r �prefix�urir r r �startPrefixMapping) s
zPullDOM.startPrefixMappingc C s | j �� | _d S r )r r r )r r& r r r �endPrefixMapping0 s zPullDOM.endPrefixMappingc C s� d}t | dd �}|d k r:|D ]\}}||j||f< q g | _|\}} |r�|d krn| j| }
|
rj|
d | }n| }| jr�| j�||�} q�| �||�} n | jr�| j�| �} n | �d | �} |�� D ]�\}}|\} }
| |k�r|
dkr�|
}nd|
}| j� | |�}| �
|� nX| �rF| j| }
|
�r(|
d |
}n|
}| j� | |�}| �
|� n| j� |
�}| � |� ||_
q�t| fd g| jd< | jd | _| �| � d S )Nz http://www.w3.org/2000/xmlns/r" �:r# zxmlns:� )�getattr�_attrsr" r �documentZcreateElementNS�
buildDocument�
createElement�itemsZcreateAttributeNSZsetAttributeNodeNS�createAttribute�setAttributeNode�valuer r r )r �name�tagName�attrsZ xmlns_uriZ xmlns_attrs�anamer4 r' Z localnamer& �nodeZa_uriZ a_localnameZqname�attrr r r �startElementNS3 sP
zPullDOM.startElementNSc C s& t | �� fd g| jd< | jd | _d S �Nr+ �r r r )r r5 r6 r r r � endElementNSl s zPullDOM.endElementNSc C sz | j r| j �|�}n | �d |�}|�� D ]$\}}| j �|�}||_|�|� q(t|fd g| jd< | jd | _| � |� d S r< )
r. r0 r/ r1 r2 r4 r3 r r r )r r5 r7 r9 r8 r4 r: r r r � startElementp s zPullDOM.startElementc C s& t | �� fd g| jd< | jd | _d S r< r= )r r5 r r r �
endElement s zPullDOM.endElementc C sN | j r2| j �|�}t|fd g| jd< | jd | _nt|fd g}| j�|� d S r< )r. �
createCommentr r r r )r �sr9 �eventr r r �comment� s zPullDOM.commentc C sR | j r4| j �||�}t|fd g| jd< | jd | _nt||fd g}| j�|� d S r< )r. �createProcessingInstructionr r r r )r �target�datar9 rC r r r �processingInstruction� s z PullDOM.processingInstructionc C s. | j �|�}t|fd g| jd< | jd | _d S r< )r. �createTextNoder r �r �charsr9 r r r �ignorableWhitespace� s zPullDOM.ignorableWhitespacec C s. | j �|�}t|fd g| jd< | jd | _d S r< )r. rI r r rJ r r r �
characters� s zPullDOM.charactersc C s$ | j d kr dd l}|jjjj| _ d S )Nr )r Zxml.dom.minidomZdomZminidomZDocument�implementation)r r r r r �
startDocument� s
zPullDOM.startDocumentc C s� | j �||d �}|| _t|fd g| jd< | jd | _| �|� | jD ]�}|d d tkr�|d \}}}| j�||�}t|f|d< nD|d d t kr�| j�
|d d �}t |f|d< nt d|d d ��|| jd< || _qDd | _|j S )Nr+ r zUnknown pending event )
r ZcreateDocumentr. r r r r r rE r rA �AssertionErrorZ
firstChild) r r' Ztagnamer9 �e�_rF rG �nr r r r/ � s$
zPullDOM.buildDocumentc C s t | jfd g| jd< | �� d S r< )r r. r r �r r r r � endDocument� s zPullDOM.endDocumentc C s
d | _ d S r )r. rT r r r �clear� s z
PullDOM.clear)N)�__name__�
__module__� __qualname__r r. r r r! r( r) r; r> r? r@ rD rH rL rM rO r/ rU rV r r r r r
s&
9 r
c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� ErrorHandlerc C s t |� d S r )�print�r Z exceptionr r r �warning� s zErrorHandler.warningc C s |�d S r r r\ r r r �error� s zErrorHandler.errorc C s |�d S r r r\ r r r �
fatalError� s zErrorHandler.fatalErrorN)rW rX rY r] r^ r_ r r r r rZ � s rZ c @ s\ e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )�DOMEventStreamc C s2 || _ || _|| _t| jd�s&| j| _| �� d S )N�feed)�stream�parser�bufsizer$ �_slurp�getEvent�reset)r rb rc rd r r r r � s zDOMEventStream.__init__c C s. t � | _| j�tjjjd� | j�| j� d S r< ) r
�pulldomrc Z
setFeaturer �saxZhandlerZfeature_namespacesZsetContentHandlerrT r r r rg � s zDOMEventStream.resetc C s0 dd l }|jdtdd� | �� }|r(|S t�d S )Nr z[DOMEventStream's __getitem__ method ignores 'pos' parameter. Use iterator protocol instead.� )�
stacklevel)�warnings�warn�DeprecationWarningrf �
IndexError)r �posrl �rcr r r � __getitem__� s �zDOMEventStream.__getitem__c C s | � � }|r|S t�d S r )rf �
StopIteration�r rq r r r �__next__� s zDOMEventStream.__next__c C s | S r r rT r r r �__iter__� s zDOMEventStream.__iter__c C sl | � � }|g}|rh|\}}||kr&d S |tkr<|d �|� |tkrP|�|� n|tkr^|d= | � � }qd S r )rf r � appendChildr r )r r9 rC �parents�tokenZcur_noder r r �
expandNode� s zDOMEventStream.expandNodec C s~ | j jd s| j j| j _| j jd sR| j�| j�}|sD| j�� d S | j�|� q| j jd d }| j jd d | j jd< |S �Nr+ r ) rh r r rb �readrd rc �closera )r �bufrq r r r rf s
zDOMEventStream.getEventc C s | j �| j� | j| _| �� S r )rc �parserb �_emitrf rT r r r re s zDOMEventStream._slurpc C s, | j jd d }| j jd d | j jd< |S r{ )rh r rt r r r r� s zDOMEventStream._emitc C s | j �� | ` d | _d | _d S r )rh rV rc rb rT r r r rV ! s
zDOMEventStream.clearN)
rW rX rY r rg rr ru rv rz rf re r� rV r r r r r` � s
r` c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �SAX2DOMc C s2 t �| |||� | jd }| jd }|�|� d S �Nr
���)r
r; r rw )r r5 r6 r7 �curNode�
parentNoder r r r; * s
zSAX2DOM.startElementNSc C s0 t �| ||� | jd }| jd }|�|� d S r� )r
r? r rw )r r5 r7 r� r� r r r r? 0 s
zSAX2DOM.startElementc C s4 t �| ||� | jd d }| jd }|�|� d S �Nr r+ r
)r
rH r r rw )r rF rG r9 r� r r r rH 6 s
z SAX2DOM.processingInstructionc C s2 t �| |� | jd d }| jd }|�|� d S r� )r
rL r r rw �r rK r9 r� r r r rL < s
zSAX2DOM.ignorableWhitespacec C s2 t �| |� | jd d }| jd }|�|� d S r� )r
rM r r rw r� r r r rM B s
zSAX2DOM.charactersN)rW rX rY r; r? rH rL rM r r r r r� ( s
r� i�? c C s@ |d kr t }t| t�r"t| d�}n| }|s4tj�� }t|||�S )N�rb)�default_bufsize�
isinstance�str�openr ri � make_parserr` )Zstream_or_stringrc rd rb r r r r K s
r c C s6 ddl m} t| �}|| �}|s*tj�� }t|||�S )Nr )�StringIO)�ior� �lenr ri r� r` )�stringrc r� rd r~ r r r � parseStringV s
r� )NN)N)Zxml.saxr Zxml.sax.handlerr r r r r r r r ri ZContentHandlerr
rZ r` r� r� r r� r r r r �<module> s" 8\!
U
e5d�� � @ s d Z ddlmZmZmZ ddlmZmZmZ ddlm Z ddl
m Z m Z ddl
mZ ejZejZejZejjZejjZejjZejjZe�� Ze�dd�e�dd �e�dd
�e�dd �e�dd �e�dd
�e�dd�e�dd�e�dd�d� ZG dd� de�Z dd� Z dd� Z G dd� d�Z eeefZ G dd� de�Z!G d d � d e�Z"G d d � d e"�Z#G d d!� d!e"�Z$d"Z%d#e% Z&G d$d%� d%e �Z'G d&d'� d'�Z(G d(d)� d)e(e �Z)G d*d+� d+e(e'�Z*G d,d-� d-e+�Z,G d.d/� d/e �Z-d;d1d2�Z.d<d3d4�Z/d=d5d6�Z0d>d7d8�Z1d9d:� Z2dS )?z�Facility to use the Expat parser to load a minidom instance
from a string or file.
This avoids all the overhead of SAX and pulldom to gain performance.
� )�
xmlbuilder�minidom�Node)�EMPTY_NAMESPACE� EMPTY_PREFIX�XMLNS_NAMESPACE)�expat)�
_append_child�_set_attribute_node)�
NodeFilterNZcdata� enumeration�entity�entities�idZidrefZidrefsZnmtokenZnmtokens) ZCDATA�ENUMZENTITYZENTITIES�IDZIDREFZIDREFSZNMTOKENZNMTOKENSc @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )� ElementInfo��
_attr_info�_model�tagNameNc C s || _ g | _|| _d S �N)r r r )�selfr �model� r �,/usr/lib64/python3.8/xml/dom/expatbuilder.py�__init__? s zElementInfo.__init__c C s | j | j| jfS r r �r r r r � __getstate__D s zElementInfo.__getstate__c C s |\| _ | _| _d S r r )r �stater r r � __setstate__G s zElementInfo.__setstate__c C sN | j D ]@}|d |kr|d }|d dkr6td S t|d S qtjS )N� ���r �(r )r �
_typeinfo_mapr �_no_type)r �aname�info�tr r r �getAttributeTypeJ s
z ElementInfo.getAttributeTypec C s t jS r )r r% )r Z namespaceURIZ localNamer r r �getAttributeTypeNST s z ElementInfo.getAttributeTypeNSc C s, | j r$| j d }|tjjtjjfkS dS d S �Nr F)r r r Z
XML_CTYPE_ANYZXML_CTYPE_MIXED)r �typer r r �isElementContentW s
�z ElementInfo.isElementContentc C s | j r| j d tjjkS dS d S r+ )r r r ZXML_CTYPE_EMPTYr r r r �isEmpty_ s zElementInfo.isEmptyc C s, | j D ] }|d |kr|d dk S qdS )Nr! r" r F)r )r r& r' r r r �isIde s
zElementInfo.isIdc C s | � ||f�S r )r/ )r ZeuriZenameZaurir& r r r �isIdNSk s zElementInfo.isIdNS)N)
�__name__�
__module__� __qualname__� __slots__r r r r) r* r- r. r/ r0 r r r r r < s
r c C s | � ||�S r )�_intern_setdefault)�builder�sr r r �_interno s r8 c C s� |� d�}| j}t|�dkrR|\}}}|||�}d||f }|||�}|||�}n4t|�dkrz|\}}t}|||� }}n td| ��|||�|||fS )N� � z%s:%s� z4Unsupported syntax: spaces in URIs not supported: %r)�splitr5 �lenr �
ValueError)r6 �name�parts�intern�uri� localname�prefix�qnamer r r �_parse_ns_namer s
rF c @ s� e Zd ZdZd;dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Zd3d4� Z d5d6� Z d7d8� Z d9d:� Z dS )<� ExpatBuilderzPDocument builder that uses Expat to build a ParsedXML.DOM document
instance.Nc C sP |d krt �� }|| _| jjd k r2t| jj�| _n d | _t| _d | _| � � d S r )
r ZOptions�_options�filter�FilterVisibilityController�_filterr �_finish_start_element�_parser�reset)r �optionsr r r r � s zExpatBuilder.__init__c C s t �� S )zCreate a new parser object.)r � ParserCreater r r r � createParser� s zExpatBuilder.createParserc C sF | j s@| �� | _ | j jj| _d| j _d| j _d| j _| �| j � | j S )z7Return the parser object, creating a new one if needed.T) rM rQ rA �
setdefaultr5 Z buffer_textZordered_attributesZspecified_attributes�installr r r r � getParser� s
zExpatBuilder.getParserc C s, t �tdd�| _| j| _| jj| _d| _dS )z6Free all data structures used during DOM construction.NF)�theDOMImplementationZcreateDocumentr �document�curNode�
_elem_info�_cdatar r r r rN � s �
zExpatBuilder.resetc C s� | j |_| j|_| j|_| j|_| jj r0| j
|_ | j |_
| jjrH| j|_| jjrj| j|_| j|_| j|_n| j|_| j|_| j|_ | j |_ | j |_ dS )z>Install the callbacks needed to build the DOM into the parser.N)!�start_doctype_decl_handler�StartDoctypeDeclHandler�first_element_handler�StartElementHandler�end_element_handler�EndElementHandler�
pi_handler� ProcessingInstructionHandlerrH r �entity_decl_handler�EntityDeclHandler�notation_decl_handler�NotationDeclHandler�comments�comment_handler�CommentHandlerZcdata_sections�start_cdata_section_handler�StartCdataSectionHandler�end_cdata_section_handler�EndCdataSectionHandler� character_data_handler_cdata�CharacterDataHandler�character_data_handler�external_entity_ref_handler�ExternalEntityRefHandler�xml_decl_handlerZXmlDeclHandler�element_decl_handlerZElementDeclHandler�attlist_decl_handlerZAttlistDeclHandler�r �parserr r r rS � s$
zExpatBuilder.installc C s� | � � }d}zH|�d�}|s qF|�|d� |r@| jjr@| �|� d}q|�dd� W n tk
rh Y nX | j}| �� d| _|S )zIParse a document from a file object, returning the document
node.Ti @ r F� N) rT �read�ParserV �documentElement�
_setup_subset� ParseEscaperN rM )r �filerv Z first_buffer�buffer�docr r r � parseFile� s"
zExpatBuilder.parseFilec C sP | � � }z|�|d� | �|� W n tk
r6 Y nX | j}| �� d| _|S )z<Parse a document from a string, returning the document node.TN)rT ry r{ r| rV rN rM )r �stringrv r r r r � parseString� s zExpatBuilder.parseStringc C s. | j jr*t� }|�|� |�� }|| j j_dS )z/Load the internal subset if there might be one.N)rV �doctype�InternalSubsetExtractorr� � getSubset�internalSubset)r r~ Z extractor�subsetr r r r{ � s
zExpatBuilder._setup_subsetc C s� | j j�|||�}| j |_t| j |� || j _| jrj| j�|�tkrjd | j _| j j d= d }d | j
_ d | j
_ |r�|d k r�g |j
_g |j_d | j
_d | j
_| j| j
_d S �N���)rV �implementationZcreateDocumentType�
ownerDocumentr r� rK �
acceptNode�
FILTER_REJECT�
childNodesrM rc re r �_seq� notationsrh ra �end_doctype_decl_handler�EndDoctypeDeclHandler)r Z doctypeName�systemId�publicId�has_internal_subsetr� r r r rZ � s* �
z'ExpatBuilder.start_doctype_decl_handlerc C s2 | j jr| j| j_| j| j_| js.| js.t | _
d S r ) rH rf rg rM rh r` ra rX rK r �_finish_end_elementr r r r r� s
z%ExpatBuilder.end_doctype_decl_handlerc C s@ | j �||�}t| j|� | jr<| j�|�tkr<| j�|� d S r )rV ZcreateProcessingInstructionr rW rK r� r� � removeChild)r �target�data�noder r r r` s zExpatBuilder.pi_handlerc C s� | j j}| jrH| jr4|d jtkr4|d �|� d S | j�|�}d| _nD|rv|d jt krv|d }|j
| }||_
d S t � � }||_
| j|_
t| j |� d S )Nr� T)rW r� rY �_cdata_continue�nodeType�CDATA_SECTION_NODEZ
appendDatarV ZcreateCDATASection� TEXT_NODEr� r �Textr� r )r r� r� r� �valuer r r rm s$ �
z)ExpatBuilder.character_data_handler_cdatac C s^ | j j}|r2|d jtkr2|d }|j| |_d S t�� }|j| |_| j|_t | j |� d S r� )
rW r� r� r� r� r r� rV r� r )r r� r� r� r r r ro & s z#ExpatBuilder.character_data_handlerc
C s� |rd S | j jsd S | j�||||�}|d k rF| j�|�} |j�| � | jjjj�|� | j r|| j �
|�t kr|| jjjjd= d S r� ) rH r rV Z_create_entityZcreateTextNoder� �appendr� r� rK r� r� )
r Z
entityNameZis_parameter_entityr� �baser� r� � notationNamer� �childr r r rb 1 s
� z ExpatBuilder.entity_decl_handlerc C sJ | j �|||�}| j jjj�|� | jrF| j�|�tkrF| j jjjd= d S r� ) rV Z_create_notationr� r� r� r� rK r� �
FILTER_ACCEPT)r r� r� r� r� r� r r r rd C s z"ExpatBuilder.notation_decl_handlerc C s> | j �|�}t| j|� | jr:| j�|�tkr:| j�|� d S r )rV Z
createCommentr rW rK r� r� r� )r r� r� r r r rg I s z ExpatBuilder.comment_handlerc C s d| _ d| _d S )NTF�rY r� r r r r ri O s z(ExpatBuilder.start_cdata_section_handlerc C s d| _ d| _d S )NFr� r r r r rk S s z&ExpatBuilder.end_cdata_section_handlerc C s dS �Nr! r )r �contextr� r� r� r r r rp W s z(ExpatBuilder.external_entity_ref_handlerc C s2 | j d kr| jst| _| j| �� _| �||� d S r )rK rX r r� �start_element_handlerrT r] )r r? �
attributesr r r r\ Z s z"ExpatBuilder.first_element_handlerc C s� | j �|�}t| j|� || _|rptdt|�d�D ]<}t�|| td t �}||d }||_
| j |_ t ||� q2|| j j
k r�| �|� d S )Nr r; r! )rV Z
createElementr rW �ranger= r �Attrr r r� r� r
rz rL )r r? r� r� �i�ar� r r r r� ` s � z"ExpatBuilder.start_element_handlerc C sj | j rf|| jjkrd S | j �|�}|tkr4t| � n|tkrFt| � nd S |j| _ |j�
|� |� � d S r ) rK rV rz �startContainerr� �Rejecter� FILTER_SKIP�Skipper�
parentNoderW r� �unlink)r r� Zfiltr r r rL q s
z"ExpatBuilder._finish_start_elementc C s | j }|j| _ | �|� d S r )rW r� r� )r r? rW r r r r^ � s z ExpatBuilder.end_element_handlerc C s\ | j �|j�}|r | �||� | jrX|| jjkr4d S | j�|�tkrX| j �
|� |� � d S r ) rX �getr �_handle_white_text_nodesrK rV rz r� r� rW r� r� )r rW r' r r r r� � s z ExpatBuilder._finish_end_elementc C sZ | j js|�� sd S g }|jD ]"}|jtkr |j�� s |�|� q |D ]}|� |� qFd S r )
rH Z whitespace_in_element_contentr- r� r� r� r� �stripr� r� )r r� r' �Lr� r r r r� � s �
z%ExpatBuilder._handle_white_text_nodesc C s0 | j �|�}|d kr&t||�| j |< n||_d S r )rX r� r r )r r? r r' r r r rs � s z!ExpatBuilder.element_decl_handlerc
C sF | j �|�}|d kr&t|�}|| j |< |j�d |d d |d||g� d S �Nr )rX r� r r r� )r �elemr? r, �defaultZrequiredr' r r r rt � s
�z!ExpatBuilder.attlist_decl_handlerc C s2 || j _|| j _|dkr.|r&d| j _nd| j _d S )Nr TF)rV �version�encoding�
standalone)r r� r� r� r r r rr � s
z ExpatBuilder.xml_decl_handler)N) r1 r2 r3 �__doc__r rQ rT rN rS r� r� r{ rZ r� r` rm ro rb rd rg ri rk rp r\ r� rL r^ r� r� rs rt rr r r r r rG � s:
rG c @ s� e Zd ZdZdZdd� Zdd� Zdd� Zej e
j ej e
j
eje
jeje
jeje
jeje
jeje
jeje
jeje
jej e
j ej e
j ej e
j!i Z"d S )
rJ zoWrapper around a DOMBuilderFilter which implements the checks
to make the whatToShow filter attribute work.�rI c C s
|| _ d S r r� )r rI r r r r � s z#FilterVisibilityController.__init__c C sT | j |j }| jj|@ rL| j�|�}|tkr0t�|tkrHtdt |� ��|S t
S d S )Nz)startContainer() returned illegal value: ) �_nodetype_maskr� rI �
whatToShowr� �FILTER_INTERRUPTr| �_ALLOWED_FILTER_RETURNSr> �reprr� )r r� �mask�valr r r r� � s
�z)FilterVisibilityController.startContainerc C s� | j |j }| jj|@ r|| j�|�}|tkr0t�|tkr`|j}|j d d � D ]}|�
|� qLt S |t krxt
dt|� ��|S tS d S )Nz%acceptNode() returned illegal value: )r� r� rI r� r� r� r| r� r� r� Z appendChildr� r� r> r� r� )r r� r� r� �parentr� r r r r� � s
�z%FilterVisibilityController.acceptNodeN)#r1 r2 r3 r� r4 r r� r� r Z ELEMENT_NODEr Z SHOW_ELEMENTZATTRIBUTE_NODEZSHOW_ATTRIBUTEr� Z SHOW_TEXTr� ZSHOW_CDATA_SECTIONZENTITY_REFERENCE_NODEZSHOW_ENTITY_REFERENCEZ ENTITY_NODEZ SHOW_ENTITYZPROCESSING_INSTRUCTION_NODEZSHOW_PROCESSING_INSTRUCTIONZ COMMENT_NODEZ SHOW_COMMENT�
DOCUMENT_NODEZ
SHOW_DOCUMENTZDOCUMENT_TYPE_NODEZSHOW_DOCUMENT_TYPEZDOCUMENT_FRAGMENT_NODEZSHOW_DOCUMENT_FRAGMENTZ
NOTATION_NODEZ
SHOW_NOTATIONr� r r r r rJ � s<
�rJ c @ s e Zd ZdZdd� ZdS )� FilterCrutch)�_builder�_level�
_old_start�_old_endc C s6 d| _ || _|j}|j| _|j| _| j|_| j|_d S r� ) r� r� rM r] r� r_ r� r� r^ )r r6 rv r r r r s zFilterCrutch.__init__N)r1 r2 r3 r4 r r r r r r� s r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r� r c C s, t �| |� |j}dD ]}t||d � qd S )N)ra rh rn rj rl rq )r� r rM �setattr)r r6 rv r? r r r r s zRejecter.__init__c G s | j d | _ d S r� )r� �r �argsr r r r� s z Rejecter.start_element_handlerc G s@ | j dkr0| jj}| j�|� | j|_| j|_n | j d | _ d S �Nr r! )r� r� rM rS r� r] r� r_ )r r� rv r r r r^ s
z Rejecter.end_element_handlerN)r1 r2 r3 r4 r r� r^ r r r r r� s r� c @ s e Zd ZdZdd� Zdd� ZdS )r� r c G s. | j j}| j|� | j j|k r*| jd | _d S r� )r� rW r� r� )r r� r� r r r r� - s
z Skipper.start_element_handlerc G sD | j dkr*| j| jj_| j| jj_d | _n| j d | _ | j|� d S r� )r� r� r� rM r] r� r_ r� r r r r^ 3 s
zSkipper.end_element_handlerN)r1 r2 r3 r4 r� r^ r r r r r� * s r� z8http://xml.python.org/entities/fragment-builder/internalz�<!DOCTYPE wrapper
%%s [
<!ENTITY fragment-builder-internal
SYSTEM "%s">
%%s
]>
<wrapper %%s
>&fragment-builder-internal;</wrapper>c @ sJ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dS )�FragmentBuilderz�Builder which constructs document fragments given XML source
text and a context node.
The context node is expected to provide information about the
namespace declarations which are in scope at the start of the
fragment.
Nc C s6 |j tkr|| _|| _n|j| _|| _t�| |� d S r )r� r� �originalDocumentr� r� rG r )r r� rO r r r r [ s
zFragmentBuilder.__init__c C s t �| � d | _d S r )rG rN �fragmentr r r r rN d s
zFragmentBuilder.resetc C s | � |�� �S )zRParse a document fragment from a file object, returning the
fragment node.)r� rx �r r} r r r r� h s zFragmentBuilder.parseFilec C s� || _ | �� }| jj}d}|rV|jp*| �� }|jrDd|j|jf }qZ|jrZd|j }nd}| �� }t |||f }z|�
|d� W n | � � � Y nX | j }| � � |S )zMParse a document fragment from a string, returning the
fragment node.rw zPUBLIC "%s" "%s"z SYSTEM "%s"r! )
�_sourcerT r� r� r� �_getDeclarationsr� r� � _getNSattrs�_FRAGMENT_BUILDER_TEMPLATEry rN r� ) r r� rv r� Zidentr� ZnsattrsrV r� r r r r� m s.
� zFragmentBuilder.parseStringc C s | j jj}d}|�rt|jj�D ]R}|j�|�}|r<|d }d||jf }|jrdd||j|j f }q d||j f }q t|j
j�D ]�}|j
�|�}|r�|d }d||jf }|jr�d||j|j f }n&|j r�d||j f }nd ||j j f }|j
r�d
||j
f }|d }q�|S ) z�Re-create the internal subset from the DocumentType node.
This is only needed if we don't already have the
internalSubset as a string.
rw z
z%s<!NOTATION %sz!%s PUBLIC "%s"
"%s">z%s SYSTEM "%s">z
%s<!ENTITY %sz %s PUBLIC "%s"
"%s"z%s SYSTEM "%s"z%s "%s"z%s NOTATION %s�>)r� r� r� r� r� Zlength�itemZnodeNamer� r� r Z
firstChildr� r� )r r� r7 r� Znotationr
r r r r� � s:
� �
z FragmentBuilder._getDeclarationsc C s dS )Nrw r r r r r r� � s zFragmentBuilder._getNSattrsc C s~ |t krh| j}| j}| j�|�}| j| _| j�� | _| j| _z|� | jd� W 5 || _|| _d | _X dS t
� | ||||�S d S )Nr! r� ) �$_FRAGMENT_BUILDER_INTERNAL_SYSTEM_IDrV rW rM ZExternalEntityParserCreater� ZcreateDocumentFragmentr� r� ry rG rp )r r� r� r� r� Z old_documentZ old_cur_noderv r r r rp � s( �z+FragmentBuilder.external_entity_ref_handler)N) r1 r2 r3 r� r rN r� r� r� r� rp r r r r r� R s
$r� c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�
Namespacesz7Mix-in class for builders; adds support for namespaces.c C s
g | _ d S r )�_ns_ordered_prefixesr r r r �_initNamespaces� s zNamespaces._initNamespacesc C s t jdd�}d|_|S )z'Create a new namespace-handling parser.r9 )Znamespace_separatorT)r rP Znamespace_prefixesru r r r rQ � s zNamespaces.createParserc C s t �| |� | jjr | j|_dS )z.Insert the namespace-handlers onto the parser.N)rG rS rH Znamespace_declarations� start_namespace_decl_handlerZStartNamespaceDeclHandlerru r r r rS � s �zNamespaces.installc C s | j �||f� dS )z/Push this namespace declaration on our storage.N)r� r� )r rD rB r r r r� � s z'Namespaces.start_namespace_decl_handlerc C s� d|kr t | |�\}}}}nt}|}d }t}t�||||�}| j|_t| j|� || _| j r�| j D ]P\}}|r�t�
t | d| �t |d�}nt�
dt dt�}||_
| j|_t||� qb| j d d �= |�r~|�� |j} |j}
tdt|�d�D ]�} || } || d }
d| k�rDt | | �\}}}}t�
||||�}|| |< ||
||f< n$t�
| t| t�}|| | < ||
t| f< | j|_|
|_
||_q�d S )Nr9 �xmlns:�xmlnsr r; r! )rF r r r ZElementrV r� r rW r� r� r8 r r� r
Z_ensure_attributes�_attrs�_attrsNSr� r= Z ownerElement)r r? r� rB rC rD rE r� r� r� r� r� r& r� r r r r� � s^ � �
� z Namespaces.start_element_handlerN)
r1 r2 r3 r� r� rQ rS r� r� r^ r r r r r� � s 5r� c @ s e Zd ZdZdd� ZdS )�ExpatBuilderNSz*Document builder that supports namespaces.c C s t �| � | �� d S r )rG rN r� r r r r rN ) s
zExpatBuilderNS.resetN)r1 r2 r3 r� rN r r r r r� & s r� c @ s e Zd ZdZdd� Zdd� ZdS )�FragmentBuilderNSz*Fragment builder that supports namespaces.c C s t �| � | �� d S r )r� rN r� r r r r rN 1 s
zFragmentBuilderNS.resetc C s� d}| j }g }|r~t|d�rv|j�� D ]N\}}||kr8q&|�|� |rPd| }nd}|rhd|||f }q&d||f }q&|j}q|S )zNReturn string of namespace attributes from this element and
ancestors.rw �_ns_prefix_urir� r� z%s
%s='%s'z %s='%s')r� �hasattrr� �itemsr� r� )r �attrsr� r� rD rB Zdeclnamer r r r� 5 s"
z FragmentBuilderNS._getNSattrsN)r1 r2 r3 r� rN r� r r r r r� . s r� c @ s e Zd ZdZdS )r| zEException raised to short-circuit parsing in InternalSubsetExtractor.N)r1 r2 r3 r� r r r r r| S s r| c @ sL e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dS )r� zBXML processor which can rip out the internal document type subset.Nc C s | j S )z'Return the internal subset as a string.)r� r r r r r� \ s z!InternalSubsetExtractor.getSubsetc C s* zt �| |� W n tk
r$ Y nX d S r )rG r� r| r� r r r r� ` s z!InternalSubsetExtractor.parseFilec C s* zt �| |� W n tk
r$ Y nX d S r )rG r� r| )r r� r r r r� f s z#InternalSubsetExtractor.parseStringc C s | j |_| j|_d S r )rZ r[ r� r] ru r r r rS l s z InternalSubsetExtractor.installc C s0 |r&| � � }g | _| jj|_| j|_nt� �d S r )rT r� r� ZDefaultHandlerr� r� r| )r r? r� r� r� rv r r r rZ p s
z2InternalSubsetExtractor.start_doctype_decl_handlerc C s, d� | j��dd��dd�}|| _t� �d S )Nrw z
�
�
)�joinr� �replacer| )r r7 r r r r� z s z0InternalSubsetExtractor.end_doctype_decl_handlerc C s
t � �d S r )r| )r r? r� r r r r� s z-InternalSubsetExtractor.start_element_handler) r1 r2 r3 r� r� r� r� r� rS rZ r� r� r r r r r� W s
r� Tc C sL |r t � }nt� }t| t�r>t| d��}|�|�}W 5 Q R X n
|�| �}|S )z{Parse a document, returning the resulting Document node.
'file' may be either a file name or an open file object.
�rb)r� rG �
isinstance�str�openr� )r} �
namespacesr6 �fp�resultr r r �parse� s
r� c C s |r t � }nt� }|�| �S )zOParse a document from a string, returning the resulting
Document node.
)r� rG r� )r� r� r6 r r r r� � s r� c C sP |rt |�}nt|�}t| t�rBt| d��}|�|�}W 5 Q R X n
|�| �}|S )z�Parse a fragment of a document, given the context from which it
was originally extracted. context should be the parent of the
node(s) which are in the fragment.
'file' may be either a file name or an open file object.
r� )r� r� r� r� r� r� )r} r� r� r6 r� r� r r r �
parseFragment� s
r� c C s |rt |�}nt|�}|�| �S )z�Parse a fragment of a document from a string, given the context
from which it was originally extracted. context should be the
parent of the node(s) which are in the fragment.
)r� r� r� )r� r� r� r6 r r r �parseFragmentString� s
r� c C s | j rt| �S t| �S dS )z,Create a builder based on an Options object.N)r� r� rG )rO r r r � makeBuilder� s r� )T)T)T)T)3r� Zxml.domr r r r r r Z xml.parsersr Zxml.dom.minidomr r
Zxml.dom.NodeFilterr r� r� r� ZDOMBuilderFilterr� r� r� r� ZgetDOMImplementationrU ZTypeInfor$ �objectr r8 rF rG r� rJ r� r� r� r� r� r� r� r� r� � Exceptionr| r� r� r� r� r� r� r r r r �<module> sf
� 3 C
: � ��
u_%,
U
e5d� � @ s� d Z G dd� d�ZdZdZdZdZdZdZd Zd
Z d Z
d Z d
Z dZ
dZdZdZdZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e�ZG d d � d e�ZG d!d"� d"e�ZG d#d$� d$e�ZG d%d&� d&e�Z G d'd(� d(e�Z G d)d*� d*e�Z G d+d,� d,e�Z G d-d.� d.e�Z G d/d0� d0e�Z!G d1d2� d2e�Z"G d3d4� d4e�Z#G d5d6� d6�Z$d7Z%d8Z&d9Z'd:Z(d:Z)dd;l*m+Z+m,Z, d:S )<a
W3C Document Object Model implementation for Python.
The Python mapping of the Document Object Model is documented in the
Python Library Reference in the section on the xml.dom package.
This package contains the following modules:
minidom -- A simple implementation of the Level 1 DOM with namespace
support added (based on the Level 2 specification) and other
minor Level 2 functionality.
pulldom -- DOM builder supporting on-demand tree-building for selected
subtrees of the document.
c @ sD e Zd ZdZdZdZdZdZdZdZ dZ
d Z d
Z d Z
d Zd
ZdZdS )�Nodez$Class giving the NodeType constants.� � � � � � � � � � �
� � N)�__name__�
__module__� __qualname__�__doc__� __slots__Z ELEMENT_NODEZATTRIBUTE_NODEZ TEXT_NODEZCDATA_SECTION_NODEZENTITY_REFERENCE_NODEZ ENTITY_NODEZPROCESSING_INSTRUCTION_NODEZ COMMENT_NODEZ
DOCUMENT_NODEZDOCUMENT_TYPE_NODEZDOCUMENT_FRAGMENT_NODEZ
NOTATION_NODEr r r �(/usr/lib64/python3.8/xml/dom/__init__.pyr s r r r r r r r r r
r r r
r �
� � � c @ s e Zd ZdZdd� Zdd� ZdS )� DOMExceptionzmAbstract base class for DOM exceptions.
Exceptions with specific codes are specializations of this class.c O s( | j tkrtd��tj| f|�|� d S )Nz0DOMException should not be instantiated directly)� __class__r � RuntimeError� Exception�__init__)�self�args�kwr r r r B s
�zDOMException.__init__c C s | j S )N)�code)r r r r � _get_codeH s zDOMException._get_codeN)r r r r r r" r r r r r > s r c @ s e Zd ZeZdS )� IndexSizeErrN)r r r �INDEX_SIZE_ERRr! r r r r r# L s r# c @ s e Zd ZeZdS )�DomstringSizeErrN)r r r �DOMSTRING_SIZE_ERRr! r r r r r% O s r% c @ s e Zd ZeZdS )�HierarchyRequestErrN)r r r �HIERARCHY_REQUEST_ERRr! r r r r r' R s r' c @ s e Zd ZeZdS )�WrongDocumentErrN)r r r �WRONG_DOCUMENT_ERRr! r r r r r) U s r) c @ s e Zd ZeZdS )�InvalidCharacterErrN)r r r �INVALID_CHARACTER_ERRr! r r r r r+ X s r+ c @ s e Zd ZeZdS )�NoDataAllowedErrN)r r r �NO_DATA_ALLOWED_ERRr! r r r r r- [ s r- c @ s e Zd ZeZdS )�NoModificationAllowedErrN)r r r �NO_MODIFICATION_ALLOWED_ERRr! r r r r r/ ^ s r/ c @ s e Zd ZeZdS )� NotFoundErrN)r r r �
NOT_FOUND_ERRr! r r r r r1 a s r1 c @ s e Zd ZeZdS )�NotSupportedErrN)r r r �NOT_SUPPORTED_ERRr! r r r r r3 d s r3 c @ s e Zd ZeZdS )�InuseAttributeErrN)r r r �INUSE_ATTRIBUTE_ERRr! r r r r r5 g s r5 c @ s e Zd ZeZdS )�InvalidStateErrN)r r r �INVALID_STATE_ERRr! r r r r r7 j s r7 c @ s e Zd ZeZdS )� SyntaxErrN)r r r �
SYNTAX_ERRr! r r r r r9 m s r9 c @ s e Zd ZeZdS )�InvalidModificationErrN)r r r �INVALID_MODIFICATION_ERRr! r r r r r; p s r; c @ s e Zd ZeZdS )� NamespaceErrN)r r r �
NAMESPACE_ERRr! r r r r r= s s r= c @ s e Zd ZeZdS )�InvalidAccessErrN)r r r �INVALID_ACCESS_ERRr! r r r r r? v s r? c @ s e Zd ZeZdS )�
ValidationErrN)r r r �VALIDATION_ERRr! r r r r rA y s rA c @ s e Zd ZdZdZdZdZdZdS )�UserDataHandlerzBClass giving the operation constants for UserDataHandler.handle().r r r r N)r r r r Z NODE_CLONEDZ
NODE_IMPORTEDZ NODE_DELETEDZ NODE_RENAMEDr r r r rC | s
rC z$http://www.w3.org/XML/1998/namespacez http://www.w3.org/2000/xmlns/z http://www.w3.org/1999/xhtmlN)�getDOMImplementation�registerDOMImplementation)-r r r$ r& r( r* r, r. r0 r2 r4 r6 r8 r: r< r> r@ rB r r r# r% r' r) r+ r- r/ r1 r3 r5 r7 r9 r; r= r? rA rC Z
XML_NAMESPACEZXMLNS_NAMESPACEZXHTML_NAMESPACEZEMPTY_NAMESPACEZ EMPTY_PREFIXZdomregrD rE r r r r �<module> sR
U
e5d�. � @ s� d dl Zd dlZdZdZdZdZdZdZdZ d Z
G d
d � d ej j �Z
G d d
� d
�ZG dd� d�ZG dd� de
�ZdZddd�Zddd�ZdS )� N�
START_ELEMENT� END_ELEMENT�COMMENT�START_DOCUMENT� END_DOCUMENT�PROCESSING_INSTRUCTION�IGNORABLE_WHITESPACE�
CHARACTERSc @ s� e Zd ZdZdZd$dd�Zdd� Zdd� Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� ZdS )%�PullDOMNc C sz ddl m} || _d d g| _| j| _g | _| jj| _z| jj| _W n t k
rV Y nX |dig| _
| j
d | _ g | _ d S )Nr )�
XML_NAMESPACE�xml���)
Zxml.domr �documentFactory�
firstEvent� lastEvent� elementStack�append�push�pop�AttributeError� _ns_contexts�_current_context�pending_events)�selfr r � r �'/usr/lib64/python3.8/xml/dom/pulldom.py�__init__ s
zPullDOM.__init__c C s | j d }| j d= |S �Nr
)r )r �resultr r r r ! s
z PullDOM.popc C s
|| _ d S �N)�_locator)r Zlocatorr r r �setDocumentLocator& s zPullDOM.setDocumentLocatorc C sH t | d�sg | _| j�|p d|f� | j�| j�� � |p<d | j|< d S )N� _xmlns_attrs�xmlns)�hasattrr" r r r �copy)r �prefix�urir r r �startPrefixMapping) s
zPullDOM.startPrefixMappingc C s | j �� | _d S r )r r r )r r& r r r �endPrefixMapping0 s zPullDOM.endPrefixMappingc C s� d}t | dd �}|d k r:|D ]\}}||j||f< q g | _|\}} |r�|d krn| j| }
|
rj|
d | }n| }| jr�| j�||�} q�| �||�} n | jr�| j�| �} n | �d | �} |�� D ]�\}}|\} }
| |k�r|
dkr�|
}nd|
}| j� | |�}| �
|� nX| �rF| j| }
|
�r(|
d |
}n|
}| j� | |�}| �
|� n| j� |
�}| � |� ||_
q�t| fd g| jd< | jd | _| �| � d S )Nz http://www.w3.org/2000/xmlns/r" �:r# zxmlns:� )�getattr�_attrsr" r �documentZcreateElementNS�
buildDocument�
createElement�itemsZcreateAttributeNSZsetAttributeNodeNS�createAttribute�setAttributeNode�valuer r r )r �name�tagName�attrsZ xmlns_uriZ xmlns_attrs�anamer4 r' Z localnamer& �nodeZa_uriZ a_localnameZqname�attrr r r �startElementNS3 sP
zPullDOM.startElementNSc C s& t | �� fd g| jd< | jd | _d S �Nr+ �r r r )r r5 r6 r r r � endElementNSl s zPullDOM.endElementNSc C sz | j r| j �|�}n | �d |�}|�� D ]$\}}| j �|�}||_|�|� q(t|fd g| jd< | jd | _| � |� d S r< )
r. r0 r/ r1 r2 r4 r3 r r r )r r5 r7 r9 r8 r4 r: r r r � startElementp s zPullDOM.startElementc C s& t | �� fd g| jd< | jd | _d S r< r= )r r5 r r r �
endElement s zPullDOM.endElementc C sN | j r2| j �|�}t|fd g| jd< | jd | _nt|fd g}| j�|� d S r< )r. �
createCommentr r r r )r �sr9 �eventr r r �comment� s zPullDOM.commentc C sR | j r4| j �||�}t|fd g| jd< | jd | _nt||fd g}| j�|� d S r< )r. �createProcessingInstructionr r r r )r �target�datar9 rC r r r �processingInstruction� s z PullDOM.processingInstructionc C s. | j �|�}t|fd g| jd< | jd | _d S r< )r. �createTextNoder r �r �charsr9 r r r �ignorableWhitespace� s zPullDOM.ignorableWhitespacec C s. | j �|�}t|fd g| jd< | jd | _d S r< )r. rI r r rJ r r r �
characters� s zPullDOM.charactersc C s$ | j d kr dd l}|jjjj| _ d S )Nr )r Zxml.dom.minidomZdomZminidomZDocument�implementation)r r r r r �
startDocument� s
zPullDOM.startDocumentc C s� | j �||d �}|| _t|fd g| jd< | jd | _| �|� | jD ]�}|d d tkr�|d \}}}| j�||�}t|f|d< nD|d d t kr�| j�
|d d �}t |f|d< nt d|d d ��|| jd< || _qDd | _|j S )Nr+ r zUnknown pending event )
r ZcreateDocumentr. r r r r r rE r rA �AssertionErrorZ
firstChild) r r' Ztagnamer9 �e�_rF rG �nr r r r/ � s$
zPullDOM.buildDocumentc C s t | jfd g| jd< | �� d S r< )r r. r r �r r r r � endDocument� s zPullDOM.endDocumentc C s
d| _ dS )z.clear(): Explicitly release parsing structuresN)r. rT r r r �clear� s z
PullDOM.clear)N)�__name__�
__module__� __qualname__r r. r r r! r( r) r; r> r? r@ rD rH rL rM rO r/ rU rV r r r r r
s&
9 r
c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� ErrorHandlerc C s t |� d S r )�print�r Z exceptionr r r �warning� s zErrorHandler.warningc C s |�d S r r r\ r r r �error� s zErrorHandler.errorc C s |�d S r r r\ r r r �
fatalError� s zErrorHandler.fatalErrorN)rW rX rY r] r^ r_ r r r r rZ � s rZ c @ s\ e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )�DOMEventStreamc C s2 || _ || _|| _t| jd�s&| j| _| �� d S )N�feed)�stream�parser�bufsizer$ �_slurp�getEvent�reset)r rb rc rd r r r r � s zDOMEventStream.__init__c C s. t � | _| j�tjjjd� | j�| j� d S r< ) r
�pulldomrc Z
setFeaturer �saxZhandlerZfeature_namespacesZsetContentHandlerrT r r r rg � s zDOMEventStream.resetc C s0 dd l }|jdtdd� | �� }|r(|S t�d S )Nr z[DOMEventStream's __getitem__ method ignores 'pos' parameter. Use iterator protocol instead.� )�
stacklevel)�warnings�warn�DeprecationWarningrf �
IndexError)r �posrl �rcr r r � __getitem__� s �zDOMEventStream.__getitem__c C s | � � }|r|S t�d S r )rf �
StopIteration�r rq r r r �__next__� s zDOMEventStream.__next__c C s | S r r rT r r r �__iter__� s zDOMEventStream.__iter__c C sl | � � }|g}|rh|\}}||kr&d S |tkr<|d �|� |tkrP|�|� n|tkr^|d= | � � }qd S r )rf r � appendChildr r )r r9 rC �parents�tokenZcur_noder r r �
expandNode� s zDOMEventStream.expandNodec C s~ | j jd s| j j| j _| j jd sR| j�| j�}|sD| j�� d S | j�|� q| j jd d }| j jd d | j jd< |S )Nr+ r ) rh r r rb �readrd rc �closera )r �bufrq r r r rf s
zDOMEventStream.getEventc C s | j �| j� | j| _| �� S )z� Fallback replacement for getEvent() using the
standard SAX2 interface, which means we slurp the
SAX events into memory (no performance gain, but
we are compatible to all SAX parsers).
)rc �parserb �_emitrf rT r r r re s zDOMEventStream._slurpc C s, | j jd d }| j jd d | j jd< |S )zn Fallback replacement for getEvent() that emits
the events that _slurp() read previously.
r+ r )rh r rt r r r r s zDOMEventStream._emitc C s | j �� | ` d| _d| _dS )z+clear(): Explicitly release parsing objectsN)rh rV rc rb rT r r r rV ! s
zDOMEventStream.clearN)
rW rX rY r rg rr ru rv rz rf re r rV r r r r r` � s
r` c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �SAX2DOMc C s2 t �| |||� | jd }| jd }|�|� d S �Nr
���)r
r; r rw )r r5 r6 r7 �curNode�
parentNoder r r r; * s
zSAX2DOM.startElementNSc C s0 t �| ||� | jd }| jd }|�|� d S r� )r
r? r rw )r r5 r7 r� r� r r r r? 0 s
zSAX2DOM.startElementc C s4 t �| ||� | jd d }| jd }|�|� d S �Nr r+ r
)r
rH r r rw )r rF rG r9 r� r r r rH 6 s
z SAX2DOM.processingInstructionc C s2 t �| |� | jd d }| jd }|�|� d S r� )r
rL r r rw �r rK r9 r� r r r rL < s
zSAX2DOM.ignorableWhitespacec C s2 t �| |� | jd d }| jd }|�|� d S r� )r
rM r r rw r� r r r rM B s
zSAX2DOM.charactersN)rW rX rY r; r? rH rL rM r r r r r� ( s
r� i�? c C s@ |d kr t }t| t�r"t| d�}n| }|s4tj�� }t|||�S )N�rb)�default_bufsize�
isinstance�str�openr ri � make_parserr` )Zstream_or_stringrc rd rb r r r r~ K s
r~ c C s6 ddl m} t| �}|| �}|s*tj�� }t|||�S )Nr )�StringIO)�ior� �lenr ri r� r` )�stringrc r� rd r} r r r � parseStringV s
r� )NN)N)Zxml.saxr Zxml.sax.handlerr r r r r r r r ri ZContentHandlerr
rZ r` r� r� r~ r� r r r r �<module> s" 8\!
U
e5d� � @ s� d Z G dd� d�ZdZdZdZdZdZdZd Zd
Z d Z
d Z d
Z dZ
dZdZdZdZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e�ZG d d � d e�ZG d!d"� d"e�ZG d#d$� d$e�ZG d%d&� d&e�Z G d'd(� d(e�Z G d)d*� d*e�Z G d+d,� d,e�Z G d-d.� d.e�Z G d/d0� d0e�Z!G d1d2� d2e�Z"G d3d4� d4e�Z#G d5d6� d6�Z$d7Z%d8Z&d9Z'd:Z(d:Z)dd;l*m+Z+m,Z, d:S )<a
W3C Document Object Model implementation for Python.
The Python mapping of the Document Object Model is documented in the
Python Library Reference in the section on the xml.dom package.
This package contains the following modules:
minidom -- A simple implementation of the Level 1 DOM with namespace
support added (based on the Level 2 specification) and other
minor Level 2 functionality.
pulldom -- DOM builder supporting on-demand tree-building for selected
subtrees of the document.
c @ sD e Zd ZdZdZdZdZdZdZdZ dZ
d Z d
Z d Z
d Zd
ZdZdS )�Nodez$Class giving the NodeType constants.� � � � � � � � � � �
� � N)�__name__�
__module__� __qualname__�__doc__� __slots__Z ELEMENT_NODEZATTRIBUTE_NODEZ TEXT_NODEZCDATA_SECTION_NODEZENTITY_REFERENCE_NODEZ ENTITY_NODEZPROCESSING_INSTRUCTION_NODEZ COMMENT_NODEZ
DOCUMENT_NODEZDOCUMENT_TYPE_NODEZDOCUMENT_FRAGMENT_NODEZ
NOTATION_NODEr r r �(/usr/lib64/python3.8/xml/dom/__init__.pyr s r r r r r r r r r
r r r
r �
� � � c @ s e Zd ZdZdd� Zdd� ZdS )� DOMExceptionzmAbstract base class for DOM exceptions.
Exceptions with specific codes are specializations of this class.c O s( | j tkrtd��tj| f|�|� d S )Nz0DOMException should not be instantiated directly)� __class__r � RuntimeError� Exception�__init__)�self�args�kwr r r r B s
�zDOMException.__init__c C s | j S )N)�code)r r r r � _get_codeH s zDOMException._get_codeN)r r r r r r" r r r r r > s r c @ s e Zd ZeZdS )� IndexSizeErrN)r r r �INDEX_SIZE_ERRr! r r r r r# L s r# c @ s e Zd ZeZdS )�DomstringSizeErrN)r r r �DOMSTRING_SIZE_ERRr! r r r r r% O s r% c @ s e Zd ZeZdS )�HierarchyRequestErrN)r r r �HIERARCHY_REQUEST_ERRr! r r r r r' R s r' c @ s e Zd ZeZdS )�WrongDocumentErrN)r r r �WRONG_DOCUMENT_ERRr! r r r r r) U s r) c @ s e Zd ZeZdS )�InvalidCharacterErrN)r r r �INVALID_CHARACTER_ERRr! r r r r r+ X s r+ c @ s e Zd ZeZdS )�NoDataAllowedErrN)r r r �NO_DATA_ALLOWED_ERRr! r r r r r- [ s r- c @ s e Zd ZeZdS )�NoModificationAllowedErrN)r r r �NO_MODIFICATION_ALLOWED_ERRr! r r r r r/ ^ s r/ c @ s e Zd ZeZdS )� NotFoundErrN)r r r �
NOT_FOUND_ERRr! r r r r r1 a s r1 c @ s e Zd ZeZdS )�NotSupportedErrN)r r r �NOT_SUPPORTED_ERRr! r r r r r3 d s r3 c @ s e Zd ZeZdS )�InuseAttributeErrN)r r r �INUSE_ATTRIBUTE_ERRr! r r r r r5 g s r5 c @ s e Zd ZeZdS )�InvalidStateErrN)r r r �INVALID_STATE_ERRr! r r r r r7 j s r7 c @ s e Zd ZeZdS )� SyntaxErrN)r r r �
SYNTAX_ERRr! r r r r r9 m s r9 c @ s e Zd ZeZdS )�InvalidModificationErrN)r r r �INVALID_MODIFICATION_ERRr! r r r r r; p s r; c @ s e Zd ZeZdS )� NamespaceErrN)r r r �
NAMESPACE_ERRr! r r r r r= s s r= c @ s e Zd ZeZdS )�InvalidAccessErrN)r r r �INVALID_ACCESS_ERRr! r r r r r? v s r? c @ s e Zd ZeZdS )�
ValidationErrN)r r r �VALIDATION_ERRr! r r r r rA y s rA c @ s e Zd ZdZdZdZdZdZdS )�UserDataHandlerzBClass giving the operation constants for UserDataHandler.handle().r r r r N)r r r r Z NODE_CLONEDZ
NODE_IMPORTEDZ NODE_DELETEDZ NODE_RENAMEDr r r r rC | s
rC z$http://www.w3.org/XML/1998/namespacez http://www.w3.org/2000/xmlns/z http://www.w3.org/1999/xhtmlN)�getDOMImplementation�registerDOMImplementation)-r r r$ r& r( r* r, r. r0 r2 r4 r6 r8 r: r< r> r@ rB r r r# r% r' r) r+ r- r/ r1 r3 r5 r7 r9 r; r= r? rA rC Z
XML_NAMESPACEZXMLNS_NAMESPACEZXHTML_NAMESPACEZEMPTY_NAMESPACEZ EMPTY_PREFIXZdomregrD rE r r r r �<module> sR
U
e5d) � @ s� d Z ddlZddlZddlmZmZmZmZ ddlT ddl m
Z
m Z ej j
jej j
jfZG dd� dej j
�Z
ee
dd d
� ee
d d d
� ee
d
dd
� dd� Zdd� Zdd� Zdd� Zdd� ZG dd� de
�ZG dd � d e
�Zeed d d
� eed
d d
� eed d!d
� G d"d#� d#e�Zeed$d%d
� eZG d&d'� d'e�Z e dd�Z G d(d)� d)e
�Z ee d*d+d
� ee d
d,d
� d-d.� Z G d/d0� d0�Z G d1d2� d2e e
�Z!G d3d4� d4e e
�Z"ee"d$d5d
� G d6d7� d7e"�Z#ee#d8d9d
� ee#d:d;d
� d<d=� Z$d>d?� Z%G d@dA� dAe"�Z&G dBdC� dCe#�Z'G dDdE� dEe�Z(ee(d$dFd
� G dGdH� dH�Z)G dIdJ� dJe)e e
�Z*G dKdL� dLe)e
�Z+G dMdN� dNe)e e
�Z,G dOdP� dPe
�Z-G dQdR� dRe�Z.dSdT� Z/G dUdV� dVe
e �Z0ee0dWdXd
� dYdZ� Z1d[d\� Z2d]d^� Z3ded_d`�Z4dfdadb�Z5dgdcdd�Z6dS )hac Simple implementation of the Level 1 DOM.
Namespaces and other minor Level 2 features are also supported.
parse("foo.xml")
parseString("<foo><bar/></foo>")
Todo:
=====
* convenience methods for getting elements and text.
* more testing
* bring some of the writer and linearizer code into conformance with this
interface
* SAX 2 namespaces
� N)�EMPTY_NAMESPACE� EMPTY_PREFIX�XMLNS_NAMESPACE�domreg)�*)�DOMImplementationLS�
DocumentLSc @ s� e Zd ZdZdZdZdZdZeZ dd� Z
d2dd�Z d3dd �Z d
d � Z
d d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Z d*d+� Z d,d-� Z d.d/� Z d0d1� Z dS )4�NodeNc C s dS )NT� ��selfr
r
�'/usr/lib64/python3.8/xml/dom/minidom.py�__bool__+ s z
Node.__bool__c C s | � dd|�S �N� )� toprettyxml)r �encodingr
r
r
�toxml. s z
Node.toxml� �
c C sx |d krt �� }nt jt �� |ddd�}| jtjkrH| �|d|||� n| �|d||� |d krh|�� S |� � �� S d S )N�xmlcharrefreplacer )r �errors�newliner )
�io�StringIO�
TextIOWrapper�BytesIO�nodeTyper �
DOCUMENT_NODE�writexml�getvalue�detach)r �indent�newlr �writerr
r
r
r 1 s
� zNode.toprettyxmlc C s
t | j�S �N)�bool�
childNodesr r
r
r
�
hasChildNodesC s zNode.hasChildNodesc C s | j S r% �r' r r
r
r
�_get_childNodesF s zNode._get_childNodesc C s | j r| j d S d S �Nr r) r r
r
r
�_get_firstChildI s zNode._get_firstChildc C s | j r| j d S d S �N���r) r r
r
r
�_get_lastChildM s zNode._get_lastChildc C s
|j | jkr,t|j�D ]}| �||� q|S |j | jkrTtj�dt |�t | �f ��|j
d k rj|j
� |� |d kr~| � |� n�z| j�
|�}W n tk
r� tj�� �Y nX |j tkr�t| � | j�||� ||_||_|r�| j|d }||_||_nd |_| |_
|S )N�%s cannot be child of %s� )r �DOCUMENT_FRAGMENT_NODE�tupler' � insertBefore�_child_node_types�xml�dom�HierarchyRequestErr�repr�
parentNode� removeChild� appendChild�index�
ValueError� NotFoundErr�_nodeTypes_with_children�_clear_id_cache�insert� nextSibling�previousSibling)r �newChild�refChild�cr= �noder
r
r
r4 Q s8 �
zNode.insertBeforec C s� |j | jkr*t|j�D ]}| �|� q|S |j | jkrTtj�dt |�t | �f ��n|j t
krft | � |j d k r||j �
|� t| |� d |_|S �Nr0 )r r2 r3 r' r< r5 r6 r7 r8 r9 r@ rA r: r; �
_append_childrC )r rH rG r
r
r
r< q s �
zNode.appendChildc C s |j | jkr(|j}| �|� | �||�S |j | jkrPtj�dt |�t | �f ��||kr\d S |j
d k rr|j
�|� z| j � |�}W n t
k
r� tj�� �Y nX || j |< | |_
d |_
|j tks�|j tkr�t| � |j|_|j|_d |_d |_|jr�||j_|j�r||j_|S rI )r r2 rC r; r4 r5 r6 r7 r8 r9 r: r' r= r> r? r@ rA rD )r rE �oldChildrF r= r
r
r
� replaceChild� s@
�
�zNode.replaceChildc C s� z| j �|� W n tk
r. tj�� �Y nX |jd k rD|j|j_|jd k rX|j|j_d |_|_|jt krvt
| � d |_ |S r% ) r' �remover> r6 r7 r? rC rD r r@ rA r: �r rK r
r
r
r; � s
zNode.removeChildc C s� g }| j D ]�}|jtjkr�|jsJ|r0|j|d _|jr@|j|j_|�� q�|r�|d j|jkr�|d }|j|j |_|j|_|jr�||j_|�� q�|�|� q
|�|� |jtj kr
|�
� q
|| j d d �< d S r- ) r' r r � TEXT_NODE�datarC rD �unlink�append� ELEMENT_NODE� normalize)r �L�childrH r
r
r
rT � s*
zNode.normalizec C s t | || jp| �S r% )� _clone_node�
ownerDocument)r �deepr
r
r
� cloneNode� s zNode.cloneNodec C s | j j�||�S r% )rX �implementation�
hasFeature�r �feature�versionr
r
r
� isSupported� s zNode.isSupportedc C s d S r% r
r r
r
r
�_get_localName� s zNode._get_localNamec C s | |kS r% r
�r �otherr
r
r
�
isSameNode� s zNode.isSameNodec C s | � |d �r| S d S d S r% )r` �r r^ r
r
r
� getInterface� s zNode.getInterfacec C s0 z| j | d W S ttfk
r* Y d S X d S r+ )�
_user_data�AttributeError�KeyError�r �keyr
r
r
� getUserData� s zNode.getUserDatac C sn d }z
| j }W n tk
r, i }|| _ Y nX ||krB|| d }|d kr^d }|d k rj||= n ||f||< |S r+ )rg rh )r rk rP �handler�old�dr
r
r
� setUserData� s
zNode.setUserDatac C sD t | d�r@t| j�� �D ]&\}\}}|d k r|�|||||� qd S )Nrg )�hasattr�listrg �itemsZhandle)r � operation�srcZdstrk rP rm r
r
r
�_call_user_data_handler� s
z Node._call_user_data_handlerc C s> d | _ | _| jr.| jD ] }|�� qt� | _d | _d | _d S r% )r: rX r' rQ �NodeListrD rC )r rV r
r
r
rQ s
z Node.unlinkc C s | S r% r
r r
r
r
� __enter__ s zNode.__enter__c C s | � � d S r% )rQ )r ZetZev�tbr
r
r
�__exit__ s z
Node.__exit__)N)r r N)!�__name__�
__module__� __qualname__� namespaceURIr: rX rC rD r �prefixr r r r( r* r, r/ r4 r< rL r; rT rZ r` ra rd rf rl rp rv rQ rx rz r
r
r
r
r " s:
r �
firstChildzFirst child node, or None.)�doc� lastChildzLast child node, or None.� localNamez"Namespace-local name of this node.c C s2 | j }|r |d }||_||_|�|� | |_d S r- )r' rD rC rR r: )r rH r' Zlastr
r
r
rJ s
rJ c C s$ | d k r | j tjkrdS | j} q dS �NTF)r r r r: �rH r
r
r
� _in_document& s
r� c C s6 |r2|� dd�� dd�� dd�� dd�}| �|� d S )
zWrites datachars to writer.�&z&�<z<�"z"�>z>N)�replace�write)r$ rP r
r
r
� _write_data. s � �r� c C sD | j D ]8}|jtjkr2|dks(|j|kr2|�|� t|||� q|S �Nr )r' r r rS �tagNamerR � _get_elements_by_tagName_helper)�parent�name�rcrH r
r
r
r� 5 s
��
r� c C sX | j D ]L}|jtjkr|dks(|j|krD|dks:|j|krD|�|� t||||� q|S r� )r' r r rS r� r~ rR �"_get_elements_by_tagName_ns_helper)r� ZnsURIr� r� rH r
r
r
r� = s
��
r� c @ sJ e Zd ZejZdZdZdZdZ ej
ej ej ej
ejejejfZdd� ZdS )�DocumentFragmentz#document-fragmentNc C s t � | _d S r% )rw r' r r
r
r
�__init__T s zDocumentFragment.__init__)r{ r| r} r r2 r �nodeName� nodeValue�
attributesr: rS rO �CDATA_SECTION_NODE�ENTITY_REFERENCE_NODE�PROCESSING_INSTRUCTION_NODE� COMMENT_NODE�
NOTATION_NODEr5 r� r
r
r
r
r� F s �r� c @ s� e Zd ZdZejZdZdZdZ ej
ej fZ e
ddfdd�Zdd� Zdd � Zd
d � Zd d
� Zeee� ZZdd� Zdd� Zeee� ZZdd� Zdd� Zeee�Z dd� Z dd� Z dd� Z dS ) �Attr)�_name�_valuer~ �_prefixr' �
_localNamerX � ownerElementNFc C s2 d | _ || _|| _|| _t� | _| j�t� � d S r% )r� r� r~ r� rw r' rR �Text)r �qNamer~ r� r r
r
r
r� b s z
Attr.__init__c C s4 z| j W S tk
r. | j�dd�d Y S X d S �N�:r1 r. )r� rh r� �splitr r
r
r
ra o s zAttr._get_localNamec C s | j S r% )� specifiedr r
r
r
�_get_specifiedu s zAttr._get_specifiedc C s | j S r% )r� r r
r
r
� _get_namex s zAttr._get_namec C s || _ | jd k rt| j� d S r% )r� r� rA �r �valuer
r
r
� _set_name{ s
zAttr._set_namec C s | j S r% )r� r r
r
r
�
_get_value� s zAttr._get_valuec C s6 || _ || jd _| jd k r&t| j� || jd _d S r+ )r� r' rP r� rA r� r
r
r
�
_set_value� s
zAttr._set_valuec C s | j S r% )r� r r
r
r
� _get_prefix� s zAttr._get_prefixc C sd | j }|dkr&|r&|tkr&tj�d��|| _|d kr<| j}nd|| jf }| jrZt| j� || _ d S )N�xmlnsz5illegal use of 'xmlns' prefix for the wrong namespacez%s:%s)
r~ r r6 r7 � NamespaceErrr� r� r� rA r� )r r ZnsuriZnewNamer
r
r
� _set_prefix� s �
zAttr._set_prefixc C sv | j }|d k rR|j| j= |j| j| jf= | jrRd| _| jd8 _| j j d8 _ | j
D ] }|� � qX| j
d d �= d S )NFr1 ) r� �_attrsr� �_attrsNSr~ r� �_is_id�_magic_id_nodesrX �_magic_id_countr' rQ )r �elemrV r
r
r
rQ � s
z Attr.unlinkc C sf | j r
dS | j}| j}|d ks&|d kr*dS |�|�}|d kr@dS | jrV|�| j| j�S |�| j�S d S r� ) r� rX r� �_get_elem_infor~ �isIdNSr� �isIdr� �r r� r� �infor
r
r
� _get_isId� s
zAttr._get_isIdc C s\ | j }| j}|d ks |d kr tS |�|�}|d kr6tS | jrL|�| j| j�S |�| j�S d S r% ) rX r� �_no_typer� r~ �getAttributeTypeNSr� �getAttributeTyper� r� r
r
r
�_get_schemaType� s
zAttr._get_schemaType) r{ r| r} � __slots__r �ATTRIBUTE_NODEr r� r� r� rO r� r5 r r� ra r� r� r� �propertyr� r� r� r� r� r� r� r� r rQ r� r� r
r
r
r
r� X s. �
r� r� z True if this attribute is an ID.z'Namespace-local name of this attribute.�
schemaTypez Schema type for this attribute.c @ s� e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
d:dd�ZeZdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Z d2d3� Z d4d5� Z d6d7� Z d8d9� Z dS );� NamedNodeMapa The attribute list is a transient interface to the underlying
dictionaries. Mutations here will change the underlying element's
dictionary.
Ordering is imposed artificially and does not reflect the order of
attributes as found in an input document.
�r� r� �
_ownerElementc C s || _ || _|| _d S r% r� )r �attrsZattrsNSr� r
r
r
r� � s zNamedNodeMap.__init__c C s
t | j�S r% )�lenr� r r
r
r
� _get_length� s zNamedNodeMap._get_lengthc C s4 z| t | j�� �| W S tk
r. Y d S X d S r% )rr r� �keys�
IndexError�r r= r
r
r
�item� s zNamedNodeMap.itemc C s* g }| j �� D ]}|�|j|jf� q|S r% )r� �valuesrR r� r� �r rU rH r
r
r
rs � s zNamedNodeMap.itemsc C s0 g }| j �� D ] }|�|j|jf|jf� q|S r% )r� r� rR r~ r� r� r� r
r
r
�itemsNS� s zNamedNodeMap.itemsNSc C s" t |t�r|| jkS || jkS d S r% )�
isinstance�strr� r� rj r
r
r
� __contains__� s
zNamedNodeMap.__contains__c C s
| j �� S r% )r� r� r r
r
r
r� s zNamedNodeMap.keysc C s
| j �� S r% )r� r� r r
r
r
�keysNS s zNamedNodeMap.keysNSc C s
| j �� S r% )r� r� r r
r
r
r� s zNamedNodeMap.valuesNc C s | j �||�S r% �r� �get)r r� r� r
r
r
r�
s zNamedNodeMap.getc C s: | j t|dd �krdS t| �t|�kt| �t|�k S d S )Nr� r )r� �getattr�idrb r
r
r
�_cmp s zNamedNodeMap._cmpc C s | � |�dkS r+ �r� rb r
r
r
�__eq__ s zNamedNodeMap.__eq__c C s | � |�dkS r+ r� rb r
r
r
�__ge__ s zNamedNodeMap.__ge__c C s | � |�dkS r+ r� rb r
r
r
�__gt__ s zNamedNodeMap.__gt__c C s | � |�dkS r+ r� rb r
r
r
�__le__ s zNamedNodeMap.__le__c C s | � |�dk S r+ r� rb r
r
r
�__lt__! s zNamedNodeMap.__lt__c C s" t |t�r| j| S | j| S d S r% )r� r3 r� r� )r �attname_or_tupler
r
r
� __getitem__$ s
zNamedNodeMap.__getitem__c C sv t |t�rRz| j| }W n0 tk
rH t|�}| jj|_| �|� Y nX ||_n t |t�sdt d��|}| �|� d S )Nz%value must be a string or Attr object)
r� r� r� ri r� r� rX � setNamedItemr� � TypeError)r �attnamer� rH r
r
r
� __setitem__+ s
zNamedNodeMap.__setitem__c C s( z | j | W S tk
r" Y d S X d S r% )r� ri �r r� r
r
r
� getNamedItem: s zNamedNodeMap.getNamedItemc C s, z| j ||f W S tk
r& Y d S X d S r% )r� ri �r r~ r� r
r
r
�getNamedItemNS@ s zNamedNodeMap.getNamedItemNSc C sX | � |�}|d k rJt| j� | j|j= | j|j|jf= t|d�rFd |_ |S t
j � � �d S �Nr� )
r� rA r� r� r� r� r~ r� rq r� r6 r7 r? �r r� �nr
r
r
�removeNamedItemF s
z NamedNodeMap.removeNamedItemc C sZ | � ||�}|d k rLt| j� | j|j|jf= | j|j= t|d�rHd |_ |S t
j � � �d S r� )
r� rA r� r� r~ r� r� r� rq r� r6 r7 r? �r r~ r� r� r
r
r
�removeNamedItemNSR s
z NamedNodeMap.removeNamedItemNSc C st t |t�s&tj�dt|�t| �f ��| j�|j�}|r@|� � || j|j< || j
|j |j f< | j
|_t|j� |S rI )r� r� r6 r7 r8 r9 r� r� r� rQ r� r~ r� r� r� rA )r rH rn r
r
r
r� ^ s
�
zNamedNodeMap.setNamedItemc C s
| � |�S r% )r� �r rH r
r
r
�setNamedItemNSk s zNamedNodeMap.setNamedItemNSc C s | | }t |j� |�� d S r% )rA r� rQ )r r� rH r
r
r
� __delitem__n s
zNamedNodeMap.__delitem__c C s | j | j| jfS r% r� r r
r
r
� __getstate__s s zNamedNodeMap.__getstate__c C s |\| _ | _| _d S r% r� �r �stater
r
r
� __setstate__v s zNamedNodeMap.__setstate__)N)!r{ r| r} �__doc__r� r� r� r� rs r� r� r� r� r� r� �__len__r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r
r
r
r
r� � s<
r� Zlengthz$Number of nodes in the NamedNodeMap.c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) �TypeInfo�� namespacer� c C s || _ || _d S r% r )r r r� r
r
r
r� � s zTypeInfo.__init__c C s2 | j r d| jj| j| j f S d| jj| jf S d S )Nz<%s %r (from %r)>z<%s %r>)r � __class__r{ r� r r
r
r
�__repr__� s
�zTypeInfo.__repr__c C s | j S r% )r� r r
r
r
r� � s zTypeInfo._get_namec C s | j S r% )r r r
r
r
�_get_namespace� s zTypeInfo._get_namespaceN)r{ r| r} r� r� r r� r r
r
r
r
r� s
r� c @ s e Zd ZdZejZdZeZ dZ
ejej ej ej
ejejfZeddfdd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Z dd� Z e Z d d � Z d d � Z d d!� Z!e!Z"d"d#� Z#d$d%� Z$d&d'� Z%d(d)� Z&d*d+� Z'd9d-d.�Z(d/d0� Z)d1d2� Z*d3d4� Z+d5d6� Z,d7d8� Z-dS ):�Element) rX r: r� r� r r~ r� r' r� r� rC rD Nr c C sB d | _ | | _| _|| _|| _t� | _d | _| _d | _ d | _
d S r% ) r: r� r� r r~ rw r' rC rD r� r� )r r� r~ r r� r
r
r
r� � s
zElement.__init__c C s | j d kri | _ i | _d S r% )r� r� r r
r
r
�_ensure_attributes� s
zElement._ensure_attributesc C s4 z| j W S tk
r. | j�dd�d Y S X d S r� )r� rh r� r� r r
r
r
ra � s zElement._get_localNamec C s | j S r% �r� r r
r
r
� _get_tagName� s zElement._get_tagNamec C s@ | j d k r&t| j �� �D ] }|�� qd | _ d | _t�| � d S r% )r� rr r� rQ r� r )r �attrr
r
r
rQ � s
zElement.unlinkc C s8 | j d krdS z| j | jW S tk
r2 Y dS X d S r )r� r� ri )r r� r
r
r
� getAttribute� s
zElement.getAttributec C s< | j d krdS z| j ||f jW S tk
r6 Y dS X d S r )r� r� ri r� r
r
r
�getAttributeNS� s
zElement.getAttributeNSc C sV | � |�}|d kr4t|�}||_| j|_| �|� n ||jkrR||_|jrRt| � d S r% )�getAttributeNoder� r� rX �setAttributeNoder� rA )r r� r� r r
r
r
� setAttribute� s
zElement.setAttributec C s� t |�\}}| �||�}|d krHt||||�}||_| j|_| �|� n4||jkrf||_|jrft| � |j|kr|||_||_ d S r% )
�_nssplit�getAttributeNodeNSr� r� rX r
r� rA r r� )r r~ �
qualifiedNamer� r � localnamer r
r
r
�setAttributeNS� s
zElement.setAttributeNSc C s | j d krd S | j �|�S r% r� )r �attrnamer
r
r
r � s
zElement.getAttributeNodec C s | j d krd S | j �||f�S r% )r� r� r� r
r
r
r s
zElement.getAttributeNodeNSc C s� |j d | fkrtj�d��| �� | j�|jd �}|d k rD| �|� | j �|j
|j fd �}|d k rt||k rt| �|� t | |� ||k r�|S ||k r�|S d S )Nz attribute node already owned)
r� r6 r7 ZInuseAttributeErrr r� r� r� �removeAttributeNoder� r~ r� �_set_attribute_node)r r Zold1Zold2r
r
r
r
s
zElement.setAttributeNodec C sP | j d krtj�� �z| j| }W n tk
r@ tj�� �Y nX | �|� d S r% )r� r6 r7 r? r� ri r )r r� r r
r
r
�removeAttribute s
zElement.removeAttributec C sT | j d krtj�� �z| j ||f }W n tk
rD tj�� �Y nX | �|� d S r% )r� r6 r7 r? ri r )r r~ r� r r
r
r
�removeAttributeNS% s
zElement.removeAttributeNSc C s^ |d krt j�� �z| j|j W n tk
r@ t j�� �Y nX t| � |�� | j|_|S r% ) r6 r7 r? r� r� ri rA rQ rX r� r
r
r
r . s
zElement.removeAttributeNodec C s | j d krdS || j kS �NF�r� r� r
r
r
� hasAttribute> s
zElement.hasAttributec C s | j d krdS ||f| j kS r )r� r� r
r
r
�hasAttributeNSC s
zElement.hasAttributeNSc C s t | |t� �S r% �r� rw r� r
r
r
�getElementsByTagNameH s z Element.getElementsByTagNamec C s t | ||t� �S r% �r� rw r� r
r
r
�getElementsByTagNameNSK s �z Element.getElementsByTagNameNSc C s d| j t| �f S )Nz<DOM Element: %s at %#x>)r� r� r r
r
r
r O s zElement.__repr__r c C s� |� |d | j � | �� }|�� D ],}|� d| � t||| j� |� d� q$| jr�|� d� t| j�dkr�| jd jt j
t j fkr�| jd � |ddd� n4|� |� | jD ]}|� ||| ||� q�|� |� |� d| j|f � n|� d | � d S )
Nr� z %s="r� r� r1 r r z</%s>%sz/>%s)
r� r� �_get_attributesr� r� r� r' r� r r rO r� r )r r$ r" � addindentr# r� Za_namerH r
r
r
r R s*
��
zElement.writexmlc C s | � � t| j| j| �S r% )r r� r� r� r r
r
r
r! m s zElement._get_attributesc C s | j r
dS dS d S r� r r r
r
r
�
hasAttributesq s zElement.hasAttributesc C s | � |�}| �|� d S r% )r �setIdAttributeNode)r r� �idAttrr
r
r
�setIdAttributey s
zElement.setIdAttributec C s | � ||�}| �|� d S r% )r r$ )r r~ r� r% r
r
r
�setIdAttributeNS} s zElement.setIdAttributeNSc C sj |d ks| � |j�s tj�� �t| �d k r4tj�� �|jsfd|_| jd7 _| j j
d7 _
t | � d S )NTr1 ) rd r� r6 r7 r? �_get_containing_entref�NoModificationAllowedErrr� r� rX r� rA )r r% r
r
r
r$ � s
zElement.setIdAttributeNode)r r r ).r{ r| r} r� r rS r r� r� r� r� r� r� rO r� r� r5 r r� r ra r rQ r
r r r r r r
ZsetAttributeNodeNSr r r ZremoveAttributeNodeNSr r r r r r r! r# r& r' r$ r
r
r
r
r � sT ��
r r� z*NamedNodeMap of attributes on the element.z%Namespace-local name of this element.c C s8 t | � | �� || j|j< || j|j|jf< | |_d S r% )rA r r� r� r� r~ r� r� )�elementr r
r
r
r � s
r c @ sf e Zd ZdZdZdZe� ZdZdZ dd� Z
dd� Z dd � Z d
d � Z
d d
� Zdd� Zdd� Zdd� ZdS )� Childlessz�Mixin that makes childless-ness easy to implement and avoids
the complexity of the Node methods that deal with children.
r
Nc C s d S r% r
r r
r
r
r, � s zChildless._get_firstChildc C s d S r% r
r r
r
r
r/ � s zChildless._get_lastChildc C s t j�| jd ��d S )Nz nodes cannot have children�r6 r7 r8 r� r� r
r
r
r< � s �zChildless.appendChildc C s dS r r
r r
r
r
r( � s zChildless.hasChildNodesc C s t j�| jd ��d S �Nz nodes do not have childrenr, �r rE rF r
r
r
r4 � s �zChildless.insertBeforec C s t j�| jd ��d S r- )r6 r7 r? r� rN r
r
r
r; � s �zChildless.removeChildc C s d S r% r
r r
r
r
rT � s zChildless.normalizec C s t j�| jd ��d S r- r, �r rE rK r
r
r
rL � s �zChildless.replaceChild)r{ r| r} r� r� r� Z
EmptyNodeListr' r� r� r, r/ r< r( r4 r; rT rL r
r
r
r
r+ � s r+ c @ s\ e Zd ZejZdZdd� Zdd� Zdd� Z e
ee �Z dd � Z d
d � Z
e
e e
�Zdd
d�ZdS )�ProcessingInstruction��targetrP c C s || _ || _d S r% r1 )r r2 rP r
r
r
r� � s z ProcessingInstruction.__init__c C s | j S r% �rP r r
r
r
�_get_nodeValue� s z$ProcessingInstruction._get_nodeValuec C s
|| _ d S r% r3 r� r
r
r
�_set_nodeValue� s z$ProcessingInstruction._set_nodeValuec C s | j S r% �r2 r r
r
r
�
_get_nodeName� s z#ProcessingInstruction._get_nodeNamec C s
|| _ d S r% r6 r� r
r
r
�
_set_nodeName� s z#ProcessingInstruction._set_nodeNamer c C s |� d|| j| j|f � d S )Nz
%s<?%s %s?>%s)r� r2 rP �r r$ r" r" r# r
r
r
r � s z ProcessingInstruction.writexmlN)r r r )r{ r| r} r r� r r� r� r4 r5 r� r� r7 r8 r� r r
r
r
r
r0 � s
r0 c @ sr e Zd ZdZdd� Zdd� ZeZdd� Zdd � Ze ee� Z
Z d
d � Z d d
� Z
dd� Zdd� Zdd� Zdd� ZdS )�
CharacterData)�_datarX r: rD rC c C s, d | _ | _d | _| _d| _t�| � d S r )rX r: rD rC r; r r� r r
r
r
r� � s zCharacterData.__init__c C s
t | j�S r% )r� rP r r
r
r
r� � s zCharacterData._get_lengthc C s | j S r% �r; r r
r
r
� _get_data� s zCharacterData._get_datac C s
|| _ d S r% r< �r rP r
r
r
� _set_data� s zCharacterData._set_datac C s6 | j }t|�dkrd}nd}d| jj|dd� |f S )N�
z...r z<DOM %s node "%r%s">r )rP r� r r{ )r rP Z dotdotdotr
r
r
r � s
�zCharacterData.__repr__c C sT |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��| j||| � S �Nr �offset cannot be negative�#offset cannot be beyond end of data�count cannot be negative�r6 r7 � IndexSizeErrr� rP �r �offset�countr
r
r
�
substringData� s zCharacterData.substringDatac C s | j | | _ d S r% r3 )r �argr
r
r
�
appendData s zCharacterData.appendDatac C sZ |dk rt j�d��|t| j�kr.t j�d��|rVd| jd |� || j|d � f | _d S )Nr rB rC �%s%s%srE )r rH rK r
r
r
�
insertData s �zCharacterData.insertDatac C sl |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��|rh| jd |� | j|| d � | _d S rA rE rG r
r
r
�
deleteData s zCharacterData.deleteDatac C sr |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��|rnd| jd |� || j|| d � f | _d S )Nr rB rC rD rM rE )r rH rI rK r
r
r
� replaceData s �zCharacterData.replaceDataN)r{ r| r} r� r� r� r� r= r? r� rP r� r rJ rL rN rO rP r
r
r
r
r: � s
r: zLength of the string data.c @ sH e Zd ZdZejZdZdZdd� Z ddd�Z
d d
� Z d d � Z d
d� Z
dS )r� r
z#textNc C s� |dk s|t | j�kr"tj�d��| �� }| j|d � |_| j|_| j}| jr~| | jj kr~|d krp| j�
|� n| j� ||� | jd |� | _|S )Nr zillegal offset value) r� rP r6 r7 rF r rX rC r: r' r< r4 )r rH ZnewText�nextr
r
r
� splitText1 s zText.splitTextr c C s t |d|| j|f � d S )NrM )r� rP r9 r
r
r
r @ s z
Text.writexmlc C s� | j g}| j}|d k rB|jtjtjfkrB|�d|j � |j}qqBq| j}|d k rz|jtjtjfkrz|�|j � |j}qHqzqHd� |�S )Nr r )
rP rD r r rO r� rB rC rR �join)r rU r� r
r
r
�_get_wholeTextE s zText._get_wholeTextc C s� | j }| j}|d k r@|jtjtjfkr@|j}|�|� |}q q@q | j}|sT|�| � |d k r�|jtjtjfkr�|j}|�|� |}qTq�qT|r�|| _| S d S d S r% ) r: rD r r rO r� r; rC rP )r Zcontentr� r� rQ r
r
r
�replaceWholeTextW s*
zText.replaceWholeTextc C sF | j �� rdS t| �}|d kr"dS | j�|�}|d kr:dS |�� S d S r )rP �strip�_get_containing_elementrX r� �isElementContent)r r� r� r
r
r
�!_get_isWhitespaceInElementContents s
z&Text._get_isWhitespaceInElementContent)r r r )r{ r| r} r� r rO r r� r� rR r rT rU rY r
r
r
r
r� * s
r� Z isWhitespaceInElementContentzKTrue iff this text node contains only whitespace and is in element content.Z wholeTextz.The text of all logically-adjacent text nodes.c C s* | j }|d k r&|jtjkr |S |j }qd S r% )r: r r rS �rH rG r
r
r
rW � s rW c C s* | j }|d k r&|jtjkr |S |j }qd S r% )r: r r r� rZ r
r
r
r( � s r( c @ s( e Zd ZejZdZdd� Zddd�ZdS ) �Commentz#commentc C s t �| � || _d S r% )r: r� r; r> r
r
r
r� � s
zComment.__init__r c C s, d| j krtd��|�d|| j |f � d S )Nz--z%'--' is not allowed in a comment nodez
%s<!--%s-->%s)rP r> r� r9 r
r
r
r � s
zComment.writexmlN)r r r ) r{ r| r} r r� r r� r� r r
r
r
r
r[ � s r[ c @ s$ e Zd ZdZejZdZddd�ZdS )� CDATASectionr
z#cdata-sectionr c C s, | j �d�dkrtd��|�d| j � d S )Nz]]>r z$']]>' not allowed in a CDATA sectionz<![CDATA[%s]]>)rP �findr> r� r9 r
r
r
r � s zCDATASection.writexmlN)r r r ) r{ r| r} r� r r� r r� r r
r
r
r
r\ � s r\ c @ sz e Zd ZdZd dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd S ) � ReadOnlySequentialNamedNodeMap��_seqr
c C s
|| _ d S r% r_ )r �seqr
r
r
r� � s z'ReadOnlySequentialNamedNodeMap.__init__c C s
t | j�S r% �r� r` r r
r
r
r� � s z&ReadOnlySequentialNamedNodeMap.__len__c C s
t | j�S r% rb r r
r
r
r� � s z*ReadOnlySequentialNamedNodeMap._get_lengthc C s" | j D ]}|j|kr| S qd S r% )r` r� r� r
r
r
r� � s
z+ReadOnlySequentialNamedNodeMap.getNamedItemc C s, | j D ] }|j|kr|j|kr| S qd S r% )r` r~ r� r� r
r
r
r� � s
z-ReadOnlySequentialNamedNodeMap.getNamedItemNSc C s4 t |t�r| j|� }n
| �|�}|d kr0t|��|S r% )r� r3 r� r� ri )r Z
name_or_tuplerH r
r
r
r� � s
z*ReadOnlySequentialNamedNodeMap.__getitem__c C s4 |dk r d S z | j | W S tk
r. Y d S X d S r+ )r` r� r� r
r
r
r� � s z#ReadOnlySequentialNamedNodeMap.itemc C s t j�d��d S �Nz"NamedNodeMap instance is read-only�r6 r7 r) r� r
r
r
r� � s �z.ReadOnlySequentialNamedNodeMap.removeNamedItemc C s t j�d��d S rc rd r� r
r
r
r� � s �z0ReadOnlySequentialNamedNodeMap.removeNamedItemNSc C s t j�d��d S rc rd r� r
r
r
r� � s �z+ReadOnlySequentialNamedNodeMap.setNamedItemc C s t j�d��d S rc rd r� r
r
r
r� � s �z-ReadOnlySequentialNamedNodeMap.setNamedItemNSc C s | j gS r% r_ r r
r
r
r� � s z+ReadOnlySequentialNamedNodeMap.__getstate__c C s |d | _ d S r+ r_ r� r
r
r
r� � s z+ReadOnlySequentialNamedNodeMap.__setstate__N)r
)r{ r| r} r� r� r� r� r� r� r� r� r� r� r� r� r� r� r
r
r
r
r^ � s
r^ z&Number of entries in the NamedNodeMap.c @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S )
�
Identifiedz@Mix-in class that supports the publicId and systemId attributes.��publicId�systemIdc C s || _ || _d S r% rf )r rg rh r
r
r
�_identified_mixin_init� s z!Identified._identified_mixin_initc C s | j S r% )rg r r
r
r
�
_get_publicId� s zIdentified._get_publicIdc C s | j S r% )rh r r
r
r
�
_get_systemId� s zIdentified._get_systemIdN)r{ r| r} r� r� ri rj rk r
r
r
r
re � s
re c @ sH e Zd ZejZdZdZdZdZ dZ
dd� Z dd� Z dd� Z
d d d
�ZdS ) � DocumentTypeNc C s2 t � | _t � | _|r&t|�\}}|| _| j| _d S r% )r^ �entities� notationsr r� r� )r r r r r
r
r
r�
s zDocumentType.__init__c C s | j S r% )�internalSubsetr r
r
r
�_get_internalSubset s z DocumentType._get_internalSubsetc C s� | j d kr�td �}| j|_| j|_tjjj}|r�g |j_ g |j
_ | j
j D ]2}t |j|j |j
�}|j
j �|� |�|||� qH| jj D ]N}t|j|j |j
|j�}|j|_|j|_|j|_|jj �|� |�|||� q�| �|| |� |S d S d S r% )rX rl r� r� r6 r7 �UserDataHandler� NODE_CLONEDrm r` rn �Notationrg rh rR rv �Entity� notationName�actualEncodingr r_ )r rY �clonert r� �notation�e�entityr
r
r
rZ s0
�zDocumentType.cloneNoder c C s� |� d� |� | j� | jr8|� d|| j|| jf � n| jrR|� d|| jf � | jd k r||� d� |� | j� |� d� |� d| � d S )Nz
<!DOCTYPE z%s PUBLIC '%s'%s '%s'z%s SYSTEM '%s'z [�]r� )r� r� rg rh ro r9 r
r
r
r 0 s
�
zDocumentType.writexml)r r r )r{ r| r} r �DOCUMENT_TYPE_NODEr r� r� rg rh ro r� rp rZ r r
r
r
r
rl s rl c @ sf e Zd ZdZejZdZdZdZ dZ
dd� Z dd� Z dd� Z
dd � Zd
d � Zd d
� Zdd� Zdd� ZdS )rt Nc C s$ || _ || _t� | _| �||� d S r% )r� ru rw r' ri )r r� rg rh rx r
r
r
r� G s zEntity.__init__c C s | j S r% �rv r r
r
r
�_get_actualEncodingM s zEntity._get_actualEncodingc C s | j S r% �r r r
r
r
�
_get_encodingP s zEntity._get_encodingc C s | j S r% �r_ r r
r
r
� _get_versionS s zEntity._get_versionc C s t j�d��d S )Nz(cannot append children to an entity node�r6 r7 r8 )r rE r
r
r
r< V s �zEntity.appendChildc C s t j�d��d S )Nz+cannot insert children below an entity noder� r. r
r
r
r4 Z s �zEntity.insertBeforec C s t j�d��d S )Nz*cannot remove children from an entity noder� rN r
r
r
r; ^ s �zEntity.removeChildc C s t j�d��d S )Nz)cannot replace children of an entity noder� r/ r
r
r
rL b s �zEntity.replaceChild)r{ r| r} r� r Z ENTITY_NODEr r� rv r r_ r� r~ r� r� r< r4 r; rL r
r
r
r
rt > s rt c @ s e Zd ZejZdZdd� ZdS )rs Nc C s || _ | �||� d S r% )r� ri )r r� rg rh r
r
r
r� j s zNotation.__init__)r{ r| r} r r� r r� r� r
r
r
r
rs f s rs c @ sH e Zd ZddddddddgZd d
� Zd d � Zd
d� Zdd� Zdd� ZdS )�DOMImplementation)�core�1.0)r� �2.0)r� N)r6 r� )r6 r� )r6 N)�ls-loadz3.0)r� Nc C s |dkr d }|� � |f| jkS r )�lower� _featuresr] r
r
r
r\ z s z DOMImplementation.hasFeaturec C s� |r|j d k rtj�d��| �� }|d ko8|d ko8|d k }|sP|rPtj�d��|r�t|�\}}|dkr||dkr|tj�d��|r�|s�tj�d��|�||�}|r�|� |� |� |� |r�| |_ |_
||_ | |_ |S )Nz(doctype object owned by another DOM treezElement with no namer6 z$http://www.w3.org/XML/1998/namespacezillegal use of 'xml' prefixz(illegal use of prefix without namespaces)
r: r6 r7 �WrongDocumentErr�_create_documentZInvalidCharacterErrr r� �createElementNSr< rX �doctyper[ ) r r~ r r� r� Zadd_root_elementr r r* r
r
r
�createDocument s> ���
� �
z DOMImplementation.createDocumentc C s t |�}||_||_|S r% )rl rg rh )r r rg rh r� r
r
r
�createDocumentType� s z$DOMImplementation.createDocumentTypec C s | � |d �r| S d S d S r% )r\ re r
r
r
rf � s z DOMImplementation.getInterfacec C s t � S r% )�Documentr r
r
r
r� � s z"DOMImplementation._create_documentN) r{ r| r} r� r\ r� r� rf r� r
r
r
r
r� o s �
-r� c @ s\ e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
dS )� ElementInfoz�Object that represents content-model information for an element.
This implementation is not expected to be used in practice; DOM
builders should provide implementations which do the right thing
using information available to it.
r c C s
|| _ d S r% r r� r
r
r
r� � s zElementInfo.__init__c C s t S r% �r� �r Zanamer
r
r
r� � s z ElementInfo.getAttributeTypec C s t S r% r� r� r
r
r
r� � s z ElementInfo.getAttributeTypeNSc C s dS r r
r r
r
r
rX � s z ElementInfo.isElementContentc C s dS )zQReturns true iff this element is declared to have an EMPTY
content model.Fr
r r
r
r
�isEmpty� s zElementInfo.isEmptyc C s dS )z7Returns true iff the named attribute is a DTD-style ID.Fr
r� r
r
r
r� � s zElementInfo.isIdc C s dS )z<Returns true iff the identified attribute is a DTD-style ID.Fr
r� r
r
r
r� � s zElementInfo.isIdNSc C s | j S r% r r r
r
r
r� � s zElementInfo.__getstate__c C s
|| _ d S r% r r� r
r
r
r� � s zElementInfo.__setstate__N)r{ r| r} r� r� r� r� r� rX r� r� r� r� r� r
r
r
r
r� � s r� c C s> | j tjkr | j�� d | _n t| �r:| jj�� d | j_d S r% )r r r � _id_cache�clear�_id_search_stackr� rX r� r
r
r
rA � s
rA c @ sr e Zd ZdZejejejejfZ e
� Z ej Z
dZdZdZdZd ZZdZdZdZdZdZdZdZdZdd� Z dd � Z d
d � Z d d
� Z dd� Z dd� Z!dd� Z"dd� Z#dd� Z$dd� Z%dd� Z&d d � Z'd d � Z(d d!� Z)d"d#� Z*d$d%� Z+d&d'� Z,d(d)� Z-d*d+� Z.d,d-� Z/d.d/� Z0d0d1� Z1d2d3� Z2d4d5� Z3d6d7� Z4d8d9� Z5d:d;� Z6d<d=� Z7d>d?� Z8d@dA� Z9dBdC� Z:dIdEdF�Z;dGdH� Z<dS )Jr� )�
_elem_infor� r� r' r� z #documentNFr c C s$ d | _ t� | _i | _i | _d | _d S r% )r� rw r' r� r� r� r r
r
r
r� s
zDocument.__init__c C s& |j r|j |jf}n|j}| j�|�S r% )r~ r� r� r� r� )r r* rk r
r
r
r� s zDocument._get_elem_infoc C s | j S r% r} r r
r
r
r~ s z Document._get_actualEncodingc C s | j S r% )r� r r
r
r
� _get_doctype s zDocument._get_doctypec C s | j S r% )� documentURIr r
r
r
�_get_documentURI! s zDocument._get_documentURIc C s | j S r% r r r
r
r
r� $ s zDocument._get_encodingc C s | j S r% )� errorHandlerr r
r
r
�_get_errorHandler' s zDocument._get_errorHandlerc C s | j S r% )�
standaloner r
r
r
�_get_standalone* s zDocument._get_standalonec C s | j S r% )�strictErrorCheckingr r
r
r
�_get_strictErrorChecking- s z!Document._get_strictErrorCheckingc C s | j S r% r� r r
r
r
r� 0 s zDocument._get_versionc C sj |j | jkr(tj�dt|�t| �f ��|jd k r>|j�|� |j tj kr^| �
� r^tj�d��t� | |�S )Nr0 z two document elements disallowed) r r5 r6 r7 r8 r9 r: r; r rS �_get_documentElementr< r� r
r
r
r< 3 s �
��zDocument.appendChildc C sV z| j �|� W n tk
r. tj�� �Y nX d |_|_d |_| j |krRd | _ |S r% )
r' rM r> r6 r7 r? rC rD r: �documentElementrN r
r
r
r; C s
zDocument.removeChildc C s$ | j D ]}|jtjkr| S qd S r% )r' r r rS r� r
r
r
r� O s
z Document._get_documentElementc C s( | j d k r| j �� d | _ t�| � d S r% )r� rQ r r r
r
r
rQ T s
zDocument.unlinkc C s� |sd S | j �d d d �}| j|_| j|_| j|_| jD ]n}t|||�}|j�|�sVt �|j�
|� |j t j
kr~|jd ks�t �n |j t jkr�|jd ks�t �||_||_q6| �tjjj| |� |S r% )r[ r� r r� r_ r' rW rX rd �AssertionErrorrR r r r r� r| r� r: rv r6 r7 rq rr )r rY rw r� Z
childcloner
r
r
rZ Z s*
�zDocument.cloneNodec C s t � }| |_|S r% )r� rX )r ro r
r
r
�createDocumentFragmento s z Document.createDocumentFragmentc C s t |�}| |_|S r% )r rX )r r� ry r
r
r
�
createElementt s zDocument.createElementc C s( t |t�std��t� }||_| |_|S �Nz node contents must be a string)r� r� r� r� rP rX )r rP �tr
r
r
�createTextNodey s
zDocument.createTextNodec C s( t |t�std��t� }||_| |_|S r� )r� r� r� r\ rP rX �r rP rG r
r
r
�createCDATASection� s
zDocument.createCDATASectionc C s t |�}| |_|S r% )r[ rX r� r
r
r
�
createComment� s zDocument.createCommentc C s t ||�}| |_|S r% )r0 rX )r r2 rP �pr
r
r
�createProcessingInstruction� s
z$Document.createProcessingInstructionc C s t |�}| |_d|_|S r )r� rX r� )r r� �ar
r
r
�createAttribute� s zDocument.createAttributec C s" t |�\}}t|||�}| |_|S r% )r r rX )r r~ r r r� ry r
r
r
r� � s zDocument.createElementNSc C s* t |�\}}t||||�}| |_d|_|S r )r r� rX r� )r r~ r r r� r� r
r
r
�createAttributeNS� s
zDocument.createAttributeNSc C s t ||||�}| |_|S r% )rt rX )r r� rg rh ru ry r
r
r
�_create_entity� s zDocument._create_entityc C s t |||�}| |_|S r% )rs rX )r r� rg rh r� r
r
r
�_create_notation� s zDocument._create_notationc C s� || j kr| j | S | js$| js$d S | j}|d krB| jg}|| _n|sJd S d }|�r�|�� }|�dd� |jD �� | �|�}|�rB|j �
� D ]�}|j r�|� |j |j
�r�|| j |j< |j|kr�|}n |js� �q�q�|�|j��r
|| j |j< |j|kr�|}n|j�s> �q�q�|jr�|| j |j< |j|k�r.|}q�|jdkr� �q�q�n>|j�r�|j �
� D ]*}|j�rT|| j |j< |j|k�rT|}�qT|d k rN�q�qN|S )Nc S s g | ]}|j tkr|�qS r
)r r@ )�.0rV r
r
r
�
<listcomp>� s
�z+Document.getElementById.<locals>.<listcomp>r1 )r� r� r� r� r� �pop�extendr' r� r� r� r~ r� r� r� r� r� r� r� )r r� �stack�resultrH r� r r
r
r
�getElementById� sZ
zDocument.getElementByIdc C s t | |t� �S r% r r� r
r
r
r � s z Document.getElementsByTagNamec C s t | ||t� �S r% r r� r
r
r
r � s �z Document.getElementsByTagNameNSc C s | j �||�S r% )r[ r\ r] r
r
r
r` � s zDocument.isSupportedc C s> |j tjkrtj�d��n|j tjkr2tj�d��t||| �S )Nz cannot import document nodesz!cannot import document type nodes)r r r r6 r7 �NotSupportedErrr| rW )r rH rY r
r
r
�
importNode� s
zDocument.importNoder c C sJ |d kr|� d| � n|� d||f � | jD ]}|�||||� q0d S )Nz<?xml version="1.0" ?>z%<?xml version="1.0" encoding="%s"?>%s)r� r' r )r r$ r" r" r# r rH r
r
r
r � s �
zDocument.writexmlc C sJ |j | k r tj�d| |j f ��|jtjtjfkr>tj�d��|t kr�d|kr�|�
dd�\}}|dkr�|tjj kr�tj� d��q�|dkr�|tjj kr�|jtjkr�tj� d��d }|}nd }d }|jtjkr�|j
}|d k r�|j}|�|� nd }||_||_||_||_|jtjk�r ||_n*||_|d k �rF|�|� |�rF|�|� |S )Nz?cannot rename nodes from other documents;
expected %s,
found %sz8renameNode() only applies to element and attribute nodesr� r1 r� z illegal use of 'xmlns' prefixz$illegal use of the 'xmlns' attribute)rX r6 r7 r� r r rS r� r� r r� r r� r� r� r r r� r~ r� r� r� r
r$ )r r� r~ r� r r� r* Zis_idr
r
r
�
renameNode sb
���
��
�
��
zDocument.renameNode)r r r N)=r{ r| r} r� r rS r� r� r| r5 r� r[ r r r� r� r� r: rD rC rv r r� r_ r� r� r� r� r� r� r~ r� r� r� r� r� r� r� r< r; r� rQ rZ r� r� r� r� r� r� r� r� r� r� r� r� r r r` r� r r� r
r
r
r
r� � sj �
:
r� r� z#Top-level element of this document.c
C s� | j �|�rtjjj}n
tjjj}| jtj kr�|�
| j | j �}| j
�� D ]0}|�|j |j |j� |�|j |j�}|j|_qH|r�| jD ]}t|||�}|�|� q��n| jtjkr�|�� }|r�| jD ]}t|||�}|�|� qn�| jtjkr�|�| j�}�n�| jtj k�r |� | j�}�n�| jtj k�r>|� | j | j�}�nz| jtj!k�r\|�"| j�}�n\| jtj#k�r�|�$| j | j �}d|_| j|_�n,| jtj%k�r�| j |k �s�t&�tjjj}|j'�(| j)| j*| j+�}||_ |�r�g |j,_-g |j._-| j.j-D ]F} t/| j | j*| j+�}
||
_ |j.j-�0|
� t1| d��r�| �2|| |
� �q�| j,j-D ]b} t3| j | j*| j+| j4�} | j5| _5| j6| _6| j7| _7|| _ |j,j-�0| � t1| d��r>| �2|| | � �q>ntj�8dt9| � ��t1| d��r�| �2|| |� |S )zo
Clone a node and give it the new owner document.
Called by Node.cloneNode and Document.importNode
Trv zCannot clone node %s):rX rd r6 r7 rq rr Z
NODE_IMPORTEDr r rS r� r~ r� r� r� r r� r r� r� r' rW r< r2 r� rO r� rP r� r� r� r� r2 r� r� r� r� r| r� r[ r� r� rg rh rm r` rn rs rR rq rv rt ru rv r r_ r� r9 )
rH rY ZnewOwnerDocumentrt rw r r� rV rG r� rx ry rz r
r
r
rW B s�
�
��
� � rW c C s, | � dd�}t|�dkr |S d |d fS d S )Nr� r1 � r )r� r� )r Zfieldsr
r
r
r � s r c C s, | ||�}|� � \}}|�|� |�� |S r% )ZgetEventZ
expandNoder� )�func�args�kwargsZeventsZtoktypeZrootNoder
r
r
�_do_pulldom_parse� s
r� c C sH |dkr"|s"ddl m} |�| �S ddl m} t|j| f||d��S dS )z3Parse a file into a DOM by filename or file object.Nr �� expatbuilder��pulldom)�parser�bufsize)�xml.domr� �parser� r� )�filer� r� r� r� r
r
r
r� � s
�r� c C sB |dkr ddl m} |�| �S ddl m} t|j| fd|i�S dS )z&Parse a file into a DOM from a string.Nr r� r� r� )r� r� � parseStringr� r� )�stringr� r� r� r
r
r
r� � s
�r� c C s@ | r:t | t�rt�| �} | D ] \}}tj�||�s d S q tjS r% )r� r� r Z_parse_feature_stringr� r[ r\ )Zfeatures�f�vr
r
r
�getDOMImplementation� s
r� )NN)N)N)7r� r r� r6 r r r r Zxml.dom.minicompatZxml.dom.xmlbuilderr r r7 r rS r� r@ Z defpropertyrJ r� r� r� r� r� r� �objectr� Z
AttributeListr� r� r r r+ r0 r: r� rW r( r[ r\ r^ re rl rt rs r� r� rA r� rW r r� r� r� r� r
r
r
r
�<module> s� � v
y $�
x�� )GU�� >�<( O* P�R
U
e5d� � @ s G d d� d�Z dS )c @ sT e Zd ZdZdZdZdZdZdZdZ dZ
dZ dZ d Z
d
Zd Zd Zd
ZdZdd� ZdS )�
NodeFilter� � � l �� � � � � �@ � � i i i c C s t �d S )N)�NotImplementedError)�selfZnode� r �*/usr/lib64/python3.8/xml/dom/NodeFilter.py�
acceptNode s zNodeFilter.acceptNodeN)�__name__�
__module__� __qualname__Z
FILTER_ACCEPTZ
FILTER_REJECTZ FILTER_SKIPZSHOW_ALLZ SHOW_ELEMENTZSHOW_ATTRIBUTEZ SHOW_TEXTZSHOW_CDATA_SECTIONZSHOW_ENTITY_REFERENCEZ SHOW_ENTITYZSHOW_PROCESSING_INSTRUCTIONZ SHOW_COMMENTZ
SHOW_DOCUMENTZSHOW_DOCUMENT_TYPEZSHOW_DOCUMENT_FRAGMENTZ
SHOW_NOTATIONr r r r r r s" r N)r r r r r �<module> � U
e5d'
� @ sJ d Z ddddgZddlZefZG dd� de�ZG dd� de�Z d d� Z
dS )
z�Python version compatibility support for minidom.
This module contains internal implementation details and
should not be imported; use xml.dom.minidom instead.
�NodeList�
EmptyNodeList� StringTypes� defproperty� Nc @ s> e Zd ZdZdd� Zdd� Zdd� Zeeedd �Zd
d � Z d S )
r � c C s( d| krt | �k r$n n| | S d S �Nr ��len��self�indexr r �*/usr/lib64/python3.8/xml/dom/minicompat.py�item5 s z
NodeList.itemc C s t | �S �Nr �r r r r
� _get_length9 s zNodeList._get_lengthc C s t j�d��d S �Nz.attempt to modify read-only attribute 'length'��xml�dom�NoModificationAllowedErr�r �valuer r r
� _set_length< s �zNodeList._set_length�$The number of nodes in the NodeList.��docc C s |d kr g }|| d d �< d S r r )r �stater r r
� __setstate__D s zNodeList.__setstate__N)
�__name__�
__module__� __qualname__� __slots__r r r �property�lengthr r r r r
r 2 s �c @ sF e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Ze eed d
�Z
dS )r r c C s t � }|�|� |S r �r �extend�r �other�NLr r r
�__add__M s
zEmptyNodeList.__add__c C s t � }|�|� |S r r% r' r r r
�__radd__R s
zEmptyNodeList.__radd__c C s d S r r r
r r r
r W s zEmptyNodeList.itemc C s dS r r r r r r
r Z s zEmptyNodeList._get_lengthc C s t j�d��d S r r r r r r
r ] s �zEmptyNodeList._set_lengthr r N) r r r! r" r* r+ r r r r# r$ r r r r
r J s �c C sR t | d| �}|fdd�}t| d| �r4td| ��t|||d�}t| ||� d S )NZ_get_c S s t j�dt|� ��d S )Nz&attempt to modify read-only attribute )r r r �repr)r r �namer r r
�setg s
�zdefproperty.<locals>.setZ_set_zexpected not to find _set_r )�getattr�hasattr�AssertionErrorr# �setattr)�klassr- r �getr. Zpropr r r
r e s �) �__doc__�__all__Zxml.domr �strr �listr �tupler r r r r r
�<module> s * U
e5d�� � @ s d dl mZmZmZ d dl mZmZmZ d dlmZ d dl m
Z
m Z d dl m
Z
ejZejZejZejjZejjZejjZejjZe�� Ze�dd�e�dd�e�dd �e�dd
�e�dd �e�dd �e�dd
�e�dd�e�dd�d� ZG dd� de�Zdd� Z dd� Z G dd� d�Z eeefZ G dd� de�Z G dd � d e�Z!G d d � d e!�Z"G d d � d e!�Z#d!Z$d"e$ Z%G d#d$� d$e �Z&G d%d&� d&�Z'G d'd(� d(e'e �Z(G d)d*� d*e'e&�Z)G d+d,� d,e*�Z+G d-d.� d.e �Z,d:d0d1�Z-d;d2d3�Z.d<d4d5�Z/d=d6d7�Z0d8d9� Z1dS )>� )�
xmlbuilder�minidom�Node)�EMPTY_NAMESPACE� EMPTY_PREFIX�XMLNS_NAMESPACE)�expat)�
_append_child�_set_attribute_node)�
NodeFilterNZcdata� enumeration�entity�entities�idZidrefZidrefsZnmtokenZnmtokens) ZCDATA�ENUMZENTITYZENTITIES�IDZIDREFZIDREFSZNMTOKENZNMTOKENSc @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )� ElementInfo��
_attr_info�_model�tagNameNc C s || _ g | _|| _d S �N)r r r )�selfr �model� r �,/usr/lib64/python3.8/xml/dom/expatbuilder.py�__init__? s zElementInfo.__init__c C s | j | j| jfS r r �r r r r � __getstate__D s zElementInfo.__getstate__c C s |\| _ | _| _d S r r )r �stater r r � __setstate__G s zElementInfo.__setstate__c C sN | j D ]@}|d |kr|d }|d dkr6td S t|d S qtjS )N� ���r �(r )r �
_typeinfo_mapr �_no_type)r �aname�info�tr r r �getAttributeTypeJ s
z ElementInfo.getAttributeTypec C s t jS r )r r% )r Z namespaceURIZ localNamer r r �getAttributeTypeNST s z ElementInfo.getAttributeTypeNSc C s, | j r$| j d }|tjjtjjfkS dS d S �Nr F)r r r Z
XML_CTYPE_ANYZXML_CTYPE_MIXED)r �typer r r �isElementContentW s
�z ElementInfo.isElementContentc C s | j r| j d tjjkS dS d S r+ )r r r ZXML_CTYPE_EMPTYr r r r �isEmpty_ s zElementInfo.isEmptyc C s, | j D ] }|d |kr|d dk S qdS )Nr! r" r F)r )r r& r' r r r �isIde s
zElementInfo.isIdc C s | � ||f�S r )r/ )r ZeuriZenameZaurir& r r r �isIdNSk s zElementInfo.isIdNS)N)
�__name__�
__module__� __qualname__� __slots__r r r r) r* r- r. r/ r0 r r r r r < s
r c C s | � ||�S r )�_intern_setdefault)�builder�sr r r �_interno s r8 c C s� |� d�}| j}t|�dkrR|\}}}|||�}d||f }|||�}|||�}n4t|�dkrz|\}}t}|||� }}n td| ��|||�|||fS )N� � z%s:%s� z4Unsupported syntax: spaces in URIs not supported: %r)�splitr5 �lenr �
ValueError)r6 �name�parts�intern�uri� localname�prefix�qnamer r r �_parse_ns_namer s
rF c @ s� e Zd Zd:dd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Zd4d5� Z d6d7� Z d8d9� Z dS );� ExpatBuilderNc C sP |d krt �� }|| _| jjd k r2t| jj�| _n d | _t| _d | _| � � d S r )
r ZOptions�_options�filter�FilterVisibilityController�_filterr �_finish_start_element�_parser�reset)r �optionsr r r r � s zExpatBuilder.__init__c C s t �� S r )r � ParserCreater r r r � createParser� s zExpatBuilder.createParserc C sF | j s@| �� | _ | j jj| _d| j _d| j _d| j _| �| j � | j S �NT) rM rQ rA �
setdefaultr5 Z buffer_textZordered_attributesZspecified_attributes�installr r r r � getParser� s
zExpatBuilder.getParserc C s, t �td d �| _| j| _| jj| _d| _d S �NF)�theDOMImplementationZcreateDocumentr �document�curNode�
_elem_info�_cdatar r r r rN � s �
zExpatBuilder.resetc C s� | j |_| j|_| j|_| j|_| jj r0| j
|_ | j |_
| jjrH| j|_| jjrj| j|_| j|_| j|_n| j|_| j|_| j|_ | j |_ | j |_ d S r )!�start_doctype_decl_handler�StartDoctypeDeclHandler�first_element_handler�StartElementHandler�end_element_handler�EndElementHandler�
pi_handler� ProcessingInstructionHandlerrH r �entity_decl_handler�EntityDeclHandler�notation_decl_handler�NotationDeclHandler�comments�comment_handler�CommentHandlerZcdata_sections�start_cdata_section_handler�StartCdataSectionHandler�end_cdata_section_handler�EndCdataSectionHandler� character_data_handler_cdata�CharacterDataHandler�character_data_handler�external_entity_ref_handler�ExternalEntityRefHandler�xml_decl_handlerZXmlDeclHandler�element_decl_handlerZElementDeclHandler�attlist_decl_handlerZAttlistDeclHandler�r �parserr r r rT � s$
zExpatBuilder.installc C s� | � � }d}zH|�d�}|s qF|�|d� |r@| jjr@| �|� d}q|�dd� W n tk
rh Y nX | j}| �� d | _|S )NTi @ r F� ) rU �read�ParserX �documentElement�
_setup_subset� ParseEscaperN rM )r �filerx Z first_buffer�buffer�docr r r � parseFile� s"
zExpatBuilder.parseFilec C sP | � � }z|�|d� | �|� W n tk
r6 Y nX | j}| �� d | _|S rR )rU r{ r} r~ rX rN rM )r �stringrx r� r r r � parseString� s zExpatBuilder.parseStringc C s. | j jr*t� }|�|� |�� }|| j j_d S r )rX �doctype�InternalSubsetExtractorr� � getSubset�internalSubset)r r� Z extractor�subsetr r r r} � s
zExpatBuilder._setup_subsetc C s� | j j�|||�}| j |_t| j |� || j _| jrj| j�|�tkrjd | j _| j j d= d }d | j
_ d | j
_ |r�|d k r�g |j
_g |j_d | j
_d | j
_| j| j
_d S �N���)rX �implementationZcreateDocumentType�
ownerDocumentr r� rK �
acceptNode�
FILTER_REJECT�
childNodesrM re rg r �_seq� notationsrj rc �end_doctype_decl_handler�EndDoctypeDeclHandler)r Z doctypeName�systemId�publicId�has_internal_subsetr� r r r r\ � s* �
z'ExpatBuilder.start_doctype_decl_handlerc C s2 | j jr| j| j_| j| j_| js.| js.t | _
d S r ) rH rh ri rM rj rb rc rZ rK r �_finish_end_elementr r r r r� s
z%ExpatBuilder.end_doctype_decl_handlerc C s@ | j �||�}t| j|� | jr<| j�|�tkr<| j�|� d S r )rX ZcreateProcessingInstructionr rY rK r� r� � removeChild)r �target�data�noder r r rb s zExpatBuilder.pi_handlerc C s� | j j}| jrH| jr4|d jtkr4|d �|� d S | j�|�}d| _nD|rv|d jt krv|d }|j
| }||_
d S t � � }||_
| j|_
t| j |� d S )Nr� T)rY r� r[ �_cdata_continue�nodeType�CDATA_SECTION_NODEZ
appendDatarX ZcreateCDATASection� TEXT_NODEr� r �Textr� r )r r� r� r� �valuer r r ro s$ �
z)ExpatBuilder.character_data_handler_cdatac C s^ | j j}|r2|d jtkr2|d }|j| |_d S t�� }|j| |_| j|_t | j |� d S r� )
rY r� r� r� r� r r� rX r� r )r r� r� r� r r r rq & s z#ExpatBuilder.character_data_handlerc
C s� |rd S | j jsd S | j�||||�}|d k rF| j�|�} |j�| � | jjjj�|� | j r|| j �
|�t kr|| jjjjd= d S r� ) rH r rX Z_create_entityZcreateTextNoder� �appendr� r� rK r� r� )
r Z
entityNameZis_parameter_entityr� �baser� r� � notationNamer� �childr r r rd 1 s
� z ExpatBuilder.entity_decl_handlerc C sJ | j �|||�}| j jjj�|� | jrF| j�|�tkrF| j jjjd= d S r� ) rX Z_create_notationr� r� r� r� rK r� �
FILTER_ACCEPT)r r� r� r� r� r� r r r rf C s z"ExpatBuilder.notation_decl_handlerc C s> | j �|�}t| j|� | jr:| j�|�tkr:| j�|� d S r )rX Z
createCommentr rY rK r� r� r� )r r� r� r r r ri I s z ExpatBuilder.comment_handlerc C s d| _ d| _d S )NTF�r[ r� r r r r rk O s z(ExpatBuilder.start_cdata_section_handlerc C s d| _ d| _d S rV r� r r r r rm S s z&ExpatBuilder.end_cdata_section_handlerc C s dS �Nr! r )r �contextr� r� r� r r r rr W s z(ExpatBuilder.external_entity_ref_handlerc C s2 | j d kr| jst| _| j| �� _| �||� d S r )rK rZ r r� �start_element_handlerrU r_ )r r? �
attributesr r r r^ Z s z"ExpatBuilder.first_element_handlerc C s� | j �|�}t| j|� || _|rptdt|�d�D ]<}t�|| td t �}||d }||_
| j |_ t ||� q2|| j j
k r�| �|� d S )Nr r; r! )rX Z
createElementr rY �ranger= r �Attrr r r� r� r
r| rL )r r? r� r� �i�ar� r r r r� ` s � z"ExpatBuilder.start_element_handlerc C sj | j rf|| jjkrd S | j �|�}|tkr4t| � n|tkrFt| � nd S |j| _ |j�
|� |� � d S r ) rK rX r| �startContainerr� �Rejecter� FILTER_SKIP�Skipper�
parentNoderY r� �unlink)r r� Zfiltr r r rL q s
z"ExpatBuilder._finish_start_elementc C s | j }|j| _ | �|� d S r )rY r� r� )r r? rY r r r r` � s z ExpatBuilder.end_element_handlerc C s\ | j �|j�}|r | �||� | jrX|| jjkr4d S | j�|�tkrX| j �
|� |� � d S r ) rZ �getr �_handle_white_text_nodesrK rX r| r� r� rY r� r� )r rY r' r r r r� � s z ExpatBuilder._finish_end_elementc C sZ | j js|�� sd S g }|jD ]"}|jtkr |j�� s |�|� q |D ]}|� |� qFd S r )
rH Z whitespace_in_element_contentr- r� r� r� r� �stripr� r� )r r� r' �Lr� r r r r� � s �
z%ExpatBuilder._handle_white_text_nodesc C s0 | j �|�}|d kr&t||�| j |< n||_d S r )rZ r� r r )r r? r r' r r r ru � s z!ExpatBuilder.element_decl_handlerc
C sF | j �|�}|d kr&t|�}|| j |< |j�d |d d |d||g� d S �Nr )rZ r� r r r� )r �elemr? r, �defaultZrequiredr' r r r rv � s
�z!ExpatBuilder.attlist_decl_handlerc C s2 || j _|| j _|dkr.|r&d| j _nd| j _d S )Nr TF)rX �version�encoding�
standalone)r r� r� r� r r r rt � s
z ExpatBuilder.xml_decl_handler)N) r1 r2 r3 r rQ rU rN rT r� r� r} r\ r� rb ro rq rd rf ri rk rm rr r^ r� rL r` r� r� ru rv rt r r r r rG � s8
rG c @ s� e Zd ZdZdd� Zdd� Zdd� Zeje j
ej e j ej
e jeje jeje jeje jeje jeje jeje jeje j ej e j ej e j i Z!dS ) rJ �rI c C s
|| _ d S r r� )r rI r r r r � s z#FilterVisibilityController.__init__c C sT | j |j }| jj|@ rL| j�|�}|tkr0t�|tkrHtdt |� ��|S t
S d S )Nz)startContainer() returned illegal value: ) �_nodetype_maskr� rI �
whatToShowr� �FILTER_INTERRUPTr~ �_ALLOWED_FILTER_RETURNSr> �reprr� )r r� �mask�valr r r r� � s
�z)FilterVisibilityController.startContainerc C s� | j |j }| jj|@ r|| j�|�}|tkr0t�|tkr`|j}|j d d � D ]}|�
|� qLt S |t krxt
dt|� ��|S tS d S )Nz%acceptNode() returned illegal value: )r� r� rI r� r� r� r~ r� r� r� Z appendChildr� r� r> r� r� )r r� r� r� �parentr� r r r r� � s
�z%FilterVisibilityController.acceptNodeN)"r1 r2 r3 r4 r r� r� r Z ELEMENT_NODEr Z SHOW_ELEMENTZATTRIBUTE_NODEZSHOW_ATTRIBUTEr� Z SHOW_TEXTr� ZSHOW_CDATA_SECTIONZENTITY_REFERENCE_NODEZSHOW_ENTITY_REFERENCEZ ENTITY_NODEZ SHOW_ENTITYZPROCESSING_INSTRUCTION_NODEZSHOW_PROCESSING_INSTRUCTIONZ COMMENT_NODEZ SHOW_COMMENT�
DOCUMENT_NODEZ
SHOW_DOCUMENTZDOCUMENT_TYPE_NODEZSHOW_DOCUMENT_TYPEZDOCUMENT_FRAGMENT_NODEZSHOW_DOCUMENT_FRAGMENTZ
NOTATION_NODEZ
SHOW_NOTATIONr� r r r r rJ � s:
�rJ c @ s e Zd ZdZdd� ZdS )� FilterCrutch)�_builder�_level�
_old_start�_old_endc C s6 d| _ || _|j}|j| _|j| _| j|_| j|_d S r� ) r� r� rM r_ r� ra r� r� r` )r r6 rx r r r r s zFilterCrutch.__init__N)r1 r2 r3 r4 r r r r r r� s r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r� r c C s, t �| |� |j}dD ]}t||d � qd S )N)rc rj rp rl rn rs )r� r rM �setattr)r r6 rx r? r r r r s zRejecter.__init__c G s | j d | _ d S r� )r� �r �argsr r r r� s z Rejecter.start_element_handlerc G s@ | j dkr0| jj}| j�|� | j|_| j|_n | j d | _ d S �Nr r! )r� r� rM rT r� r_ r� ra )r r� rx r r r r` s
z Rejecter.end_element_handlerN)r1 r2 r3 r4 r r� r` r r r r r� s r� c @ s e Zd ZdZdd� Zdd� ZdS )r� r c G s. | j j}| j|� | j j|k r*| jd | _d S r� )r� rY r� r� )r r� r� r r r r� - s
z Skipper.start_element_handlerc G sD | j dkr*| j| jj_| j| jj_d | _n| j d | _ | j|� d S r� )r� r� r� rM r_ r� ra r� r r r r` 3 s
zSkipper.end_element_handlerN)r1 r2 r3 r4 r� r` r r r r r� * s r� z8http://xml.python.org/entities/fragment-builder/internalz�<!DOCTYPE wrapper
%%s [
<!ENTITY fragment-builder-internal
SYSTEM "%s">
%%s
]>
<wrapper %%s
>&fragment-builder-internal;</wrapper>c @ sF e Zd Zddd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dS )�FragmentBuilderNc C s6 |j tkr|| _|| _n|j| _|| _t�| |� d S r )r� r� �originalDocumentr� r� rG r )r r� rO r r r r [ s
zFragmentBuilder.__init__c C s t �| � d | _d S r )rG rN �fragmentr r r r rN d s
zFragmentBuilder.resetc C s | � |�� �S r )r� rz �r r r r r r� h s zFragmentBuilder.parseFilec C s� || _ | �� }| jj}d}|rV|jp*| �� }|jrDd|j|jf }qZ|jrZd|j }nd}| �� }t |||f }z|�
|d� W n | � � � Y nX | j }| � � |S )Nry zPUBLIC "%s" "%s"z SYSTEM "%s"r! )
�_sourcerU r� r� r� �_getDeclarationsr� r� � _getNSattrs�_FRAGMENT_BUILDER_TEMPLATEr{ rN r� ) r r� rx r� Zidentr� ZnsattrsrX r� r r r r� m s.
� zFragmentBuilder.parseStringc C s | j jj}d}|�rt|jj�D ]R}|j�|�}|r<|d }d||jf }|jrdd||j|j f }q d||j f }q t|j
j�D ]�}|j
�|�}|r�|d }d||jf }|jr�d||j|j f }n&|j r�d||j f }nd ||j j f }|j
r�d
||j
f }|d }q�|S ) Nry z
z%s<!NOTATION %sz!%s PUBLIC "%s"
"%s">z%s SYSTEM "%s">z
%s<!ENTITY %sz %s PUBLIC "%s"
"%s"z%s SYSTEM "%s"z%s "%s"z%s NOTATION %s�>)r� r� r� r� r� Zlength�itemZnodeNamer� r� r Z
firstChildr� r� )r r� r7 r� Znotationr
r r r r� � s:
� �
z FragmentBuilder._getDeclarationsc C s dS )Nry r r r r r r� � s zFragmentBuilder._getNSattrsc C s~ |t krh| j}| j}| j�|�}| j| _| j�� | _| j| _z|� | jd� W 5 || _|| _d | _X dS t
� | ||||�S d S )Nr! r� ) �$_FRAGMENT_BUILDER_INTERNAL_SYSTEM_IDrX rY rM ZExternalEntityParserCreater� ZcreateDocumentFragmentr� r� r{ rG rr )r r� r� r� r� Z old_documentZ old_cur_noderx r r r rr � s( �z+FragmentBuilder.external_entity_ref_handler)N)
r1 r2 r3 r rN r� r� r� r� rr r r r r r� R s
$r� c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �
Namespacesc C s
g | _ d S r )�_ns_ordered_prefixesr r r r �_initNamespaces� s zNamespaces._initNamespacesc C s t jdd�}d|_|S )Nr9 )Znamespace_separatorT)r rP Znamespace_prefixesrw r r r rQ � s zNamespaces.createParserc C s t �| |� | jjr | j|_d S r )rG rT rH Znamespace_declarations� start_namespace_decl_handlerZStartNamespaceDeclHandlerrw r r r rT � s �zNamespaces.installc C s | j �||f� d S r )r� r� )r rD rB r r r r� � s z'Namespaces.start_namespace_decl_handlerc C s� d|kr t | |�\}}}}nt}|}d }t}t�||||�}| j|_t| j|� || _| j r�| j D ]P\}}|r�t�
t | d| �t |d�}nt�
dt dt�}||_
| j|_t||� qb| j d d �= |�r~|�� |j} |j}
tdt|�d�D ]�} || } || d }
d| k�rDt | | �\}}}}t�
||||�}|| |< ||
||f< n$t�
| t| t�}|| | < ||
t| f< | j|_|
|_
||_q�d S )Nr9 �xmlns:�xmlnsr r; r! )rF r r r ZElementrX r� r rY r� r� r8 r r� r
Z_ensure_attributes�_attrs�_attrsNSr� r= Z ownerElement)r r? r� rB rC rD rE r� r� r� r� r� r& r� r r r r� � s^ � �
� z Namespaces.start_element_handlerN) r1 r2 r3 r� rQ rT r� r� r` r r r r r� � s 5r� c @ s e Zd Zdd� ZdS )�ExpatBuilderNSc C s t �| � | �� d S r )rG rN r� r r r r rN ) s
zExpatBuilderNS.resetN)r1 r2 r3 rN r r r r r� & s r� c @ s e Zd Zdd� Zdd� ZdS )�FragmentBuilderNSc C s t �| � | �� d S r )r� rN r� r r r r rN 1 s
zFragmentBuilderNS.resetc C s� d}| j }g }|r~t|d�rv|j�� D ]N\}}||kr8q&|�|� |rPd| }nd}|rhd|||f }q&d||f }q&|j}q|S )Nry �_ns_prefix_urir� r� z%s
%s='%s'z %s='%s')r� �hasattrr� �itemsr� r� )r �attrsr� r� rD rB Zdeclnamer r r r� 5 s"
z FragmentBuilderNS._getNSattrsN)r1 r2 r3 rN r� r r r r r� . s r� c @ s e Zd ZdS )r~ N)r1 r2 r3 r r r r r~ S s r~ c @ sH e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dS )r� Nc C s | j S r )r� r r r r r� \ s z!InternalSubsetExtractor.getSubsetc C s* zt �| |� W n tk
r$ Y nX d S r )rG r� r~ r� r r r r� ` s z!InternalSubsetExtractor.parseFilec C s* zt �| |� W n tk
r$ Y nX d S r )rG r� r~ )r r� r r r r� f s z#InternalSubsetExtractor.parseStringc C s | j |_| j|_d S r )r\ r] r� r_ rw r r r rT l s z InternalSubsetExtractor.installc C s0 |r&| � � }g | _| jj|_| j|_nt� �d S r )rU r� r� ZDefaultHandlerr� r� r~ )r r? r� r� r� rx r r r r\ p s
z2InternalSubsetExtractor.start_doctype_decl_handlerc C s, d� | j��dd��dd�}|| _t� �d S )Nry z
�
�
)�joinr� �replacer~ )r r7 r r r r� z s z0InternalSubsetExtractor.end_doctype_decl_handlerc C s
t � �d S r )r~ )r r? r� r r r r� s z-InternalSubsetExtractor.start_element_handler) r1 r2 r3 r� r� r� r� rT r\ r� r� r r r r r� W s
r� Tc C sL |r t � }nt� }t| t�r>t| d��}|�|�}W 5 Q R X n
|�| �}|S �N�rb)r� rG �
isinstance�str�openr� )r �
namespacesr6 �fp�resultr r r �parse� s
r� c C s |r t � }nt� }|�| �S r )r� rG r� )r� r� r6 r r r r� � s r� c C sP |rt |�}nt|�}t| t�rBt| d��}|�|�}W 5 Q R X n
|�| �}|S r� )r� r� r� r� r� r� )r r� r� r6 r� r� r r r �
parseFragment� s
r� c C s |rt |�}nt|�}|�| �S r )r� r� r� )r� r� r� r6 r r r �parseFragmentString� s
r� c C s | j rt| �S t| �S d S r )r� r� rG )rO r r r � makeBuilder� s r� )T)T)T)T)2Zxml.domr r r r r r Z xml.parsersr Zxml.dom.minidomr r
Zxml.dom.NodeFilterr r� r� r� ZDOMBuilderFilterr� r� r� r� ZgetDOMImplementationrW ZTypeInfor$ �objectr r8 rF rG r� rJ r� r� r� r� r� r� r� r� r� � Exceptionr~ r� r� r� r� r� r� r r r r �<module> sd
� 3 C
: � ��
u_%,
U
e5d�� � @ s d Z ddlmZmZmZ ddlmZmZmZ ddlm Z ddl
m Z m Z ddl
mZ ejZejZejZejjZejjZejjZejjZe�� Ze�dd�e�dd �e�dd
�e�dd �e�dd �e�dd
�e�dd�e�dd�e�dd�d� ZG dd� de�Z dd� Z dd� Z G dd� d�Z eeefZ G dd� de�Z!G d d � d e�Z"G d d � d e"�Z#G d d!� d!e"�Z$d"Z%d#e% Z&G d$d%� d%e �Z'G d&d'� d'�Z(G d(d)� d)e(e �Z)G d*d+� d+e(e'�Z*G d,d-� d-e+�Z,G d.d/� d/e �Z-d;d1d2�Z.d<d3d4�Z/d=d5d6�Z0d>d7d8�Z1d9d:� Z2dS )?z�Facility to use the Expat parser to load a minidom instance
from a string or file.
This avoids all the overhead of SAX and pulldom to gain performance.
� )�
xmlbuilder�minidom�Node)�EMPTY_NAMESPACE� EMPTY_PREFIX�XMLNS_NAMESPACE)�expat)�
_append_child�_set_attribute_node)�
NodeFilterNZcdata� enumeration�entity�entities�idZidrefZidrefsZnmtokenZnmtokens) ZCDATA�ENUMZENTITYZENTITIES�IDZIDREFZIDREFSZNMTOKENZNMTOKENSc @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )� ElementInfo��
_attr_info�_model�tagNameNc C s || _ g | _|| _d S �N)r r r )�selfr �model� r �,/usr/lib64/python3.8/xml/dom/expatbuilder.py�__init__? s zElementInfo.__init__c C s | j | j| jfS r r �r r r r � __getstate__D s zElementInfo.__getstate__c C s |\| _ | _| _d S r r )r �stater r r � __setstate__G s zElementInfo.__setstate__c C sN | j D ]@}|d |kr|d }|d dkr6td S t|d S qtjS )N� ���r �(r )r �
_typeinfo_mapr �_no_type)r �aname�info�tr r r �getAttributeTypeJ s
z ElementInfo.getAttributeTypec C s t jS r )r r% )r � namespaceURI� localNamer r r �getAttributeTypeNST s z ElementInfo.getAttributeTypeNSc C s, | j r$| j d }|tjjtjjfkS dS d S �Nr F)r r r Z
XML_CTYPE_ANYZXML_CTYPE_MIXED)r �typer r r �isElementContentW s
�z ElementInfo.isElementContentc C s | j r| j d tjjkS dS d S r- )r r r ZXML_CTYPE_EMPTYr r r r �isEmpty_ s zElementInfo.isEmptyc C s, | j D ] }|d |kr|d dk S qdS )Nr! r" r F)r )r r& r' r r r �isIde s
zElementInfo.isIdc C s | � ||f�S r )r1 )r ZeuriZenameZaurir& r r r �isIdNSk s zElementInfo.isIdNS)N)
�__name__�
__module__� __qualname__� __slots__r r r r) r, r/ r0 r1 r2 r r r r r < s
r c C s | � ||�S r )�_intern_setdefault)�builder�sr r r �_interno s r: c C s� d|ks t �|�d�}| j}t|�dkr^|\}}}|||�}d||f }|||�}|||�}n4t|�dkr�|\}}t}|||� }}n td| ��|||�|||fS )N� � z%s:%s� z4Unsupported syntax: spaces in URIs not supported: %r)�AssertionError�splitr7 �lenr �
ValueError)r8 �name�parts�intern�uri� localname�prefix�qnamer r r �_parse_ns_namer s
rI c @ s� e Zd ZdZd;dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Zd3d4� Z d5d6� Z d7d8� Z d9d:� Z dS )<� ExpatBuilderzPDocument builder that uses Expat to build a ParsedXML.DOM document
instance.Nc C sP |d krt �� }|| _| jjd k r2t| jj�| _n d | _t| _d | _| � � d S r )
r ZOptions�_options�filter�FilterVisibilityController�_filterr �_finish_start_element�_parser�reset)r �optionsr r r r � s zExpatBuilder.__init__c C s t �� S )zCreate a new parser object.)r � ParserCreater r r r � createParser� s zExpatBuilder.createParserc C sF | j s@| �� | _ | j jj| _d| j _d| j _d| j _| �| j � | j S )z7Return the parser object, creating a new one if needed.T) rP rT rD �
setdefaultr7 Z buffer_textZordered_attributesZspecified_attributes�installr r r r � getParser� s
zExpatBuilder.getParserc C s, t �tdd�| _| j| _| jj| _d| _dS )z6Free all data structures used during DOM construction.NF)�theDOMImplementationZcreateDocumentr �document�curNode�
_elem_info�_cdatar r r r rQ � s �
zExpatBuilder.resetc C s� | j |_| j|_| j|_| j|_| jj r0| j
|_ | j |_
| jjrH| j|_| jjrj| j|_| j|_| j|_n| j|_| j|_| j|_ | j |_ | j |_ dS )z>Install the callbacks needed to build the DOM into the parser.N)!�start_doctype_decl_handler�StartDoctypeDeclHandler�first_element_handler�StartElementHandler�end_element_handler�EndElementHandler�
pi_handler� ProcessingInstructionHandlerrK r �entity_decl_handler�EntityDeclHandler�notation_decl_handler�NotationDeclHandler�comments�comment_handler�CommentHandlerZcdata_sections�start_cdata_section_handler�StartCdataSectionHandler�end_cdata_section_handler�EndCdataSectionHandler� character_data_handler_cdata�CharacterDataHandler�character_data_handler�external_entity_ref_handler�ExternalEntityRefHandler�xml_decl_handlerZXmlDeclHandler�element_decl_handlerZElementDeclHandler�attlist_decl_handlerZAttlistDeclHandler�r �parserr r r rV � s$
zExpatBuilder.installc C s� | � � }d}zH|�d�}|s qF|�|d� |r@| jjr@| �|� d}q|�dd� W n tk
rh Y nX | j}| �� d| _|S )zIParse a document from a file object, returning the document
node.Ti @ r F� N) rW �read�ParserY �documentElement�
_setup_subset� ParseEscaperQ rP )r �filery Z first_buffer�buffer�docr r r � parseFile� s"
zExpatBuilder.parseFilec C sP | � � }z|�|d� | �|� W n tk
r6 Y nX | j}| �� d| _|S )z<Parse a document from a string, returning the document node.TN)rW r| r~ r rY rQ rP )r �stringry r� r r r � parseString� s zExpatBuilder.parseStringc C s. | j jr*t� }|�|� |�� }|| j j_dS )z/Load the internal subset if there might be one.N)rY �doctype�InternalSubsetExtractorr� � getSubset�internalSubset)r r� Z extractor�subsetr r r r~ � s
zExpatBuilder._setup_subsetc C s� | j j�|||�}| j |_t| j |� || j _| jrj| j�|�tkrjd | j _| j j d= d }d | j
_ d | j
_ |r�|d k r�g |j
_g |j_d | j
_d | j
_| j| j
_d S �N���)rY �implementationZcreateDocumentType�
ownerDocumentr r� rN �
acceptNode�
FILTER_REJECT�
childNodesrP rf rh r �_seq� notationsrk rd �end_doctype_decl_handler�EndDoctypeDeclHandler)r Z doctypeName�systemId�publicId�has_internal_subsetr� r r r r] � s* �
z'ExpatBuilder.start_doctype_decl_handlerc C s2 | j jr| j| j_| j| j_| js.| js.t | _
d S r ) rK ri rj rP rk rc rd r[ rN r �_finish_end_elementr r r r r� s
z%ExpatBuilder.end_doctype_decl_handlerc C s@ | j �||�}t| j|� | jr<| j�|�tkr<| j�|� d S r )rY ZcreateProcessingInstructionr rZ rN r� r� � removeChild)r �target�data�noder r r rc s zExpatBuilder.pi_handlerc C s� | j j}| jrH| jr4|d jtkr4|d �|� d S | j�|�}d| _nD|rv|d jt krv|d }|j
| }||_
d S t � � }||_
| j|_
t| j |� d S )Nr� T)rZ r� r\ �_cdata_continue�nodeType�CDATA_SECTION_NODEZ
appendDatarY ZcreateCDATASection� TEXT_NODEr� r �Textr� r )r r� r� r� �valuer r r rp s$ �
z)ExpatBuilder.character_data_handler_cdatac C s^ | j j}|r2|d jtkr2|d }|j| |_d S t�� }|j| |_| j|_t | j |� d S r� )
rZ r� r� r� r� r r� rY r� r )r r� r� r� r r r rr & s z#ExpatBuilder.character_data_handlerc
C s� |rd S | j jsd S | j�||||�}|d k rF| j�|�} |j�| � | jjjj�|� | j r|| j �
|�t kr|| jjjjd= d S r� ) rK r rY Z_create_entityZcreateTextNoder� �appendr� r� rN r� r� )
r Z
entityNameZis_parameter_entityr� �baser� r� � notationNamer� �childr r r re 1 s
� z ExpatBuilder.entity_decl_handlerc C sJ | j �|||�}| j jjj�|� | jrF| j�|�tkrF| j jjjd= d S r� ) rY Z_create_notationr� r� r� r� rN r� �
FILTER_ACCEPT)r r� r� r� r� r� r r r rg C s z"ExpatBuilder.notation_decl_handlerc C s> | j �|�}t| j|� | jr:| j�|�tkr:| j�|� d S r )rY Z
createCommentr rZ rN r� r� r� )r r� r� r r r rj I s z ExpatBuilder.comment_handlerc C s d| _ d| _d S )NTF�r\ r� r r r r rl O s z(ExpatBuilder.start_cdata_section_handlerc C s d| _ d| _d S )NFr� r r r r rn S s z&ExpatBuilder.end_cdata_section_handlerc C s dS �Nr! r )r �contextr� r� r� r r r rs W s z(ExpatBuilder.external_entity_ref_handlerc C s2 | j d kr| jst| _| j| �� _| �||� d S r )rN r[ r r� �start_element_handlerrW r` )r rB �
attributesr r r r_ Z s z"ExpatBuilder.first_element_handlerc C s� | j �|�}t| j|� || _|rptdt|�d�D ]<}t�|| td t �}||d }||_
| j |_ t ||� q2|| j j
k r�| �|� d S )Nr r= r! )rY Z
createElementr rZ �ranger@ r �Attrr r r� r� r
r} rO )r rB r� r� �i�ar� r r r r� ` s � z"ExpatBuilder.start_element_handlerc C sj | j rf|| jjkrd S | j �|�}|tkr4t| � n|tkrFt| � nd S |j| _ |j�
|� |� � d S r ) rN rY r} �startContainerr� �Rejecter� FILTER_SKIP�Skipper�
parentNoderZ r� �unlink)r r� Zfiltr r r rO q s
z"ExpatBuilder._finish_start_elementc C s | j }|j| _ | �|� d S r )rZ r� r� )r rB rZ r r r ra � s z ExpatBuilder.end_element_handlerc C s\ | j �|j�}|r | �||� | jrX|| jjkr4d S | j�|�tkrX| j �
|� |� � d S r ) r[ �getr �_handle_white_text_nodesrN rY r} r� r� rZ r� r� )r rZ r' r r r r� � s z ExpatBuilder._finish_end_elementc C sZ | j js|�� sd S g }|jD ]"}|jtkr |j�� s |�|� q |D ]}|� |� qFd S r )
rK Z whitespace_in_element_contentr/ r� r� r� r� �stripr� r� )r r� r' �Lr� r r r r� � s �
z%ExpatBuilder._handle_white_text_nodesc C s> | j �|�}|d kr&t||�| j |< n|jd ks4t�||_d S r )r[ r� r r r> )r rB r r' r r r rv � s
z!ExpatBuilder.element_decl_handlerc
C sF | j �|�}|d kr&t|�}|| j |< |j�d |d d |d||g� d S �Nr )r[ r� r r r� )r �elemrB r. �defaultZrequiredr' r r r rw � s
�z!ExpatBuilder.attlist_decl_handlerc C s2 || j _|| j _|dkr.|r&d| j _nd| j _d S )Nr TF)rY �version�encoding�
standalone)r r� r� r� r r r ru � s
z ExpatBuilder.xml_decl_handler)N) r3 r4 r5 �__doc__r rT rW rQ rV r� r� r~ r] r� rc rp rr re rg rj rl rn rs r_ r� rO ra r� r� rv rw ru r r r r rJ � s:
rJ c @ s� e Zd ZdZdZdd� Zdd� Zdd� Zej e
j ej e
j
eje
jeje
jeje
jeje
jeje
jeje
jeje
jej e
j ej e
j ej e
j!i Z"d S )
rM zoWrapper around a DOMBuilderFilter which implements the checks
to make the whatToShow filter attribute work.�rL c C s
|| _ d S r r� )r rL r r r r � s z#FilterVisibilityController.__init__c C sT | j |j }| jj|@ rL| j�|�}|tkr0t�|tkrHtdt |� ��|S t
S d S )Nz)startContainer() returned illegal value: ) �_nodetype_maskr� rL �
whatToShowr� �FILTER_INTERRUPTr �_ALLOWED_FILTER_RETURNSrA �reprr� )r r� �mask�valr r r r� � s
�z)FilterVisibilityController.startContainerc C s� | j |j }| jj|@ r|| j�|�}|tkr0t�|tkr`|j}|j d d � D ]}|�
|� qLt S |t krxt
dt|� ��|S tS d S )Nz%acceptNode() returned illegal value: )r� r� rL r� r� r� r r� r� r� Z appendChildr� r� rA r� r� )r r� r� r� �parentr� r r r r� � s
�z%FilterVisibilityController.acceptNodeN)#r3 r4 r5 r� r6 r r� r� r Z ELEMENT_NODEr Z SHOW_ELEMENTZATTRIBUTE_NODEZSHOW_ATTRIBUTEr� Z SHOW_TEXTr� ZSHOW_CDATA_SECTIONZENTITY_REFERENCE_NODEZSHOW_ENTITY_REFERENCEZ ENTITY_NODEZ SHOW_ENTITYZPROCESSING_INSTRUCTION_NODEZSHOW_PROCESSING_INSTRUCTIONZ COMMENT_NODEZ SHOW_COMMENT�
DOCUMENT_NODEZ
SHOW_DOCUMENTZDOCUMENT_TYPE_NODEZSHOW_DOCUMENT_TYPEZDOCUMENT_FRAGMENT_NODEZSHOW_DOCUMENT_FRAGMENTZ
NOTATION_NODEZ
SHOW_NOTATIONr� r r r r rM � s<
�rM c @ s e Zd ZdZdd� ZdS )� FilterCrutch)�_builder�_level�
_old_start�_old_endc C s6 d| _ || _|j}|j| _|j| _| j|_| j|_d S r� ) r� r� rP r` r� rb r� r� ra )r r8 ry r r r r s zFilterCrutch.__init__N)r3 r4 r5 r6 r r r r r r� s r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r� r c C s, t �| |� |j}dD ]}t||d � qd S )N)rd rk rq rm ro rt )r� r rP �setattr)r r8 ry rB r r r r s zRejecter.__init__c G s | j d | _ d S r� )r� �r �argsr r r r� s z Rejecter.start_element_handlerc G s@ | j dkr0| jj}| j�|� | j|_| j|_n | j d | _ d S �Nr r! )r� r� rP rV r� r` r� rb )r r� ry r r r ra s
z Rejecter.end_element_handlerN)r3 r4 r5 r6 r r� ra r r r r r� s r� c @ s e Zd ZdZdd� Zdd� ZdS )r� r c G s. | j j}| j|� | j j|k r*| jd | _d S r� )r� rZ r� r� )r r� r� r r r r� - s
z Skipper.start_element_handlerc G sD | j dkr*| j| jj_| j| jj_d | _n| j d | _ | j|� d S r� )r� r� r� rP r` r� rb r� r r r ra 3 s
zSkipper.end_element_handlerN)r3 r4 r5 r6 r� ra r r r r r� * s r� z8http://xml.python.org/entities/fragment-builder/internalz�<!DOCTYPE wrapper
%%s [
<!ENTITY fragment-builder-internal
SYSTEM "%s">
%%s
]>
<wrapper %%s
>&fragment-builder-internal;</wrapper>c @ sJ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dS )�FragmentBuilderz�Builder which constructs document fragments given XML source
text and a context node.
The context node is expected to provide information about the
namespace declarations which are in scope at the start of the
fragment.
Nc C s6 |j tkr|| _|| _n|j| _|| _t�| |� d S r )r� r� �originalDocumentr� r� rJ r )r r� rR r r r r [ s
zFragmentBuilder.__init__c C s t �| � d | _d S r )rJ rQ �fragmentr r r r rQ d s
zFragmentBuilder.resetc C s | � |�� �S )zRParse a document fragment from a file object, returning the
fragment node.)r� r{ �r r� r r r r� h s zFragmentBuilder.parseFilec C s� || _ | �� }| jj}d}|rV|jp*| �� }|jrDd|j|jf }qZ|jrZd|j }nd}| �� }t |||f }z|�
|d� W n | � � � Y nX | j }| � � |S )zMParse a document fragment from a string, returning the
fragment node.rz zPUBLIC "%s" "%s"z SYSTEM "%s"r! )
�_sourcerW r� r� r� �_getDeclarationsr� r� � _getNSattrs�_FRAGMENT_BUILDER_TEMPLATEr| rQ r� ) r r� ry r� Zidentr� ZnsattrsrY r� r r r r� m s.
� zFragmentBuilder.parseStringc C s | j jj}d}|�rt|jj�D ]R}|j�|�}|r<|d }d||jf }|jrdd||j|j f }q d||j f }q t|j
j�D ]�}|j
�|�}|r�|d }d||jf }|jr�d||j|j f }n&|j r�d||j f }nd ||j j f }|j
r�d
||j
f }|d }q�|S ) z�Re-create the internal subset from the DocumentType node.
This is only needed if we don't already have the
internalSubset as a string.
rz z
z%s<!NOTATION %sz!%s PUBLIC "%s"
"%s">z%s SYSTEM "%s">z
%s<!ENTITY %sz %s PUBLIC "%s"
"%s"z%s SYSTEM "%s"z%s "%s"z%s NOTATION %s�>)r� r� r� r� r� Zlength�item�nodeNamer� r� r Z
firstChildr� r� )r r� r9 r� Znotationr
r r r r� � s:
� �
z FragmentBuilder._getDeclarationsc C s dS )Nrz r r r r r r� � s zFragmentBuilder._getNSattrsc C s~ |t krh| j}| j}| j�|�}| j| _| j�� | _| j| _z|� | jd� W 5 || _|| _d | _X dS t
� | ||||�S d S )Nr! r� ) �$_FRAGMENT_BUILDER_INTERNAL_SYSTEM_IDrY rZ rP ZExternalEntityParserCreater� ZcreateDocumentFragmentr� r� r| rJ rs )r r� r� r� r� Z old_documentZ old_cur_nodery r r r rs � s( �z+FragmentBuilder.external_entity_ref_handler)N) r3 r4 r5 r� r rQ r� r� r� r� rs r r r r r� R s
$r� c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�
Namespacesz7Mix-in class for builders; adds support for namespaces.c C s
g | _ d S r )�_ns_ordered_prefixesr r r r �_initNamespaces� s zNamespaces._initNamespacesc C s t jdd�}d|_|S )z'Create a new namespace-handling parser.r; )Znamespace_separatorT)r rS Znamespace_prefixesrx r r r rT � s zNamespaces.createParserc C s t �| |� | jjr | j|_dS )z.Insert the namespace-handlers onto the parser.N)rJ rV rK Znamespace_declarations� start_namespace_decl_handlerZStartNamespaceDeclHandlerrx r r r rV � s �zNamespaces.installc C s | j �||f� dS )z/Push this namespace declaration on our storage.N)r� r� )r rG rE r r r r� � s z'Namespaces.start_namespace_decl_handlerc C s� d|kr t | |�\}}}}nt}|}d }t}t�||||�}| j|_t| j|� || _| j r�| j D ]P\}}|r�t�
t | d| �t |d�}nt�
dt dt�}||_
| j|_t||� qb| j d d �= |�r~|�� |j} |j}
tdt|�d�D ]�} || } || d }
d| k�rDt | | �\}}}}t�
||||�}|| |< ||
||f< n$t�
| t| t�}|| | < ||
t| f< | j|_|
|_
||_q�d S )Nr; �xmlns:�xmlnsr r= r! )rI r r r ZElementrY r� r rZ r� r� r: r r� r
Z_ensure_attributes�_attrs�_attrsNSr� r@ Z ownerElement)r rB r� rE rF rG rH r� r� r� r� r� r& r� r r r r� � s^ � �
� z Namespaces.start_element_handlerc C s� | j }d|krHt| |�\}}}}|j|kr>|j|kr>|j|ksltd��n$|j|ksZtd��|jtksltd��|j| _ | � |� d S )Nr; z$element stack messed up! (namespace)z&element stack messed up - bad nodeNamez*element stack messed up - bad namespaceURI)
rZ rI r* r+ rG r> r� r r� r� )r rB rZ rE rF rG rH r r r ra s$
��� � �z Namespaces.end_element_handlerN)
r3 r4 r5 r� r� rT rV r� r� ra r r r r r� � s 5r� c @ s e Zd ZdZdd� ZdS )�ExpatBuilderNSz*Document builder that supports namespaces.c C s t �| � | �� d S r )rJ rQ r� r r r r rQ ) s
zExpatBuilderNS.resetN)r3 r4 r5 r� rQ r r r r r� & s r� c @ s e Zd ZdZdd� Zdd� ZdS )�FragmentBuilderNSz*Fragment builder that supports namespaces.c C s t �| � | �� d S r )r� rQ r� r r r r rQ 1 s
zFragmentBuilderNS.resetc C s� d}| j }g }|r~t|d�rv|j�� D ]N\}}||kr8q&|�|� |rPd| }nd}|rhd|||f }q&d||f }q&|j}q|S )zNReturn string of namespace attributes from this element and
ancestors.rz �_ns_prefix_urir� r� z%s
%s='%s'z %s='%s')r� �hasattrr� �itemsr� r� )r �attrsr� r� rG rE Zdeclnamer r r r� 5 s"
z FragmentBuilderNS._getNSattrsN)r3 r4 r5 r� rQ r� r r r r r� . s r� c @ s e Zd ZdZdS )r zEException raised to short-circuit parsing in InternalSubsetExtractor.N)r3 r4 r5 r� r r r r r S s r c @ sL e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dS )r� zBXML processor which can rip out the internal document type subset.Nc C s | j S )z'Return the internal subset as a string.)r� r r r r r� \ s z!InternalSubsetExtractor.getSubsetc C s* zt �| |� W n tk
r$ Y nX d S r )rJ r� r r� r r r r� ` s z!InternalSubsetExtractor.parseFilec C s* zt �| |� W n tk
r$ Y nX d S r )rJ r� r )r r� r r r r� f s z#InternalSubsetExtractor.parseStringc C s | j |_| j|_d S r )r] r^ r� r` rx r r r rV l s z InternalSubsetExtractor.installc C s0 |r&| � � }g | _| jj|_| j|_nt� �d S r )rW r� r� ZDefaultHandlerr� r� r )r rB r� r� r� ry r r r r] p s
z2InternalSubsetExtractor.start_doctype_decl_handlerc C s, d� | j��dd��dd�}|| _t� �d S )Nrz z
�
�
)�joinr� �replacer )r r9 r r r r� z s z0InternalSubsetExtractor.end_doctype_decl_handlerc C s
t � �d S r )r )r rB r� r r r r� s z-InternalSubsetExtractor.start_element_handler) r3 r4 r5 r� r� r� r� r� rV r] r� r� r r r r r� W s
r� Tc C sL |r t � }nt� }t| t�r>t| d��}|�|�}W 5 Q R X n
|�| �}|S )z{Parse a document, returning the resulting Document node.
'file' may be either a file name or an open file object.
�rb)r� rJ �
isinstance�str�openr� )r� �
namespacesr8 �fp�resultr r r �parse� s
r� c C s |r t � }nt� }|�| �S )zOParse a document from a string, returning the resulting
Document node.
)r� rJ r� )r� r� r8 r r r r� � s r� c C sP |rt |�}nt|�}t| t�rBt| d��}|�|�}W 5 Q R X n
|�| �}|S )z�Parse a fragment of a document, given the context from which it
was originally extracted. context should be the parent of the
node(s) which are in the fragment.
'file' may be either a file name or an open file object.
r� )r� r� r� r� r� r� )r� r� r� r8 r� r� r r r �
parseFragment� s
r� c C s |rt |�}nt|�}|�| �S )z�Parse a fragment of a document from a string, given the context
from which it was originally extracted. context should be the
parent of the node(s) which are in the fragment.
)r� r� r� )r� r� r� r8 r r r �parseFragmentString� s
r� c C s | j rt| �S t| �S dS )z,Create a builder based on an Options object.N)r� r� rJ )rR r r r � makeBuilder� s r� )T)T)T)T)3r� Zxml.domr r r r r r Z xml.parsersr Zxml.dom.minidomr r
Zxml.dom.NodeFilterr r� r� r� ZDOMBuilderFilterr� r� r� r� ZgetDOMImplementationrX ZTypeInfor$ �objectr r: rI rJ r� rM r� r� r� r� r� r� r� r� r� � Exceptionr r� r� r� r� r� r� r r r r �<module> sf
� 3 C
: � ��
u_%,
U
e5d'
� @ sF d dddgZ ddlZefZG dd � d e�ZG dd� de�Zdd� Z dS ) �NodeList�
EmptyNodeList� StringTypes� defproperty� Nc @ s> e Zd ZdZdd� Zdd� Zdd� Zeeedd �Zd
d � Z d S )
r � c C s( d| krt | �k r$n n| | S d S �Nr ��len��self�indexr r �*/usr/lib64/python3.8/xml/dom/minicompat.py�item5 s z
NodeList.itemc C s t | �S �Nr �r r r r
� _get_length9 s zNodeList._get_lengthc C s t j�d��d S �Nz.attempt to modify read-only attribute 'length'��xml�dom�NoModificationAllowedErr�r �valuer r r
� _set_length< s �zNodeList._set_length�$The number of nodes in the NodeList.��docc C s |d kr g }|| d d �< d S r r )r �stater r r
� __setstate__D s zNodeList.__setstate__N)
�__name__�
__module__� __qualname__� __slots__r r r �property�lengthr r r r r
r 2 s �c @ sF e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Ze eed d
�Z
dS )r r c C s t � }|�|� |S r �r �extend�r �other�NLr r r
�__add__M s
zEmptyNodeList.__add__c C s t � }|�|� |S r r% r' r r r
�__radd__R s
zEmptyNodeList.__radd__c C s d S r r r
r r r
r W s zEmptyNodeList.itemc C s dS r r r r r r
r Z s zEmptyNodeList._get_lengthc C s t j�d��d S r r r r r r
r ] s �zEmptyNodeList._set_lengthr r N) r r r! r" r* r+ r r r r# r$ r r r r
r J s �c C s8 t | d| �}|fdd�}t|||d�}t| ||� d S )NZ_get_c S s t j�dt|� ��d S )Nz&attempt to modify read-only attribute )r r r �repr)r r �namer r r
�setg s
�zdefproperty.<locals>.setr )�getattrr# �setattr)�klassr- r �getr. Zpropr r r
r e s )
�__all__Zxml.domr �strr �listr �tupler r r r r r
�<module>+ s
U
e5ds0 � @ s� d dl Z d dlZd dlZd dlmZ dddgZG dd� d�ZG dd� d�Zd d
� Z G d d� de
�Z G d d� de
�Z G d
d� d�Z
[G dd� d�ZG dd� d�ZdS )� N)�
NodeFilter�
DOMBuilder�DOMEntityResolver�DOMInputSourcec @ sX e Zd ZdZdZdZdZdZdZdZ dZ
dZ dZ dZ
dZdZdZdZdZdZdZdZdS )�Options� TFN)�__name__�
__module__� __qualname__�
namespaces�namespace_declarations�
validation�external_parameter_entities�external_general_entitiesZexternal_dtd_subset�validate_if_schemaZvalidate�datatype_normalization�create_entity_ref_nodes�entities� whitespace_in_element_content�cdata_sections�comments� charset_overrides_xml_encoding�infoset�supported_mediatypes_only� errorHandler�filter� r r �*/usr/lib64/python3.8/xml/dom/xmlbuilder.pyr
s&
r c @ s& e Zd ZdZdZdZdZdZdZdZ eeee fZ
dd� Z dd � Z d
d � Z
d d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdgdgd gd gd gd gd gd!gd"gd#gd"d$gd%gd&gd'gd(gd)gd*gd+gd,gd-gg dd!d"d$d(d.d'd+d-g d/gd0gd1gd2�Zd3d4� Zd5d6� Zd7d8� Zd9d:� Zd;d<� ZdS )=r Nr � � � c C s t � | _d S �N)r �_options��selfr r r �__init__: s zDOMBuilder.__init__c C s | j S r! ��entityResolverr# r r r �_get_entityResolver= s z DOMBuilder._get_entityResolverc C s
|| _ d S r! r& )r$ r' r r r �_set_entityResolver? s z DOMBuilder._set_entityResolverc C s | j S r! �r r# r r r �_get_errorHandlerB s z DOMBuilder._get_errorHandlerc C s
|| _ d S r! r* )r$ r r r r �_set_errorHandlerD s z DOMBuilder._set_errorHandlerc C s | j S r! �r r# r r r � _get_filterG s zDOMBuilder._get_filterc C s
|| _ d S r! r- )r$ r r r r � _set_filterI s zDOMBuilder._set_filterc C s� | � |�rt|rdpd}z| jt|�|f }W n( tk
rT tj�d|f �d �Y q�X |D ]\}}t| j||� qZntj� dt
|� ��d S )Nr r zunsupported feature: %rzunknown feature: ) �supportsFeature� _settings� _name_xform�KeyError�xml�dom�NotSupportedErr�setattrr" � NotFoundErr�repr)r$ �name�stateZsettings�valuer r r �
setFeatureL s
�� zDOMBuilder.setFeaturec C s t | jt|��S r! )�hasattrr" r2 )r$ r: r r r r0 Z s zDOMBuilder.supportsFeaturec C s t |�|rdpdf}|| jkS )Nr r )r2 r1 )r$ r: r; �keyr r r �
canSetFeature] s zDOMBuilder.canSetFeature�r r �r r �r
r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r )r r �r r �r r �r r )rA rB rC rD rE rF rG rH rI rJ rK rL rM rN rO rP rQ rR rS rT )r r )r r rU rV rW c C s� t |�}zt| j|�W S tk
r� |dkrp| j}|joj|joj|joj|joj|jph|j ph|j
ph|j ph|j Y S t
j�dt|� ��Y nX d S )Nr zfeature %s not known)r2 �getattrr" �AttributeErrorr r r r r r r r r r4 r5 r8 r9 )r$ r: Zxname�optionsr r r �
getFeature� s0 �������� zDOMBuilder.getFeaturec C s. | j r| j �d |�}nt� �d |�}| �|�S r! )r' �
resolveEntityr �parse)r$ �uri�inputr r r �parseURI� s zDOMBuilder.parseURIc C sR t � | j�}| j|_| j|_|j}|d krF|jrFdd l}|j�|j�}| � ||�S �Nr )
�copyr" r r �
byteStream�systemId�urllib.request�requestZurlopen�_parse_bytestream)r$ r_ rZ �fp�urllibr r r r] � s zDOMBuilder.parsec C s || j krtd��td��d S )Nznot a legal actionzHaven't written this yet...)�_legal_actions�
ValueError�NotImplementedError)r$ r_ Zcnode�actionr r r �parseWithContext� s
zDOMBuilder.parseWithContextc C s dd l }|jj�|�}|�|�S ra )Zxml.dom.expatbuilderr5 Z expatbuilderZ makeBuilderZ parseFile)r$ �streamrZ r4 Zbuilderr r r rg � s z DOMBuilder._parse_bytestream)r r r
r' r r ZACTION_REPLACEZACTION_APPEND_AS_CHILDRENZACTION_INSERT_AFTERZACTION_INSERT_BEFORErj r% r( r) r+ r, r. r/ r= r0 r@ r1 r[ r` r] rn rg r r r r r - s� � ��������������������� ����=
c C s | � � �dd�S )N�-�_)�lower�replace)r: r r r r2 � s r2 c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r )�_openerc
C s� t � }||_||_| �� �|�|_| �|�|_dd l}dd l }|j
� |�}|\}}} }
} } | r�| � d�s�|�
| �d } ||| |
| | f}|j
�|�|_|S )Nr �/)r �publicIdrd � _get_opener�openrc �_guess_media_encoding�encoding� posixpathZ urllib.parser] Zurlparse�endswith�dirnameZ
urlunparse�baseURI)
r$ rv rd �sourcer{ ri �partsZschemeZnetloc�pathZparamsZqueryZfragmentr r r r\ � s z DOMEntityResolver.resolveEntityc C s2 z| j W S tk
r, | �� | _ | j Y S X d S r! )rt rY �_create_openerr# r r r rw � s
z DOMEntityResolver._get_openerc C s dd l }|j�� S ra )re rf Z build_opener)r$ ri r r r r� � s z DOMEntityResolver._create_openerc C sF |j �� }d|krB|�� D ]&}|�d�r|�dd�d �� S qd S )Nz Content-Typezcharset=�=r )rc �infoZgetplist�
startswith�splitrr )r$ r r� Zparamr r r ry � s
z'DOMEntityResolver._guess_media_encodingN)r r r
� __slots__r\ rw r� ry r r r r r � s
c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd d � Zd d � Zd S )!r �rc �characterStream�
stringDatarz rv rd r~ c C s. d | _ d | _d | _d | _d | _d | _d | _d S r! r� r# r r r r% s zDOMInputSource.__init__c C s | j S r! �rc r# r r r �_get_byteStream s z DOMInputSource._get_byteStreamc C s
|| _ d S r! r� )r$ rc r r r �_set_byteStream s z DOMInputSource._set_byteStreamc C s | j S r! �r� r# r r r �_get_characterStream s z#DOMInputSource._get_characterStreamc C s
|| _ d S r! r� )r$ r� r r r �_set_characterStream s z#DOMInputSource._set_characterStreamc C s | j S r! �r� r# r r r �_get_stringData s z DOMInputSource._get_stringDatac C s
|| _ d S r! r� )r$ �datar r r �_set_stringData s z DOMInputSource._set_stringDatac C s | j S r! �rz r# r r r �
_get_encoding s z DOMInputSource._get_encodingc C s
|| _ d S r! r� )r$ rz r r r �
_set_encoding s z DOMInputSource._set_encodingc C s | j S r! �rv r# r r r �
_get_publicId" s z DOMInputSource._get_publicIdc C s
|| _ d S r! r� )r$ rv r r r �
_set_publicId$ s z DOMInputSource._set_publicIdc C s | j S r! �rd r# r r r �
_get_systemId' s z DOMInputSource._get_systemIdc C s
|| _ d S r! r� )r$ rd r r r �
_set_systemId) s z DOMInputSource._set_systemIdc C s | j S r! �r~ r# r r r � _get_baseURI, s zDOMInputSource._get_baseURIc C s
|| _ d S r! r� �r$ r^ r r r � _set_baseURI. s zDOMInputSource._set_baseURIN)r r r
r� r% r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r s c @ s: e Zd ZdZdZdZdZejZ dd� Z
dd� Z d d
� Z d S ) �DOMBuilderFilterr r r r c C s | j S r! )�
whatToShowr# r r r �_get_whatToShowC s z DOMBuilderFilter._get_whatToShowc C s | j S r! ��
FILTER_ACCEPT�r$ Zelementr r r �
acceptNodeF s zDOMBuilderFilter.acceptNodec C s | j S r! r� r� r r r �startContainerI s z DOMBuilderFilter.startContainerN)
r r r
r� Z
FILTER_REJECTZ FILTER_SKIPZFILTER_INTERRUPTr ZSHOW_ALLr� r� r� r� r r r r r� 2 s
r� c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�
DocumentLSFc C s dS )NFr r# r r r �
_get_asyncT s zDocumentLS._get_asyncc C s |rt j�d��d S )Nz.asynchronous document loading is not supported)r4 r5 r6 )r$ �flagr r r �
_set_asyncW s �zDocumentLS._set_asyncc C s t d��d S )Nz'haven't figured out what this means yet�rl r# r r r �abort\ s �zDocumentLS.abortc C s t d��d S �Nzhaven't written this yetr� r� r r r �loadb s zDocumentLS.loadc C s t d��d S r� r� )r$ r r r r �loadXMLe s zDocumentLS.loadXMLc C s* |d kr| }n|j | k r"tj�� �|�� S r! )Z
ownerDocumentr4 r5 ZWrongDocumentErrZtoxml)r$ Zsnoder r r �saveXMLh s
zDocumentLS.saveXMLN)
r r r
Zasync_r� r� r� r� r� r� r r r r r� O s r� c @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S )
�DOMImplementationLSr r c C sF |d k rt j�d��|| jkr$t� S || jkr:t j�d��td��d S )Nz schemaType not yet supportedz'asynchronous builders are not supportedzunknown value for mode)r4 r5 r6 �MODE_SYNCHRONOUSr �MODE_ASYNCHRONOUSrk )r$ �modeZ
schemaTyper r r �createDOMBuildert s �
�z$DOMImplementationLS.createDOMBuilderc C s t d��d S )Nz-the writer interface hasn't been written yet!r� r# r r r �createDOMWriter s �z#DOMImplementationLS.createDOMWriterc C s t � S r! )r r# r r r �createDOMInputSource� s z(DOMImplementationLS.createDOMInputSourceN)r r r
r� r� r� r� r� r r r r r� p s
r� )rb �warningsZxml.domr4 Zxml.dom.NodeFilterr �__all__r r r2 �objectr r r� r� r� r r r r �<module> s
%,1!U
e5ds0 � @ s� d Z ddlZddlZddlZddlmZ dddgZG dd� d�ZG d d� d�Z d
d � Z
G d d� de �Z G d
d� de �Z
G dd� d�Z[G dd� d�ZG dd� d�ZdS )z4Implementation of the DOM Level 3 'LS-Load' feature.� N)�
NodeFilter�
DOMBuilder�DOMEntityResolver�DOMInputSourcec @ s\ e Zd ZdZdZdZdZdZdZdZ dZ
dZ dZ dZ
dZdZdZdZdZdZdZdZdZdS )�Optionsz�Features object that has variables set for each DOMBuilder feature.
The DOMBuilder class uses an instance of this class to pass settings to
the ExpatBuilder class.
� TFN)�__name__�
__module__� __qualname__�__doc__�
namespaces�namespace_declarations�
validation�external_parameter_entities�external_general_entitiesZexternal_dtd_subset�validate_if_schemaZvalidate�datatype_normalization�create_entity_ref_nodes�entities� whitespace_in_element_content�cdata_sections�comments� charset_overrides_xml_encoding�infoset�supported_mediatypes_only� errorHandler�filter� r r �*/usr/lib64/python3.8/xml/dom/xmlbuilder.pyr
s( r c @ s& e Zd ZdZdZdZdZdZdZdZ eeee fZ
dd� Z dd � Z d
d � Z
d d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdgdgd gd gd gd gd gd!gd"gd#gd"d$gd%gd&gd'gd(gd)gd*gd+gd,gd-gg dd!d"d$d(d.d'd+d-g d/gd0gd1gd2�Zd3d4� Zd5d6� Zd7d8� Zd9d:� Zd;d<� ZdS )=r Nr � � � c C s t � | _d S �N)r �_options��selfr r r �__init__: s zDOMBuilder.__init__c C s | j S r" ��entityResolverr$ r r r �_get_entityResolver= s z DOMBuilder._get_entityResolverc C s
|| _ d S r" r' )r% r( r r r �_set_entityResolver? s z DOMBuilder._set_entityResolverc C s | j S r" �r r$ r r r �_get_errorHandlerB s z DOMBuilder._get_errorHandlerc C s
|| _ d S r" r+ )r% r r r r �_set_errorHandlerD s z DOMBuilder._set_errorHandlerc C s | j S r" �r r$ r r r � _get_filterG s zDOMBuilder._get_filterc C s
|| _ d S r" r. )r% r r r r � _set_filterI s zDOMBuilder._set_filterc C s� | � |�rt|rdpd}z| jt|�|f }W n( tk
rT tj�d|f �d �Y q�X |D ]\}}t| j||� qZntj� dt
|� ��d S )Nr r zunsupported feature: %rzunknown feature: ) �supportsFeature� _settings� _name_xform�KeyError�xml�dom�NotSupportedErr�setattrr# � NotFoundErr�repr)r% �name�stateZsettings�valuer r r �
setFeatureL s
�� zDOMBuilder.setFeaturec C s t | jt|��S r" )�hasattrr# r3 )r% r; r r r r1 Z s zDOMBuilder.supportsFeaturec C s t |�|rdpdf}|| jkS )Nr r )r3 r2 )r% r; r< �keyr r r �
canSetFeature] s zDOMBuilder.canSetFeature�r
r �r
r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r �r r )r r �r r �r r �r r )rB rC rD rE rF rG rH rI rJ rK rL rM rN rO rP rQ rR rS rT rU )r r )r r rV rW rX c C s� t |�}zt| j|�W S tk
r� |dkrp| j}|joj|joj|joj|joj|jph|j ph|j
ph|j ph|j Y S t
j�dt|� ��Y nX d S )Nr zfeature %s not known)r3 �getattrr# �AttributeErrorr r r r r
r r r r r5 r6 r9 r: )r% r; Zxname�optionsr r r �
getFeature� s0 �������� zDOMBuilder.getFeaturec C s. | j r| j �d |�}nt� �d |�}| �|�S r" )r( �
resolveEntityr �parse)r% �uri�inputr r r �parseURI� s zDOMBuilder.parseURIc C sR t � | j�}| j|_| j|_|j}|d krF|jrFdd l}|j�|j�}| � ||�S �Nr )
�copyr# r r �
byteStream�systemId�urllib.request�requestZurlopen�_parse_bytestream)r% r` r[ �fp�urllibr r r r^ � s zDOMBuilder.parsec C s || j krtd��td��d S )Nznot a legal actionzHaven't written this yet...)�_legal_actions�
ValueError�NotImplementedError)r% r` Zcnode�actionr r r �parseWithContext� s
zDOMBuilder.parseWithContextc C s dd l }|jj�|�}|�|�S rb )Zxml.dom.expatbuilderr6 Z expatbuilderZ makeBuilderZ parseFile)r% �streamr[ r5 Zbuilderr r r rh � s z DOMBuilder._parse_bytestream)r r r
r( r r ZACTION_REPLACEZACTION_APPEND_AS_CHILDRENZACTION_INSERT_AFTERZACTION_INSERT_BEFORErk r& r) r* r, r- r/ r0 r> r1 rA r2 r\ ra r^ ro rh r r r r r - s� � ��������������������� ����=
c C s | � � �dd�S )N�-�_)�lower�replace)r; r r r r3 � s r3 c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r )�_openerc
C s� |d k s t �t� }||_||_| �� �|�|_| �|�|_dd l }dd l
}|j � |�}|\}}} }
} } | r�| �
d�s�|�| �d } ||| |
| | f}|j �|�|_|S )Nr �/)�AssertionErrorr �publicIdre � _get_opener�openrd �_guess_media_encoding�encoding� posixpathZ urllib.parser^ Zurlparse�endswith�dirnameZ
urlunparse�baseURI)
r% rx re �sourcer} rj �partsZschemeZnetloc�pathZparamsZqueryZfragmentr r r r] � s z DOMEntityResolver.resolveEntityc C s2 z| j W S tk
r, | �� | _ | j Y S X d S r" )ru rZ �_create_openerr$ r r r ry � s
z DOMEntityResolver._get_openerc C s dd l }|j�� S rb )rf rg Z build_opener)r% rj r r r r� � s z DOMEntityResolver._create_openerc C sF |j �� }d|krB|�� D ]&}|�d�r|�dd�d �� S qd S )Nz Content-Typezcharset=�=r )rd �infoZgetplist�
startswith�splitrs )r% r� r� Zparamr r r r{ � s
z'DOMEntityResolver._guess_media_encodingN)r r r
� __slots__r] ry r� r{ r r r r r � s
c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd d � Zd d � Zd S )!r �rd �characterStream�
stringDatar| rx re r� c C s. d | _ d | _d | _d | _d | _d | _d | _d S r" r� r$ r r r r& s zDOMInputSource.__init__c C s | j S r" �rd r$ r r r �_get_byteStream s z DOMInputSource._get_byteStreamc C s
|| _ d S r" r� )r% rd r r r �_set_byteStream s z DOMInputSource._set_byteStreamc C s | j S r" �r� r$ r r r �_get_characterStream s z#DOMInputSource._get_characterStreamc C s
|| _ d S r" r� )r% r� r r r �_set_characterStream s z#DOMInputSource._set_characterStreamc C s | j S r" �r� r$ r r r �_get_stringData s z DOMInputSource._get_stringDatac C s
|| _ d S r" r� )r% �datar r r �_set_stringData s z DOMInputSource._set_stringDatac C s | j S r" �r| r$ r r r �
_get_encoding s z DOMInputSource._get_encodingc C s
|| _ d S r" r� )r% r| r r r �
_set_encoding s z DOMInputSource._set_encodingc C s | j S r" �rx r$ r r r �
_get_publicId" s z DOMInputSource._get_publicIdc C s
|| _ d S r" r� )r% rx r r r �
_set_publicId$ s z DOMInputSource._set_publicIdc C s | j S r" �re r$ r r r �
_get_systemId' s z DOMInputSource._get_systemIdc C s
|| _ d S r" r� )r% re r r r �
_set_systemId) s z DOMInputSource._set_systemIdc C s | j S r" �r� r$ r r r � _get_baseURI, s zDOMInputSource._get_baseURIc C s
|| _ d S r" r� �r% r_ r r r � _set_baseURI. s zDOMInputSource._set_baseURIN)r r r
r� r& r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r s c @ s> e Zd ZdZdZdZdZdZej Z
dd� Z dd � Z d
d � Z
d S )
�DOMBuilderFilterzSElement filter which can be used to tailor construction of
a DOM instance.
r r r r! c C s | j S r" )�
whatToShowr$ r r r �_get_whatToShowC s z DOMBuilderFilter._get_whatToShowc C s | j S r" ��
FILTER_ACCEPT�r% Zelementr r r �
acceptNodeF s zDOMBuilderFilter.acceptNodec C s | j S r" r� r� r r r �startContainerI s z DOMBuilderFilter.startContainerN)r r r
r r� Z
FILTER_REJECTZ FILTER_SKIPZFILTER_INTERRUPTr ZSHOW_ALLr� r� r� r� r r r r r� 2 s r� c @ sD e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dS )�
DocumentLSz=Mixin to create documents that conform to the load/save spec.Fc C s dS )NFr r$ r r r �
_get_asyncT s zDocumentLS._get_asyncc C s |rt j�d��d S )Nz.asynchronous document loading is not supported)r5 r6 r7 )r% �flagr r r �
_set_asyncW s �zDocumentLS._set_asyncc C s t d��d S )Nz'haven't figured out what this means yet�rm r$ r r r �abort\ s �zDocumentLS.abortc C s t d��d S �Nzhaven't written this yetr� r� r r r �loadb s zDocumentLS.loadc C s t d��d S r� r� )r% r� r r r �loadXMLe s zDocumentLS.loadXMLc C s* |d kr| }n|j | k r"tj�� �|�� S r" )Z
ownerDocumentr5 r6 ZWrongDocumentErrZtoxml)r% Zsnoder r r �saveXMLh s
zDocumentLS.saveXMLN) r r r
r Zasync_r� r� r� r� r� r� r r r r r� O s r� c @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S )
�DOMImplementationLSr r c C sF |d k rt j�d��|| jkr$t� S || jkr:t j�d��td��d S )Nz schemaType not yet supportedz'asynchronous builders are not supportedzunknown value for mode)r5 r6 r7 �MODE_SYNCHRONOUSr �MODE_ASYNCHRONOUSrl )r% �modeZ
schemaTyper r r �createDOMBuildert s �
�z$DOMImplementationLS.createDOMBuilderc C s t d��d S )Nz-the writer interface hasn't been written yet!r� r$ r r r �createDOMWriter s �z#DOMImplementationLS.createDOMWriterc C s t � S r" )r r$ r r r �createDOMInputSource� s z(DOMImplementationLS.createDOMInputSourceN)r r r
r� r� r� r� r� r r r r r� p s
r� )r rc �warningsZxml.domr5 Zxml.dom.NodeFilterr �__all__r r r3 �objectr r r� r� r� r r r r �<module> s
%,1!U
e5d�. � @ s� d dl Zd dlZdZdZdZdZdZdZdZ d Z
G d
d � d ej j �Z
G d d
� d
�ZG dd� d�ZG dd� de
�ZdZddd�Zddd�ZdS )� N�
START_ELEMENT� END_ELEMENT�COMMENT�START_DOCUMENT� END_DOCUMENT�PROCESSING_INSTRUCTION�IGNORABLE_WHITESPACE�
CHARACTERSc @ s� e Zd ZdZdZd$dd�Zdd� Zdd� Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� ZdS )%�PullDOMNc C sz ddl m} || _d d g| _| j| _g | _| jj| _z| jj| _W n t k
rV Y nX |dig| _
| j
d | _ g | _ d S )Nr )�
XML_NAMESPACE�xml���)
Zxml.domr �documentFactory�
firstEvent� lastEvent� elementStack�append�push�pop�AttributeError� _ns_contexts�_current_context�pending_events)�selfr r � r �'/usr/lib64/python3.8/xml/dom/pulldom.py�__init__ s
zPullDOM.__init__c C s | j d }| j d= |S �Nr
)r )r �resultr r r r ! s
z PullDOM.popc C s
|| _ d S �N)�_locator)r Zlocatorr r r �setDocumentLocator& s zPullDOM.setDocumentLocatorc C sH t | d�sg | _| j�|p d|f� | j�| j�� � |p<d | j|< d S )N� _xmlns_attrs�xmlns)�hasattrr" r r r �copy)r �prefix�urir r r �startPrefixMapping) s
zPullDOM.startPrefixMappingc C s | j �� | _d S r )r r r )r r& r r r �endPrefixMapping0 s zPullDOM.endPrefixMappingc C s� d}t | dd �}|d k r:|D ]\}}||j||f< q g | _|\}} |r�|d krn| j| }
|
rj|
d | }n| }| jr�| j�||�} q�| �||�} n | jr�| j�| �} n | �d | �} |�� D ]�\}}|\} }
| |k�r|
dkr�|
}nd|
}| j� | |�}| �
|� nX| �rF| j| }
|
�r(|
d |
}n|
}| j� | |�}| �
|� n| j� |
�}| � |� ||_
q�t| fd g| jd< | jd | _| �| � d S )Nz http://www.w3.org/2000/xmlns/r" �:r# zxmlns:� )�getattr�_attrsr" r �documentZcreateElementNS�
buildDocument�
createElement�itemsZcreateAttributeNSZsetAttributeNodeNS�createAttribute�setAttributeNode�valuer r r )r �name�tagName�attrsZ xmlns_uriZ xmlns_attrs�anamer4 r' Z localnamer& �nodeZa_uriZ a_localnameZqname�attrr r r �startElementNS3 sP
zPullDOM.startElementNSc C s& t | �� fd g| jd< | jd | _d S �Nr+ �r r r )r r5 r6 r r r � endElementNSl s zPullDOM.endElementNSc C sz | j r| j �|�}n | �d |�}|�� D ]$\}}| j �|�}||_|�|� q(t|fd g| jd< | jd | _| � |� d S r< )
r. r0 r/ r1 r2 r4 r3 r r r )r r5 r7 r9 r8 r4 r: r r r � startElementp s zPullDOM.startElementc C s& t | �� fd g| jd< | jd | _d S r< r= )r r5 r r r �
endElement s zPullDOM.endElementc C sN | j r2| j �|�}t|fd g| jd< | jd | _nt|fd g}| j�|� d S r< )r. �
createCommentr r r r )r �sr9 �eventr r r �comment� s zPullDOM.commentc C sR | j r4| j �||�}t|fd g| jd< | jd | _nt||fd g}| j�|� d S r< )r. �createProcessingInstructionr r r r )r �target�datar9 rC r r r �processingInstruction� s z PullDOM.processingInstructionc C s. | j �|�}t|fd g| jd< | jd | _d S r< )r. �createTextNoder r �r �charsr9 r r r �ignorableWhitespace� s zPullDOM.ignorableWhitespacec C s. | j �|�}t|fd g| jd< | jd | _d S r< )r. rI r r rJ r r r �
characters� s zPullDOM.charactersc C s$ | j d kr dd l}|jjjj| _ d S )Nr )r Zxml.dom.minidomZdomZminidomZDocument�implementation)r r r r r �
startDocument� s
zPullDOM.startDocumentc C s� | j �||d �}|| _t|fd g| jd< | jd | _| �|� | jD ]�}|d d tkr�|d \}}}| j�||�}t|f|d< nD|d d t kr�| j�
|d d �}t |f|d< nt d|d d ��|| jd< || _qDd | _|j S )Nr+ r zUnknown pending event )
r ZcreateDocumentr. r r r r r rE r rA �AssertionErrorZ
firstChild) r r' Ztagnamer9 �e�_rF rG �nr r r r/ � s$
zPullDOM.buildDocumentc C s t | jfd g| jd< | �� d S r< )r r. r r �r r r r � endDocument� s zPullDOM.endDocumentc C s
d| _ dS )z.clear(): Explicitly release parsing structuresN)r. rT r r r �clear� s z
PullDOM.clear)N)�__name__�
__module__� __qualname__r r. r r r! r( r) r; r> r? r@ rD rH rL rM rO r/ rU rV r r r r r
s&
9 r
c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� ErrorHandlerc C s t |� d S r )�print�r Z exceptionr r r �warning� s zErrorHandler.warningc C s |�d S r r r\ r r r �error� s zErrorHandler.errorc C s |�d S r r r\ r r r �
fatalError� s zErrorHandler.fatalErrorN)rW rX rY r] r^ r_ r r r r rZ � s rZ c @ s\ e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )�DOMEventStreamc C s2 || _ || _|| _t| jd�s&| j| _| �� d S )N�feed)�stream�parser�bufsizer$ �_slurp�getEvent�reset)r rb rc rd r r r r � s zDOMEventStream.__init__c C s. t � | _| j�tjjjd� | j�| j� d S r< ) r
�pulldomrc Z
setFeaturer �saxZhandlerZfeature_namespacesZsetContentHandlerrT r r r rg � s zDOMEventStream.resetc C s0 dd l }|jdtdd� | �� }|r(|S t�d S )Nr z[DOMEventStream's __getitem__ method ignores 'pos' parameter. Use iterator protocol instead.� )�
stacklevel)�warnings�warn�DeprecationWarningrf �
IndexError)r �posrl �rcr r r � __getitem__� s �zDOMEventStream.__getitem__c C s | � � }|r|S t�d S r )rf �
StopIteration�r rq r r r �__next__� s zDOMEventStream.__next__c C s | S r r rT r r r �__iter__� s zDOMEventStream.__iter__c C sl | � � }|g}|rh|\}}||kr&d S |tkr<|d �|� |tkrP|�|� n|tkr^|d= | � � }qd S r )rf r � appendChildr r )r r9 rC �parents�tokenZcur_noder r r �
expandNode� s zDOMEventStream.expandNodec C s~ | j jd s| j j| j _| j jd sR| j�| j�}|sD| j�� d S | j�|� q| j jd d }| j jd d | j jd< |S )Nr+ r ) rh r r rb �readrd rc �closera )r �bufrq r r r rf s
zDOMEventStream.getEventc C s | j �| j� | j| _| �� S )z� Fallback replacement for getEvent() using the
standard SAX2 interface, which means we slurp the
SAX events into memory (no performance gain, but
we are compatible to all SAX parsers).
)rc �parserb �_emitrf rT r r r re s zDOMEventStream._slurpc C s, | j jd d }| j jd d | j jd< |S )zn Fallback replacement for getEvent() that emits
the events that _slurp() read previously.
r+ r )rh r rt r r r r s zDOMEventStream._emitc C s | j �� | ` d| _d| _dS )z+clear(): Explicitly release parsing objectsN)rh rV rc rb rT r r r rV ! s
zDOMEventStream.clearN)
rW rX rY r rg rr ru rv rz rf re r rV r r r r r` � s
r` c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �SAX2DOMc C s2 t �| |||� | jd }| jd }|�|� d S �Nr
���)r
r; r rw )r r5 r6 r7 �curNode�
parentNoder r r r; * s
zSAX2DOM.startElementNSc C s0 t �| ||� | jd }| jd }|�|� d S r� )r
r? r rw )r r5 r7 r� r� r r r r? 0 s
zSAX2DOM.startElementc C s4 t �| ||� | jd d }| jd }|�|� d S �Nr r+ r
)r
rH r r rw )r rF rG r9 r� r r r rH 6 s
z SAX2DOM.processingInstructionc C s2 t �| |� | jd d }| jd }|�|� d S r� )r
rL r r rw �r rK r9 r� r r r rL < s
zSAX2DOM.ignorableWhitespacec C s2 t �| |� | jd d }| jd }|�|� d S r� )r
rM r r rw r� r r r rM B s
zSAX2DOM.charactersN)rW rX rY r; r? rH rL rM r r r r r� ( s
r� i�? c C s@ |d kr t }t| t�r"t| d�}n| }|s4tj�� }t|||�S )N�rb)�default_bufsize�
isinstance�str�openr ri � make_parserr` )Zstream_or_stringrc rd rb r r r r~ K s
r~ c C s6 ddl m} t| �}|| �}|s*tj�� }t|||�S )Nr )�StringIO)�ior� �lenr ri r� r` )�stringrc r� rd r} r r r � parseStringV s
r� )NN)N)Zxml.saxr Zxml.sax.handlerr r r r r r r r ri ZContentHandlerr
rZ r` r� r� r~ r� r r r r �<module> s" 8\!
U
e5d� � @ s G d d� d�Z dS )c @ sX e Zd ZdZdZdZdZdZdZdZ dZ
dZ dZ d Z
d
Zd Zd Zd
ZdZdZdd� ZdS )�
NodeFilterzL
This is the DOM2 NodeFilter interface. It contains only constants.
� � � l �� � � � � �@ � � i i i c C s t �d S )N)�NotImplementedError)�selfZnode� r �*/usr/lib64/python3.8/xml/dom/NodeFilter.py�
acceptNode s zNodeFilter.acceptNodeN)�__name__�
__module__� __qualname__�__doc__Z
FILTER_ACCEPTZ
FILTER_REJECTZ FILTER_SKIPZSHOW_ALLZ SHOW_ELEMENTZSHOW_ATTRIBUTEZ SHOW_TEXTZSHOW_CDATA_SECTIONZSHOW_ENTITY_REFERENCEZ SHOW_ENTITYZSHOW_PROCESSING_INSTRUCTIONZ SHOW_COMMENTZ
SHOW_DOCUMENTZSHOW_DOCUMENT_TYPEZSHOW_DOCUMENT_FRAGMENTZ
SHOW_NOTATIONr r r r r r s$ r N)r r r r r �<module> � U
e5d) � @ s� d dl Z d dlZd dlmZmZmZmZ d dlT d dlm Z m
Z
ej j j
ej j jfZG dd� dej j �Z ee ddd � ee d
d d � ee d d
d � dd� Zdd� Zdd� Zdd� Zdd� ZG dd� de �ZG dd� de �Zeed d d � eed d d � eed d d � G d!d"� d"e�Zeed#d$d � eZG d%d&� d&e�Zedd�Z G d'd(� d(e �Z ee d)d*d � ee d d+d � d,d-� Z G d.d/� d/�Z G d0d1� d1e e �Z G d2d3� d3e e �Z!ee!d#d4d � G d5d6� d6e!�Z"ee"d7d8d � ee"d9d:d � d;d<� Z#d=d>� Z$G d?d@� d@e!�Z%G dAdB� dBe"�Z&G dCdD� dDe�Z'ee'd#dEd � G dFdG� dG�Z(G dHdI� dIe(e e �Z)G dJdK� dKe(e �Z*G dLdM� dMe(e e �Z+G dNdO� dOe �Z,G dPdQ� dQe�Z-dRdS� Z.G dTdU� dUe e
�Z/ee/dVdWd � dXdY� Z0dZd[� Z1d\d]� Z2ddd^d_�Z3ded`da�Z4dfdbdc�Z5dS )g� N)�EMPTY_NAMESPACE� EMPTY_PREFIX�XMLNS_NAMESPACE�domreg)�*)�DOMImplementationLS�
DocumentLSc @ s� e Zd ZdZdZdZdZdZeZ dd� Z
d2dd�Z d3dd �Z d
d � Z
d d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Z d*d+� Z d,d-� Z d.d/� Z d0d1� Z dS )4�NodeNc C s dS )NT� ��selfr
r
�'/usr/lib64/python3.8/xml/dom/minidom.py�__bool__+ s z
Node.__bool__c C s | � dd|�S �N� )� toprettyxml)r �encodingr
r
r
�toxml. s z
Node.toxml� �
c C sx |d krt �� }nt jt �� |ddd�}| jtjkrH| �|d|||� n| �|d||� |d krh|�� S |� � �� S d S )N�xmlcharrefreplacer )r �errors�newliner )
�io�StringIO�
TextIOWrapper�BytesIO�nodeTyper �
DOCUMENT_NODE�writexml�getvalue�detach)r �indent�newlr �writerr
r
r
r 1 s
� zNode.toprettyxmlc C s
t | j�S �N)�bool�
childNodesr r
r
r
�
hasChildNodesC s zNode.hasChildNodesc C s | j S r% �r' r r
r
r
�_get_childNodesF s zNode._get_childNodesc C s | j r| j d S d S �Nr r) r r
r
r
�_get_firstChildI s zNode._get_firstChildc C s | j r| j d S d S �N���r) r r
r
r
�_get_lastChildM s zNode._get_lastChildc C s
|j | jkr,t|j�D ]}| �||� q|S |j | jkrTtj�dt |�t | �f ��|j
d k rj|j
� |� |d kr~| � |� n�z| j�
|�}W n tk
r� tj�� �Y nX |j tkr�t| � | j�||� ||_||_|r�| j|d }||_||_nd |_| |_
|S )N�%s cannot be child of %s� )r �DOCUMENT_FRAGMENT_NODE�tupler' � insertBefore�_child_node_types�xml�dom�HierarchyRequestErr�repr�
parentNode� removeChild� appendChild�index�
ValueError� NotFoundErr�_nodeTypes_with_children�_clear_id_cache�insert� nextSibling�previousSibling)r �newChild�refChild�cr= �noder
r
r
r4 Q s8 �
zNode.insertBeforec C s� |j | jkr*t|j�D ]}| �|� q|S |j | jkrTtj�dt |�t | �f ��n|j t
krft | � |j d k r||j �
|� t| |� d |_|S �Nr0 )r r2 r3 r' r< r5 r6 r7 r8 r9 r@ rA r: r; �
_append_childrC )r rH rG r
r
r
r< q s �
zNode.appendChildc C s |j | jkr(|j}| �|� | �||�S |j | jkrPtj�dt |�t | �f ��||kr\d S |j
d k rr|j
�|� z| j � |�}W n t
k
r� tj�� �Y nX || j |< | |_
d |_
|j tks�|j tkr�t| � |j|_|j|_d |_d |_|jr�||j_|j�r||j_|S rI )r r2 rC r; r4 r5 r6 r7 r8 r9 r: r' r= r> r? r@ rA rD )r rE �oldChildrF r= r
r
r
� replaceChild� s@
�
�zNode.replaceChildc C s� z| j �|� W n tk
r. tj�� �Y nX |jd k rD|j|j_|jd k rX|j|j_d |_|_|jt krvt
| � d |_ |S r% ) r' �remover> r6 r7 r? rC rD r r@ rA r: �r rK r
r
r
r; � s
zNode.removeChildc C s� g }| j D ]�}|jtjkr�|jsJ|r0|j|d _|jr@|j|j_|�� q�|r�|d j|jkr�|d }|j|j |_|j|_|jr�||j_|�� q�|�|� q
|�|� |jtj kr
|�
� q
|| j d d �< d S r- ) r' r r � TEXT_NODE�datarC rD �unlink�append� ELEMENT_NODE� normalize)r �L�childrH r
r
r
rT � s*
zNode.normalizec C s t | || jp| �S r% )� _clone_node�
ownerDocument)r �deepr
r
r
� cloneNode� s zNode.cloneNodec C s | j j�||�S r% )rX �implementation�
hasFeature�r �feature�versionr
r
r
� isSupported� s zNode.isSupportedc C s d S r% r
r r
r
r
�_get_localName� s zNode._get_localNamec C s | |kS r% r
�r �otherr
r
r
�
isSameNode� s zNode.isSameNodec C s | � |d �r| S d S d S r% )r` �r r^ r
r
r
� getInterface� s zNode.getInterfacec C s0 z| j | d W S ttfk
r* Y d S X d S r+ )�
_user_data�AttributeError�KeyError�r �keyr
r
r
� getUserData� s zNode.getUserDatac C sn d }z
| j }W n tk
r, i }|| _ Y nX ||krB|| d }|d kr^d }|d k rj||= n ||f||< |S r+ )rg rh )r rk rP �handler�old�dr
r
r
� setUserData� s
zNode.setUserDatac C sD t | d�r@t| j�� �D ]&\}\}}|d k r|�|||||� qd S )Nrg )�hasattr�listrg �itemsZhandle)r � operation�srcZdstrk rP rm r
r
r
�_call_user_data_handler� s
z Node._call_user_data_handlerc C s> d | _ | _| jr.| jD ] }|�� qt� | _d | _d | _d S r% )r: rX r' rQ �NodeListrD rC )r rV r
r
r
rQ s
z Node.unlinkc C s | S r% r
r r
r
r
� __enter__ s zNode.__enter__c C s | � � d S r% )rQ )r ZetZev�tbr
r
r
�__exit__ s z
Node.__exit__)N)r r N)!�__name__�
__module__� __qualname__� namespaceURIr: rX rC rD r �prefixr r r r( r* r, r/ r4 r< rL r; rT rZ r` ra rd rf rl rp rv rQ rx rz r
r
r
r
r " s:
r �
firstChildzFirst child node, or None.)�doc� lastChildzLast child node, or None.� localNamez"Namespace-local name of this node.c C s2 | j }|r |d }||_||_|�|� | |_d S r- )r' rD rC rR r: )r rH r' Zlastr
r
r
rJ s
rJ c C s$ | d k r | j tjkrdS | j} q dS �NTF)r r r r: �rH r
r
r
� _in_document& s
r� c C s6 |r2|� dd�� dd�� dd�� dd�}| �|� d S ) N�&z&�<z<�"z"�>z>)�replace�write)r$ rP r
r
r
� _write_data. s � �r� c C sD | j D ]8}|jtjkr2|dks(|j|kr2|�|� t|||� q|S �Nr )r' r r rS �tagNamerR � _get_elements_by_tagName_helper)�parent�name�rcrH r
r
r
r� 5 s
��
r� c C sX | j D ]L}|jtjkr|dks(|j|krD|dks:|j|krD|�|� t||||� q|S r� )r' r r rS r� r~ rR �"_get_elements_by_tagName_ns_helper)r� ZnsURIr� r� rH r
r
r
r� = s
��
r� c @ sJ e Zd ZejZdZdZdZdZ ej
ej ej ej
ejejejfZdd� ZdS )�DocumentFragmentz#document-fragmentNc C s t � | _d S r% )rw r' r r
r
r
�__init__T s zDocumentFragment.__init__)r{ r| r} r r2 r �nodeName� nodeValue�
attributesr: rS rO �CDATA_SECTION_NODE�ENTITY_REFERENCE_NODE�PROCESSING_INSTRUCTION_NODE� COMMENT_NODE�
NOTATION_NODEr5 r� r
r
r
r
r� F s �r� c @ s� e Zd ZdZejZdZdZdZ ej
ej fZ e
ddfdd�Zdd� Zdd � Zd
d � Zd d
� Zeee� ZZdd� Zdd� Zeee� ZZdd� Zdd� Zeee�Z dd� Z dd� Z dd� Z dS ) �Attr)�_name�_valuer~ �_prefixr' �
_localNamerX � ownerElementNFc C s2 d | _ || _|| _|| _t� | _| j�t� � d S r% )r� r� r~ r� rw r' rR �Text)r �qNamer~ r� r r
r
r
r� b s z
Attr.__init__c C s4 z| j W S tk
r. | j�dd�d Y S X d S �N�:r1 r. )r� rh r� �splitr r
r
r
ra o s zAttr._get_localNamec C s | j S r% )� specifiedr r
r
r
�_get_specifiedu s zAttr._get_specifiedc C s | j S r% )r� r r
r
r
� _get_namex s zAttr._get_namec C s || _ | jd k rt| j� d S r% )r� r� rA �r �valuer
r
r
� _set_name{ s
zAttr._set_namec C s | j S r% )r� r r
r
r
�
_get_value� s zAttr._get_valuec C s6 || _ || jd _| jd k r&t| j� || jd _d S r+ )r� r' rP r� rA r� r
r
r
�
_set_value� s
zAttr._set_valuec C s | j S r% )r� r r
r
r
� _get_prefix� s zAttr._get_prefixc C sd | j }|dkr&|r&|tkr&tj�d��|| _|d kr<| j}nd|| jf }| jrZt| j� || _ d S )N�xmlnsz5illegal use of 'xmlns' prefix for the wrong namespacez%s:%s)
r~ r r6 r7 � NamespaceErrr� r� r� rA r� )r r ZnsuriZnewNamer
r
r
� _set_prefix� s �
zAttr._set_prefixc C sv | j }|d k rR|j| j= |j| j| jf= | jrRd| _| jd8 _| j j d8 _ | j
D ] }|� � qX| j
d d �= d S )NFr1 ) r� �_attrsr� �_attrsNSr~ r� �_is_id�_magic_id_nodesrX �_magic_id_countr' rQ )r �elemrV r
r
r
rQ � s
z Attr.unlinkc C sf | j r
dS | j}| j}|d ks&|d kr*dS |�|�}|d kr@dS | jrV|�| j| j�S |�| j�S d S r� ) r� rX r� �_get_elem_infor~ �isIdNSr� �isIdr� �r r� r� �infor
r
r
� _get_isId� s
zAttr._get_isIdc C s\ | j }| j}|d ks |d kr tS |�|�}|d kr6tS | jrL|�| j| j�S |�| j�S d S r% ) rX r� �_no_typer� r~ �getAttributeTypeNSr� �getAttributeTyper� r� r
r
r
�_get_schemaType� s
zAttr._get_schemaType) r{ r| r} � __slots__r �ATTRIBUTE_NODEr r� r� r� rO r� r5 r r� ra r� r� r� �propertyr� r� r� r� r� r� r� r� r rQ r� r� r
r
r
r
r� X s. �
r� r� z True if this attribute is an ID.z'Namespace-local name of this attribute.�
schemaTypez Schema type for this attribute.c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z d9dd�Z
eZdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Z d3d4� Z d5d6� Z d7d8� Z dS ):� NamedNodeMap�r� r� �
_ownerElementc C s || _ || _|| _d S r% r� )r �attrsZattrsNSr� r
r
r
r� � s zNamedNodeMap.__init__c C s
t | j�S r% )�lenr� r r
r
r
� _get_length� s zNamedNodeMap._get_lengthc C s4 z| t | j�� �| W S tk
r. Y d S X d S r% )rr r� �keys�
IndexError�r r= r
r
r
�item� s zNamedNodeMap.itemc C s* g }| j �� D ]}|�|j|jf� q|S r% )r� �valuesrR r� r� �r rU rH r
r
r
rs � s zNamedNodeMap.itemsc C s0 g }| j �� D ] }|�|j|jf|jf� q|S r% )r� r� rR r~ r� r� r� r
r
r
�itemsNS� s zNamedNodeMap.itemsNSc C s" t |t�r|| jkS || jkS d S r% )�
isinstance�strr� r� rj r
r
r
� __contains__� s
zNamedNodeMap.__contains__c C s
| j �� S r% )r� r� r r
r
r
r� s zNamedNodeMap.keysc C s
| j �� S r% )r� r� r r
r
r
�keysNS s zNamedNodeMap.keysNSc C s
| j �� S r% )r� r� r r
r
r
r� s zNamedNodeMap.valuesNc C s | j �||�S r% �r� �get)r r� r� r
r
r
r�
s zNamedNodeMap.getc C s: | j t|dd �krdS t| �t|�kt| �t|�k S d S )Nr� r )r� �getattr�idrb r
r
r
�_cmp s zNamedNodeMap._cmpc C s | � |�dkS r+ �r� rb r
r
r
�__eq__ s zNamedNodeMap.__eq__c C s | � |�dkS r+ r� rb r
r
r
�__ge__ s zNamedNodeMap.__ge__c C s | � |�dkS r+ r� rb r
r
r
�__gt__ s zNamedNodeMap.__gt__c C s | � |�dkS r+ r� rb r
r
r
�__le__ s zNamedNodeMap.__le__c C s | � |�dk S r+ r� rb r
r
r
�__lt__! s zNamedNodeMap.__lt__c C s" t |t�r| j| S | j| S d S r% )r� r3 r� r� )r �attname_or_tupler
r
r
� __getitem__$ s
zNamedNodeMap.__getitem__c C sv t |t�rRz| j| }W n0 tk
rH t|�}| jj|_| �|� Y nX ||_n t |t�sdt d��|}| �|� d S )Nz%value must be a string or Attr object)
r� r� r� ri r� r� rX � setNamedItemr� � TypeError)r �attnamer� rH r
r
r
� __setitem__+ s
zNamedNodeMap.__setitem__c C s( z | j | W S tk
r" Y d S X d S r% )r� ri �r r� r
r
r
� getNamedItem: s zNamedNodeMap.getNamedItemc C s, z| j ||f W S tk
r& Y d S X d S r% )r� ri �r r~ r� r
r
r
�getNamedItemNS@ s zNamedNodeMap.getNamedItemNSc C sX | � |�}|d k rJt| j� | j|j= | j|j|jf= t|d�rFd |_ |S t
j � � �d S �Nr� )
r� rA r� r� r� r� r~ r� rq r� r6 r7 r? �r r� �nr
r
r
�removeNamedItemF s
z NamedNodeMap.removeNamedItemc C sZ | � ||�}|d k rLt| j� | j|j|jf= | j|j= t|d�rHd |_ |S t
j � � �d S r� )
r� rA r� r� r~ r� r� r� rq r� r6 r7 r? �r r~ r� r� r
r
r
�removeNamedItemNSR s
z NamedNodeMap.removeNamedItemNSc C st t |t�s&tj�dt|�t| �f ��| j�|j�}|r@|� � || j|j< || j
|j |j f< | j
|_t|j� |S rI )r� r� r6 r7 r8 r9 r� r� r� rQ r� r~ r� r� r� rA )r rH rn r
r
r
r� ^ s
�
zNamedNodeMap.setNamedItemc C s
| � |�S r% )r� �r rH r
r
r
�setNamedItemNSk s zNamedNodeMap.setNamedItemNSc C s | | }t |j� |�� d S r% )rA r� rQ )r r� rH r
r
r
� __delitem__n s
zNamedNodeMap.__delitem__c C s | j | j| jfS r% r� r r
r
r
� __getstate__s s zNamedNodeMap.__getstate__c C s |\| _ | _| _d S r% r� �r �stater
r
r
� __setstate__v s zNamedNodeMap.__setstate__)N) r{ r| r} r� r� r� r� rs r� r� r� r� r� r� �__len__r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r
r
r
r
r� � s:
r� Zlengthz$Number of nodes in the NamedNodeMap.c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) �TypeInfo�� namespacer� c C s || _ || _d S r% r� )r r r� r
r
r
r� � s zTypeInfo.__init__c C s2 | j r d| jj| j| j f S d| jj| jf S d S )Nz<%s %r (from %r)>z<%s %r>)r � __class__r{ r� r r
r
r
�__repr__� s
�zTypeInfo.__repr__c C s | j S r% )r� r r
r
r
r� � s zTypeInfo._get_namec C s | j S r% )r r r
r
r
�_get_namespace� s zTypeInfo._get_namespaceN)r{ r| r} r� r� r r� r r
r
r
r
r� s
r� c @ s e Zd ZdZejZdZeZ dZ
ejej ej ej
ejejfZeddfdd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Z dd� Z e Z d d � Z d d � Z d d!� Z!e!Z"d"d#� Z#d$d%� Z$d&d'� Z%d(d)� Z&d*d+� Z'd9d-d.�Z(d/d0� Z)d1d2� Z*d3d4� Z+d5d6� Z,d7d8� Z-dS ):�Element) rX r: r� r� r r~ r� r' r� r� rC rD Nr c C sB d | _ | | _| _|| _|| _t� | _d | _| _d | _ d | _
d S r% ) r: r� r� r r~ rw r' rC rD r� r� )r r� r~ r r� r
r
r
r� � s
zElement.__init__c C s | j d kri | _ i | _d S r% )r� r� r r
r
r
�_ensure_attributes� s
zElement._ensure_attributesc C s4 z| j W S tk
r. | j�dd�d Y S X d S r� )r� rh r� r� r r
r
r
ra � s zElement._get_localNamec C s | j S r% �r� r r
r
r
� _get_tagName� s zElement._get_tagNamec C s@ | j d k r&t| j �� �D ] }|�� qd | _ d | _t�| � d S r% )r� rr r� rQ r� r )r �attrr
r
r
rQ � s
zElement.unlinkc C s8 | j d krdS z| j | jW S tk
r2 Y dS X d S r )r� r� ri )r r� r
r
r
� getAttribute� s
zElement.getAttributec C s< | j d krdS z| j ||f jW S tk
r6 Y dS X d S r )r� r� ri r� r
r
r
�getAttributeNS� s
zElement.getAttributeNSc C sV | � |�}|d kr4t|�}||_| j|_| �|� n ||jkrR||_|jrRt| � d S r% )�getAttributeNoder� r� rX �setAttributeNoder� rA )r r� r� r r
r
r
� setAttribute� s
zElement.setAttributec C s� t |�\}}| �||�}|d krHt||||�}||_| j|_| �|� n4||jkrf||_|jrft| � |j|kr|||_||_ d S r% )
�_nssplit�getAttributeNodeNSr� r� rX r r� rA r r� )r r~ �
qualifiedNamer� r � localnamer r
r
r
�setAttributeNS� s
zElement.setAttributeNSc C s | j d krd S | j �|�S r% r� )r �attrnamer
r
r
r � s
zElement.getAttributeNodec C s | j d krd S | j �||f�S r% )r� r� r� r
r
r
r s
zElement.getAttributeNodeNSc C s� |j d | fkrtj�d��| �� | j�|jd �}|d k rD| �|� | j �|j
|j fd �}|d k rt||k rt| �|� t | |� ||k r�|S ||k r�|S d S )Nz attribute node already owned)
r� r6 r7 ZInuseAttributeErrr r� r� r� �removeAttributeNoder� r~ r� �_set_attribute_node)r r Zold1Zold2r
r
r
r s
zElement.setAttributeNodec C sP | j d krtj�� �z| j| }W n tk
r@ tj�� �Y nX | �|� d S r% )r� r6 r7 r? r� ri r )r r� r r
r
r
�removeAttribute s
zElement.removeAttributec C sT | j d krtj�� �z| j ||f }W n tk
rD tj�� �Y nX | �|� d S r% )r� r6 r7 r? ri r )r r~ r� r r
r
r
�removeAttributeNS% s
zElement.removeAttributeNSc C s^ |d krt j�� �z| j|j W n tk
r@ t j�� �Y nX t| � |�� | j|_|S r% ) r6 r7 r? r� r� ri rA rQ rX r� r
r
r
r . s
zElement.removeAttributeNodec C s | j d krdS || j kS �NF�r� r� r
r
r
� hasAttribute> s
zElement.hasAttributec C s | j d krdS ||f| j kS r )r� r� r
r
r
�hasAttributeNSC s
zElement.hasAttributeNSc C s t | |t� �S r% �r� rw r� r
r
r
�getElementsByTagNameH s z Element.getElementsByTagNamec C s t | ||t� �S r% �r� rw r� r
r
r
�getElementsByTagNameNSK s �z Element.getElementsByTagNameNSc C s d| j t| �f S )Nz<DOM Element: %s at %#x>)r� r� r r
r
r
r O s zElement.__repr__r c C s� |� |d | j � | �� }|�� D ],}|� d| � t||| j� |� d� q$| jr�|� d� t| j�dkr�| jd jt j
t j fkr�| jd � |ddd� n4|� |� | jD ]}|� ||| ||� q�|� |� |� d| j|f � n|� d | � d S )
Nr� z %s="r� r� r1 r r z</%s>%sz/>%s)
r� r� �_get_attributesr� r� r� r' r� r r rO r� r )r r$ r" � addindentr# r� Za_namerH r
r
r
r R s*
��
zElement.writexmlc C s | � � t| j| j| �S r% )r r� r� r� r r
r
r
r m s zElement._get_attributesc C s | j r
dS dS d S r� r r r
r
r
�
hasAttributesq s zElement.hasAttributesc C s | � |�}| �|� d S r% )r �setIdAttributeNode)r r� �idAttrr
r
r
�setIdAttributey s
zElement.setIdAttributec C s | � ||�}| �|� d S r% )r r# )r r~ r� r$ r
r
r
�setIdAttributeNS} s zElement.setIdAttributeNSc C sj |d ks| � |j�s tj�� �t| �d k r4tj�� �|jsfd|_| jd7 _| j j
d7 _
t | � d S )NTr1 ) rd r� r6 r7 r? �_get_containing_entref�NoModificationAllowedErrr� r� rX r� rA )r r$ r
r
r
r# � s
zElement.setIdAttributeNode)r r r ).r{ r| r} r� r rS r r� r� r� r� r� r� rO r� r� r5 r r� r ra r rQ r r
r
r r r r ZsetAttributeNodeNSr r r ZremoveAttributeNodeNSr r r r r r r r" r% r& r# r
r
r
r
r � sT ��
r r� z*NamedNodeMap of attributes on the element.z%Namespace-local name of this element.c C s8 t | � | �� || j|j< || j|j|jf< | |_d S r% )rA r r� r� r� r~ r� r� )�elementr r
r
r
r � s
r c @ sb e Zd ZdZdZe� ZdZdZdd� Z dd� Z
dd� Z d d
� Z d d � Z
d
d� Zdd� Zdd� ZdS )� Childlessr
Nc C s d S r% r
r r
r
r
r, � s zChildless._get_firstChildc C s d S r% r
r r
r
r
r/ � s zChildless._get_lastChildc C s t j�| jd ��d S )Nz nodes cannot have children�r6 r7 r8 r� r� r
r
r
r< � s �zChildless.appendChildc C s dS r r
r r
r
r
r( � s zChildless.hasChildNodesc C s t j�| jd ��d S �Nz nodes do not have childrenr+ �r rE rF r
r
r
r4 � s �zChildless.insertBeforec C s t j�| jd ��d S r, )r6 r7 r? r� rN r
r
r
r; � s �zChildless.removeChildc C s d S r% r
r r
r
r
rT � s zChildless.normalizec C s t j�| jd ��d S r, r+ �r rE rK r
r
r
rL � s �zChildless.replaceChild)r{ r| r} r� r� Z
EmptyNodeListr' r� r� r, r/ r< r( r4 r; rT rL r
r
r
r
r* � s r* c @ s\ e Zd ZejZdZdd� Zdd� Zdd� Z e
ee �Z dd � Z d
d � Z
e
e e
�Zdd
d�ZdS )�ProcessingInstruction��targetrP c C s || _ || _d S r% r0 )r r1 rP r
r
r
r� � s z ProcessingInstruction.__init__c C s | j S r% �rP r r
r
r
�_get_nodeValue� s z$ProcessingInstruction._get_nodeValuec C s
|| _ d S r% r2 r� r
r
r
�_set_nodeValue� s z$ProcessingInstruction._set_nodeValuec C s | j S r% �r1 r r
r
r
�
_get_nodeName� s z#ProcessingInstruction._get_nodeNamec C s
|| _ d S r% r5 r� r
r
r
�
_set_nodeName� s z#ProcessingInstruction._set_nodeNamer c C s |� d|| j| j|f � d S )Nz
%s<?%s %s?>%s)r� r1 rP �r r$ r" r! r# r
r
r
r � s z ProcessingInstruction.writexmlN)r r r )r{ r| r} r r� r r� r� r3 r4 r� r� r6 r7 r� r r
r
r
r
r/ � s
r/ c @ sr e Zd ZdZdd� Zdd� ZeZdd� Zdd � Ze ee� Z
Z d
d � Z d d
� Z
dd� Zdd� Zdd� Zdd� ZdS )�
CharacterData)�_datarX r: rD rC c C s, d | _ | _d | _| _d| _t�| � d S r )rX r: rD rC r: r r� r r
r
r
r� � s zCharacterData.__init__c C s
t | j�S r% )r� rP r r
r
r
r� � s zCharacterData._get_lengthc C s | j S r% �r: r r
r
r
� _get_data� s zCharacterData._get_datac C s
|| _ d S r% r; �r rP r
r
r
� _set_data� s zCharacterData._set_datac C s6 | j }t|�dkrd}nd}d| jj|dd� |f S )N�
z...r z<DOM %s node "%r%s">r )rP r� r r{ )r rP Z dotdotdotr
r
r
r � s
�zCharacterData.__repr__c C sT |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��| j||| � S �Nr �offset cannot be negative�#offset cannot be beyond end of data�count cannot be negative�r6 r7 � IndexSizeErrr� rP �r �offset�countr
r
r
�
substringData� s zCharacterData.substringDatac C s | j | | _ d S r% r2 )r �argr
r
r
�
appendData s zCharacterData.appendDatac C sZ |dk rt j�d��|t| j�kr.t j�d��|rVd| jd |� || j|d � f | _d S )Nr rA rB �%s%s%srD )r rG rJ r
r
r
�
insertData s �zCharacterData.insertDatac C sl |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��|rh| jd |� | j|| d � | _d S r@ rD rF r
r
r
�
deleteData s zCharacterData.deleteDatac C sr |dk rt j�d��|t| j�kr.t j�d��|dk rBt j�d��|rnd| jd |� || j|| d � f | _d S )Nr rA rB rC rL rD )r rG rH rJ r
r
r
� replaceData s �zCharacterData.replaceDataN)r{ r| r} r� r� r� r� r< r> r� rP r� r rI rK rM rN rO r
r
r
r
r9 � s
r9 zLength of the string data.c @ sH e Zd ZdZejZdZdZdd� Z ddd�Z
d d
� Z d d � Z d
d� Z
dS )r� r
z#textNc C s� |dk s|t | j�kr"tj�d��| �� }| j|d � |_| j|_| j}| jr~| | jj kr~|d krp| j�
|� n| j� ||� | jd |� | _|S )Nr zillegal offset value) r� rP r6 r7 rE r rX rC r: r' r< r4 )r rG ZnewText�nextr
r
r
� splitText1 s zText.splitTextr c C s t |d|| j|f � d S )NrL )r� rP r8 r
r
r
r @ s z
Text.writexmlc C s� | j g}| j}|d k rB|jtjtjfkrB|�d|j � |j}qqBq| j}|d k rz|jtjtjfkrz|�|j � |j}qHqzqHd� |�S )Nr r )
rP rD r r rO r� rB rC rR �join)r rU r� r
r
r
�_get_wholeTextE s zText._get_wholeTextc C s� | j }| j}|d k r@|jtjtjfkr@|j}|�|� |}q q@q | j}|sT|�| � |d k r�|jtjtjfkr�|j}|�|� |}qTq�qT|r�|| _| S d S d S r% ) r: rD r r rO r� r; rC rP )r Zcontentr� r� rP r
r
r
�replaceWholeTextW s*
zText.replaceWholeTextc C sF | j �� rdS t| �}|d kr"dS | j�|�}|d kr:dS |�� S d S r )rP �strip�_get_containing_elementrX r� �isElementContent)r r� r� r
r
r
�!_get_isWhitespaceInElementContents s
z&Text._get_isWhitespaceInElementContent)r r r )r{ r| r} r� r rO r r� r� rQ r rS rT rX r
r
r
r
r� * s
r� Z isWhitespaceInElementContentzKTrue iff this text node contains only whitespace and is in element content.Z wholeTextz.The text of all logically-adjacent text nodes.c C s* | j }|d k r&|jtjkr |S |j }qd S r% )r: r r rS �rH rG r
r
r
rV � s rV c C s* | j }|d k r&|jtjkr |S |j }qd S r% )r: r r r� rY r
r
r
r' � s r' c @ s( e Zd ZejZdZdd� Zddd�ZdS ) �Commentz#commentc C s t �| � || _d S r% )r9 r� r: r= r
r
r
r� � s
zComment.__init__r c C s, d| j krtd��|�d|| j |f � d S )Nz--z%'--' is not allowed in a comment nodez
%s<!--%s-->%s)rP r> r� r8 r
r
r
r � s
zComment.writexmlN)r r r ) r{ r| r} r r� r r� r� r r
r
r
r
rZ � s rZ c @ s$ e Zd ZdZejZdZddd�ZdS )� CDATASectionr
z#cdata-sectionr c C s, | j �d�dkrtd��|�d| j � d S )Nz]]>r z$']]>' not allowed in a CDATA sectionz<![CDATA[%s]]>)rP �findr> r� r8 r
r
r
r � s zCDATASection.writexmlN)r r r ) r{ r| r} r� r r� r r� r r
r
r
r
r[ � s r[ c @ sz e Zd ZdZd dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd S ) � ReadOnlySequentialNamedNodeMap��_seqr
c C s
|| _ d S r% r^ )r �seqr
r
r
r� � s z'ReadOnlySequentialNamedNodeMap.__init__c C s
t | j�S r% �r� r_ r r
r
r
r� � s z&ReadOnlySequentialNamedNodeMap.__len__c C s
t | j�S r% ra r r
r
r
r� � s z*ReadOnlySequentialNamedNodeMap._get_lengthc C s" | j D ]}|j|kr| S qd S r% )r_ r� r� r
r
r
r� � s
z+ReadOnlySequentialNamedNodeMap.getNamedItemc C s, | j D ] }|j|kr|j|kr| S qd S r% )r_ r~ r� r� r
r
r
r� � s
z-ReadOnlySequentialNamedNodeMap.getNamedItemNSc C s4 t |t�r| j|� }n
| �|�}|d kr0t|��|S r% )r� r3 r� r� ri )r Z
name_or_tuplerH r
r
r
r� � s
z*ReadOnlySequentialNamedNodeMap.__getitem__c C s4 |dk r d S z | j | W S tk
r. Y d S X d S r+ )r_ r� r� r
r
r
r� � s z#ReadOnlySequentialNamedNodeMap.itemc C s t j�d��d S �Nz"NamedNodeMap instance is read-only�r6 r7 r( r� r
r
r
r� � s �z.ReadOnlySequentialNamedNodeMap.removeNamedItemc C s t j�d��d S rb rc r� r
r
r
r� � s �z0ReadOnlySequentialNamedNodeMap.removeNamedItemNSc C s t j�d��d S rb rc r� r
r
r
r� � s �z+ReadOnlySequentialNamedNodeMap.setNamedItemc C s t j�d��d S rb rc r� r
r
r
r� � s �z-ReadOnlySequentialNamedNodeMap.setNamedItemNSc C s | j gS r% r^ r r
r
r
r� � s z+ReadOnlySequentialNamedNodeMap.__getstate__c C s |d | _ d S r+ r^ r� r
r
r
r� � s z+ReadOnlySequentialNamedNodeMap.__setstate__N)r
)r{ r| r} r� r� r� r� r� r� r� r� r� r� r� r� r� r� r
r
r
r
r] � s
r] z&Number of entries in the NamedNodeMap.c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �
Identified��publicId�systemIdc C s || _ || _d S r% re )r rf rg r
r
r
�_identified_mixin_init� s z!Identified._identified_mixin_initc C s | j S r% )rf r r
r
r
�
_get_publicId� s zIdentified._get_publicIdc C s | j S r% )rg r r
r
r
�
_get_systemId� s zIdentified._get_systemIdN)r{ r| r} r� rh ri rj r
r
r
r
rd � s rd c @ sH e Zd ZejZdZdZdZdZ dZ
dd� Z dd� Z dd� Z
d d d
�ZdS ) � DocumentTypeNc C s2 t � | _t � | _|r&t|�\}}|| _| j| _d S r% )r] �entities� notationsr r� r� )r r r r r
r
r
r�
s zDocumentType.__init__c C s | j S r% )�internalSubsetr r
r
r
�_get_internalSubset s z DocumentType._get_internalSubsetc C s� | j d kr�td �}| j|_| j|_tjjj}|r�g |j_ g |j
_ | j
j D ]2}t |j|j |j
�}|j
j �|� |�|||� qH| jj D ]N}t|j|j |j
|j�}|j|_|j|_|j|_|jj �|� |�|||� q�| �|| |� |S d S d S r% )rX rk r� r� r6 r7 �UserDataHandler� NODE_CLONEDrl r_ rm �Notationrf rg rR rv �Entity� notationName�actualEncodingr r_ )r rY �clonert r� �notation�e�entityr
r
r
rZ s0
�zDocumentType.cloneNoder c C s� |� d� |� | j� | jr8|� d|| j|| jf � n| jrR|� d|| jf � | jd k r||� d� |� | j� |� d� |� d| � d S )Nz
<!DOCTYPE z%s PUBLIC '%s'%s '%s'z%s SYSTEM '%s'z [�]r� )r� r� rf rg rn r8 r
r
r
r 0 s
�
zDocumentType.writexml)r r r )r{ r| r} r �DOCUMENT_TYPE_NODEr r� r� rf rg rn r� ro rZ r r
r
r
r
rk s rk c @ sf e Zd ZdZejZdZdZdZ dZ
dd� Z dd� Z dd� Z
dd � Zd
d � Zd d
� Zdd� Zdd� ZdS )rs Nc C s$ || _ || _t� | _| �||� d S r% )r� rt rw r' rh )r r� rf rg rw r
r
r
r� G s zEntity.__init__c C s | j S r% �ru r r
r
r
�_get_actualEncodingM s zEntity._get_actualEncodingc C s | j S r% �r r r
r
r
�
_get_encodingP s zEntity._get_encodingc C s | j S r% �r_ r r
r
r
� _get_versionS s zEntity._get_versionc C s t j�d��d S )Nz(cannot append children to an entity node�r6 r7 r8 )r rE r
r
r
r< V s �zEntity.appendChildc C s t j�d��d S )Nz+cannot insert children below an entity noder� r- r
r
r
r4 Z s �zEntity.insertBeforec C s t j�d��d S )Nz*cannot remove children from an entity noder� rN r
r
r
r; ^ s �zEntity.removeChildc C s t j�d��d S )Nz)cannot replace children of an entity noder� r. r
r
r
rL b s �zEntity.replaceChild)r{ r| r} r� r Z ENTITY_NODEr r� ru r r_ r� r} r r� r< r4 r; rL r
r
r
r
rs > s rs c @ s e Zd ZejZdZdd� ZdS )rr Nc C s || _ | �||� d S r% )r� rh )r r� rf rg r
r
r
r� j s zNotation.__init__)r{ r| r} r r� r r� r� r
r
r
r
rr f s rr c @ sH e Zd ZddddddddgZd d
� Zd d � Zd
d� Zdd� Zdd� ZdS )�DOMImplementation)�core�1.0)r� �2.0)r� N)r6 r� )r6 r� )r6 N)�ls-loadz3.0)r� Nc C s |dkr d }|� � |f| jkS r )�lower� _featuresr] r
r
r
r\ z s z DOMImplementation.hasFeaturec C s� |r|j d k rtj�d��| �� }|d ko8|d ko8|d k }|sP|rPtj�d��|r�t|�\}}|dkr||dkr|tj�d��|r�|s�tj�d��|�||�}|r�|� |� |� |� |r�| |_ |_
||_ | |_ |S )Nz(doctype object owned by another DOM treezElement with no namer6 z$http://www.w3.org/XML/1998/namespacezillegal use of 'xml' prefixz(illegal use of prefix without namespaces)
r: r6 r7 �WrongDocumentErr�_create_documentZInvalidCharacterErrr r� �createElementNSr< rX �doctyper[ ) r r~ r r� r� Zadd_root_elementr r r) r
r
r
�createDocument s> ���
� �
z DOMImplementation.createDocumentc C s t |�}||_||_|S r% )rk rf rg )r r rf rg r� r
r
r
�createDocumentType� s z$DOMImplementation.createDocumentTypec C s | � |d �r| S d S d S r% )r\ re r
r
r
rf � s z DOMImplementation.getInterfacec C s t � S r% )�Documentr r
r
r
r� � s z"DOMImplementation._create_documentN) r{ r| r} r� r\ r� r� rf r� r
r
r
r
r� o s �
-r� c @ sX e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dS )� ElementInfor c C s
|| _ d S r% r r� r
r
r
r� � s zElementInfo.__init__c C s t S r% �r� �r Zanamer
r
r
r� � s z ElementInfo.getAttributeTypec C s t S r% r� r� r
r
r
r� � s z ElementInfo.getAttributeTypeNSc C s dS r r
r r
r
r
rW � s z ElementInfo.isElementContentc C s dS r r
r r
r
r
�isEmpty� s zElementInfo.isEmptyc C s dS r r
r� r
r
r
r� � s zElementInfo.isIdc C s dS r r
r� r
r
r
r� � s zElementInfo.isIdNSc C s | j S r% r r r
r
r
r� � s zElementInfo.__getstate__c C s
|| _ d S r% r r� r
r
r
r� � s zElementInfo.__setstate__N)
r{ r| r} r� r� r� r� rW r� r� r� r� r� r
r
r
r
r� � s r� c C s> | j tjkr | j�� d | _n t| �r:| jj�� d | j_d S r% )r r r � _id_cache�clear�_id_search_stackr� rX r� r
r
r
rA � s
rA c @ sr e Zd ZdZejejejejfZ e
� Z ej Z
dZdZdZdZd ZZdZdZdZdZdZdZdZdZdd� Z dd � Z d
d � Z d d
� Z dd� Z dd� Z!dd� Z"dd� Z#dd� Z$dd� Z%dd� Z&d d � Z'd d � Z(d d!� Z)d"d#� Z*d$d%� Z+d&d'� Z,d(d)� Z-d*d+� Z.d,d-� Z/d.d/� Z0d0d1� Z1d2d3� Z2d4d5� Z3d6d7� Z4d8d9� Z5d:d;� Z6d<d=� Z7d>d?� Z8d@dA� Z9dBdC� Z:dIdEdF�Z;dGdH� Z<dS )Jr� )�
_elem_infor� r� r' r� z #documentNFr c C s$ d | _ t� | _i | _i | _d | _d S r% )r� rw r' r� r� r� r r
r
r
r� s
zDocument.__init__c C s& |j r|j |jf}n|j}| j�|�S r% )r~ r� r� r� r� )r r) rk r
r
r
r� s zDocument._get_elem_infoc C s | j S r% r| r r
r
r
r} s z Document._get_actualEncodingc C s | j S r% )r� r r
r
r
� _get_doctype s zDocument._get_doctypec C s | j S r% )� documentURIr r
r
r
�_get_documentURI! s zDocument._get_documentURIc C s | j S r% r~ r r
r
r
r $ s zDocument._get_encodingc C s | j S r% )� errorHandlerr r
r
r
�_get_errorHandler' s zDocument._get_errorHandlerc C s | j S r% )�
standaloner r
r
r
�_get_standalone* s zDocument._get_standalonec C s | j S r% )�strictErrorCheckingr r
r
r
�_get_strictErrorChecking- s z!Document._get_strictErrorCheckingc C s | j S r% r� r r
r
r
r� 0 s zDocument._get_versionc C sj |j | jkr(tj�dt|�t| �f ��|jd k r>|j�|� |j tj kr^| �
� r^tj�d��t� | |�S )Nr0 z two document elements disallowed) r r5 r6 r7 r8 r9 r: r; r rS �_get_documentElementr< r� r
r
r
r< 3 s �
��zDocument.appendChildc C sV z| j �|� W n tk
r. tj�� �Y nX d |_|_d |_| j |krRd | _ |S r% )
r' rM r> r6 r7 r? rC rD r: �documentElementrN r
r
r
r; C s
zDocument.removeChildc C s$ | j D ]}|jtjkr| S qd S r% )r' r r rS r� r
r
r
r� O s
z Document._get_documentElementc C s( | j d k r| j �� d | _ t�| � d S r% )r� rQ r r r
r
r
rQ T s
zDocument.unlinkc C s� |sd S | j �d d d �}| j|_| j|_| j|_| jD ]B}t|||�}|j�|� |jt j
kr`n|jt j krr||_ ||_
q6| �tjjj| |� |S r% )r[ r� r r� r_ r' rW rR r r r r{ r� r: rv r6 r7 rp rq )r rY rv r� Z
childcloner
r
r
rZ Z s&
�zDocument.cloneNodec C s t � }| |_|S r% )r� rX )r ro r
r
r
�createDocumentFragmento s z Document.createDocumentFragmentc C s t |�}| |_|S r% )r rX )r r� rx r
r
r
�
createElementt s zDocument.createElementc C s( t |t�std��t� }||_| |_|S �Nz node contents must be a string)r� r� r� r� rP rX )r rP �tr
r
r
�createTextNodey s
zDocument.createTextNodec C s( t |t�std��t� }||_| |_|S r� )r� r� r� r[ rP rX �r rP rG r
r
r
�createCDATASection� s
zDocument.createCDATASectionc C s t |�}| |_|S r% )rZ rX r� r
r
r
�
createComment� s zDocument.createCommentc C s t ||�}| |_|S r% )r/ rX )r r1 rP �pr
r
r
�createProcessingInstruction� s
z$Document.createProcessingInstructionc C s t |�}| |_d|_|S r )r� rX r� )r r� �ar
r
r
�createAttribute� s zDocument.createAttributec C s" t |�\}}t|||�}| |_|S r% )r r rX )r r~ r r r� rx r
r
r
r� � s zDocument.createElementNSc C s* t |�\}}t||||�}| |_d|_|S r )r r� rX r� )r r~ r r r� r� r
r
r
�createAttributeNS� s
zDocument.createAttributeNSc C s t ||||�}| |_|S r% )rs rX )r r� rf rg rt rx r
r
r
�_create_entity� s zDocument._create_entityc C s t |||�}| |_|S r% )rr rX )r r� rf rg r� r
r
r
�_create_notation� s zDocument._create_notationc C s� || j kr| j | S | js$| js$d S | j}|d krB| jg}|| _n|sJd S d }|�r�|�� }|�dd� |jD �� | �|�}|�rB|j �
� D ]�}|j r�|� |j |j
�r�|| j |j< |j|kr�|}n |js� �q�q�|�|j��r
|| j |j< |j|kr�|}n|j�s> �q�q�|jr�|| j |j< |j|k�r.|}q�|jdkr� �q�q�n>|j�r�|j �
� D ]*}|j�rT|| j |j< |j|k�rT|}�qT|d k rN�q�qN|S )Nc S s g | ]}|j tkr|�qS r
)r r@ )�.0rV r
r
r
�
<listcomp>� s
�z+Document.getElementById.<locals>.<listcomp>r1 )r� r� r� r� r� �pop�extendr' r� r� r� r~ r� r� r� r� r� r� r� )r r� �stack�resultrH r� r r
r
r
�getElementById� sZ
zDocument.getElementByIdc C s t | |t� �S r% r r� r
r
r
r � s z Document.getElementsByTagNamec C s t | ||t� �S r% r r� r
r
r
r � s �z Document.getElementsByTagNameNSc C s | j �||�S r% )r[ r\ r] r
r
r
r` � s zDocument.isSupportedc C s> |j tjkrtj�d��n|j tjkr2tj�d��t||| �S )Nz cannot import document nodesz!cannot import document type nodes)r r r r6 r7 �NotSupportedErrr{ rW )r rH rY r
r
r
�
importNode� s
zDocument.importNoder c C sJ |d kr|� d| � n|� d||f � | jD ]}|�||||� q0d S )Nz<?xml version="1.0" ?>z%<?xml version="1.0" encoding="%s"?>%s)r� r' r )r r$ r" r! r# r rH r
r
r
r � s �
zDocument.writexmlc C sJ |j | k r tj�d| |j f ��|jtjtjfkr>tj�d��|t kr�d|kr�|�
dd�\}}|dkr�|tjj kr�tj� d��q�|dkr�|tjj kr�|jtjkr�tj� d��d }|}nd }d }|jtjkr�|j
}|d k r�|j}|�|� nd }||_||_||_||_|jtjk�r ||_n*||_|d k �rF|�|� |�rF|�|� |S )Nz?cannot rename nodes from other documents;
expected %s,
found %sz8renameNode() only applies to element and attribute nodesr� r1 r� z illegal use of 'xmlns' prefixz$illegal use of the 'xmlns' attribute)rX r6 r7 r� r r rS r� r� r r� r r� r� r� r r r� r~ r� r� r� r r# )r r� r~ r� r r� r) Zis_idr
r
r
�
renameNode sb
���
��
�
��
zDocument.renameNode)r r r N)=r{ r| r} r� r rS r� r� r{ r5 r� r[ r r r� r� r� r: rD rC ru r r� r_ r� r� r� r� r� r� r} r� r� r r� r� r� r� r< r; r� rQ rZ r� r� r� r� r� r� r� r� r� r� r� r� r r r` r� r r� r
r
r
r
r� � sj �
:
r� r� z#Top-level element of this document.c
C s� | j �|�rtjjj}n
tjjj}| jtj kr�|�
| j | j �}| j
�� D ]0}|�|j |j |j� |�|j |j�}|j|_qH|r�| jD ]}t|||�}|�|� q��n| jtjkr�|�� }|r�| jD ]}t|||�}|�|� qn�| jtjkr�|�| j�}�n�| jtj k�r |� | j�}�n�| jtj k�r>|� | j | j�}�nj| jtj!k�r\|�"| j�}�nL| jtj#k�r�|�$| j | j �}d|_| j|_�n | jtj%k�r�tjjj}|j&�'| j(| j)| j*�}||_ |�r�g |j+_,g |j-_,| j-j,D ]F} t.| j | j)| j*�}
||
_ |j-j,�/|
� t0| d��r�| �1|| |
� �q�| j+j,D ]b} t2| j | j)| j*| j3�} | j4| _4| j5| _5| j6| _6|| _ |j+j,�/| � t0| d��r.| �1|| | � �q.ntj�7dt8| � ��t0| d��r�| �1|| |� |S )NTrv zCannot clone node %s)9rX rd r6 r7 rp rq Z
NODE_IMPORTEDr r rS r� r~ r� r� r� r r� r r� r� r' rW r< r2 r� rO r� rP r� r� r� r� r1 r� r� r� r� r{ r[ r� r� rf rg rl r_ rm rr rR rq rv rs rt ru r r_ r� r9 )
rH rY ZnewOwnerDocumentrt rv r r� rV rG r� rw rx ry r
r
r
rW B s�
�
��
� � rW c C s, | � dd�}t|�dkr |S d |d fS d S )Nr� r1 � r )r� r� )r Zfieldsr
r
r
r � s r c C s, | ||�}|� � \}}|�|� |�� |S r% )ZgetEventZ
expandNoder� )�func�args�kwargsZeventsZtoktypeZrootNoder
r
r
�_do_pulldom_parse� s
r� c C sH |d kr"|s"ddl m} |�| �S ddl m} t|j| f||d��S d S )Nr �� expatbuilder��pulldom)�parser�bufsize)�xml.domr� �parser� r� )�filer� r� r� r� r
r
r
r� � s
�r� c C sB |d kr ddl m} |�| �S ddl m} t|j| fd|i�S d S )Nr r� r� r� )r� r� � parseStringr� r� )�stringr� r� r� r
r
r
r� � s
�r� c C s@ | r:t | t�rt�| �} | D ] \}}tj�||�s d S q tjS r% )r� r� r Z_parse_feature_stringr� r[ r\ )Zfeatures�f�vr
r
r
�getDOMImplementation� s
r� )NN)N)N)6r r� r6 r r r r Zxml.dom.minicompatZxml.dom.xmlbuilderr r r7 r rS r� r@ Z defpropertyrJ r� r� r� r� r� r� �objectr� Z
AttributeListr� r� r r r* r/ r9 r� rV r' rZ r[ r] rd rk rs rr r� r� rA r� rW r r� r� r� r� r
r
r
r
�<module> s� � v
y $�
x�� )GU�� >�<( O* P�R
U
e5d� � @ s G d d� d�Z dS )c @ sX e Zd ZdZdZdZdZdZdZdZ dZ
dZ dZ d Z
d
Zd Zd Zd
ZdZdZdd� ZdS )�
NodeFilterzL
This is the DOM2 NodeFilter interface. It contains only constants.
� � � l �� � � � � �@ � � i i i c C s t �d S )N)�NotImplementedError)�selfZnode� r �*/usr/lib64/python3.8/xml/dom/NodeFilter.py�
acceptNode s zNodeFilter.acceptNodeN)�__name__�
__module__� __qualname__�__doc__Z
FILTER_ACCEPTZ
FILTER_REJECTZ FILTER_SKIPZSHOW_ALLZ SHOW_ELEMENTZSHOW_ATTRIBUTEZ SHOW_TEXTZSHOW_CDATA_SECTIONZSHOW_ENTITY_REFERENCEZ SHOW_ENTITYZSHOW_PROCESSING_INSTRUCTIONZ SHOW_COMMENTZ
SHOW_DOCUMENTZSHOW_DOCUMENT_TYPEZSHOW_DOCUMENT_FRAGMENTZ
SHOW_NOTATIONr r r r r r s$ r N)r r r r r �<module> � """W3C Document Object Model implementation for Python.
The Python mapping of the Document Object Model is documented in the
Python Library Reference in the section on the xml.dom package.
This package contains the following modules:
minidom -- A simple implementation of the Level 1 DOM with namespace
support added (based on the Level 2 specification) and other
minor Level 2 functionality.
pulldom -- DOM builder supporting on-demand tree-building for selected
subtrees of the document.
"""
class Node:
"""Class giving the NodeType constants."""
__slots__ = ()
# DOM implementations may use this as a base class for their own
# Node implementations. If they don't, the constants defined here
# should still be used as the canonical definitions as they match
# the values given in the W3C recommendation. Client code can
# safely refer to these values in all tests of Node.nodeType
# values.
ELEMENT_NODE = 1
ATTRIBUTE_NODE = 2
TEXT_NODE = 3
CDATA_SECTION_NODE = 4
ENTITY_REFERENCE_NODE = 5
ENTITY_NODE = 6
PROCESSING_INSTRUCTION_NODE = 7
COMMENT_NODE = 8
DOCUMENT_NODE = 9
DOCUMENT_TYPE_NODE = 10
DOCUMENT_FRAGMENT_NODE = 11
NOTATION_NODE = 12
#ExceptionCode
INDEX_SIZE_ERR = 1
DOMSTRING_SIZE_ERR = 2
HIERARCHY_REQUEST_ERR = 3
WRONG_DOCUMENT_ERR = 4
INVALID_CHARACTER_ERR = 5
NO_DATA_ALLOWED_ERR = 6
NO_MODIFICATION_ALLOWED_ERR = 7
NOT_FOUND_ERR = 8
NOT_SUPPORTED_ERR = 9
INUSE_ATTRIBUTE_ERR = 10
INVALID_STATE_ERR = 11
SYNTAX_ERR = 12
INVALID_MODIFICATION_ERR = 13
NAMESPACE_ERR = 14
INVALID_ACCESS_ERR = 15
VALIDATION_ERR = 16
class DOMException(Exception):
"""Abstract base class for DOM exceptions.
Exceptions with specific codes are specializations of this class."""
def __init__(self, *args, **kw):
if self.__class__ is DOMException:
raise RuntimeError(
"DOMException should not be instantiated directly")
Exception.__init__(self, *args, **kw)
def _get_code(self):
return self.code
class IndexSizeErr(DOMException):
code = INDEX_SIZE_ERR
class DomstringSizeErr(DOMException):
code = DOMSTRING_SIZE_ERR
class HierarchyRequestErr(DOMException):
code = HIERARCHY_REQUEST_ERR
class WrongDocumentErr(DOMException):
code = WRONG_DOCUMENT_ERR
class InvalidCharacterErr(DOMException):
code = INVALID_CHARACTER_ERR
class NoDataAllowedErr(DOMException):
code = NO_DATA_ALLOWED_ERR
class NoModificationAllowedErr(DOMException):
code = NO_MODIFICATION_ALLOWED_ERR
class NotFoundErr(DOMException):
code = NOT_FOUND_ERR
class NotSupportedErr(DOMException):
code = NOT_SUPPORTED_ERR
class InuseAttributeErr(DOMException):
code = INUSE_ATTRIBUTE_ERR
class InvalidStateErr(DOMException):
code = INVALID_STATE_ERR
class SyntaxErr(DOMException):
code = SYNTAX_ERR
class InvalidModificationErr(DOMException):
code = INVALID_MODIFICATION_ERR
class NamespaceErr(DOMException):
code = NAMESPACE_ERR
class InvalidAccessErr(DOMException):
code = INVALID_ACCESS_ERR
class ValidationErr(DOMException):
code = VALIDATION_ERR
class UserDataHandler:
"""Class giving the operation constants for UserDataHandler.handle()."""
# Based on DOM Level 3 (WD 9 April 2002)
NODE_CLONED = 1
NODE_IMPORTED = 2
NODE_DELETED = 3
NODE_RENAMED = 4
XML_NAMESPACE = "http://www.w3.org/XML/1998/namespace"
XMLNS_NAMESPACE = "http://www.w3.org/2000/xmlns/"
XHTML_NAMESPACE = "http://www.w3.org/1999/xhtml"
EMPTY_NAMESPACE = None
EMPTY_PREFIX = None
from .domreg import getDOMImplementation, registerDOMImplementation
# This is the Python mapping for interface NodeFilter from
# DOM2-Traversal-Range. It contains only constants.
class NodeFilter:
"""
This is the DOM2 NodeFilter interface. It contains only constants.
"""
FILTER_ACCEPT = 1
FILTER_REJECT = 2
FILTER_SKIP = 3
SHOW_ALL = 0xFFFFFFFF
SHOW_ELEMENT = 0x00000001
SHOW_ATTRIBUTE = 0x00000002
SHOW_TEXT = 0x00000004
SHOW_CDATA_SECTION = 0x00000008
SHOW_ENTITY_REFERENCE = 0x00000010
SHOW_ENTITY = 0x00000020
SHOW_PROCESSING_INSTRUCTION = 0x00000040
SHOW_COMMENT = 0x00000080
SHOW_DOCUMENT = 0x00000100
SHOW_DOCUMENT_TYPE = 0x00000200
SHOW_DOCUMENT_FRAGMENT = 0x00000400
SHOW_NOTATION = 0x00000800
def acceptNode(self, node):
raise NotImplementedError
#
# ElementTree
# $Id: ElementPath.py 3375 2008-02-13 08:05:08Z fredrik $
#
# limited xpath support for element trees
#
# history:
# 2003-05-23 fl created
# 2003-05-28 fl added support for // etc
# 2003-08-27 fl fixed parsing of periods in element names
# 2007-09-10 fl new selection engine
# 2007-09-12 fl fixed parent selector
# 2007-09-13 fl added iterfind; changed findall to return a list
# 2007-11-30 fl added namespaces support
# 2009-10-30 fl added child element value filter
#
# Copyright (c) 2003-2009 by Fredrik Lundh. All rights reserved.
#
# fredrik@pythonware.com
# http://www.pythonware.com
#
# --------------------------------------------------------------------
# The ElementTree toolkit is
#
# Copyright (c) 1999-2009 by Fredrik Lundh
#
# By obtaining, using, and/or copying this software and/or its
# associated documentation, you agree that you have read, understood,
# and will comply with the following terms and conditions:
#
# Permission to use, copy, modify, and distribute this software and
# its associated documentation for any purpose and without fee is
# hereby granted, provided that the above copyright notice appears in
# all copies, and that both that copyright notice and this permission
# notice appear in supporting documentation, and that the name of
# Secret Labs AB or the author not be used in advertising or publicity
# pertaining to distribution of the software without specific, written
# prior permission.
#
# SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
# ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR
# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
# OF THIS SOFTWARE.
# --------------------------------------------------------------------
# Licensed to PSF under a Contributor Agreement.
# See http://www.python.org/psf/license for licensing details.
##
# Implementation module for XPath support. There's usually no reason
# to import this module directly; the <b>ElementTree</b> does this for
# you, if needed.
##
import re
xpath_tokenizer_re = re.compile(
r"("
r"'[^']*'|\"[^\"]*\"|"
r"::|"
r"//?|"
r"\.\.|"
r"\(\)|"
r"[/.*:\[\]\(\)@=])|"
r"((?:\{[^}]+\})?[^/\[\]\(\)@=\s]+)|"
r"\s+"
)
def xpath_tokenizer(pattern, namespaces=None):
default_namespace = namespaces.get('') if namespaces else None
parsing_attribute = False
for token in xpath_tokenizer_re.findall(pattern):
ttype, tag = token
if tag and tag[0] != "{":
if ":" in tag:
prefix, uri = tag.split(":", 1)
try:
if not namespaces:
raise KeyError
yield ttype, "{%s}%s" % (namespaces[prefix], uri)
except KeyError:
raise SyntaxError("prefix %r not found in prefix map" % prefix) from None
elif default_namespace and not parsing_attribute:
yield ttype, "{%s}%s" % (default_namespace, tag)
else:
yield token
parsing_attribute = False
else:
yield token
parsing_attribute = ttype == '@'
def get_parent_map(context):
parent_map = context.parent_map
if parent_map is None:
context.parent_map = parent_map = {}
for p in context.root.iter():
for e in p:
parent_map[e] = p
return parent_map
def _is_wildcard_tag(tag):
return tag[:3] == '{*}' or tag[-2:] == '}*'
def _prepare_tag(tag):
_isinstance, _str = isinstance, str
if tag == '{*}*':
# Same as '*', but no comments or processing instructions.
# It can be a surprise that '*' includes those, but there is no
# justification for '{*}*' doing the same.
def select(context, result):
for elem in result:
if _isinstance(elem.tag, _str):
yield elem
elif tag == '{}*':
# Any tag that is not in a namespace.
def select(context, result):
for elem in result:
el_tag = elem.tag
if _isinstance(el_tag, _str) and el_tag[0] != '{':
yield elem
elif tag[:3] == '{*}':
# The tag in any (or no) namespace.
suffix = tag[2:] # '}name'
no_ns = slice(-len(suffix), None)
tag = tag[3:]
def select(context, result):
for elem in result:
el_tag = elem.tag
if el_tag == tag or _isinstance(el_tag, _str) and el_tag[no_ns] == suffix:
yield elem
elif tag[-2:] == '}*':
# Any tag in the given namespace.
ns = tag[:-1]
ns_only = slice(None, len(ns))
def select(context, result):
for elem in result:
el_tag = elem.tag
if _isinstance(el_tag, _str) and el_tag[ns_only] == ns:
yield elem
else:
raise RuntimeError(f"internal parser error, got {tag}")
return select
def prepare_child(next, token):
tag = token[1]
if _is_wildcard_tag(tag):
select_tag = _prepare_tag(tag)
def select(context, result):
def select_child(result):
for elem in result:
yield from elem
return select_tag(context, select_child(result))
else:
if tag[:2] == '{}':
tag = tag[2:] # '{}tag' == 'tag'
def select(context, result):
for elem in result:
for e in elem:
if e.tag == tag:
yield e
return select
def prepare_star(next, token):
def select(context, result):
for elem in result:
yield from elem
return select
def prepare_self(next, token):
def select(context, result):
yield from result
return select
def prepare_descendant(next, token):
try:
token = next()
except StopIteration:
return
if token[0] == "*":
tag = "*"
elif not token[0]:
tag = token[1]
else:
raise SyntaxError("invalid descendant")
if _is_wildcard_tag(tag):
select_tag = _prepare_tag(tag)
def select(context, result):
def select_child(result):
for elem in result:
for e in elem.iter():
if e is not elem:
yield e
return select_tag(context, select_child(result))
else:
if tag[:2] == '{}':
tag = tag[2:] # '{}tag' == 'tag'
def select(context, result):
for elem in result:
for e in elem.iter(tag):
if e is not elem:
yield e
return select
def prepare_parent(next, token):
def select(context, result):
# FIXME: raise error if .. is applied at toplevel?
parent_map = get_parent_map(context)
result_map = {}
for elem in result:
if elem in parent_map:
parent = parent_map[elem]
if parent not in result_map:
result_map[parent] = None
yield parent
return select
def prepare_predicate(next, token):
# FIXME: replace with real parser!!! refs:
# http://effbot.org/zone/simple-iterator-parser.htm
# http://javascript.crockford.com/tdop/tdop.html
signature = []
predicate = []
while 1:
try:
token = next()
except StopIteration:
return
if token[0] == "]":
break
if token == ('', ''):
# ignore whitespace
continue
if token[0] and token[0][:1] in "'\"":
token = "'", token[0][1:-1]
signature.append(token[0] or "-")
predicate.append(token[1])
signature = "".join(signature)
# use signature to determine predicate type
if signature == "@-":
# [@attribute] predicate
key = predicate[1]
def select(context, result):
for elem in result:
if elem.get(key) is not None:
yield elem
return select
if signature == "@-='":
# [@attribute='value']
key = predicate[1]
value = predicate[-1]
def select(context, result):
for elem in result:
if elem.get(key) == value:
yield elem
return select
if signature == "-" and not re.match(r"\-?\d+$", predicate[0]):
# [tag]
tag = predicate[0]
def select(context, result):
for elem in result:
if elem.find(tag) is not None:
yield elem
return select
if signature == ".='" or (signature == "-='" and not re.match(r"\-?\d+$", predicate[0])):
# [.='value'] or [tag='value']
tag = predicate[0]
value = predicate[-1]
if tag:
def select(context, result):
for elem in result:
for e in elem.findall(tag):
if "".join(e.itertext()) == value:
yield elem
break
else:
def select(context, result):
for elem in result:
if "".join(elem.itertext()) == value:
yield elem
return select
if signature == "-" or signature == "-()" or signature == "-()-":
# [index] or [last()] or [last()-index]
if signature == "-":
# [index]
index = int(predicate[0]) - 1
if index < 0:
raise SyntaxError("XPath position >= 1 expected")
else:
if predicate[0] != "last":
raise SyntaxError("unsupported function")
if signature == "-()-":
try:
index = int(predicate[2]) - 1
except ValueError:
raise SyntaxError("unsupported expression")
if index > -2:
raise SyntaxError("XPath offset from last() must be negative")
else:
index = -1
def select(context, result):
parent_map = get_parent_map(context)
for elem in result:
try:
parent = parent_map[elem]
# FIXME: what if the selector is "*" ?
elems = list(parent.findall(elem.tag))
if elems[index] is elem:
yield elem
except (IndexError, KeyError):
pass
return select
raise SyntaxError("invalid predicate")
ops = {
"": prepare_child,
"*": prepare_star,
".": prepare_self,
"..": prepare_parent,
"//": prepare_descendant,
"[": prepare_predicate,
}
_cache = {}
class _SelectorContext:
parent_map = None
def __init__(self, root):
self.root = root
# --------------------------------------------------------------------
##
# Generate all matching objects.
def iterfind(elem, path, namespaces=None):
# compile selector pattern
if path[-1:] == "/":
path = path + "*" # implicit all (FIXME: keep this?)
cache_key = (path,)
if namespaces:
cache_key += tuple(sorted(namespaces.items()))
try:
selector = _cache[cache_key]
except KeyError:
if len(_cache) > 100:
_cache.clear()
if path[:1] == "/":
raise SyntaxError("cannot use absolute path on element")
next = iter(xpath_tokenizer(path, namespaces)).__next__
try:
token = next()
except StopIteration:
return
selector = []
while 1:
try:
selector.append(ops[token[0]](next, token))
except StopIteration:
raise SyntaxError("invalid path") from None
try:
token = next()
if token[0] == "/":
token = next()
except StopIteration:
break
_cache[cache_key] = selector
# execute selector pattern
result = [elem]
context = _SelectorContext(elem)
for select in selector:
result = select(context, result)
return result
##
# Find first matching object.
def find(elem, path, namespaces=None):
return next(iterfind(elem, path, namespaces), None)
##
# Find all matching objects.
def findall(elem, path, namespaces=None):
return list(iterfind(elem, path, namespaces))
##
# Find text for first matching object.
def findtext(elem, path, default=None, namespaces=None):
try:
elem = next(iterfind(elem, path, namespaces))
return elem.text or ""
except StopIteration:
return default
#
# ElementTree
# $Id: ElementInclude.py 3375 2008-02-13 08:05:08Z fredrik $
#
# limited xinclude support for element trees
#
# history:
# 2003-08-15 fl created
# 2003-11-14 fl fixed default loader
#
# Copyright (c) 2003-2004 by Fredrik Lundh. All rights reserved.
#
# fredrik@pythonware.com
# http://www.pythonware.com
#
# --------------------------------------------------------------------
# The ElementTree toolkit is
#
# Copyright (c) 1999-2008 by Fredrik Lundh
#
# By obtaining, using, and/or copying this software and/or its
# associated documentation, you agree that you have read, understood,
# and will comply with the following terms and conditions:
#
# Permission to use, copy, modify, and distribute this software and
# its associated documentation for any purpose and without fee is
# hereby granted, provided that the above copyright notice appears in
# all copies, and that both that copyright notice and this permission
# notice appear in supporting documentation, and that the name of
# Secret Labs AB or the author not be used in advertising or publicity
# pertaining to distribution of the software without specific, written
# prior permission.
#
# SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
# ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR
# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
# OF THIS SOFTWARE.
# --------------------------------------------------------------------
# Licensed to PSF under a Contributor Agreement.
# See http://www.python.org/psf/license for licensing details.
##
# Limited XInclude support for the ElementTree package.
##
import copy
from . import ElementTree
XINCLUDE = "{http://www.w3.org/2001/XInclude}"
XINCLUDE_INCLUDE = XINCLUDE + "include"
XINCLUDE_FALLBACK = XINCLUDE + "fallback"
##
# Fatal include error.
class FatalIncludeError(SyntaxError):
pass
##
# Default loader. This loader reads an included resource from disk.
#
# @param href Resource reference.
# @param parse Parse mode. Either "xml" or "text".
# @param encoding Optional text encoding (UTF-8 by default for "text").
# @return The expanded resource. If the parse mode is "xml", this
# is an ElementTree instance. If the parse mode is "text", this
# is a Unicode string. If the loader fails, it can return None
# or raise an OSError exception.
# @throws OSError If the loader fails to load the resource.
def default_loader(href, parse, encoding=None):
if parse == "xml":
with open(href, 'rb') as file:
data = ElementTree.parse(file).getroot()
else:
if not encoding:
encoding = 'UTF-8'
with open(href, 'r', encoding=encoding) as file:
data = file.read()
return data
##
# Expand XInclude directives.
#
# @param elem Root element.
# @param loader Optional resource loader. If omitted, it defaults
# to {@link default_loader}. If given, it should be a callable
# that implements the same interface as <b>default_loader</b>.
# @throws FatalIncludeError If the function fails to include a given
# resource, or if the tree contains malformed XInclude elements.
# @throws OSError If the function fails to load a given resource.
def include(elem, loader=None):
if loader is None:
loader = default_loader
# look for xinclude elements
i = 0
while i < len(elem):
e = elem[i]
if e.tag == XINCLUDE_INCLUDE:
# process xinclude directive
href = e.get("href")
parse = e.get("parse", "xml")
if parse == "xml":
node = loader(href, parse)
if node is None:
raise FatalIncludeError(
"cannot load %r as %r" % (href, parse)
)
node = copy.copy(node)
if e.tail:
node.tail = (node.tail or "") + e.tail
elem[i] = node
elif parse == "text":
text = loader(href, parse, e.get("encoding"))
if text is None:
raise FatalIncludeError(
"cannot load %r as %r" % (href, parse)
)
if i:
node = elem[i-1]
node.tail = (node.tail or "") + text + (e.tail or "")
else:
elem.text = (elem.text or "") + text + (e.tail or "")
del elem[i]
continue
else:
raise FatalIncludeError(
"unknown parse type in xi:include tag (%r)" % parse
)
elif e.tag == XINCLUDE_FALLBACK:
raise FatalIncludeError(
"xi:fallback tag must be child of xi:include (%r)" % e.tag
)
else:
include(e, loader)
i = i + 1
U
e5dD � @ s d S )N� r r r �*/usr/lib64/python3.8/xml/etree/__init__.py�<module> � U
e5dR � @ s d dl T dS )� )�*N)Zxml.etree.ElementTree� r r �./usr/lib64/python3.8/xml/etree/cElementTree.py�<module> � U
e5d � @ sP d dl Z ddlmZ dZed Zed ZG dd� de�Zd d d
�Zd
d d�Z dS )� N� )� ElementTreez!{http://www.w3.org/2001/XInclude}�includeZfallbackc @ s e Zd ZdS )�FatalIncludeErrorN)�__name__�
__module__� __qualname__� r r �0/usr/lib64/python3.8/xml/etree/ElementInclude.pyr > s r c C s\ |dkr.t | d��}t�|��� }W 5 Q R X n*|s6d}t | d|d��}|�� }W 5 Q R X |S )N�xml�rbzUTF-8�r)�encoding)�openr �parseZgetroot�read)�hrefr r �file�datar r r
�default_loaderM s r c C sh |d kr t }d}|t| �k �rd| | }|jtk�r4|�d�}|�dd�}|dkr�|||�}|d krrtd||f ��t�|�}|jr�|jp�d|j |_|| |< n�|dk�r&||||�d��}|d kr�td||f ��|r�| |d }|jp�d| |jp�d |_n | j�pd| |j�pd | _| |= qn td
| ��n&|jt k�rPtd |j ��n
t
||� |d }qd S ) Nr r r r zcannot load %r as %r� �textr r z)unknown parse type in xi:include tag (%r)z0xi:fallback tag must be child of xi:include (%r)) r �len�tag�XINCLUDE_INCLUDE�getr �copy�tailr �XINCLUDE_FALLBACKr )�elem�loader�i�er r Znoder r r r
r c sN
�
� � �
)N)N)
r r r ZXINCLUDEr r � SyntaxErrorr r r r r r r
�<module>3 s
U
e5d>3 � @ s� d dl Z e �d�Zd"dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Zdd� Z dd� Z
dd� Z dd� Z eee e e
e d�Z
i ZG dd� d�Zd#dd�Zd$d d �Zd%d d �Zd&d d!�ZdS )'� Nz\('[^']*'|\"[^\"]*\"|::|//?|\.\.|\(\)|[/.*:\[\]\(\)@=])|((?:\{[^}]+\})?[^/\[\]\(\)@=\s]+)|\s+c c s� |r|� d�nd }d}t�| �D ]�}|\}}|r�|d dkr�d|kr�|�dd�\}}z"|s^t�|d|| |f fV W q� tk
r� td| �d �Y q�X n"|r�|s�|d||f fV n|V d}q |V |d k}q d S )
N� Fr �{�:� z{%s}%sz!prefix %r not found in prefix map�@)�get�xpath_tokenizer_re�findall�split�KeyError� SyntaxError) �pattern�
namespacesZdefault_namespaceZparsing_attribute�tokenZttype�tag�prefixZuri� r �-/usr/lib64/python3.8/xml/etree/ElementPath.py�xpath_tokenizerI s& r c C s> | j }|d kr:i | _ }| j�� D ]}|D ] }|||< q*q"|S �N)�
parent_map�root�iter)�contextr �p�er r r �get_parent_mapa s
r c C s | d d� dkp | dd � dkS )N� �{*}����}*r �r r r r �_is_wildcard_tagk s r" c s� t t � ��dkr"� �fdd�}n��dkr:� �fdd�}n��d d� dkr��dd � �tt�� d ���dd � �� ����fd d�}nL�d
d � d krƈd d � �td t����� ���fd
d�}ntd�� ���|S )Nz{*}*c 3 s |D ]}� |j ��r|V qd S r r! �r �result�elem�� _isinstance�_strr r �selectu s z _prepare_tag.<locals>.selectz{}*c 3 s0 |D ]&}|j }� |��r|d dkr|V qd S )Nr r r! �r r$ r% Zel_tagr& r r r) { s r r � c 3 s8 |D ].}|j }|�ks,� |��r|� �kr|V qd S r r! r* )r' r( �no_ns�suffixr r r r) � s r r ���c 3 s0 |D ]&}|j }� |��r|� �kr|V qd S r r! r* )r' r( �ns�ns_onlyr r r) � s zinternal parser error, got )�
isinstance�str�slice�len� RuntimeError)r r) r )r' r( r, r/ r0 r- r r � _prepare_tago s
r6 c sR |d �t ��r&t��� � fdd�}n(�d d� dkrB�dd � ��fdd�}|S )Nr c s dd� }� | ||��S )Nc s s | D ]}|E d H qd S r r )r$ r% r r r � select_child� s z3prepare_child.<locals>.select.<locals>.select_childr �r r$ r7 ��
select_tagr r r) � s z prepare_child.<locals>.selectr+ �{}c 3 s( |D ] }|D ]}|j � kr |V q qd S r r! �r r$ r% r r! r r r) � s
)r" r6 ��nextr r) r �r: r r �
prepare_child� s r@ c C s dd� }|S )Nc s s |D ]}|E d H qd S r r r# r r r r) � s z prepare_star.<locals>.selectr r= r r r � prepare_star� s rA c C s dd� }|S )Nc s s |E d H d S r r )r r$ r r r r) � s z prepare_self.<locals>.selectr r= r r r � prepare_self� s rB c s� z
| � }W n t k
r Y d S X |d dkr4d�n|d sF|d �ntd��t��rlt��� � fdd�}n(�d d� dkr��dd � ��fd d�}|S )
Nr �*r zinvalid descendantc s dd� }� | ||��S )Nc s s* | D ] }|� � D ]}||k r|V qqd S r �r )r$ r% r r r r r7 � s z8prepare_descendant.<locals>.select.<locals>.select_childr r8 r9 r r r) � s z"prepare_descendant.<locals>.selectr+ r; c 3 s, |D ]"}|� � �D ]}||k r|V qqd S r rD r< r! r r r) � s )�
StopIterationr r" r6 r= r r? r �prepare_descendant� s
rF c C s dd� }|S )Nc s s@ t | �}i }|D ]*}||kr|| }||krd ||< |V qd S r )r )r r$ r Z
result_mapr% �parentr r r r) � s z prepare_parent.<locals>.selectr r= r r r �prepare_parent� s
rH c sL g }g }z
| � }W n t k
r( Y d S X |d dkr8q�|dkrBq|d rr|d d d� dkrrd|d dd� f}|�|d p�d� |�|d � qd �|�}|d
kr�|d ��fd d �}|S |d
kr�|d �|d ���fdd �}|S |dk�r t�d|d ��s |d ��fdd �}|S |dk�sB|dk�rxt�d|d ��sx|d �|d ���rh��fdd �}n �fdd �}|S |dk�s�|dk�s�|dk�r@|dk�r�t|d �d � � dk �r0td��nl|d dk�r�td��|dk�r,zt|d �d � W n tk
�r td��Y nX � d k�r0td ��nd� � fd d �}|S td ��d S ) Nr �])r r r z'"�'r. �-r z@-c 3 s" |D ]}|� � �d k r|V qd S r �r r# )�keyr r r) � s z!prepare_predicate.<locals>.selectz@-='c 3 s" |D ]}|� � ��kr|V qd S r rL r# )rM �valuer r r) s z\-?\d+$c 3 s" |D ]}|� � �d k r|V qd S r )�findr# r! r r r) s z.='z-='c 3 s: |D ]0}|� � �D ] }d�|�� ��kr|V qqqd S �Nr )r �join�itertextr< )r rN r r r) s
c 3 s& |D ] }d� |�� �� kr|V qd S rP )rQ rR r# )rN r r r) s z-()z-()-z XPath position >= 1 expectedZlastzunsupported functionr+ zunsupported expressionr z)XPath offset from last() must be negativec
3 s^ t | �}|D ]L}z.|| }t|�|j��}|� |kr<|V W q ttfk
rV Y q X q d S r )r �listr r �
IndexErrorr )r r$ r r% rG Zelems)�indexr r r) 5 s
zinvalid predicate)rE �appendrQ �re�match�intr �
ValueError)r> r Z signatureZ predicater) r )rU rM r rN r �prepare_predicate� sj
&
r[ )r rC �.z..z//�[c @ s e Zd ZdZdd� ZdS )�_SelectorContextNc C s
|| _ d S r )r )�selfr r r r �__init__P s z_SelectorContext.__init__)�__name__�
__module__� __qualname__r r` r r r r r^ N s r^ c
C sj |dd � dkr|d }|f}|r6|t t|�� ��7 }zt| }W � n� tk
�r@ tt�dkrjt�� |d d� dkr�td��tt ||��j
}z
|� }W n t k
r� Y Y d S X g }z |� t
|d ||�� W n t k
r� td�d �Y nX z |� }|d dk�r|� }W q� t k
�r0 Y �q4Y q�X q�|t|< Y nX | g}t| �}|D ]} | ||�}�qT|S ) Nr. �/rC �d r z#cannot use absolute path on elementr z invalid path)�tuple�sorted�items�_cacher r4 �clearr r r �__next__rE rV �opsr^ )
r% �pathr Z cache_keyZselectorr> r r$ r r) r r r �iterfindX sD
rn c C s t t| ||�d �S r )r> rn �r% rm r r r r rO � s rO c C s t t| ||��S r )rS rn ro r r r r � s r c C s: z t t| ||��} | jpdW S tk
r4 | Y S X d S rP )r> rn �textrE )r% rm �defaultr r r r �findtext� s
rr )N)N)N)N)NN)rW �compiler r r r" r6 r@ rA rB rF rH r[ rl ri r^ rn rO r rr r r r r �<module>; s4 �
)
b�
,
U
e5dR � @ s d dl T dS )� )�*N)Zxml.etree.ElementTree� r r �./usr/lib64/python3.8/xml/etree/cElementTree.py�<module> � U
e5dD � @ s d S )N� r r r �*/usr/lib64/python3.8/xml/etree/__init__.py�<module> � U
e5dD � @ s d S )N� r r r �*/usr/lib64/python3.8/xml/etree/__init__.py�<module> � U
e5d>3 � @ s� d dl Z e �d�Zd"dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Zdd� Z dd� Z
dd� Z dd� Z eee e e
e d�Z
i ZG dd� d�Zd#dd�Zd$d d �Zd%d d �Zd&d d!�ZdS )'� Nz\('[^']*'|\"[^\"]*\"|::|//?|\.\.|\(\)|[/.*:\[\]\(\)@=])|((?:\{[^}]+\})?[^/\[\]\(\)@=\s]+)|\s+c c s� |r|� d�nd }d}t�| �D ]�}|\}}|r�|d dkr�d|kr�|�dd�\}}z"|s^t�|d|| |f fV W q� tk
r� td| �d �Y q�X n"|r�|s�|d||f fV n|V d}q |V |d k}q d S )
N� Fr �{�:� z{%s}%sz!prefix %r not found in prefix map�@)�get�xpath_tokenizer_re�findall�split�KeyError� SyntaxError) �pattern�
namespacesZdefault_namespaceZparsing_attribute�tokenZttype�tag�prefixZuri� r �-/usr/lib64/python3.8/xml/etree/ElementPath.py�xpath_tokenizerI s& r c C s> | j }|d kr:i | _ }| j�� D ]}|D ] }|||< q*q"|S �N)�
parent_map�root�iter)�contextr �p�er r r �get_parent_mapa s
r c C s | d d� dkp | dd � dkS )N� �{*}����}*r �r r r r �_is_wildcard_tagk s r" c s� t t � ��dkr"� �fdd�}n��dkr:� �fdd�}n��d d� dkr��dd � �tt�� d ���dd � �� ����fd d�}nL�d
d � d krƈd d � �td t����� ���fd
d�}ntd�� ���|S )Nz{*}*c 3 s |D ]}� |j ��r|V qd S r r! �r �result�elem�� _isinstance�_strr r �selectu s z _prepare_tag.<locals>.selectz{}*c 3 s0 |D ]&}|j }� |��r|d dkr|V qd S )Nr r r! �r r$ r% Zel_tagr& r r r) { s r r � c 3 s8 |D ].}|j }|�ks,� |��r|� �kr|V qd S r r! r* )r' r( �no_ns�suffixr r r r) � s r r ���c 3 s0 |D ]&}|j }� |��r|� �kr|V qd S r r! r* )r' r( �ns�ns_onlyr r r) � s zinternal parser error, got )�
isinstance�str�slice�len� RuntimeError)r r) r )r' r( r, r/ r0 r- r r � _prepare_tago s
r6 c sR |d �t ��r&t��� � fdd�}n(�d d� dkrB�dd � ��fdd�}|S )Nr c s dd� }� | ||��S )Nc s s | D ]}|E d H qd S r r )r$ r% r r r � select_child� s z3prepare_child.<locals>.select.<locals>.select_childr �r r$ r7 ��
select_tagr r r) � s z prepare_child.<locals>.selectr+ �{}c 3 s( |D ] }|D ]}|j � kr |V q qd S r r! �r r$ r% r r! r r r) � s
)r" r6 ��nextr r) r �r: r r �
prepare_child� s r@ c C s dd� }|S )Nc s s |D ]}|E d H qd S r r r# r r r r) � s z prepare_star.<locals>.selectr r= r r r � prepare_star� s rA c C s dd� }|S )Nc s s |E d H d S r r )r r$ r r r r) � s z prepare_self.<locals>.selectr r= r r r � prepare_self� s rB c s� z
| � }W n t k
r Y d S X |d dkr4d�n|d sF|d �ntd��t��rlt��� � fdd�}n(�d d� dkr��dd � ��fd d�}|S )
Nr �*r zinvalid descendantc s dd� }� | ||��S )Nc s s* | D ] }|� � D ]}||k r|V qqd S r �r )r$ r% r r r r r7 � s z8prepare_descendant.<locals>.select.<locals>.select_childr r8 r9 r r r) � s z"prepare_descendant.<locals>.selectr+ r; c 3 s, |D ]"}|� � �D ]}||k r|V qqd S r rD r< r! r r r) � s )�
StopIterationr r" r6 r= r r? r �prepare_descendant� s
rF c C s dd� }|S )Nc s s@ t | �}i }|D ]*}||kr|| }||krd ||< |V qd S r )r )r r$ r Z
result_mapr% �parentr r r r) � s z prepare_parent.<locals>.selectr r= r r r �prepare_parent� s
rH c sL g }g }z
| � }W n t k
r( Y d S X |d dkr8q�|dkrBq|d rr|d d d� dkrrd|d dd� f}|�|d p�d� |�|d � qd �|�}|d
kr�|d ��fd d �}|S |d
kr�|d �|d ���fdd �}|S |dk�r t�d|d ��s |d ��fdd �}|S |dk�sB|dk�rxt�d|d ��sx|d �|d ���rh��fdd �}n �fdd �}|S |dk�s�|dk�s�|dk�r@|dk�r�t|d �d � � dk �r0td��nl|d dk�r�td��|dk�r,zt|d �d � W n tk
�r td��Y nX � d k�r0td ��nd� � fd d �}|S td ��d S ) Nr �])r r r z'"�'r. �-r z@-c 3 s" |D ]}|� � �d k r|V qd S r �r r# )�keyr r r) � s z!prepare_predicate.<locals>.selectz@-='c 3 s" |D ]}|� � ��kr|V qd S r rL r# )rM �valuer r r) s z\-?\d+$c 3 s" |D ]}|� � �d k r|V qd S r )�findr# r! r r r) s z.='z-='c 3 s: |D ]0}|� � �D ] }d�|�� ��kr|V qqqd S �Nr )r �join�itertextr< )r rN r r r) s
c 3 s& |D ] }d� |�� �� kr|V qd S rP )rQ rR r# )rN r r r) s z-()z-()-z XPath position >= 1 expectedZlastzunsupported functionr+ zunsupported expressionr z)XPath offset from last() must be negativec
3 s^ t | �}|D ]L}z.|| }t|�|j��}|� |kr<|V W q ttfk
rV Y q X q d S r )r �listr r �
IndexErrorr )r r$ r r% rG Zelems)�indexr r r) 5 s
zinvalid predicate)rE �appendrQ �re�match�intr �
ValueError)r> r Z signatureZ predicater) r )rU rM r rN r �prepare_predicate� sj
&
r[ )r rC �.z..z//�[c @ s e Zd ZdZdd� ZdS )�_SelectorContextNc C s
|| _ d S r )r )�selfr r r r �__init__P s z_SelectorContext.__init__)�__name__�
__module__� __qualname__r r` r r r r r^ N s r^ c
C sj |dd � dkr|d }|f}|r6|t t|�� ��7 }zt| }W � n� tk
�r@ tt�dkrjt�� |d d� dkr�td��tt ||��j
}z
|� }W n t k
r� Y Y d S X g }z |� t
|d ||�� W n t k
r� td�d �Y nX z |� }|d dk�r|� }W q� t k
�r0 Y �q4Y q�X q�|t|< Y nX | g}t| �}|D ]} | ||�}�qT|S ) Nr. �/rC �d r z#cannot use absolute path on elementr z invalid path)�tuple�sorted�items�_cacher r4 �clearr r r �__next__rE rV �opsr^ )
r% �pathr Z cache_keyZselectorr> r r$ r r) r r r �iterfindX sD
rn c C s t t| ||�d �S r )r> rn �r% rm r r r r rO � s rO c C s t t| ||��S r )rS rn ro r r r r � s r c C s: z t t| ||��} | jpdW S tk
r4 | Y S X d S rP )r> rn �textrE )r% rm �defaultr r r r �findtext� s
rr )N)N)N)N)NN)rW �compiler r r r" r6 r@ rA rB rF rH r[ rl ri r^ rn rO r rr r r r r �<module>; s4 �
)
b�
,
U
e5d� � @ s� d Z ddddddddd d
d d d
ddddddddddddgZdZdd lZdd lZdd lZdd lZdd lZdd lZdd l Z d d l
m Z G d d
� d
e �Z
d d� ZG d!d� d�Zi fd"d�Zd]d#d�Zd^d$d �ZeZG d%d
� d
�ZG d&d� d�Ze jd'd(� �Zd_d)d*�Zd+d,� Zd-Zz ee�ZW n e k
�r. Y nX d.d/� Z d0d1� Z ee e d2�Z d3d� Z d4d5d6d7d8d9d:d;�Z!e!e _!d<d=� Z"d>d?� Z#d@dA� Z$dBdC� Z%d`d d dDdE�dFd�Z&G dGdH� dHej'�Z(dad d dDdE�dId�Z)dJd� Z*dbdKd �Z+dcdLd�Z,G dMd� d�Z-dddNd�Z.dedOd�Z/e.Z0dfdPd�Z1G dQd� d�Z2G dRd� d�Z3dgd d dS�dTd�Z4e�5dUej6�j7Z8G dVd� d�Z9dWdX� Z:dYdZ� Z;z eZ<dd[l=T dd\l=m>Z> W n e?k
�r� Y n X e>ee� d S )ha Lightweight XML support for Python.
XML is an inherently hierarchical data format, and the most natural way to
represent it is with a tree. This module has two classes for this purpose:
1. ElementTree represents the whole XML document as a tree and
2. Element represents a single node in this tree.
Interactions with the whole document (reading and writing to/from files) are
usually done on the ElementTree level. Interactions with a single XML element
and its sub-elements are done on the Element level.
Element is a flexible container object designed to store hierarchical data
structures in memory. It can be described as a cross between a list and a
dictionary. Each Element has a number of properties associated with it:
'tag' - a string containing the element's name.
'attributes' - a Python dictionary storing the element's attributes.
'text' - a string containing the element's text content.
'tail' - an optional string containing text after the element's end tag.
And a number of child elements stored in a Python sequence.
To create an element instance, use the Element constructor,
or the SubElement factory function.
You can also use the ElementTree class to wrap an element structure
and convert it to and from XML.
�Comment�dump�Element� ElementTree�
fromstring�fromstringlist� iselement� iterparse�parse�
ParseError�PI�ProcessingInstruction�QName�
SubElement�tostring� tostringlist� TreeBuilder�VERSION�XML�XMLID� XMLParser�
XMLPullParser�register_namespace� canonicalize�C14NWriterTargetz1.3.0� N� )� ElementPathc @ s e Zd ZdZdS )r
z�An error when parsing an XML document.
In addition to its exception value, a ParseError contains
two extra attributes:
'code' - the specific exception code
'position' - the line and column of the error
N)�__name__�
__module__� __qualname__�__doc__� r! r! �-/usr/lib64/python3.8/xml/etree/ElementTree.pyr
j s c C s
t | d�S )z2Return True if *element* appears to be an Element.�tag)�hasattr)�elementr! r! r" r x s c @ s
e Zd ZdZdZdZdZdZi fdd�Zdd� Z dd� Z
d d
� Z d d � Z d
d� Z
dd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd9d!d"�Zd:d#d$�Zd;d%d&�Zd<d'd(�Zd)d*� Zd=d+d,�Z d-d.� Z d/d0� Z d1d2� Z d>d3d4�Z d?d5d6�Z!d7d8� Z"dS )@r ah An XML element.
This class is the reference implementation of the Element interface.
An element's length is its number of subelements. That means if you
want to check if an element is truly empty, you should check BOTH
its length AND its text attribute.
The element tag, attribute names, and attribute values can be either
bytes or strings.
*tag* is the element name. *attrib* is an optional dictionary containing
element attributes. *extra* are additional element attributes given as
keyword arguments.
Example form:
<tag attrib>text<child/>...</tag>tail
Nc K s6 t |t�s td|jjf ��|| _||�| _g | _d S )Nzattrib must be dict, not %s)�
isinstance�dict� TypeError� __class__r r# �attrib� _children)�selfr# r* �extrar! r! r" �__init__� s
�
zElement.__init__c C s d| j j| jt| �f S )Nz<%s %r at %#x>)r) r r# �id�r, r! r! r" �__repr__� s zElement.__repr__c C s | � ||�S )z�Create a new element with the same type.
*tag* is a string containing the element name.
*attrib* is a dictionary containing the element attributes.
Do not call this method, use the SubElement factory function instead.
)r) )r, r# r* r! r! r" � makeelement� s zElement.makeelementc C s0 | � | j| j�}| j|_| j|_| |dd�< |S )z�Return copy of current element.
This creates a shallow copy. Subelements will be shared with the
original tree.
N)r2 r# r* �text�tail)r, �elemr! r! r" �copy� s
z Element.copyc C s
t | j�S �N)�lenr+ r0 r! r! r" �__len__� s zElement.__len__c C s t jdtdd� t| j�dkS )NzyThe behavior of this method will change in future versions. Use specific 'len(elem)' or 'elem is not None' test instead.� ��
stacklevelr )�warnings�warn�
FutureWarningr8 r+ r0 r! r! r" �__bool__� s �zElement.__bool__c C s
| j | S r7 �r+ �r, �indexr! r! r" � __getitem__� s zElement.__getitem__c C s8 t |t�r |D ]}| �|� qn
| �|� || j|< d S r7 )r& �slice�_assert_is_elementr+ )r, rC r% Zeltr! r! r" � __setitem__� s
zElement.__setitem__c C s | j |= d S r7 rA rB r! r! r" � __delitem__� s zElement.__delitem__c C s | � |� | j�|� dS )a Add *subelement* to the end of this element.
The new element will appear in document order after the last existing
subelement (or directly after the text, if it's the first subelement),
but before the end tag for this element.
N�rF r+ �append�r, �
subelementr! r! r" rJ � s
zElement.appendc C s$ |D ]}| � |� | j�|� qdS )zkAppend subelements from a sequence.
*elements* is a sequence with zero or more elements.
NrI )r, �elementsr% r! r! r" �extend� s
zElement.extendc C s | � |� | j�||� dS )z(Insert *subelement* at position *index*.N)rF r+ �insert)r, rC rL r! r! r" rO � s
zElement.insertc C s t |t�s tdt|�j ��d S )Nzexpected an Element, not %s)r& � _Element_Pyr( �typer )r, �er! r! r" rF � s
zElement._assert_is_elementc C s | j �|� dS )a� Remove matching subelement.
Unlike the find methods, this method compares elements based on
identity, NOT ON tag value or contents. To remove subelements by
other means, the easiest way is to use a list comprehension to
select what elements to keep, and then use slice assignment to update
the parent element.
ValueError is raised if a matching element could not be found.
N)r+ �removerK r! r! r" rS s
zElement.removec C s t jdtdd� | jS )z`(Deprecated) Return all subelements.
Elements are returned in document order.
zaThis method will be removed in future versions. Use 'list(elem)' or iteration over elem instead.r: r; )r= r> �DeprecationWarningr+ r0 r! r! r" � getchildren s �zElement.getchildrenc C s t �| ||�S )a Find first matching element by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
)r �find�r, �path�
namespacesr! r! r" rV ! s z Element.findc C s t �| |||�S )a� Find text for first matching element by tag name or path.
*path* is a string having either an element tag or an XPath,
*default* is the value to return if the element was not found,
*namespaces* is an optional mapping from namespace prefix to full name.
Return text content of first matching element, or default value if
none was found. Note that if an element is found having no text
content, the empty string is returned.
)r �findtext�r, rX �defaultrY r! r! r" rZ , s zElement.findtextc C s t �| ||�S )a Find all matching subelements by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Returns list containing all matching elements in document order.
)r �findallrW r! r! r" r] : s zElement.findallc C s t �| ||�S )a Find all matching subelements by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return an iterable yielding all matching elements in document order.
)r �iterfindrW r! r! r" r^ E s zElement.iterfindc C s | j �� g | _d | _| _dS )z�Reset element.
This function removes all subelements, clears all attributes, and sets
the text and tail attributes to None.
N)r* �clearr+ r3 r4 r0 r! r! r" r_ P s
z
Element.clearc C s | j �||�S )ag Get element attribute.
Equivalent to attrib.get, but some implementations may handle this a
bit more efficiently. *key* is what attribute to look for, and
*default* is what to return if the attribute was not found.
Returns a string containing the attribute value, or the default if
attribute was not found.
)r* �get)r, �keyr\ r! r! r" r` [ s z Element.getc C s || j |< dS )z�Set element attribute.
Equivalent to attrib[key] = value, but some implementations may handle
this a bit more efficiently. *key* is what attribute to set, and
*value* is the attribute value to set it to.
N)r* )r, ra �valuer! r! r" �seth s z Element.setc C s
| j �� S )z�Get list of attribute names.
Names are returned in an arbitrary order, just like an ordinary
Python dict. Equivalent to attrib.keys()
)r* �keysr0 r! r! r" rd r s z Element.keysc C s
| j �� S )z�Get element attributes as a sequence.
The attributes are returned in arbitrary order. Equivalent to
attrib.items().
Return a list of (name, value) tuples.
)r* �itemsr0 r! r! r" re { s z
Element.itemsc c sD |dkr d}|dks | j |kr$| V | jD ]}|�|�E dH q*dS )a Create tree iterator.
The iterator loops over the element and all subelements in document
order, returning all elements with a matching tag.
If the tree structure is modified during iteration, new or removed
elements may or may not be included. To get a stable set, use the
list() function on the iterator, and loop over the resulting list.
*tag* is what tags to look for (default is to return all elements)
Return an iterator containing all the matching elements.
�*N)r# r+ �iter)r, r# rR r! r! r" rg � s
z Element.iterc C s t jdtdd� t| �|��S )NzbThis method will be removed in future versions. Use 'elem.iter()' or 'list(elem.iter())' instead.r: r; �r= r> rT �listrg �r, r# r! r! r" � getiterator� s �zElement.getiteratorc c sX | j }t|t�s |dk r dS | j}|r,|V | D ]"}|�� E dH |j}|r0|V q0dS )z�Create text iterator.
The iterator loops over the element and all subelements in document
order, returning all inner text.
N)r# r& �strr3 �itertextr4 )r, r# �trR r! r! r" rm � s zElement.itertext)N)NN)N)N)N)N)N)#r r r r r# r* r3 r4 r. r1 r2 r6 r9 r@ rD rG rH rJ rN rO rF rS rU rV rZ r] r^ r_ r` rc rd re rg rk rm r! r! r! r" r } s@
c K s" ||�}| � ||�}| �|� |S )a� Subelement factory which creates an element instance, and appends it
to an existing parent.
The element tag, attribute names, and attribute values can be either
bytes or Unicode strings.
*parent* is the parent element, *tag* is the subelements name, *attrib* is
an optional directory containing element attributes, *extra* are
additional attributes given as keyword arguments.
)r2 rJ )�parentr# r* r- r% r! r! r" r � s
c C s t t�}| |_|S )z�Comment element factory.
This function creates a special element which the standard serializer
serializes as an XML comment.
*text* is a string containing the comment string.
)r r r3 )r3 r% r! r! r" r � s c C s& t t�}| |_|r"|jd | |_|S )a* Processing Instruction element factory.
This function creates a special element which the standard serializer
serializes as an XML comment.
*target* is a string containing the processing instruction, *text* is a
string containing the processing instruction contents, if any.
� )r r r3 )�targetr3 r% r! r! r" r � s
c @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )r
a� Qualified name wrapper.
This class can be used to wrap a QName attribute value in order to get
proper namespace handing on output.
*text_or_uri* is a string containing the QName value either in the form
{uri}local, or if the tag argument is given, the URI part of a QName.
*tag* is an optional argument which if given, will make the first
argument (text_or_uri) be interpreted as a URI, and this argument (tag)
be interpreted as a local name.
Nc C s |rd||f }|| _ d S )Nz{%s}%s�r3 )r, Z text_or_urir# r! r! r" r. � s zQName.__init__c C s | j S r7 rr r0 r! r! r" �__str__� s z
QName.__str__c C s d| j j| jf S )Nz<%s %r>)r) r r3 r0 r! r! r" r1 s zQName.__repr__c C s
t | j�S r7 )�hashr3 r0 r! r! r" �__hash__ s zQName.__hash__c C s t |t�r| j|jkS | j|kS r7 �r& r
r3 �r, �otherr! r! r" �__le__ s
z QName.__le__c C s t |t�r| j|jk S | j|k S r7 rv rw r! r! r" �__lt__ s
z QName.__lt__c C s t |t�r| j|jkS | j|kS r7 rv rw r! r! r" �__ge__ s
z QName.__ge__c C s t |t�r| j|jkS | j|kS r7 rv rw r! r! r" �__gt__ s
z QName.__gt__c C s t |t�r| j|jkS | j|kS r7 rv rw r! r! r" �__eq__ s
z QName.__eq__)N)
r r r r r. rs r1 ru ry rz r{ r| r} r! r! r! r" r
� s
c @ s� e Zd ZdZd dd�Zdd� Zdd� Zd d d
�Zd d d �Zd d
d�Z d!dd�Z
d"dd�Z d#dd�Z d$dd�Z
d%dd�dd�Zdd � ZdS )&r a% An XML element hierarchy.
This class also provides support for serialization to and from
standard XML.
*element* is an optional root element node,
*file* is an optional file handle or file name of an XML file whose
contents will be used to initialize the tree with.
Nc C s || _ |r| �|� d S r7 )�_rootr )r, r% �filer! r! r" r. ' s zElementTree.__init__c C s | j S )z!Return root element of this tree.�r~ r0 r! r! r" �getroot- s zElementTree.getrootc C s
|| _ dS )z�Replace root element of this tree.
This will discard the current contents of the tree and replace it
with the given element. Use with care!
Nr� )r, r% r! r! r" �_setroot1 s zElementTree._setrootc C s� d}t |d�s t|d�}d}z^|dkrLt� }t |d�rL|�|�| _| jW �2S |�d�}|s\qh|�|� qL|�� | _| jW �S |r�|�� X dS )a= Load external XML document into element tree.
*source* is a file name or file object, *parser* is an optional parser
instance that defaults to XMLParser.
ParseError is raised if the parser fails to parse the document.
Returns the root element of the given source document.
F�read�rbTN� _parse_wholei )r$ �open�closer r� r~ r� �feed)r, �source�parser� close_source�datar! r! r" r ; s$
zElementTree.parsec C s | j �|�S )z�Create and return tree iterator for the root element.
The iterator loops over all elements in this tree, in document order.
*tag* is a string with the tag name to iterate over
(default is to return all elements).
)r~ rg rj r! r! r" rg ` s
zElementTree.iterc C s t jdtdd� t| �|��S )NzbThis method will be removed in future versions. Use 'tree.iter()' or 'list(tree.iter())' instead.r: r; rh rj r! r! r" rk m s �zElementTree.getiteratorc C s: |dd� dkr,d| }t jd| tdd� | j�||�S )a\ Find first matching element by tag name or path.
Same as getroot().find(path), which is Element.find()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
Nr �/�.��This search is broken in 1.3 and earlier, and will be fixed in a future version. If you rely on the current behaviour, change it to %rr: r; )r= r> r? r~ rV rW r! r! r" rV u s � �zElementTree.findc C s< |dd� dkr,d| }t jd| tdd� | j�|||�S )ae Find first matching element by tag name or path.
Same as getroot().findtext(path), which is Element.findtext()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
Nr r� r� r� r: r; )r= r> r? r~ rZ r[ r! r! r" rZ � s � �zElementTree.findtextc C s: |dd� dkr,d| }t jd| tdd� | j�||�S )aa Find all matching subelements by tag name or path.
Same as getroot().findall(path), which is Element.findall().
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return list containing all matching elements in document order.
Nr r� r� r� r: r; )r= r> r? r~ r] rW r! r! r" r] � s � �zElementTree.findallc C s: |dd� dkr,d| }t jd| tdd� | j�||�S )ag Find all matching subelements by tag name or path.
Same as getroot().iterfind(path), which is element.iterfind()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return an iterable yielding all matching elements in document order.
Nr r� r� r� r: r; )r= r> r? r~ r^ rW r! r! r" r^ � s � �zElementTree.iterfindT��short_empty_elementsc C s� |s
d}n|t kr td| ��|s4|dkr0d}nd}|�� }t||���}|dkr�|sd|dkr�|dkr�|} |dkr�d dl}
|
�� } |d
| f � |d kr�t|| j� n,t| j|�\} } t | }
|
|| j| | |d � W 5 Q R X dS )
a� Write element tree to a file as XML.
Arguments:
*file_or_filename* -- file name or a file object opened for writing
*encoding* -- the output encoding (default: US-ASCII)
*xml_declaration* -- bool indicating if an XML declaration should be
added to the output. If None, an XML declaration
is added if encoding IS NOT either of:
US-ASCII, UTF-8, or Unicode
*default_namespace* -- sets the default XML namespace (for "xmlns")
*method* -- either "xml" (default), "html, "text", or "c14n"
*short_empty_elements* -- controls the formatting of elements
that contain no content. If True (default)
they are emitted as a single self-closed
tag, otherwise they are emitted as a pair
of start/end tags
�xmlzunknown method %r�c14n�utf-8�us-asciiN)r� r� �unicoder� r z$<?xml version='1.0' encoding='%s'?>
r3 r� ) �
_serialize�
ValueError�lower� _get_writer�localeZgetpreferredencoding�_serialize_textr~ � _namespaces)r, �file_or_filename�encoding�xml_declaration�default_namespace�methodr� Z enc_lower�writeZdeclared_encodingr� �qnamesrY Z serializer! r! r" r� � s: ��� �zElementTree.writec C s | j |dd�S )Nr� )r� )r� )r, r r! r! r" �
write_c14n s zElementTree.write_c14n)NN)N)N)N)N)NN)N)N)NNNN)r r r r r. r� r� r rg rk rV rZ r] r^ r� r� r! r! r! r" r s&
%
�� :c c s" z
| j }W nP tk
rZ |dkr.t| d�}nt| d|dd�}|� |j V W 5 Q R X Y n�X |dkrl|V n�t�� ��}t| tj�r�| }nft| tj�r�t� | �}|�
|j � nBt�� }dd� |_ ||_ z| j
|_
| j|_W n tk
r� Y nX tj||ddd�}|�
|j � |j V W 5 Q R X d S ) Nr� �w�xmlcharrefreplace)r� �errorsc S s dS �NTr! r! r! r! r" �<lambda>0 � z _get_writer.<locals>.<lambda>�
)r� r� �newline)r� �AttributeErrorr� �
contextlib� ExitStackr& �io�BufferedIOBase� RawIOBase�BufferedWriter�callback�detach�writable�seekable�tell�
TextIOWrapper)r� r� r� r �stackr! r! r" r� sB
�
� r� c s d d i�i �� rd�� < � ��fdd�}| � � D ]�} | j}t|t�rZ|j�kr�||j� n<t|t�rv|�kr�||� n |d k r�|tk r�|tk r�t|� | � � D ]F\}}t|t�r�|j}|�kr�||� t|t�r�|j�kr�||j� q�| j}t|t�r0|j�kr0||j� q0��fS )N� c s� z�| d d� dkr�| dd � � dd�\}}��|�}|d krjt�|�}|d krZdt�� }|dkrj|�|< |r�d||f �| < q�|�| < n� r�td��| �| < W n tk
r� t| � Y nX d S )Nr �{�}zns%dr� z%s:%sz<cannot use non-qualified names with default_namespace option)�rsplitr` �_namespace_mapr8 r� r( �_raise_serialization_error)�qname�urir# �prefix�r� rY r� r! r" � add_qnameM s(
� z _namespaces.<locals>.add_qname)
rg r# r& r
r3 rl r r r� re )r5 r� r� r# ra rb r3 r! r� r" r� B s4
r� c K s� |j }|j}|tkr$| d| � �nv|tkr<| d| � �n^|| }|d kr||r\| t|�� |D ]}t| ||d |d� q`�n | d| � t|�� �} | s�|�r2|r�t|�� dd� d�D ](\}
} | r�d| } | d | t |
�f � q�| D ]L\} }
t
| t �r�| j} t
|
t ��r||
j }
nt |
�}
| d
|| |
f � q�|�sHt |��sH|�s�| d � |�rb| t|�� |D ]}t| ||d |d� �qf| d | d � n| d
� |j
�r�| t|j
�� d S )N� <!--%s-->�<?%s?>r� �<c S s | d S �Nr r! ��xr! r! r" r� � r� z _serialize_xml.<locals>.<lambda>�ra �:�
xmlns%s="%s"� %s="%s"�>�</z />)r# r3 r r �
_escape_cdata�_serialize_xmlri re �sorted�_escape_attribr& r
r8 r4 ) r� r5 r� rY r� �kwargsr# r3 rR re �v�kr! r! r" r� s\
�
��
�
r� )
Zarea�baseZbasefont�br�col�frameZhrZimg�inputZisindex�link�metaZparamc K s� |j }|j}|tkr(| dt|� � �n�|tkrD| dt|� � �nh|| }|d kr�|rd| t|�� |D ]}t| ||d � qh�n,| d| � t|�� �}|s�|�r8|r�t|�� dd� d�D ](\} }
|
r�d|
}
| d|
t | �f � q�|D ]N\}
} t
|
t ��r|
j}
t
| t ��r|| j } nt | �} | d ||
| f � q�| d
� |�
� } |�rx| d k�sb| d k�rl| |� n | t|�� |D ]}t| ||d � �q|| tk�r�| d
| d
� |j�r�| t|j�� d S )Nr� r� r� c S s | d S r� r! r� r! r! r" r� � r� z!_serialize_html.<locals>.<lambda>r� r� r� r� r� ZscriptZstyler� )r# r3 r r� r �_serialize_htmlri re r� r� r& r
�_escape_attrib_htmlr� �
HTML_EMPTYr4 ) r� r5 r� rY r� r# r3 rR re r� r� Zltagr! r! r" r� � sX
��
r� c C s* |� � D ] }| |� q|jr&| |j� d S r7 )rm r4 )r� r5 �partr! r! r" r� � s
r� )r� �htmlr3 c C sL t �d| �rtd��tt�� �D ] \}}||ks8|| kr t|= q | t|< dS )at Register a namespace prefix.
The registry is global, and any existing mapping for either the
given prefix or the namespace URI will be removed.
*prefix* is the namespace prefix, *uri* is a namespace uri. Tags and
attributes in this namespace will be serialized with prefix if possible.
ValueError is raised if prefix is reserved or is invalid.
zns\d+$z'Prefix format reserved for internal useN)�re�matchr� ri r� re )r� r� r� r� r! r! r" r � s r� r� ZrdfZwsdlZxsZxsiZdc)�$http://www.w3.org/XML/1998/namespacez http://www.w3.org/1999/xhtmlz+http://www.w3.org/1999/02/22-rdf-syntax-ns#z http://schemas.xmlsoap.org/wsdl/z http://www.w3.org/2001/XMLSchemaz)http://www.w3.org/2001/XMLSchema-instancez http://purl.org/dc/elements/1.1/c C s t d| t| �jf ��d S )Nz cannot serialize %r (type %s))r( rQ r rr r! r! r" r� s �r� c C sh zBd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} | W S ttfk
rb t| � Y nX d S )N�&�&r� �<r� �>��replacer( r� r� rr r! r! r" r� ! s r� c C s� z�d| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} d | krf| � d d
�} d | krz| � d d
�} d
| kr�| � d
d �} d
| kr�| � d
d�} | W S ttfk
r� t| � Y nX d S )Nr� r� r� r� r� r� �"�"z
r� �
z � z	r� rr r! r! r" r� 1 s( r� c C sh zBd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} | W S ttfk
rb t| � Y nX d S )Nr� r� r� r� r� r� r� rr r! r! r" r� M s r� T)r� r� r� c C s: |dkrt �� nt �� }t| �j||||||d� |�� S )a
Generate string representation of XML element.
All subelements are included. If encoding is "unicode", a string
is returned. Otherwise a bytestring is returned.
*element* is an Element instance, *encoding* is an optional output
encoding defaulting to US-ASCII, *method* is an optional output which can
be one of "xml" (default), "html", "text" or "c14n", *default_namespace*
sets the default XML namespace (for "xmlns").
Returns an (optionally) encoded string containing the XML data.
r� �r� r� r� r� )r� �StringIO�BytesIOr r� �getvalue)r% r� r� r� r� r� �streamr! r! r" r \ s �c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�_ListDataStreamz7An auxiliary stream accumulating into a list reference.c C s
|| _ d S r7 )�lst)r, r� r! r! r" r. v s z_ListDataStream.__init__c C s dS r� r! r0 r! r! r" r� y s z_ListDataStream.writablec C s dS r� r! r0 r! r! r" r� | s z_ListDataStream.seekablec C s | j �|� d S r7 )r� rJ )r, �br! r! r" r� s z_ListDataStream.writec C s
t | j�S r7 )r8 r� r0 r! r! r" r� � s z_ListDataStream.tellN) r r r r r. r� r� r� r� r! r! r! r" r� t s r� c C s* g }t |�}t| �j||||||d� |S )Nr� )r� r r� )r% r� r� r� r� r� r� r� r! r! r" r � s �c C sL t | t�st| �} | jtjdd� | �� j}|r<|d dkrHtj�d� dS )a# Write element tree or element structure to sys.stdout.
This function should be used for debugging only.
*elem* is either an ElementTree, or a single Element. The exact output
format is implementation dependent. In this version, it's written as an
ordinary XML file.
r� )r� ���r� N)r& r r� �sys�stdoutr� r4 )r5 r4 r! r! r" r � s
c C s t � }|�| |� |S )z�Parse XML document into element tree.
*source* is a filename or file object containing XML data,
*parser* is an optional parser instance defaulting to XMLParser.
Return an ElementTree instance.
)r r )r� r� �treer! r! r" r � s c sf t ||d��� ���fdd��G �fdd�dtjj�}|� �d�_�~d� t�d�sbt�d ��d
� �S ) aJ Incrementally parse XML document into ElementTree.
This class also reports what's going on to the user based on the
*events* it is initialized with. The supported events are the strings
"start", "end", "start-ns" and "end-ns" (the "ns" events are used to get
detailed namespace information). If *events* is omitted, only
"end" events are reported.
*source* is a filename or file object containing XML data, *events* is
a list of events to report back, *parser* is an optional parser instance.
Returns an iterator providing (event, elem) pairs.
)�events�_parserc 3 s^ zJ��� E d H ��d�} | s q,��| � q��� }��� E d H |�_W 5 � rX�� � X d S )Ni @ )r� � read_eventsr� r� �_close_and_return_root�root)r� r )r� �it�
pullparserr� r! r" �iterator� s
ziterparse.<locals>.iteratorc s e Zd Z� � jZdS )z$iterparse.<locals>.IterParseIteratorN)r r r �__next__r! )r r! r" �IterParseIterator� s r NFr� r� T)r � collections�abc�Iteratorr r$ r� )r� r� r� r r! )r� r r r r� r" r � s
c @ s< e Zd Zd
dd�dd�Zdd� Zdd� Zd d
� Zd d � ZdS )r N)r c C s< t �� | _|ptt� d�| _|d kr(d}| j�| j|� d S )N�rq )�end)r �deque�
_events_queuer r r �
_setevents)r, r� r r! r! r" r. � s
zXMLPullParser.__init__c
C sZ | j dkrtd��|rVz| j �|� W n. tk
rT } z| j�|� W 5 d}~X Y nX dS )� Feed encoded data to parser.Nz!feed() called after end of stream)r r� r� � SyntaxErrorr rJ )r, r� �excr! r! r" r� � s
zXMLPullParser.feedc C s | j �� }d | _ |S r7 )r r� )r, r r! r! r" r � s
z$XMLPullParser._close_and_return_rootc C s | � � dS )z�Finish feeding data to parser.
Unlike XMLParser, does not return the root element. Use
read_events() to consume elements from XMLPullParser.
N)r r0 r! r! r" r� s zXMLPullParser.closec c s. | j }|r*|�� }t|t�r"|�q|V qdS )z�Return an iterator over currently available (event, elem) pairs.
Events are consumed from the internal event queue as they are
retrieved from the iterator.
N)r �popleftr& � Exception)r, r� �eventr! r! r" r s
zXMLPullParser.read_events)N)r r r r. r� r r� r r! r! r! r" r � s
c C s" |st t� d�}|�| � |�� S )a Parse XML document from string constant.
This function can be used to embed "XML Literals" in Python code.
*text* is a string containing XML data, *parser* is an
optional parser instance, defaulting to the standard XMLParser.
Returns an Element instance.
r �r r r� r� )r3 r� r! r! r" r s
c C sR |st t� d�}|�| � |�� }i }|�� D ]}|�d�}|r.|||< q.||fS )a Parse XML document from string constant for its IDs.
*text* is a string containing XML data, *parser* is an
optional parser instance, defaulting to the standard XMLParser.
Returns an (Element, dict) tuple, in which the
dict maps element id:s to elements.
r r/ )r r r� r� rg r` )r3 r� r� Zidsr5 r/ r! r! r" r , s
c C s, |st t� d�}| D ]}|�|� q|�� S )z�Parse XML document from sequence of string fragments.
*sequence* is a list of other sequence, *parser* is an optional parser
instance, defaulting to the standard XMLParser.
Returns an Element instance.
r r )Zsequencer� r3 r! r! r" r D s
c @ sh e Zd ZdZdddddd�dd�Zdd� Zd d
� Zd d � Zd
d� Zdd� Z dd� Z
ddd�Z dd� Z dS )r a8 Generic element structure builder.
This builder converts a sequence of start, data, and end method
calls to a well-formed element structure.
You can use this class to build an element structure using a custom XML
parser, or a parser for some other XML-like format.
*element_factory* is an optional element factory which is called
to create new Element instances, as necessary.
*comment_factory* is a factory to create comments to be used instead of
the standard factory. If *insert_comments* is false (the default),
comments will not be inserted into the tree.
*pi_factory* is a factory to create processing instructions to be used
instead of the standard factory. If *insert_pis* is false (the default),
processing instructions will not be inserted into the tree.
NF)�comment_factory�
pi_factory�insert_comments�
insert_pisc C sd g | _ g | _d | _d | _d | _|d kr*t}|| _|| _|d krBt}|| _ || _
|d krZt }|| _ d S r7 )
�_data�_elem�_lastr~ �_tailr �_comment_factoryr r � _pi_factoryr r �_factory)r, Zelement_factoryr r r r r! r! r" r. j s zTreeBuilder.__init__c C s | j S )z;Flush builder buffers and return toplevel document Element.r� r0 r! r! r" r� ~ s zTreeBuilder.closec C s> | j r:| jd k r4d�| j �}| jr,|| j_n|| j_g | _ d S �Nr� )r r �joinr r4 r3 �r, r3 r! r! r" �_flush� s
zTreeBuilder._flushc C s | j �|� dS )z Add text to current element.N)r rJ �r, r� r! r! r" r� � s zTreeBuilder.datac C sX | � � | �||� | _}| jr2| jd �|� n| jdkrB|| _| j�|� d| _|S )z�Open new element and return it.
*tag* is the element name, *attrs* is a dict containing element
attributes.
r� Nr )r& r" r r rJ r~ r )r, r# �attrsr5 r! r! r" �start� s
zTreeBuilder.startc C s | � � | j�� | _d| _| jS )zOClose and return current Element.
*tag* is the element name.
r )r& r �popr r rj r! r! r" r
� s zTreeBuilder.endc C s | � | j| j|�S )z`Create a comment using the comment_factory.
*text* is the text of the comment.
)�_handle_singler r r% r! r! r" �comment� s
�zTreeBuilder.commentc C s | � | j| j||�S )z�Create a processing instruction using the pi_factory.
*target* is the target name of the processing instruction.
*text* is the data of the processing instruction, or ''.
)r+ r! r )r, rq r3 r! r! r" �pi� s �zTreeBuilder.pic G s: ||� }|r6| � � || _| jr0| jd �|� d| _|S )Nr� r )r& r r rJ r )r, �factoryrO �argsr5 r! r! r" r+ � s zTreeBuilder._handle_single)N)N)
r r r r r. r� r& r� r) r
r, r- r+ r! r! r! r" r V s �
c @ sp e Zd ZdZddd�dd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dd� ZdS )r aa Element structure builder for XML source data based on the expat parser.
*target* is an optional target object which defaults to an instance of the
standard TreeBuilder class, *encoding* is an optional encoding string
which if given, overrides the encoding specified in the XML file:
http://www.iana.org/assignments/character-sets
N)rq r� c C sd zddl m} W n> tk
rN z dd l}W n tk
rH td��Y nX Y nX |�|d�}|d krjt� }| | _| _| | _| _ |j
| _ i | _ | j
|_t|d�r�| j|_t|d�r�| j|_t|d�r�| j|_t|d�r�| j|_t|d �r�|j|_t|d
��r|j|_t|d ��r|j |_ d |_ d |_ d |_ d | _!i | _"zd
|j# | _$W n t%k
�r^ Y nX d S )Nr ��expatz7No module named expat; use SimpleXMLTreeBuilder insteadr� r) r
�start_ns�end_nsr� r, r- r zExpat %d.%d.%d)&� xml.parsersr1 � ImportErrorZpyexpatZ ParserCreater r� r rq �_target�error�_error�_names�_defaultZDefaultHandlerExpandr$ �_start�StartElementHandler�_end�EndElementHandler� _start_ns�StartNamespaceDeclHandler�_end_ns�EndNamespaceDeclHandlerr� ZCharacterDataHandlerr, �CommentHandlerr- � ProcessingInstructionHandlerZ buffer_text�ordered_attributes�specified_attributes�_doctype�entity� version_info�versionr� )r, rq r� r1 r� r! r! r" r. � sP �
zXMLParser.__init__c C s8 | j }|j}|D �] }|dkrDd|_d|_||| jfdd�}||_q|dkrf||| jfdd�}||_q|dkr�t| j d�r�||| j
fd d�}n||fd
d�}||_ q|d kr�t| j d �r�||| j fd
d�}n||fdd�}||_
q|dk�r||| fdd�}||_q|dk�r&||| fdd�}||_qtd| ��qd S )Nr) r c S s |||| |�f� d S r7 r! )r# Z attrib_inr rJ r) r! r! r" �handler s z%XMLParser._setevents.<locals>.handlerr
c S s |||| �f� d S r7 r! )r# r rJ r
r! r! r" rK s zstart-nsr2 c S s |||| |�f� d S r7 r! )r� r� r rJ r2 r! r! r" rK ! s c S s ||| p
d|pdff� d S r# r! )r� r� r rJ r! r! r" rK % s zend-nsr3 c S s |||| �f� d S r7 r! )r� r rJ r3 r! r! r" rK + s c S s ||d f� d S r7 r! )r� r rJ r! r! r" rK / s r, c S s |||j �| �f� d S r7 )rq r, )r3 r rJ r, r! r! r" rK 3 s r- c S s |||j �| |�f� d S r7 )rq r- )Z pi_targetr� r rJ r, r! r! r" rK 7 s zunknown event %r)r rJ rE rF r; r< r= r> r$ rq r? r@ rA rB rC rD r� )r, Z events_queueZevents_to_reportr� rJ Z
event_namerK r! r! r" r sL
�
�
� �
�
zXMLParser._seteventsc C s& t |�}|j|_|j|jf|_|�d S r7 )r
�code�lineno�offsetZposition)r, rb �errr! r! r" � _raiseerror> s zXMLParser._raiseerrorc C sF z| j | }W n2 tk
r@ |}d|kr2d| }|| j |< Y nX |S )Nr� r� )r9 �KeyError)r, ra �namer! r! r" �_fixnameD s zXMLParser._fixnamec C s | j �|p d|pd�S r# )rq r2 �r, r� r� r! r! r" r? O s zXMLParser._start_nsc C s | j �|p d�S r# )rq r3 )r, r� r! r! r" rA R s zXMLParser._end_nsc C sR | j }||�}i }|rDtdt|�d�D ] }||d |||| �< q&| j�||�S )Nr r: r )rS �ranger8 rq r) )r, r# � attr_listZfixnamer* �ir! r! r" r; U s zXMLParser._startc C s | j �| �|��S r7 )rq r
rS rj r! r! r" r= a s zXMLParser._endc C s� |d d� }|dkr�z | j j}W n tk
r6 Y d S X z|| j|dd� � W nZ tk
r� ddlm} |�d|| jj | jj
f �}d|_ | jj |_ | jj
|_
|�Y nX �n"|dkr�|d d � d
kr�g | _�n | jd k �r�|d kr�d | _d S |�� }|�sd S | j�|� t| j�}|d k�r�| jd }|d
k�rd|dk�rd| j\}}} }
| �r�| dd� } n*|dk�r�|dk�r�| j\}}}
d } nd S t| j d��r�| j �|| |
dd� � nt| d��r�t�dt� d | _d S )Nr r� r� r r0 z'undefined entity %s: line %d, column %d� r� � z <!DOCTYPEr� r: ZPUBLIC� ZSYSTEM� �doctypezaThe doctype() method of XMLParser is ignored. Define doctype() method on the TreeBuilder target.)rq r� r� rH rQ r4 r1 r7 r� ZErrorLineNumberZErrorColumnNumberrL rM rN rG �striprJ r8 r$ r\ r= r> �RuntimeWarning) r, r3 r� Z data_handlerr1 rO �nrQ rR Zpubid�systemr! r! r" r: d sd ���
�zXMLParser._defaultc
C sF z| j �|d� W n. | jk
r@ } z| �|� W 5 d}~X Y nX dS )r r N)r� �Parser8 rP )r, r� r� r! r! r" r� � s zXMLParser.feedc
C s� z| j �dd� W n. | jk
r@ } z| �|� W 5 d}~X Y nX z0z | jj}W n tk
rd Y n X |� W �S W 5 | ` | `| `| `X dS )z;Finish feeding data to parser and return element structure.r� r N) r� ra r8 rP r rq r6 r� r� )r, r� Z
close_handlerr! r! r" r� � s zXMLParser.close)r r r r r. r rP rS r? rA r; r= r: r� r� r! r! r! r" r � s .6 6)�out� from_filec K s� | dkr|dkrt d��d}|dkr0t�� }}tt|jf|�d�}| dk r`|�| � |�� n|dk rtt||d� |dk r�|� � S dS )a3 Convert XML to its C14N 2.0 serialised form.
If *out* is provided, it must be a file or file-like object that receives
the serialised canonical XML output (text, not bytes) through its ``.write()``
method. To write to a file, open it in text mode with encoding "utf-8".
If *out* is not provided, this function returns the output as text string.
Either *xml_data* (an XML string) or *from_file* (a file path or
file-like object) must be provided as input.
The configuration options are the same as for the ``C14NWriterTarget``.
Nz:Either 'xml_data' or 'from_file' must be provided as inputr )r� )
r� r� r� r r r� r� r� r r� )Zxml_datarb rc ZoptionsZsior� r! r! r" r � s
z ^\w+:\w+$c @ s� e Zd ZdZdddddddd�dd�Zefdd�Zd d
� Zd d d �Zd
d� Z dj
fdd�Z dd� Z dd� Z
d dd�Zdd� Zdd� Zd d � ZdS ) r a�
Canonicalization writer target for the XMLParser.
Serialises parse events to XML C14N 2.0.
The *write* function is used for writing out the resulting data stream
as text (not bytes). To write to a file, open it in text mode with encoding
"utf-8" and pass its ``.write`` method.
Configuration options:
- *with_comments*: set to true to include comments
- *strip_text*: set to true to strip whitespace before and after text content
- *rewrite_prefixes*: set to true to replace namespace prefixes by "n{number}"
- *qname_aware_tags*: a set of qname aware tag names in which prefixes
should be replaced in text content
- *qname_aware_attrs*: a set of qname aware attribute names in which prefixes
should be replaced in text content
- *exclude_attrs*: a set of attribute names that should not be serialised
- *exclude_tags*: a set of tag names that should not be serialised
FN)�
with_comments�
strip_text�rewrite_prefixes�qname_aware_tags�qname_aware_attrs�
exclude_attrs� exclude_tagsc C s� || _ g | _|| _|| _|r$t|�nd | _|r6t|�nd | _|| _|rRt|�| _nd | _|rjt|�j | _
nd | _
dgg| _ g | _ |s�| j �
tt�� �� | j �
g � i | _dg| _d | _d| _d| _d| _d S )N)r� r� Fr )�_writer �_with_comments� _strip_textrc �_exclude_attrs�
_exclude_tags�_rewrite_prefixes�_qname_aware_tags� intersection�_find_qname_aware_attrs�_declared_ns_stack� _ns_stackrJ ri r� re � _prefix_map�_preserve_space�_pending_start�
_root_seen�
_root_done�_ignored_depth) r, r� rd re rf rg rh ri rj r! r! r" r. � s2 � zC14NWriterTarget.__init__c c s ||�D ]}|r|E d H qd S r7 r! )r, Zns_stackZ _reversedrY r! r! r" �_iter_namespaces s z!C14NWriterTarget._iter_namespacesc C s\ |� dd�\}}| �| j�D ]$\}}||kr d|� d|� � S q td|� d|� d���d S )Nr� r r� r� zPrefix z of QName "�" is not declared in scope)�splitr| ru r� )r, Z
prefixed_namer� rR r� �pr! r! r" �_resolve_prefix_name s
z%C14NWriterTarget._resolve_prefix_namec C s� |d kr:|d d� dkr,|dd � � dd�nd|f\}}n|}t� }| �| j�D ]B\}}||kr�||kr�|rz|� d|� �n|||f S |�|� qP| jr�|| jkr�| j| }ndt| j�� � }| j|< | jd �||f� |� d|� �||fS |�s d|k�r |||fS | �| j �D ]J\}}||k�r| jd �||f� |�rR|� d|� �n|||f S �q|�st|||fS t
d|� d ���d S )
Nr r� r� r� r� r_ r� z Namespace "r} ) r� rc r| rt �addrp rv r8 rJ ru r� )r, r� r� r# Z
prefixes_seen�ur� r! r! r" �_qname s. 2
&
zC14NWriterTarget._qnamec C s | j s| j�|� d S r7 )r{ r rJ r' r! r! r" r� C s zC14NWriterTarget.datar� c C s� || j �}| j d d �= | jr.| jd s.|�� }| jd k rv| jd }| _|rVt|�rV|nd }| j||f�� |d k rvd S |r�| jr�| �t |�� d S �Nr� )
r rm rw r] rx �_looks_like_prefix_namer; ry rk �_escape_cdata_c14n)r, Z
_join_textr� r/ �
qname_textr! r! r" r& G s
zC14NWriterTarget._flushc C s0 | j r
d S | jr| �� | jd �||f� d S r� )r{ r r& ru rJ rT r! r! r" r2 U s
zC14NWriterTarget.start_nsc C s� | j d k r,| js|| j kr,| jd7 _d S | jr:| �� g }| j�|� | jd k rn|| jkrn|||f| _d S | �|||� d S r� ) ro r{ r r& rt rJ rq rx r; )r, r# r( �new_namespacesr! r! r" r) ] s
�� zC14NWriterTarget.startc s �j d k r$|r$�fdd�|�� D �}|h|�}i }|d k rV��|� }||< |�|� �jd k r�|r���|�}|r�|D ]0} || }
t|
�rv��|
� }||
< |�|� qvq�d }nd }�j� � fdd�t|dd� d�D �} |r�dd� |D �} | �� ng } |�rjt|�� �D ]^\}
}|d k �r@|
|k�r@||k�r@| || d }| |
\}} }| � |�r\|n| |f� �q
|�
d
�}�j � |�r�|d kn�j d � �j }|d
| | d � | �r�|d�
dd� | D ��� |d� |d k �r�|t| || d �� d�_�j� g � d S )Nc s i | ]\}}|� j kr||�qS r! )rn ��.0r� r� r0 r! r" �
<dictcomp>p s
z+C14NWriterTarget._start.<locals>.<dictcomp>c s i | ]}|� |��qS r! r! )r� r_ )� parse_qnamer! r" r� � s c S s | � dd�S )Nr� r )r~ )r_ r! r! r" r� � r� z)C14NWriterTarget._start.<locals>.<lambda>r� c S s$ g | ] \}}|rd | nd|f�qS )zxmlns:Zxmlnsr! )r� r� r� r! r! r" �
<listcomp>� s �z+C14NWriterTarget._start.<locals>.<listcomp>r z+{http://www.w3.org/XML/1998/namespace}spaceZpreserver� r� r� c S s& g | ] \}}d |� dt |�� d��qS )rp z="r� )�_escape_attrib_c14nr� r! r! r" r� � s r� T)rn re r� r� rs r� r� r� �sortrJ r` rw rk r$ r� ry ru )r, r# r( r� r� r� Zresolved_namesr� ZqattrsZ attr_namerb Z
parsed_qnamesrV r� r� Z
attr_qnamer� Zspace_behaviourr� r! )r� r, r" r; n s`
�
�
�
zC14NWriterTarget._startc C st | j r| j d8 _ d S | jr&| �� | �d| �|�d � d�� | j�� t| j�dk| _| j �� | j
�� d S )Nr r� r r� ) r{ r r& rk r� rw r* r8 rz rt ru rj r! r! r" r
� s
zC14NWriterTarget.endc C sd | j s
d S | jrd S | jr&| �d� n| jr:| jr:| �� | �dt|�� d�� | js`| �d� d S )Nr� z<!--z-->)rl r{ rz rk ry r r& r� r% r! r! r" r, � s zC14NWriterTarget.commentc C sp | j r
d S | jr | �d� n| jr0| jr0| �� | �|rNd|� dt|�� d�n
d|� d�� | jsl| �d� d S )Nr� z<?rp z?>)r{ rz rk ry r r& r� )r, rq r� r! r! r" r- � s $�zC14NWriterTarget.pi)N)N)r r r r r. �reversedr| r� r� r� r$ r& r2 r) r; r
r, r- r! r! r! r" r � s( � %
%
E
c C s| zVd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} | W S ttfk
rv t| � Y nX d S ) Nr� r� r� r� r� r� r� �
r� rr r! r! r" r� � s r� c C s� z~d| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} d | krf| � d d
�} d | krz| � d d �} | W S ttfk
r� t| � Y nX d S )
Nr� r� r� r� r� r� r� z	r� z
r� r� r� rr r! r! r" r� � s r� )rf )�_set_factories)N)N)N)NN)NN)N)NN)N)N)N)N)@r �__all__r r� r� r= r� r Zcollections.abcr� r� r r r
r r r r r r r
r �contextmanagerr� r� r� r� rc � NameErrorr� r� r� r r� r� r� r� r� r r� r� r r r r r r r r r r r r �compile�UNICODEr� r� r r� r� rP Z _elementtreer� r5 r! r! r! r" �<module> s� J � >
0 s
3
=2 2� �
� �
05
z g U
e5d� � @ s� d ddddddddd d
d d d
dddddddddddgZ dZddlZddlZddlZddlZddlZddlZddlZd d l m
Z
G d d � d e �Z d d� Z
G d d� d�Zi fd!d
�Zd\d"d �Zd]d#d �ZeZG d$d � d �ZG d%d� d�Zejd&d'� �Zd^d(d)�Zd*d+� Zd,Zz ee�ZW n ek
�r* Y nX d-d.� Z d/d0� Z ee e d1�Z d2d� Z d3d4d5d6d7d8d9d:�Z e e _ d;d<� Z!d=d>� Z"d?d@� Z#dAdB� Z$d_dddCdD�dEd�Z%G dFdG� dGej&�Z'd`dddCdD�dHd�Z(dId� Z)dadJd�Z*dbdKd�Z+G dLd� d�Z,dcdMd�Z-dddNd�Z.e-Z/dedOd�Z0G dPd� d�Z1G dQd� d�Z2dfdddR�dSd�Z3e�4dTej5�j6Z7G dUd� d�Z8dVdW� Z9dXdY� Z:z eZ;ddZl<T dd[l<m=Z= W n e>k
�r� Y n X e=ee� dS )g�Comment�dump�Element� ElementTree�
fromstring�fromstringlist� iselement� iterparse�parse�
ParseError�PI�ProcessingInstruction�QName�
SubElement�tostring� tostringlist� TreeBuilder�VERSION�XML�XMLID� XMLParser�
XMLPullParser�register_namespace� canonicalize�C14NWriterTargetz1.3.0� N� )� ElementPathc @ s e Zd ZdS )r
N)�__name__�
__module__� __qualname__� r r �-/usr/lib64/python3.8/xml/etree/ElementTree.pyr
j s c C s
t | d�S )N�tag)�hasattr)�elementr r r! r x s c @ s e Zd ZdZdZdZdZi fdd�Zdd� Zdd� Z dd � Z
d
d � Z d d
� Z dd� Z
dd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd8d d!�Zd9d"d#�Zd:d$d%�Zd;d&d'�Zd(d)� Zd<d*d+�Zd,d-� Z d.d/� Z d0d1� Z d=d2d3�Z d>d4d5�Z d6d7� Z!dS )?r Nc K s6 t |t�s td|jjf ��|| _||�| _g | _d S )Nzattrib must be dict, not %s)�
isinstance�dict� TypeError� __class__r r" �attrib� _children)�selfr" r) �extrar r r! �__init__� s
�
zElement.__init__c C s d| j j| jt| �f S )Nz<%s %r at %#x>)r( r r" �id�r+ r r r! �__repr__� s zElement.__repr__c C s | � ||�S �N)r( )r+ r" r) r r r! � makeelement� s zElement.makeelementc C s0 | � | j| j�}| j|_| j|_| |d d �< |S r1 )r2 r" r) �text�tail)r+ �elemr r r! �copy� s
z Element.copyc C s
t | j�S r1 )�lenr* r/ r r r! �__len__� s zElement.__len__c C s t jdtdd� t| j�dkS )NzyThe behavior of this method will change in future versions. Use specific 'len(elem)' or 'elem is not None' test instead.� ��
stacklevelr )�warnings�warn�
FutureWarningr7 r* r/ r r r! �__bool__� s �zElement.__bool__c C s
| j | S r1 �r* �r+ �indexr r r! � __getitem__� s zElement.__getitem__c C s8 t |t�r |D ]}| �|� qn
| �|� || j|< d S r1 )r% �slice�_assert_is_elementr* )r+ rB r$ Zeltr r r! � __setitem__� s
zElement.__setitem__c C s | j |= d S r1 r@ rA r r r! � __delitem__� s zElement.__delitem__c C s | � |� | j�|� d S r1 �rE r* �append�r+ �
subelementr r r! rI � s
zElement.appendc C s$ |D ]}| � |� | j�|� qd S r1 rH )r+ �elementsr$ r r r! �extend� s
zElement.extendc C s | � |� | j�||� d S r1 )rE r* �insert)r+ rB rK r r r! rN � s
zElement.insertc C s t |t�s tdt|�j ��d S )Nzexpected an Element, not %s)r% � _Element_Pyr' �typer )r+ �er r r! rE � s
zElement._assert_is_elementc C s | j �|� d S r1 )r* �removerJ r r r! rR s
zElement.removec C s t jdtdd� | jS )NzaThis method will be removed in future versions. Use 'list(elem)' or iteration over elem instead.r9 r: )r< r= �DeprecationWarningr* r/ r r r! � getchildren s �zElement.getchildrenc C s t �| ||�S r1 )r �find�r+ �path�
namespacesr r r! rU ! s z Element.findc C s t �| |||�S r1 )r �findtext�r+ rW �defaultrX r r r! rY , s zElement.findtextc C s t �| ||�S r1 )r �findallrV r r r! r\ : s zElement.findallc C s t �| ||�S r1 )r �iterfindrV r r r! r] E s zElement.iterfindc C s | j �� g | _d | _| _d S r1 )r) �clearr* r3 r4 r/ r r r! r^ P s
z
Element.clearc C s | j �||�S r1 )r) �get)r+ �keyr[ r r r! r_ [ s z Element.getc C s || j |< d S r1 )r) )r+ r` �valuer r r! �seth s z Element.setc C s
| j �� S r1 )r) �keysr/ r r r! rc r s z Element.keysc C s
| j �� S r1 )r) �itemsr/ r r r! rd { s z
Element.itemsc c sD |dkr d }|d ks | j |kr$| V | jD ]}|�|�E d H q*d S )N�*)r" r* �iter)r+ r" rQ r r r! rf � s
z Element.iterc C s t jdtdd� t| �|��S )NzbThis method will be removed in future versions. Use 'elem.iter()' or 'list(elem.iter())' instead.r9 r: �r< r= rS �listrf �r+ r" r r r! � getiterator� s �zElement.getiteratorc c sX | j }t|t�s |d k r d S | j}|r,|V | D ]"}|�� E d H |j}|r0|V q0d S r1 )r" r% �strr3 �itertextr4 )r+ r" �trQ r r r! rl � s zElement.itertext)N)NN)N)N)N)N)N)"r r r r" r) r3 r4 r- r0 r2 r6 r8 r? rC rF rG rI rM rN rE rR rT rU rY r\ r] r^ r_ rb rc rd rf rj rl r r r r! r } s>
c K s" ||�}| � ||�}| �|� |S r1 )r2 rI )�parentr" r) r, r$ r r r! r � s
c C s t t�}| |_|S r1 )r r r3 )r3 r$ r r r! r � s c C s& t t�}| |_|r"|jd | |_|S )N� )r r r3 )�targetr3 r$ r r r! r � s
c @ sV e Zd Zddd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z dS )r
Nc C s |rd||f }|| _ d S )Nz{%s}%s�r3 )r+ Z text_or_urir" r r r! r- � s zQName.__init__c C s | j S r1 rq r/ r r r! �__str__� s z
QName.__str__c C s d| j j| jf S )Nz<%s %r>)r( r r3 r/ r r r! r0 s zQName.__repr__c C s
t | j�S r1 )�hashr3 r/ r r r! �__hash__ s zQName.__hash__c C s t |t�r| j|jkS | j|kS r1 �r% r
r3 �r+ �otherr r r! �__le__ s
z QName.__le__c C s t |t�r| j|jk S | j|k S r1 ru rv r r r! �__lt__ s
z QName.__lt__c C s t |t�r| j|jkS | j|kS r1 ru rv r r r! �__ge__ s
z QName.__ge__c C s t |t�r| j|jkS | j|kS r1 ru rv r r r! �__gt__ s
z QName.__gt__c C s t |t�r| j|jkS | j|kS r1 ru rv r r r! �__eq__ s
z QName.__eq__)N) r r r r- rr r0 rt rx ry rz r{ r| r r r r! r
� s
c @ s� e Zd Zd dd�Zdd� Zdd� Zd dd �Zd d
d �Zd d d
�Zd dd�Z d!dd�Z
d"dd�Z d#dd�Z d$dd�dd�Z
dd� ZdS )%r Nc C s || _ |r| �|� d S r1 )�_rootr )r+ r$ �filer r r! r- ' s zElementTree.__init__c C s | j S r1 �r} r/ r r r! �getroot- s zElementTree.getrootc C s
|| _ d S r1 r )r+ r$ r r r! �_setroot1 s zElementTree._setrootc C s� d}t |d�s t|d�}d}z^|d krLt� }t |d�rL|�|�| _| jW �2S |�d�}|s\qh|�|� qL|�� | _| jW �S |r�|�� X d S )NF�read�rbT� _parse_wholei )r# �open�closer r� r} r� �feed)r+ �source�parser� close_source�datar r r! r ; s$
zElementTree.parsec C s | j �|�S r1 )r} rf ri r r r! rf ` s
zElementTree.iterc C s t jdtdd� t| �|��S )NzbThis method will be removed in future versions. Use 'tree.iter()' or 'list(tree.iter())' instead.r9 r: rg ri r r r! rj m s �zElementTree.getiteratorc C s: |d d� dkr,d| }t jd| tdd� | j�||�S �Nr �/�.z�This search is broken in 1.3 and earlier, and will be fixed in a future version. If you rely on the current behaviour, change it to %rr9 r: )r< r= r> r} rU rV r r r! rU u s � �zElementTree.findc C s< |d d� dkr,d| }t jd| tdd� | j�|||�S r� )r< r= r> r} rY rZ r r r! rY � s � �zElementTree.findtextc C s: |d d� dkr,d| }t jd| tdd� | j�||�S r� )r< r= r> r} r\ rV r r r! r\ � s � �zElementTree.findallc C s: |d d� dkr,d| }t jd| tdd� | j�||�S r� )r< r= r> r} r] rV r r r! r] � s � �zElementTree.iterfindT��short_empty_elementsc C s� |s
d}n|t kr td| ��|s4|dkr0d}nd}|�� }t||���}|dkr�|sd|d kr�|dkr�|} |dkr�dd l}
|
�� } |d | f � |d
kr�t|| j� n,t| j|�\} } t | }
|
|| j| | |d � W 5 Q R X d S ) N�xmlzunknown method %r�c14n�utf-8�us-ascii)r� r� �unicoder� r z$<?xml version='1.0' encoding='%s'?>
r3 r� ) �
_serialize�
ValueError�lower� _get_writer�localeZgetpreferredencoding�_serialize_textr} � _namespaces)r+ �file_or_filename�encoding�xml_declaration�default_namespace�methodr� Z enc_lower�writeZdeclared_encodingr� �qnamesrX Z serializer r r! r� � s: ��� �zElementTree.writec C s | j |dd�S )Nr� )r� )r� )r+ r~ r r r! �
write_c14n s zElementTree.write_c14n)NN)N)N)N)N)NN)N)N)NNNN)r r r r- r� r� r rf rj rU rY r\ r] r� r� r r r r! r s$
%
�� :c c s" z
| j }W nP tk
rZ |dkr.t| d�}nt| d|dd�}|� |j V W 5 Q R X Y n�X |dkrl|V n�t�� ��}t| tj�r�| }nft| tj�r�t� | �}|�
|j � nBt�� }dd� |_ ||_ z| j
|_
| j|_W n tk
r� Y nX tj||ddd�}|�
|j � |j V W 5 Q R X d S ) Nr� �w�xmlcharrefreplace)r� �errorsc S s dS �NTr r r r r! �<lambda>0 � z _get_writer.<locals>.<lambda>�
)r� r� �newline)r� �AttributeErrorr� �
contextlib� ExitStackr% �io�BufferedIOBase� RawIOBase�BufferedWriter�callback�detach�writable�seekable�tell�
TextIOWrapper)r� r� r� r~ �stackr r r! r� sB
�
� r� c s d d i�i �� rd�� < � ��fdd�}| � � D ]�} | j}t|t�rZ|j�kr�||j� n<t|t�rv|�kr�||� n |d k r�|tk r�|tk r�t|� | � � D ]F\}}t|t�r�|j}|�kr�||� t|t�r�|j�kr�||j� q�| j}t|t�r0|j�kr0||j� q0��fS )N� c s� z�| d d� dkr�| dd � � dd�\}}��|�}|d krjt�|�}|d krZdt�� }|dkrj|�|< |r�d||f �| < q�|�| < n� r�td��| �| < W n tk
r� t| � Y nX d S )Nr �{�}zns%dr� z%s:%sz<cannot use non-qualified names with default_namespace option)�rsplitr_ �_namespace_mapr7 r� r' �_raise_serialization_error)�qname�urir" �prefix�r� rX r� r r! � add_qnameM s(
� z _namespaces.<locals>.add_qname)
rf r" r% r
r3 rk r r r� rd )r5 r� r� r" r` ra r3 r r� r! r� B s4
r� c K s� |j }|j}|tkr$| d| � �nv|tkr<| d| � �n^|| }|d kr||r\| t|�� |D ]}t| ||d |d� q`�n | d| � t|�� �} | s�|�r2|r�t|�� dd� d�D ](\}
} | r�d| } | d | t |
�f � q�| D ]L\} }
t
| t �r�| j} t
|
t ��r||
j }
nt |
�}
| d
|| |
f � q�|�sHt |��sH|�s�| d � |�rb| t|�� |D ]}t| ||d |d� �qf| d | d � n| d
� |j
�r�| t|j
�� d S )N� <!--%s-->�<?%s?>r� �<c S s | d S �Nr r ��xr r r! r� � r� z _serialize_xml.<locals>.<lambda>�r` �:�
xmlns%s="%s"� %s="%s"�>�</z />)r" r3 r r �
_escape_cdata�_serialize_xmlrh rd �sorted�_escape_attribr% r
r7 r4 ) r� r5 r� rX r� �kwargsr" r3 rQ rd �v�kr r r! r� s\
�
��
�
r� )
Zarea�baseZbasefont�br�col�frameZhrZimg�inputZisindex�link�metaZparamc K s� |j }|j}|tkr(| dt|� � �n�|tkrD| dt|� � �nh|| }|d kr�|rd| t|�� |D ]}t| ||d � qh�n,| d| � t|�� �}|s�|�r8|r�t|�� dd� d�D ](\} }
|
r�d|
}
| d|
t | �f � q�|D ]N\}
} t
|
t ��r|
j}
t
| t ��r|| j } nt | �} | d ||
| f � q�| d
� |�
� } |�rx| d k�sb| d k�rl| |� n | t|�� |D ]}t| ||d � �q|| tk�r�| d
| d
� |j�r�| t|j�� d S )Nr� r� r� c S s | d S r� r r� r r r! r� � r� z!_serialize_html.<locals>.<lambda>r� r� r� r� r� ZscriptZstyler� )r" r3 r r� r �_serialize_htmlrh rd r� r� r% r
�_escape_attrib_htmlr� �
HTML_EMPTYr4 ) r� r5 r� rX r� r" r3 rQ rd r� r� Zltagr r r! r� � sX
��
r� c C s* |� � D ] }| |� q|jr&| |j� d S r1 )rl r4 )r� r5 �partr r r! r� � s
r� )r� �htmlr3 c C sL t �d| �rtd��tt�� �D ] \}}||ks8|| kr t|= q | t|< d S )Nzns\d+$z'Prefix format reserved for internal use)�re�matchr� rh r� rd )r� r� r� r� r r r! r � s r� r� ZrdfZwsdlZxsZxsiZdc)�$http://www.w3.org/XML/1998/namespacez http://www.w3.org/1999/xhtmlz+http://www.w3.org/1999/02/22-rdf-syntax-ns#z http://schemas.xmlsoap.org/wsdl/z http://www.w3.org/2001/XMLSchemaz)http://www.w3.org/2001/XMLSchema-instancez http://purl.org/dc/elements/1.1/c C s t d| t| �jf ��d S )Nz cannot serialize %r (type %s))r' rP r rq r r r! r� s �r� c C sh zBd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} | W S ttfk
rb t| � Y nX d S )N�&�&r� �<r� �>��replacer' r� r� rq r r r! r� ! s r� c C s� z�d| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} d | krf| � d d
�} d | krz| � d d
�} d
| kr�| � d
d �} d
| kr�| � d
d�} | W S ttfk
r� t| � Y nX d S )Nr� r� r� r� r� r� �"�"z
r� �
z � z	r� rq r r r! r� 1 s( r� c C sh zBd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} | W S ttfk
rb t| � Y nX d S )Nr� r� r� r� r� r� r� rq r r r! r� M s r� T)r� r� r� c C s: |dkrt �� nt �� }t| �j||||||d� |�� S )Nr� �r� r� r� r� )r� �StringIO�BytesIOr r� �getvalue)r$ r� r� r� r� r� �streamr r r! r \ s �c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �_ListDataStreamc C s
|| _ d S r1 )�lst)r+ r� r r r! r- v s z_ListDataStream.__init__c C s dS r� r r/ r r r! r� y s z_ListDataStream.writablec C s dS r� r r/ r r r! r� | s z_ListDataStream.seekablec C s | j �|� d S r1 )r� rI )r+ �br r r! r� s z_ListDataStream.writec C s
t | j�S r1 )r7 r� r/ r r r! r� � s z_ListDataStream.tellN)r r r r- r� r� r� r� r r r r! r� t s
r� c C s* g }t |�}t| �j||||||d� |S )Nr� )r� r r� )r$ r� r� r� r� r� r� r� r r r! r � s �c C sL t | t�st| �} | jtjdd� | �� j}|r<|d dkrHtj�d� d S )Nr� )r� ���r� )r% r r� �sys�stdoutr� r4 )r5 r4 r r r! r � s
c C s t � }|�| |� |S r1 )r r )r� r� �treer r r! r � s c sf t ||d��� ���fdd��G �fdd�dtjj�}|� �d �_�~d� t�d�sbt�d��d � �S )
N)�events�_parserc 3 s^ zJ��� E d H ��d�} | s q,��| � q��� }��� E d H |�_W 5 � rX�� � X d S )Ni @ )r� � read_eventsr� r� �_close_and_return_root�root)r� r )r� �it�
pullparserr� r r! �iterator� s
ziterparse.<locals>.iteratorc s e Zd Z� � jZdS )z$iterparse.<locals>.IterParseIteratorN)r r r �__next__r )r r r! �IterParseIterator� s r Fr� r� T)r � collections�abc�Iteratorr r# r� )r� r� r� r r )r� r r r r� r! r � s
c @ s< e Zd Zd
dd�dd�Zdd� Zdd� Zd d
� Zd d � ZdS )r N)r� c C s< t �� | _|ptt� d�| _|d kr(d}| j�| j|� d S )N�rp )�end)r �deque�
_events_queuer r r� �
_setevents)r+ r� r� r r r! r- � s
zXMLPullParser.__init__c
C sZ | j d krtd��|rVz| j �|� W n. tk
rT } z| j�|� W 5 d }~X Y nX d S )Nz!feed() called after end of stream)r� r� r� � SyntaxErrorr rI )r+ r� �excr r r! r� � s
zXMLPullParser.feedc C s | j �� }d | _ |S r1 )r� r� )r+ r r r r! r � s
z$XMLPullParser._close_and_return_rootc C s | � � d S r1 )r r/ r r r! r� s zXMLPullParser.closec c s. | j }|r*|�� }t|t�r"|�q|V qd S r1 )r �popleftr% � Exception)r+ r� �eventr r r! r s
zXMLPullParser.read_events)N)r r r r- r� r r� r r r r r! r � s
c C s" |st t� d�}|�| � |�� S �Nr �r r r� r� )r3 r� r r r! r s
c C sR |st t� d�}|�| � |�� }i }|�� D ]}|�d�}|r.|||< q.||fS )Nr r. )r r r� r� rf r_ )r3 r� r� Zidsr5 r. r r r! r , s
c C s, |st t� d�}| D ]}|�|� q|�� S r r )Zsequencer� r3 r r r! r D s
c @ sd e Zd Zdddddd�dd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Zdd� Z ddd�Z
dd� Z dS )r NF)�comment_factory�
pi_factory�insert_comments�
insert_pisc C sd g | _ g | _d | _d | _d | _|d kr*t}|| _|| _|d krBt}|| _ || _
|d krZt }|| _ d S r1 )
�_data�_elem�_lastr} �_tailr �_comment_factoryr r � _pi_factoryr r �_factory)r+ Zelement_factoryr r r r r r r! r- j s zTreeBuilder.__init__c C s | j S r1 r r/ r r r! r� ~ s zTreeBuilder.closec C s> | j r:| jd k r4d�| j �}| jr,|| j_n|| j_g | _ d S �Nr� )r r �joinr r4 r3 �r+ r3 r r r! �_flush� s
zTreeBuilder._flushc C s | j �|� d S r1 )r rI �r+ r� r r r! r� � s zTreeBuilder.datac C sX | � � | �||� | _}| jr2| jd �|� n| jd krB|| _| j�|� d| _|S )Nr� r )r% r! r r rI r} r )r+ r" �attrsr5 r r r! �start� s
zTreeBuilder.startc C s | � � | j�� | _d| _| jS r� )r% r �popr r ri r r r! r � s zTreeBuilder.endc C s | � | j| j|�S r1 )�_handle_singler r r$ r r r! �comment� s
�zTreeBuilder.commentc C s | � | j| j||�S r1 )r* r r )r+ rp r3 r r r! �pi� s �zTreeBuilder.pic G s: ||� }|r6| � � || _| jr0| jd �|� d| _|S )Nr� r )r% r r rI r )r+ �factoryrN �argsr5 r r r! r* � s zTreeBuilder._handle_single)N)N) r r r r- r� r% r� r( r r+ r, r* r r r r! r V s �
c @ sl e Zd Zddd�dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dS )r N)rp r� c C sd zddl m} W n> tk
rN z dd l}W n tk
rH td��Y nX Y nX |�|d�}|d krjt� }| | _| _| | _| _ |j
| _ i | _ | j
|_t|d�r�| j|_t|d�r�| j|_t|d�r�| j|_t|d�r�| j|_t|d �r�|j|_t|d
��r|j|_t|d ��r|j |_ d |_ d |_ d |_ d | _!i | _"zd
|j# | _$W n t%k
�r^ Y nX d S )Nr ��expatz7No module named expat; use SimpleXMLTreeBuilder insteadr� r( r �start_ns�end_nsr� r+ r, r zExpat %d.%d.%d)&� xml.parsersr0 � ImportErrorZpyexpatZ ParserCreater r� r� rp �_target�error�_error�_names�_defaultZDefaultHandlerExpandr# �_start�StartElementHandler�_end�EndElementHandler� _start_ns�StartNamespaceDeclHandler�_end_ns�EndNamespaceDeclHandlerr� ZCharacterDataHandlerr+ �CommentHandlerr, � ProcessingInstructionHandlerZ buffer_text�ordered_attributes�specified_attributes�_doctype�entity� version_info�versionr� )r+ rp r� r0 r� r r r! r- � sP �
zXMLParser.__init__c C s8 | j }|j}|D �] }|dkrDd|_d|_||| jfdd�}||_q|dkrf||| jfdd�}||_q|dkr�t| j d�r�||| j
fd d�}n||fd
d�}||_ q|d kr�t| j d �r�||| j fd
d�}n||fdd�}||_
q|dk�r||| fdd�}||_q|dk�r&||| fdd�}||_qtd| ��qd S )Nr( r c S s |||| |�f� d S r1 r )r" Z attrib_inr rI r( r r r! �handler s z%XMLParser._setevents.<locals>.handlerr c S s |||| �f� d S r1 r )r" r rI r r r r! rJ s zstart-nsr1 c S s |||| |�f� d S r1 r )r� r� r rI r1 r r r! rJ ! s c S s ||| p
d|pdff� d S r" r )r� r� r rI r r r! rJ % s zend-nsr2 c S s |||| �f� d S r1 r )r� r rI r2 r r r! rJ + s c S s ||d f� d S r1 r )r� r rI r r r! rJ / s r+ c S s |||j �| �f� d S r1 )rp r+ )r3 r rI r+ r r r! rJ 3 s r, c S s |||j �| |�f� d S r1 )rp r, )Z pi_targetr� r rI r+ r r r! rJ 7 s zunknown event %r)r� rI rD rE r: r; r< r= r# rp r> r? r@ rA rB rC r� )r+ Z events_queueZevents_to_reportr� rI Z
event_namerJ r r r! r sL
�
�
� �
�
zXMLParser._seteventsc C s& t |�}|j|_|j|jf|_|�d S r1 )r
�code�lineno�offsetZposition)r+ ra �errr r r! � _raiseerror> s zXMLParser._raiseerrorc C sF z| j | }W n2 tk
r@ |}d|kr2d| }|| j |< Y nX |S )Nr� r� )r8 �KeyError)r+ r` �namer r r! �_fixnameD s zXMLParser._fixnamec C s | j �|p d|pd�S r" )rp r1 �r+ r� r� r r r! r> O s zXMLParser._start_nsc C s | j �|p d�S r" )rp r2 )r+ r� r r r! r@ R s zXMLParser._end_nsc C sR | j }||�}i }|rDtdt|�d�D ] }||d |||| �< q&| j�||�S )Nr r9 r )rR �ranger7 rp r( )r+ r" � attr_listZfixnamer) �ir r r! r: U s zXMLParser._startc C s | j �| �|��S r1 )rp r rR ri r r r! r< a s zXMLParser._endc C s� |d d� }|dkr�z | j j}W n tk
r6 Y d S X z|| j|dd� � W nZ tk
r� ddlm} |�d|| jj | jj
f �}d|_ | jj |_ | jj
|_
|�Y nX �n"|dkr�|d d � d
kr�g | _�n | jd k �r�|d kr�d | _d S |�� }|�sd S | j�|� t| j�}|d k�r�| jd }|d
k�rd|dk�rd| j\}}} }
| �r�| dd� } n*|dk�r�|dk�r�| j\}}}
d } nd S t| j d��r�| j �|| |
dd� � nt| d��r�t�dt� d | _d S )Nr r� r� r r/ z'undefined entity %s: line %d, column %d� r� � z <!DOCTYPEr� r9 ZPUBLIC� ZSYSTEM� �doctypezaThe doctype() method of XMLParser is ignored. Define doctype() method on the TreeBuilder target.)rp r� r� rG rP r3 r0 r6 r� ZErrorLineNumberZErrorColumnNumberrK rL rM rF �striprI r7 r# r[ r< r= �RuntimeWarning) r+ r3 r� Z data_handlerr0 rN �nrP rQ Zpubid�systemr r r! r9 d sd ���
�zXMLParser._defaultc
C sF z| j �|d� W n. | jk
r@ } z| �|� W 5 d }~X Y nX d S )Nr )r� �Parser7 rO )r+ r� r� r r r! r� � s zXMLParser.feedc
C s� z| j �dd� W n. | jk
r@ } z| �|� W 5 d }~X Y nX z0z | jj}W n tk
rd Y n X |� W �S W 5 | ` | `| `| `X d S )Nr� r ) r� r` r7 rO r� rp r5 r� r� )r+ r� Z
close_handlerr r r! r� � s zXMLParser.close)r r r r- r rO rR r> r@ r: r< r9 r� r� r r r r! r � s
.6 6)�out� from_filec K s� | d kr|d krt d��d }|d kr0t�� }}tt|jf|�d�}| d k r`|�| � |�� n|d k rtt||d� |d k r�|� � S d S )Nz:Either 'xml_data' or 'from_file' must be provided as inputr )r� )
r� r� r� r r r� r� r� r r� )Zxml_datara rb ZoptionsZsior� r r r! r � s
z ^\w+:\w+$c @ s� e Zd Zdddddddd�dd�Zefdd�Zdd � Zd d
d �Zd d
� Zdj fdd�Z
dd� Z dd� Z d dd�Z
dd� Zdd� Zdd � ZdS ) r FN)�
with_comments�
strip_text�rewrite_prefixes�qname_aware_tags�qname_aware_attrs�
exclude_attrs� exclude_tagsc C s� || _ g | _|| _|| _|r$t|�nd | _|r6t|�nd | _|| _|rRt|�| _nd | _|rjt|�j | _
nd | _
dgg| _ g | _ |s�| j �
tt�� �� | j �
g � i | _dg| _d | _d| _d| _d| _d S )N)r� r� Fr )�_writer �_with_comments� _strip_textrb �_exclude_attrs�
_exclude_tags�_rewrite_prefixes�_qname_aware_tags� intersection�_find_qname_aware_attrs�_declared_ns_stack� _ns_stackrI rh r� rd � _prefix_map�_preserve_space�_pending_start�
_root_seen�
_root_done�_ignored_depth) r+ r� rc rd re rf rg rh ri r r r! r- � s2 � zC14NWriterTarget.__init__c c s ||�D ]}|r|E d H qd S r1 r )r+ Zns_stackZ _reversedrX r r r! �_iter_namespaces s z!C14NWriterTarget._iter_namespacesc C s\ |� dd�\}}| �| j�D ]$\}}||kr d|� d|� � S q td|� d|� d���d S )Nr� r r� r� zPrefix z of QName "�" is not declared in scope)�splitr{ rt r� )r+ Z
prefixed_namer� rQ r� �pr r r! �_resolve_prefix_name s
z%C14NWriterTarget._resolve_prefix_namec C s� |d kr:|d d� dkr,|dd � � dd�nd|f\}}n|}t� }| �| j�D ]B\}}||kr�||kr�|rz|� d|� �n|||f S |�|� qP| jr�|| jkr�| j| }ndt| j�� � }| j|< | jd �||f� |� d|� �||fS |�s d|k�r |||fS | �| j �D ]J\}}||k�r| jd �||f� |�rR|� d|� �n|||f S �q|�st|||fS t
d|� d ���d S )
Nr r� r� r� r� r^ r� z Namespace "r| ) r� rb r{ rs �addro ru r7 rI rt r� )r+ r� r� r" Z
prefixes_seen�ur� r r r! �_qname s. 2
&
zC14NWriterTarget._qnamec C s | j s| j�|� d S r1 )rz r rI r& r r r! r� C s zC14NWriterTarget.datar� c C s� || j �}| j d d �= | jr.| jd s.|�� }| jd k rv| jd }| _|rVt|�rV|nd }| j||f�� |d k rvd S |r�| jr�| �t |�� d S �Nr� )
r rl rv r\ rw �_looks_like_prefix_namer: rx rj �_escape_cdata_c14n)r+ Z
_join_textr� r. �
qname_textr r r! r% G s
zC14NWriterTarget._flushc C s0 | j r
d S | jr| �� | jd �||f� d S r� )rz r r% rt rI rS r r r! r1 U s
zC14NWriterTarget.start_nsc C s� | j d k r,| js|| j kr,| jd7 _d S | jr:| �� g }| j�|� | jd k rn|| jkrn|||f| _d S | �|||� d S r� ) rn rz r r% rs rI rp rw r: )r+ r" r' �new_namespacesr r r! r( ] s
�� zC14NWriterTarget.startc s �j d k r$|r$�fdd�|�� D �}|h|�}i }|d k rV��|� }||< |�|� �jd k r�|r���|�}|r�|D ]0} || }
t|
�rv��|
� }||
< |�|� qvq�d }nd }�j� � fdd�t|dd� d�D �} |r�dd� |D �} | �� ng } |�rjt|�� �D ]^\}
}|d k �r@|
|k�r@||k�r@| || d }| |
\}} }| � |�r\|n| |f� �q
|�
d
�}�j � |�r�|d kn�j d � �j }|d
| | d � | �r�|d�
dd� | D ��� |d� |d k �r�|t| || d �� d�_�j� g � d S )Nc s i | ]\}}|� j kr||�qS r )rm ��.0r� r� r/ r r! �
<dictcomp>p s
z+C14NWriterTarget._start.<locals>.<dictcomp>c s i | ]}|� |��qS r r )r� r^ )� parse_qnamer r! r� � s c S s | � dd�S )Nr� r )r} )r^ r r r! r� � r� z)C14NWriterTarget._start.<locals>.<lambda>r� c S s$ g | ] \}}|rd | nd|f�qS )zxmlns:Zxmlnsr )r� r� r� r r r! �
<listcomp>� s �z+C14NWriterTarget._start.<locals>.<listcomp>r z+{http://www.w3.org/XML/1998/namespace}spaceZpreserver� r� r� c S s& g | ] \}}d |� dt |�� d��qS )ro z="r� )�_escape_attrib_c14nr� r r r! r� � s r� T)rm rd r r� rr r� r� r� �sortrI r_ rv rj r# r� rx rt )r+ r" r' r� r� r� Zresolved_namesr� ZqattrsZ attr_namera Z
parsed_qnamesrU r� r� Z
attr_qnamer� Zspace_behaviourr� r )r� r+ r! r: n s`
�
�
�
zC14NWriterTarget._startc C st | j r| j d8 _ d S | jr&| �� | �d| �|�d � d�� | j�� t| j�dk| _| j �� | j
�� d S )Nr r� r r� ) rz r r% rj r� rv r) r7 ry rs rt ri r r r! r � s
zC14NWriterTarget.endc C sd | j s
d S | jrd S | jr&| �d� n| jr:| jr:| �� | �dt|�� d�� | js`| �d� d S )Nr� z<!--z-->)rk rz ry rj rx r r% r� r$ r r r! r+ � s zC14NWriterTarget.commentc C sp | j r
d S | jr | �d� n| jr0| jr0| �� | �|rNd|� dt|�� d�n
d|� d�� | jsl| �d� d S )Nr� z<?ro z?>)rz ry rj rx r r% r� )r+ rp r� r r r! r, � s $�zC14NWriterTarget.pi)N)N)r r r r- �reversedr{ r r� r� r# r% r1 r( r: r r+ r, r r r r! r � s& � %
%
E
c C s| zVd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} | W S ttfk
rv t| � Y nX d S ) Nr� r� r� r� r� r� r� �
r� rq r r r! r� � s r� c C s� z~d| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} d | krf| � d d
�} d | krz| � d d �} | W S ttfk
r� t| � Y nX d S )
Nr� r� r� r� r� r� r� z	r� z
r� r� r� rq r r r! r� � s r� )re )�_set_factories)N)N)N)NN)NN)N)NN)N)N)N)N)?�__all__r r� r� r< r� r Zcollections.abcr� r� r r r
r r r r r r r
r �contextmanagerr� r� r� r� rb � NameErrorr� r� r� r r� r� r� r� r� r r� r� r r r r r r r r r r r r �compile�UNICODEr� r� r r� r� rO Z _elementtreer� r4 r r r r! �<module>K s� � >
0 s
3
=2 2� �
� �
05
z g U
e5d>3 � @ s� d dl Z e �d�Zd"dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Zdd� Z dd� Z
dd� Z dd� Z eee e e
e d�Z
i ZG dd� d�Zd#dd�Zd$d d �Zd%d d �Zd&d d!�ZdS )'� Nz\('[^']*'|\"[^\"]*\"|::|//?|\.\.|\(\)|[/.*:\[\]\(\)@=])|((?:\{[^}]+\})?[^/\[\]\(\)@=\s]+)|\s+c c s� |r|� d�nd }d}t�| �D ]�}|\}}|r�|d dkr�d|kr�|�dd�\}}z"|s^t�|d|| |f fV W q� tk
r� td| �d �Y q�X n"|r�|s�|d||f fV n|V d}q |V |d k}q d S )
N� Fr �{�:� z{%s}%sz!prefix %r not found in prefix map�@)�get�xpath_tokenizer_re�findall�split�KeyError� SyntaxError) �pattern�
namespacesZdefault_namespaceZparsing_attribute�tokenZttype�tag�prefixZuri� r �-/usr/lib64/python3.8/xml/etree/ElementPath.py�xpath_tokenizerI s& r c C s> | j }|d kr:i | _ }| j�� D ]}|D ] }|||< q*q"|S �N)�
parent_map�root�iter)�contextr �p�er r r �get_parent_mapa s
r c C s | d d� dkp | dd � dkS )N� �{*}����}*r �r r r r �_is_wildcard_tagk s r" c s� t t � ��dkr"� �fdd�}n��dkr:� �fdd�}n��d d� dkr��dd � �tt�� d ���dd � �� ����fd d�}nL�d
d � d krƈd d � �td t����� ���fd
d�}ntd�� ���|S )Nz{*}*c 3 s |D ]}� |j ��r|V qd S r r! �r �result�elem�� _isinstance�_strr r �selectu s z _prepare_tag.<locals>.selectz{}*c 3 s0 |D ]&}|j }� |��r|d dkr|V qd S )Nr r r! �r r$ r% Zel_tagr& r r r) { s r r � c 3 s8 |D ].}|j }|�ks,� |��r|� �kr|V qd S r r! r* )r' r( �no_ns�suffixr r r r) � s r r ���c 3 s0 |D ]&}|j }� |��r|� �kr|V qd S r r! r* )r' r( �ns�ns_onlyr r r) � s zinternal parser error, got )�
isinstance�str�slice�len� RuntimeError)r r) r )r' r( r, r/ r0 r- r r � _prepare_tago s
r6 c sR |d �t ��r&t��� � fdd�}n(�d d� dkrB�dd � ��fdd�}|S )Nr c s dd� }� | ||��S )Nc s s | D ]}|E d H qd S r r )r$ r% r r r � select_child� s z3prepare_child.<locals>.select.<locals>.select_childr �r r$ r7 ��
select_tagr r r) � s z prepare_child.<locals>.selectr+ �{}c 3 s( |D ] }|D ]}|j � kr |V q qd S r r! �r r$ r% r r! r r r) � s
)r" r6 ��nextr r) r �r: r r �
prepare_child� s r@ c C s dd� }|S )Nc s s |D ]}|E d H qd S r r r# r r r r) � s z prepare_star.<locals>.selectr r= r r r � prepare_star� s rA c C s dd� }|S )Nc s s |E d H d S r r )r r$ r r r r) � s z prepare_self.<locals>.selectr r= r r r � prepare_self� s rB c s� z
| � }W n t k
r Y d S X |d dkr4d�n|d sF|d �ntd��t��rlt��� � fdd�}n(�d d� dkr��dd � ��fd d�}|S )
Nr �*r zinvalid descendantc s dd� }� | ||��S )Nc s s* | D ] }|� � D ]}||k r|V qqd S r �r )r$ r% r r r r r7 � s z8prepare_descendant.<locals>.select.<locals>.select_childr r8 r9 r r r) � s z"prepare_descendant.<locals>.selectr+ r; c 3 s, |D ]"}|� � �D ]}||k r|V qqd S r rD r< r! r r r) � s )�
StopIterationr r" r6 r= r r? r �prepare_descendant� s
rF c C s dd� }|S )Nc s s@ t | �}i }|D ]*}||kr|| }||krd ||< |V qd S r )r )r r$ r Z
result_mapr% �parentr r r r) � s z prepare_parent.<locals>.selectr r= r r r �prepare_parent� s
rH c sL g }g }z
| � }W n t k
r( Y d S X |d dkr8q�|dkrBq|d rr|d d d� dkrrd|d dd� f}|�|d p�d� |�|d � qd �|�}|d
kr�|d ��fd d �}|S |d
kr�|d �|d ���fdd �}|S |dk�r t�d|d ��s |d ��fdd �}|S |dk�sB|dk�rxt�d|d ��sx|d �|d ���rh��fdd �}n �fdd �}|S |dk�s�|dk�s�|dk�r@|dk�r�t|d �d � � dk �r0td��nl|d dk�r�td��|dk�r,zt|d �d � W n tk
�r td��Y nX � d k�r0td ��nd� � fd d �}|S td ��d S ) Nr �])r r r z'"�'r. �-r z@-c 3 s" |D ]}|� � �d k r|V qd S r �r r# )�keyr r r) � s z!prepare_predicate.<locals>.selectz@-='c 3 s" |D ]}|� � ��kr|V qd S r rL r# )rM �valuer r r) s z\-?\d+$c 3 s" |D ]}|� � �d k r|V qd S r )�findr# r! r r r) s z.='z-='c 3 s: |D ]0}|� � �D ] }d�|�� ��kr|V qqqd S �Nr )r �join�itertextr< )r rN r r r) s
c 3 s& |D ] }d� |�� �� kr|V qd S rP )rQ rR r# )rN r r r) s z-()z-()-z XPath position >= 1 expectedZlastzunsupported functionr+ zunsupported expressionr z)XPath offset from last() must be negativec
3 s^ t | �}|D ]L}z.|| }t|�|j��}|� |kr<|V W q ttfk
rV Y q X q d S r )r �listr r �
IndexErrorr )r r$ r r% rG Zelems)�indexr r r) 5 s
zinvalid predicate)rE �appendrQ �re�match�intr �
ValueError)r> r Z signatureZ predicater) r )rU rM r rN r �prepare_predicate� sj
&
r[ )r rC �.z..z//�[c @ s e Zd ZdZdd� ZdS )�_SelectorContextNc C s
|| _ d S r )r )�selfr r r r �__init__P s z_SelectorContext.__init__)�__name__�
__module__� __qualname__r r` r r r r r^ N s r^ c
C sj |dd � dkr|d }|f}|r6|t t|�� ��7 }zt| }W � n� tk
�r@ tt�dkrjt�� |d d� dkr�td��tt ||��j
}z
|� }W n t k
r� Y Y d S X g }z |� t
|d ||�� W n t k
r� td�d �Y nX z |� }|d dk�r|� }W q� t k
�r0 Y �q4Y q�X q�|t|< Y nX | g}t| �}|D ]} | ||�}�qT|S ) Nr. �/rC �d r z#cannot use absolute path on elementr z invalid path)�tuple�sorted�items�_cacher r4 �clearr r r �__next__rE rV �opsr^ )
r% �pathr Z cache_keyZselectorr> r r$ r r) r r r �iterfindX sD
rn c C s t t| ||�d �S r )r> rn �r% rm r r r r rO � s rO c C s t t| ||��S r )rS rn ro r r r r � s r c C s: z t t| ||��} | jpdW S tk
r4 | Y S X d S rP )r> rn �textrE )r% rm �defaultr r r r �findtext� s
rr )N)N)N)N)NN)rW �compiler r r r" r6 r@ rA rB rF rH r[ rl ri r^ rn rO r rr r r r r �<module>; s4 �
)
b�
,
U
e5dR � @ s d dl T dS )� )�*N)Zxml.etree.ElementTree� r r �./usr/lib64/python3.8/xml/etree/cElementTree.py�<module> � U
e5d � @ sP d dl Z ddlmZ dZed Zed ZG dd� de�Zd d d
�Zd
d d�Z dS )� N� )� ElementTreez!{http://www.w3.org/2001/XInclude}�includeZfallbackc @ s e Zd ZdS )�FatalIncludeErrorN)�__name__�
__module__� __qualname__� r r �0/usr/lib64/python3.8/xml/etree/ElementInclude.pyr > s r c C s\ |dkr.t | d��}t�|��� }W 5 Q R X n*|s6d}t | d|d��}|�� }W 5 Q R X |S )N�xml�rbzUTF-8�r)�encoding)�openr �parseZgetroot�read)�hrefr r �file�datar r r
�default_loaderM s r c C sh |d kr t }d}|t| �k �rd| | }|jtk�r4|�d�}|�dd�}|dkr�|||�}|d krrtd||f ��t�|�}|jr�|jp�d|j |_|| |< n�|dk�r&||||�d��}|d kr�td||f ��|r�| |d }|jp�d| |jp�d |_n | j�pd| |j�pd | _| |= qn td
| ��n&|jt k�rPtd |j ��n
t
||� |d }qd S ) Nr r r r zcannot load %r as %r� �textr r z)unknown parse type in xi:include tag (%r)z0xi:fallback tag must be child of xi:include (%r)) r �len�tag�XINCLUDE_INCLUDE�getr �copy�tailr �XINCLUDE_FALLBACKr )�elem�loader�i�er r Znoder r r r
r c sN
�
� � �
)N)N)
r r r ZXINCLUDEr r � SyntaxErrorr r r r r r r
�<module>3 s
U
e5d� � @ s� d Z ddddddddd d
d d d
ddddddddddddgZdZdd lZdd lZdd lZdd lZdd lZdd lZdd l Z d d l
m Z G d d
� d
e �Z
d d� ZG d!d� d�Zi fd"d�Zd]d#d�Zd^d$d �ZeZG d%d
� d
�ZG d&d� d�Ze jd'd(� �Zd_d)d*�Zd+d,� Zd-Zz ee�ZW n e k
�r. Y nX d.d/� Z d0d1� Z ee e d2�Z d3d� Z d4d5d6d7d8d9d:d;�Z!e!e _!d<d=� Z"d>d?� Z#d@dA� Z$dBdC� Z%d`d d dDdE�dFd�Z&G dGdH� dHej'�Z(dad d dDdE�dId�Z)dJd� Z*dbdKd �Z+dcdLd�Z,G dMd� d�Z-dddNd�Z.dedOd�Z/e.Z0dfdPd�Z1G dQd� d�Z2G dRd� d�Z3dgd d dS�dTd�Z4e�5dUej6�j7Z8G dVd� d�Z9dWdX� Z:dYdZ� Z;z eZ<dd[l=T dd\l=m>Z> W n e?k
�r� Y n X e>ee� d S )ha Lightweight XML support for Python.
XML is an inherently hierarchical data format, and the most natural way to
represent it is with a tree. This module has two classes for this purpose:
1. ElementTree represents the whole XML document as a tree and
2. Element represents a single node in this tree.
Interactions with the whole document (reading and writing to/from files) are
usually done on the ElementTree level. Interactions with a single XML element
and its sub-elements are done on the Element level.
Element is a flexible container object designed to store hierarchical data
structures in memory. It can be described as a cross between a list and a
dictionary. Each Element has a number of properties associated with it:
'tag' - a string containing the element's name.
'attributes' - a Python dictionary storing the element's attributes.
'text' - a string containing the element's text content.
'tail' - an optional string containing text after the element's end tag.
And a number of child elements stored in a Python sequence.
To create an element instance, use the Element constructor,
or the SubElement factory function.
You can also use the ElementTree class to wrap an element structure
and convert it to and from XML.
�Comment�dump�Element� ElementTree�
fromstring�fromstringlist� iselement� iterparse�parse�
ParseError�PI�ProcessingInstruction�QName�
SubElement�tostring� tostringlist� TreeBuilder�VERSION�XML�XMLID� XMLParser�
XMLPullParser�register_namespace� canonicalize�C14NWriterTargetz1.3.0� N� )� ElementPathc @ s e Zd ZdZdS )r
z�An error when parsing an XML document.
In addition to its exception value, a ParseError contains
two extra attributes:
'code' - the specific exception code
'position' - the line and column of the error
N)�__name__�
__module__� __qualname__�__doc__� r! r! �-/usr/lib64/python3.8/xml/etree/ElementTree.pyr
j s c C s
t | d�S )z2Return True if *element* appears to be an Element.�tag)�hasattr)�elementr! r! r" r x s c @ s
e Zd ZdZdZdZdZdZi fdd�Zdd� Z dd� Z
d d
� Z d d � Z d
d� Z
dd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd9d!d"�Zd:d#d$�Zd;d%d&�Zd<d'd(�Zd)d*� Zd=d+d,�Z d-d.� Z d/d0� Z d1d2� Z d>d3d4�Z d?d5d6�Z!d7d8� Z"dS )@r ah An XML element.
This class is the reference implementation of the Element interface.
An element's length is its number of subelements. That means if you
want to check if an element is truly empty, you should check BOTH
its length AND its text attribute.
The element tag, attribute names, and attribute values can be either
bytes or strings.
*tag* is the element name. *attrib* is an optional dictionary containing
element attributes. *extra* are additional element attributes given as
keyword arguments.
Example form:
<tag attrib>text<child/>...</tag>tail
Nc K s6 t |t�s td|jjf ��|| _||�| _g | _d S )Nzattrib must be dict, not %s)�
isinstance�dict� TypeError� __class__r r# �attrib� _children)�selfr# r* �extrar! r! r" �__init__� s
�
zElement.__init__c C s d| j j| jt| �f S )Nz<%s %r at %#x>)r) r r# �id�r, r! r! r" �__repr__� s zElement.__repr__c C s | � ||�S )z�Create a new element with the same type.
*tag* is a string containing the element name.
*attrib* is a dictionary containing the element attributes.
Do not call this method, use the SubElement factory function instead.
)r) )r, r# r* r! r! r" � makeelement� s zElement.makeelementc C s0 | � | j| j�}| j|_| j|_| |dd�< |S )z�Return copy of current element.
This creates a shallow copy. Subelements will be shared with the
original tree.
N)r2 r# r* �text�tail)r, �elemr! r! r" �copy� s
z Element.copyc C s
t | j�S �N)�lenr+ r0 r! r! r" �__len__� s zElement.__len__c C s t jdtdd� t| j�dkS )NzyThe behavior of this method will change in future versions. Use specific 'len(elem)' or 'elem is not None' test instead.� ��
stacklevelr )�warnings�warn�
FutureWarningr8 r+ r0 r! r! r" �__bool__� s �zElement.__bool__c C s
| j | S r7 �r+ �r, �indexr! r! r" � __getitem__� s zElement.__getitem__c C s8 t |t�r |D ]}| �|� qn
| �|� || j|< d S r7 )r& �slice�_assert_is_elementr+ )r, rC r% Zeltr! r! r" � __setitem__� s
zElement.__setitem__c C s | j |= d S r7 rA rB r! r! r" � __delitem__� s zElement.__delitem__c C s | � |� | j�|� dS )a Add *subelement* to the end of this element.
The new element will appear in document order after the last existing
subelement (or directly after the text, if it's the first subelement),
but before the end tag for this element.
N�rF r+ �append�r, �
subelementr! r! r" rJ � s
zElement.appendc C s$ |D ]}| � |� | j�|� qdS )zkAppend subelements from a sequence.
*elements* is a sequence with zero or more elements.
NrI )r, �elementsr% r! r! r" �extend� s
zElement.extendc C s | � |� | j�||� dS )z(Insert *subelement* at position *index*.N)rF r+ �insert)r, rC rL r! r! r" rO � s
zElement.insertc C s t |t�s tdt|�j ��d S )Nzexpected an Element, not %s)r& � _Element_Pyr( �typer )r, �er! r! r" rF � s
zElement._assert_is_elementc C s | j �|� dS )a� Remove matching subelement.
Unlike the find methods, this method compares elements based on
identity, NOT ON tag value or contents. To remove subelements by
other means, the easiest way is to use a list comprehension to
select what elements to keep, and then use slice assignment to update
the parent element.
ValueError is raised if a matching element could not be found.
N)r+ �removerK r! r! r" rS s
zElement.removec C s t jdtdd� | jS )z`(Deprecated) Return all subelements.
Elements are returned in document order.
zaThis method will be removed in future versions. Use 'list(elem)' or iteration over elem instead.r: r; )r= r> �DeprecationWarningr+ r0 r! r! r" � getchildren s �zElement.getchildrenc C s t �| ||�S )a Find first matching element by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
)r �find�r, �path�
namespacesr! r! r" rV ! s z Element.findc C s t �| |||�S )a� Find text for first matching element by tag name or path.
*path* is a string having either an element tag or an XPath,
*default* is the value to return if the element was not found,
*namespaces* is an optional mapping from namespace prefix to full name.
Return text content of first matching element, or default value if
none was found. Note that if an element is found having no text
content, the empty string is returned.
)r �findtext�r, rX �defaultrY r! r! r" rZ , s zElement.findtextc C s t �| ||�S )a Find all matching subelements by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Returns list containing all matching elements in document order.
)r �findallrW r! r! r" r] : s zElement.findallc C s t �| ||�S )a Find all matching subelements by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return an iterable yielding all matching elements in document order.
)r �iterfindrW r! r! r" r^ E s zElement.iterfindc C s | j �� g | _d | _| _dS )z�Reset element.
This function removes all subelements, clears all attributes, and sets
the text and tail attributes to None.
N)r* �clearr+ r3 r4 r0 r! r! r" r_ P s
z
Element.clearc C s | j �||�S )ag Get element attribute.
Equivalent to attrib.get, but some implementations may handle this a
bit more efficiently. *key* is what attribute to look for, and
*default* is what to return if the attribute was not found.
Returns a string containing the attribute value, or the default if
attribute was not found.
)r* �get)r, �keyr\ r! r! r" r` [ s z Element.getc C s || j |< dS )z�Set element attribute.
Equivalent to attrib[key] = value, but some implementations may handle
this a bit more efficiently. *key* is what attribute to set, and
*value* is the attribute value to set it to.
N)r* )r, ra �valuer! r! r" �seth s z Element.setc C s
| j �� S )z�Get list of attribute names.
Names are returned in an arbitrary order, just like an ordinary
Python dict. Equivalent to attrib.keys()
)r* �keysr0 r! r! r" rd r s z Element.keysc C s
| j �� S )z�Get element attributes as a sequence.
The attributes are returned in arbitrary order. Equivalent to
attrib.items().
Return a list of (name, value) tuples.
)r* �itemsr0 r! r! r" re { s z
Element.itemsc c sD |dkr d}|dks | j |kr$| V | jD ]}|�|�E dH q*dS )a Create tree iterator.
The iterator loops over the element and all subelements in document
order, returning all elements with a matching tag.
If the tree structure is modified during iteration, new or removed
elements may or may not be included. To get a stable set, use the
list() function on the iterator, and loop over the resulting list.
*tag* is what tags to look for (default is to return all elements)
Return an iterator containing all the matching elements.
�*N)r# r+ �iter)r, r# rR r! r! r" rg � s
z Element.iterc C s t jdtdd� t| �|��S )NzbThis method will be removed in future versions. Use 'elem.iter()' or 'list(elem.iter())' instead.r: r; �r= r> rT �listrg �r, r# r! r! r" � getiterator� s �zElement.getiteratorc c sX | j }t|t�s |dk r dS | j}|r,|V | D ]"}|�� E dH |j}|r0|V q0dS )z�Create text iterator.
The iterator loops over the element and all subelements in document
order, returning all inner text.
N)r# r& �strr3 �itertextr4 )r, r# �trR r! r! r" rm � s zElement.itertext)N)NN)N)N)N)N)N)#r r r r r# r* r3 r4 r. r1 r2 r6 r9 r@ rD rG rH rJ rN rO rF rS rU rV rZ r] r^ r_ r` rc rd re rg rk rm r! r! r! r" r } s@
c K s" ||�}| � ||�}| �|� |S )a� Subelement factory which creates an element instance, and appends it
to an existing parent.
The element tag, attribute names, and attribute values can be either
bytes or Unicode strings.
*parent* is the parent element, *tag* is the subelements name, *attrib* is
an optional directory containing element attributes, *extra* are
additional attributes given as keyword arguments.
)r2 rJ )�parentr# r* r- r% r! r! r" r � s
c C s t t�}| |_|S )z�Comment element factory.
This function creates a special element which the standard serializer
serializes as an XML comment.
*text* is a string containing the comment string.
)r r r3 )r3 r% r! r! r" r � s c C s& t t�}| |_|r"|jd | |_|S )a* Processing Instruction element factory.
This function creates a special element which the standard serializer
serializes as an XML comment.
*target* is a string containing the processing instruction, *text* is a
string containing the processing instruction contents, if any.
� )r r r3 )�targetr3 r% r! r! r" r � s
c @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )r
a� Qualified name wrapper.
This class can be used to wrap a QName attribute value in order to get
proper namespace handing on output.
*text_or_uri* is a string containing the QName value either in the form
{uri}local, or if the tag argument is given, the URI part of a QName.
*tag* is an optional argument which if given, will make the first
argument (text_or_uri) be interpreted as a URI, and this argument (tag)
be interpreted as a local name.
Nc C s |rd||f }|| _ d S )Nz{%s}%s�r3 )r, Z text_or_urir# r! r! r" r. � s zQName.__init__c C s | j S r7 rr r0 r! r! r" �__str__� s z
QName.__str__c C s d| j j| jf S )Nz<%s %r>)r) r r3 r0 r! r! r" r1 s zQName.__repr__c C s
t | j�S r7 )�hashr3 r0 r! r! r" �__hash__ s zQName.__hash__c C s t |t�r| j|jkS | j|kS r7 �r& r
r3 �r, �otherr! r! r" �__le__ s
z QName.__le__c C s t |t�r| j|jk S | j|k S r7 rv rw r! r! r" �__lt__ s
z QName.__lt__c C s t |t�r| j|jkS | j|kS r7 rv rw r! r! r" �__ge__ s
z QName.__ge__c C s t |t�r| j|jkS | j|kS r7 rv rw r! r! r" �__gt__ s
z QName.__gt__c C s t |t�r| j|jkS | j|kS r7 rv rw r! r! r" �__eq__ s
z QName.__eq__)N)
r r r r r. rs r1 ru ry rz r{ r| r} r! r! r! r" r
� s
c @ s� e Zd ZdZd dd�Zdd� Zdd� Zd d d
�Zd d d �Zd d
d�Z d!dd�Z
d"dd�Z d#dd�Z d$dd�Z
d%dd�dd�Zdd � ZdS )&r a% An XML element hierarchy.
This class also provides support for serialization to and from
standard XML.
*element* is an optional root element node,
*file* is an optional file handle or file name of an XML file whose
contents will be used to initialize the tree with.
Nc C s || _ |r| �|� d S r7 )�_rootr )r, r% �filer! r! r" r. ' s zElementTree.__init__c C s | j S )z!Return root element of this tree.�r~ r0 r! r! r" �getroot- s zElementTree.getrootc C s
|| _ dS )z�Replace root element of this tree.
This will discard the current contents of the tree and replace it
with the given element. Use with care!
Nr� )r, r% r! r! r" �_setroot1 s zElementTree._setrootc C s� d}t |d�s t|d�}d}z^|dkrLt� }t |d�rL|�|�| _| jW �2S |�d�}|s\qh|�|� qL|�� | _| jW �S |r�|�� X dS )a= Load external XML document into element tree.
*source* is a file name or file object, *parser* is an optional parser
instance that defaults to XMLParser.
ParseError is raised if the parser fails to parse the document.
Returns the root element of the given source document.
F�read�rbTN� _parse_wholei )r$ �open�closer r� r~ r� �feed)r, �source�parser� close_source�datar! r! r" r ; s$
zElementTree.parsec C s | j �|�S )z�Create and return tree iterator for the root element.
The iterator loops over all elements in this tree, in document order.
*tag* is a string with the tag name to iterate over
(default is to return all elements).
)r~ rg rj r! r! r" rg ` s
zElementTree.iterc C s t jdtdd� t| �|��S )NzbThis method will be removed in future versions. Use 'tree.iter()' or 'list(tree.iter())' instead.r: r; rh rj r! r! r" rk m s �zElementTree.getiteratorc C s: |dd� dkr,d| }t jd| tdd� | j�||�S )a\ Find first matching element by tag name or path.
Same as getroot().find(path), which is Element.find()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
Nr �/�.��This search is broken in 1.3 and earlier, and will be fixed in a future version. If you rely on the current behaviour, change it to %rr: r; )r= r> r? r~ rV rW r! r! r" rV u s � �zElementTree.findc C s< |dd� dkr,d| }t jd| tdd� | j�|||�S )ae Find first matching element by tag name or path.
Same as getroot().findtext(path), which is Element.findtext()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
Nr r� r� r� r: r; )r= r> r? r~ rZ r[ r! r! r" rZ � s � �zElementTree.findtextc C s: |dd� dkr,d| }t jd| tdd� | j�||�S )aa Find all matching subelements by tag name or path.
Same as getroot().findall(path), which is Element.findall().
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return list containing all matching elements in document order.
Nr r� r� r� r: r; )r= r> r? r~ r] rW r! r! r" r] � s � �zElementTree.findallc C s: |dd� dkr,d| }t jd| tdd� | j�||�S )ag Find all matching subelements by tag name or path.
Same as getroot().iterfind(path), which is element.iterfind()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return an iterable yielding all matching elements in document order.
Nr r� r� r� r: r; )r= r> r? r~ r^ rW r! r! r" r^ � s � �zElementTree.iterfindT��short_empty_elementsc C s� |s
d}n|t kr td| ��|s4|dkr0d}nd}|�� }t||���}|dkr�|sd|dkr�|dkr�|} |dkr�d dl}
|
�� } |d
| f � |d kr�t|| j� n,t| j|�\} } t | }
|
|| j| | |d � W 5 Q R X dS )
a� Write element tree to a file as XML.
Arguments:
*file_or_filename* -- file name or a file object opened for writing
*encoding* -- the output encoding (default: US-ASCII)
*xml_declaration* -- bool indicating if an XML declaration should be
added to the output. If None, an XML declaration
is added if encoding IS NOT either of:
US-ASCII, UTF-8, or Unicode
*default_namespace* -- sets the default XML namespace (for "xmlns")
*method* -- either "xml" (default), "html, "text", or "c14n"
*short_empty_elements* -- controls the formatting of elements
that contain no content. If True (default)
they are emitted as a single self-closed
tag, otherwise they are emitted as a pair
of start/end tags
�xmlzunknown method %r�c14n�utf-8�us-asciiN)r� r� �unicoder� r z$<?xml version='1.0' encoding='%s'?>
r3 r� ) �
_serialize�
ValueError�lower� _get_writer�localeZgetpreferredencoding�_serialize_textr~ � _namespaces)r, �file_or_filename�encoding�xml_declaration�default_namespace�methodr� Z enc_lower�writeZdeclared_encodingr� �qnamesrY Z serializer! r! r" r� � s: ��� �zElementTree.writec C s | j |dd�S )Nr� )r� )r� )r, r r! r! r" �
write_c14n s zElementTree.write_c14n)NN)N)N)N)N)NN)N)N)NNNN)r r r r r. r� r� r rg rk rV rZ r] r^ r� r� r! r! r! r" r s&
%
�� :c c s" z
| j }W nP tk
rZ |dkr.t| d�}nt| d|dd�}|� |j V W 5 Q R X Y n�X |dkrl|V n�t�� ��}t| tj�r�| }nft| tj�r�t� | �}|�
|j � nBt�� }dd� |_ ||_ z| j
|_
| j|_W n tk
r� Y nX tj||ddd�}|�
|j � |j V W 5 Q R X d S ) Nr� �w�xmlcharrefreplace)r� �errorsc S s dS �NTr! r! r! r! r" �<lambda>0 � z _get_writer.<locals>.<lambda>�
)r� r� �newline)r� �AttributeErrorr� �
contextlib� ExitStackr& �io�BufferedIOBase� RawIOBase�BufferedWriter�callback�detach�writable�seekable�tell�
TextIOWrapper)r� r� r� r �stackr! r! r" r� sB
�
� r� c s d d i�i �� rd�� < � ��fdd�}| � � D ]�} | j}t|t�rZ|j�kr�||j� n<t|t�rv|�kr�||� n |d k r�|tk r�|tk r�t|� | � � D ]F\}}t|t�r�|j}|�kr�||� t|t�r�|j�kr�||j� q�| j}t|t�r0|j�kr0||j� q0��fS )N� c s� z�| d d� dkr�| dd � � dd�\}}��|�}|d krjt�|�}|d krZdt�� }|dkrj|�|< |r�d||f �| < q�|�| < n� r�td��| �| < W n tk
r� t| � Y nX d S )Nr �{�}zns%dr� z%s:%sz<cannot use non-qualified names with default_namespace option)�rsplitr` �_namespace_mapr8 r� r( �_raise_serialization_error)�qname�urir# �prefix�r� rY r� r! r" � add_qnameM s(
� z _namespaces.<locals>.add_qname)
rg r# r& r
r3 rl r r r� re )r5 r� r� r# ra rb r3 r! r� r" r� B s4
r� c K s� |j }|j}|tkr$| d| � �nv|tkr<| d| � �n^|| }|d kr||r\| t|�� |D ]}t| ||d |d� q`�n | d| � t|�� �} | s�|�r2|r�t|�� dd� d�D ](\}
} | r�d| } | d | t |
�f � q�| D ]L\} }
t
| t �r�| j} t
|
t ��r||
j }
nt |
�}
| d
|| |
f � q�|�sHt |��sH|�s�| d � |�rb| t|�� |D ]}t| ||d |d� �qf| d | d � n| d
� |j
�r�| t|j
�� d S )N� <!--%s-->�<?%s?>r� �<c S s | d S �Nr r! ��xr! r! r" r� � r� z _serialize_xml.<locals>.<lambda>�ra �:�
xmlns%s="%s"� %s="%s"�>�</z />)r# r3 r r �
_escape_cdata�_serialize_xmlri re �sorted�_escape_attribr& r
r8 r4 ) r� r5 r� rY r� �kwargsr# r3 rR re �v�kr! r! r" r� s\
�
��
�
r� )
Zarea�baseZbasefont�br�col�frameZhrZimg�inputZisindex�link�metaZparamc K s� |j }|j}|tkr(| dt|� � �n�|tkrD| dt|� � �nh|| }|d kr�|rd| t|�� |D ]}t| ||d � qh�n,| d| � t|�� �}|s�|�r8|r�t|�� dd� d�D ](\} }
|
r�d|
}
| d|
t | �f � q�|D ]N\}
} t
|
t ��r|
j}
t
| t ��r|| j } nt | �} | d ||
| f � q�| d
� |�
� } |�rx| d k�sb| d k�rl| |� n | t|�� |D ]}t| ||d � �q|| tk�r�| d
| d
� |j�r�| t|j�� d S )Nr� r� r� c S s | d S r� r! r� r! r! r" r� � r� z!_serialize_html.<locals>.<lambda>r� r� r� r� r� ZscriptZstyler� )r# r3 r r� r �_serialize_htmlri re r� r� r& r
�_escape_attrib_htmlr� �
HTML_EMPTYr4 ) r� r5 r� rY r� r# r3 rR re r� r� Zltagr! r! r" r� � sX
��
r� c C s* |� � D ] }| |� q|jr&| |j� d S r7 )rm r4 )r� r5 �partr! r! r" r� � s
r� )r� �htmlr3 c C sL t �d| �rtd��tt�� �D ] \}}||ks8|| kr t|= q | t|< dS )at Register a namespace prefix.
The registry is global, and any existing mapping for either the
given prefix or the namespace URI will be removed.
*prefix* is the namespace prefix, *uri* is a namespace uri. Tags and
attributes in this namespace will be serialized with prefix if possible.
ValueError is raised if prefix is reserved or is invalid.
zns\d+$z'Prefix format reserved for internal useN)�re�matchr� ri r� re )r� r� r� r� r! r! r" r � s r� r� ZrdfZwsdlZxsZxsiZdc)�$http://www.w3.org/XML/1998/namespacez http://www.w3.org/1999/xhtmlz+http://www.w3.org/1999/02/22-rdf-syntax-ns#z http://schemas.xmlsoap.org/wsdl/z http://www.w3.org/2001/XMLSchemaz)http://www.w3.org/2001/XMLSchema-instancez http://purl.org/dc/elements/1.1/c C s t d| t| �jf ��d S )Nz cannot serialize %r (type %s))r( rQ r rr r! r! r" r� s �r� c C sh zBd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} | W S ttfk
rb t| � Y nX d S )N�&�&r� �<r� �>��replacer( r� r� rr r! r! r" r� ! s r� c C s� z�d| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} d | krf| � d d
�} d | krz| � d d
�} d
| kr�| � d
d �} d
| kr�| � d
d�} | W S ttfk
r� t| � Y nX d S )Nr� r� r� r� r� r� �"�"z
r� �
z � z	r� rr r! r! r" r� 1 s( r� c C sh zBd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} | W S ttfk
rb t| � Y nX d S )Nr� r� r� r� r� r� r� rr r! r! r" r� M s r� T)r� r� r� c C s: |dkrt �� nt �� }t| �j||||||d� |�� S )a
Generate string representation of XML element.
All subelements are included. If encoding is "unicode", a string
is returned. Otherwise a bytestring is returned.
*element* is an Element instance, *encoding* is an optional output
encoding defaulting to US-ASCII, *method* is an optional output which can
be one of "xml" (default), "html", "text" or "c14n", *default_namespace*
sets the default XML namespace (for "xmlns").
Returns an (optionally) encoded string containing the XML data.
r� �r� r� r� r� )r� �StringIO�BytesIOr r� �getvalue)r% r� r� r� r� r� �streamr! r! r" r \ s �c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�_ListDataStreamz7An auxiliary stream accumulating into a list reference.c C s
|| _ d S r7 )�lst)r, r� r! r! r" r. v s z_ListDataStream.__init__c C s dS r� r! r0 r! r! r" r� y s z_ListDataStream.writablec C s dS r� r! r0 r! r! r" r� | s z_ListDataStream.seekablec C s | j �|� d S r7 )r� rJ )r, �br! r! r" r� s z_ListDataStream.writec C s
t | j�S r7 )r8 r� r0 r! r! r" r� � s z_ListDataStream.tellN) r r r r r. r� r� r� r� r! r! r! r" r� t s r� c C s* g }t |�}t| �j||||||d� |S )Nr� )r� r r� )r% r� r� r� r� r� r� r� r! r! r" r � s �c C sL t | t�st| �} | jtjdd� | �� j}|r<|d dkrHtj�d� dS )a# Write element tree or element structure to sys.stdout.
This function should be used for debugging only.
*elem* is either an ElementTree, or a single Element. The exact output
format is implementation dependent. In this version, it's written as an
ordinary XML file.
r� )r� ���r� N)r& r r� �sys�stdoutr� r4 )r5 r4 r! r! r" r � s
c C s t � }|�| |� |S )z�Parse XML document into element tree.
*source* is a filename or file object containing XML data,
*parser* is an optional parser instance defaulting to XMLParser.
Return an ElementTree instance.
)r r )r� r� �treer! r! r" r � s c sf t ||d��� ���fdd��G �fdd�dtjj�}|� �d�_�~d� t�d�sbt�d ��d
� �S ) aJ Incrementally parse XML document into ElementTree.
This class also reports what's going on to the user based on the
*events* it is initialized with. The supported events are the strings
"start", "end", "start-ns" and "end-ns" (the "ns" events are used to get
detailed namespace information). If *events* is omitted, only
"end" events are reported.
*source* is a filename or file object containing XML data, *events* is
a list of events to report back, *parser* is an optional parser instance.
Returns an iterator providing (event, elem) pairs.
)�events�_parserc 3 s^ zJ��� E d H ��d�} | s q,��| � q��� }��� E d H |�_W 5 � rX�� � X d S )Ni @ )r� � read_eventsr� r� �_close_and_return_root�root)r� r )r� �it�
pullparserr� r! r" �iterator� s
ziterparse.<locals>.iteratorc s e Zd Z� � jZdS )z$iterparse.<locals>.IterParseIteratorN)r r r �__next__r! )r r! r" �IterParseIterator� s r NFr� r� T)r � collections�abc�Iteratorr r$ r� )r� r� r� r r! )r� r r r r� r" r � s
c @ s< e Zd Zd
dd�dd�Zdd� Zdd� Zd d
� Zd d � ZdS )r N)r c C s< t �� | _|ptt� d�| _|d kr(d}| j�| j|� d S )N�rq )�end)r �deque�
_events_queuer r r �
_setevents)r, r� r r! r! r" r. � s
zXMLPullParser.__init__c
C sZ | j dkrtd��|rVz| j �|� W n. tk
rT } z| j�|� W 5 d}~X Y nX dS )� Feed encoded data to parser.Nz!feed() called after end of stream)r r� r� � SyntaxErrorr rJ )r, r� �excr! r! r" r� � s
zXMLPullParser.feedc C s | j �� }d | _ |S r7 )r r� )r, r r! r! r" r � s
z$XMLPullParser._close_and_return_rootc C s | � � dS )z�Finish feeding data to parser.
Unlike XMLParser, does not return the root element. Use
read_events() to consume elements from XMLPullParser.
N)r r0 r! r! r" r� s zXMLPullParser.closec c s. | j }|r*|�� }t|t�r"|�q|V qdS )z�Return an iterator over currently available (event, elem) pairs.
Events are consumed from the internal event queue as they are
retrieved from the iterator.
N)r �popleftr& � Exception)r, r� �eventr! r! r" r s
zXMLPullParser.read_events)N)r r r r. r� r r� r r! r! r! r" r � s
c C s" |st t� d�}|�| � |�� S )a Parse XML document from string constant.
This function can be used to embed "XML Literals" in Python code.
*text* is a string containing XML data, *parser* is an
optional parser instance, defaulting to the standard XMLParser.
Returns an Element instance.
r �r r r� r� )r3 r� r! r! r" r s
c C sR |st t� d�}|�| � |�� }i }|�� D ]}|�d�}|r.|||< q.||fS )a Parse XML document from string constant for its IDs.
*text* is a string containing XML data, *parser* is an
optional parser instance, defaulting to the standard XMLParser.
Returns an (Element, dict) tuple, in which the
dict maps element id:s to elements.
r r/ )r r r� r� rg r` )r3 r� r� Zidsr5 r/ r! r! r" r , s
c C s, |st t� d�}| D ]}|�|� q|�� S )z�Parse XML document from sequence of string fragments.
*sequence* is a list of other sequence, *parser* is an optional parser
instance, defaulting to the standard XMLParser.
Returns an Element instance.
r r )Zsequencer� r3 r! r! r" r D s
c @ sh e Zd ZdZdddddd�dd�Zdd� Zd d
� Zd d � Zd
d� Zdd� Z dd� Z
ddd�Z dd� Z dS )r a8 Generic element structure builder.
This builder converts a sequence of start, data, and end method
calls to a well-formed element structure.
You can use this class to build an element structure using a custom XML
parser, or a parser for some other XML-like format.
*element_factory* is an optional element factory which is called
to create new Element instances, as necessary.
*comment_factory* is a factory to create comments to be used instead of
the standard factory. If *insert_comments* is false (the default),
comments will not be inserted into the tree.
*pi_factory* is a factory to create processing instructions to be used
instead of the standard factory. If *insert_pis* is false (the default),
processing instructions will not be inserted into the tree.
NF)�comment_factory�
pi_factory�insert_comments�
insert_pisc C sd g | _ g | _d | _d | _d | _|d kr*t}|| _|| _|d krBt}|| _ || _
|d krZt }|| _ d S r7 )
�_data�_elem�_lastr~ �_tailr �_comment_factoryr r � _pi_factoryr r �_factory)r, Zelement_factoryr r r r r! r! r" r. j s zTreeBuilder.__init__c C s. t | j�dkstd��| jdk s(td��| jS )z;Flush builder buffers and return toplevel document Element.r zmissing end tagsNzmissing toplevel element)r8 r �AssertionErrorr~ r0 r! r! r" r� ~ s zTreeBuilder.closec C sf | j rb| jd k r\d�| j �}| jr@| jjd ks6td��|| j_n | jjd ksTtd��|| j_g | _ d S )Nr� zinternal error (tail)zinternal error (text))r r �joinr r4 r# r3 �r, r3 r! r! r" �_flush� s
zTreeBuilder._flushc C s | j �|� dS )z Add text to current element.N)r rJ �r, r� r! r! r" r� � s zTreeBuilder.datac C sX | � � | �||� | _}| jr2| jd �|� n| jdkrB|| _| j�|� d| _|S )z�Open new element and return it.
*tag* is the element name, *attrs* is a dict containing element
attributes.
r� Nr )r& r" r r rJ r~ r )r, r# �attrsr5 r! r! r" �start� s
zTreeBuilder.startc C s@ | � � | j�� | _| jj|ks4td| jj|f ��d| _| jS )zOClose and return current Element.
*tag* is the element name.
z&end tag mismatch (expected %s, got %s)r )r& r �popr r# r# r rj r! r! r" r
� s ��zTreeBuilder.endc C s | � | j| j|�S )z`Create a comment using the comment_factory.
*text* is the text of the comment.
)�_handle_singler r r% r! r! r" �comment� s
�zTreeBuilder.commentc C s | � | j| j||�S )z�Create a processing instruction using the pi_factory.
*target* is the target name of the processing instruction.
*text* is the data of the processing instruction, or ''.
)r+ r! r )r, rq r3 r! r! r" �pi� s �zTreeBuilder.pic G s: ||� }|r6| � � || _| jr0| jd �|� d| _|S )Nr� r )r& r r rJ r )r, �factoryrO �argsr5 r! r! r" r+ � s zTreeBuilder._handle_single)N)N)
r r r r r. r� r& r� r) r
r, r- r+ r! r! r! r" r V s �
c @ sp e Zd ZdZddd�dd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dd� ZdS )r aa Element structure builder for XML source data based on the expat parser.
*target* is an optional target object which defaults to an instance of the
standard TreeBuilder class, *encoding* is an optional encoding string
which if given, overrides the encoding specified in the XML file:
http://www.iana.org/assignments/character-sets
N)rq r� c C sd zddl m} W n> tk
rN z dd l}W n tk
rH td��Y nX Y nX |�|d�}|d krjt� }| | _| _| | _| _ |j
| _ i | _ | j
|_t|d�r�| j|_t|d�r�| j|_t|d�r�| j|_t|d�r�| j|_t|d �r�|j|_t|d
��r|j|_t|d ��r|j |_ d |_ d |_ d |_ d | _!i | _"zd
|j# | _$W n t%k
�r^ Y nX d S )Nr ��expatz7No module named expat; use SimpleXMLTreeBuilder insteadr� r) r
�start_ns�end_nsr� r, r- r zExpat %d.%d.%d)&� xml.parsersr1 � ImportErrorZpyexpatZ ParserCreater r� r rq �_target�error�_error�_names�_defaultZDefaultHandlerExpandr$ �_start�StartElementHandler�_end�EndElementHandler� _start_ns�StartNamespaceDeclHandler�_end_ns�EndNamespaceDeclHandlerr� ZCharacterDataHandlerr, �CommentHandlerr- � ProcessingInstructionHandlerZ buffer_text�ordered_attributes�specified_attributes�_doctype�entity� version_info�versionr� )r, rq r� r1 r� r! r! r" r. � sP �
zXMLParser.__init__c C s8 | j }|j}|D �] }|dkrDd|_d|_||| jfdd�}||_q|dkrf||| jfdd�}||_q|dkr�t| j d�r�||| j
fd d�}n||fd
d�}||_ q|d kr�t| j d �r�||| j fd
d�}n||fdd�}||_
q|dk�r||| fdd�}||_q|dk�r&||| fdd�}||_qtd| ��qd S )Nr) r c S s |||| |�f� d S r7 r! )r# Z attrib_inr rJ r) r! r! r" �handler s z%XMLParser._setevents.<locals>.handlerr
c S s |||| �f� d S r7 r! )r# r rJ r
r! r! r" rK s zstart-nsr2 c S s |||| |�f� d S r7 r! )r� r� r rJ r2 r! r! r" rK ! s c S s ||| p
d|pdff� d S �Nr� r! )r� r� r rJ r! r! r" rK % s zend-nsr3 c S s |||| �f� d S r7 r! )r� r rJ r3 r! r! r" rK + s c S s ||d f� d S r7 r! )r� r rJ r! r! r" rK / s r, c S s |||j �| �f� d S r7 )rq r, )r3 r rJ r, r! r! r" rK 3 s r- c S s |||j �| |�f� d S r7 )rq r- )Z pi_targetr� r rJ r, r! r! r" rK 7 s zunknown event %r)r rJ rE rF r; r< r= r> r$ rq r? r@ rA rB rC rD r� )r, Z events_queueZevents_to_reportr� rJ Z
event_namerK r! r! r" r sL
�
�
� �
�
zXMLParser._seteventsc C s& t |�}|j|_|j|jf|_|�d S r7 )r
�code�lineno�offsetZposition)r, rb �errr! r! r" � _raiseerror> s zXMLParser._raiseerrorc C sF z| j | }W n2 tk
r@ |}d|kr2d| }|| j |< Y nX |S )Nr� r� )r9 �KeyError)r, ra �namer! r! r" �_fixnameD s zXMLParser._fixnamec C s | j �|p d|pd�S rL )rq r2 �r, r� r� r! r! r" r? O s zXMLParser._start_nsc C s | j �|p d�S rL )rq r3 )r, r� r! r! r" rA R s zXMLParser._end_nsc C sR | j }||�}i }|rDtdt|�d�D ] }||d |||| �< q&| j�||�S )Nr r: r )rT �ranger8 rq r) )r, r# � attr_listZfixnamer* �ir! r! r" r; U s zXMLParser._startc C s | j �| �|��S r7 )rq r
rT rj r! r! r" r= a s zXMLParser._endc C s� |d d� }|dkr�z | j j}W n tk
r6 Y d S X z|| j|dd� � W nZ tk
r� ddlm} |�d|| jj | jj
f �}d|_ | jj |_ | jj
|_
|�Y nX �n"|dkr�|d d � d
kr�g | _�n | jd k �r�|d kr�d | _d S |�� }|�sd S | j�|� t| j�}|d k�r�| jd }|d
k�rd|dk�rd| j\}}} }
| �r�| dd� } n*|dk�r�|dk�r�| j\}}}
d } nd S t| j d��r�| j �|| |
dd� � nt| d��r�t�dt� d | _d S )Nr r� r� r r0 z'undefined entity %s: line %d, column %d� r� � z <!DOCTYPEr� r: ZPUBLIC� ZSYSTEM� �doctypezaThe doctype() method of XMLParser is ignored. Define doctype() method on the TreeBuilder target.)rq r� r� rH rR r4 r1 r7 r� ZErrorLineNumberZErrorColumnNumberrM rN rO rG �striprJ r8 r$ r] r= r> �RuntimeWarning) r, r3 r� Z data_handlerr1 rP �nrQ rS Zpubid�systemr! r! r" r: d sd ���
�zXMLParser._defaultc
C sF z| j �|d� W n. | jk
r@ } z| �|� W 5 d}~X Y nX dS )r r N)r� �Parser8 rQ )r, r� r� r! r! r" r� � s zXMLParser.feedc
C s� z| j �dd� W n. | jk
r@ } z| �|� W 5 d}~X Y nX z0z | jj}W n tk
rd Y n X |� W �S W 5 | ` | `| `| `X dS )z;Finish feeding data to parser and return element structure.r� r N) r� rb r8 rQ r rq r6 r� r� )r, r� Z
close_handlerr! r! r" r� � s zXMLParser.close)r r r r r. r rQ rT r? rA r; r= r: r� r� r! r! r! r" r � s .6 6)�out� from_filec K s� | dkr|dkrt d��d}|dkr0t�� }}tt|jf|�d�}| dk r`|�| � |�� n|dk rtt||d� |dk r�|� � S dS )a3 Convert XML to its C14N 2.0 serialised form.
If *out* is provided, it must be a file or file-like object that receives
the serialised canonical XML output (text, not bytes) through its ``.write()``
method. To write to a file, open it in text mode with encoding "utf-8".
If *out* is not provided, this function returns the output as text string.
Either *xml_data* (an XML string) or *from_file* (a file path or
file-like object) must be provided as input.
The configuration options are the same as for the ``C14NWriterTarget``.
Nz:Either 'xml_data' or 'from_file' must be provided as inputr )r� )
r� r� r� r r r� r� r� r r� )Zxml_datarc rd ZoptionsZsior� r! r! r" r � s
z ^\w+:\w+$c @ s� e Zd ZdZdddddddd�dd�Zefdd�Zd d
� Zd d d �Zd
d� Z dj
fdd�Z dd� Z dd� Z
d dd�Zdd� Zdd� Zd d � ZdS ) r a�
Canonicalization writer target for the XMLParser.
Serialises parse events to XML C14N 2.0.
The *write* function is used for writing out the resulting data stream
as text (not bytes). To write to a file, open it in text mode with encoding
"utf-8" and pass its ``.write`` method.
Configuration options:
- *with_comments*: set to true to include comments
- *strip_text*: set to true to strip whitespace before and after text content
- *rewrite_prefixes*: set to true to replace namespace prefixes by "n{number}"
- *qname_aware_tags*: a set of qname aware tag names in which prefixes
should be replaced in text content
- *qname_aware_attrs*: a set of qname aware attribute names in which prefixes
should be replaced in text content
- *exclude_attrs*: a set of attribute names that should not be serialised
- *exclude_tags*: a set of tag names that should not be serialised
FN)�
with_comments�
strip_text�rewrite_prefixes�qname_aware_tags�qname_aware_attrs�
exclude_attrs� exclude_tagsc C s� || _ g | _|| _|| _|r$t|�nd | _|r6t|�nd | _|| _|rRt|�| _nd | _|rjt|�j | _
nd | _
dgg| _ g | _ |s�| j �
tt�� �� | j �
g � i | _dg| _d | _d| _d| _d| _d S )N)r� r� Fr )�_writer �_with_comments� _strip_textrc �_exclude_attrs�
_exclude_tags�_rewrite_prefixes�_qname_aware_tags� intersection�_find_qname_aware_attrs�_declared_ns_stack� _ns_stackrJ ri r� re � _prefix_map�_preserve_space�_pending_start�
_root_seen�
_root_done�_ignored_depth) r, r� re rf rg rh ri rj rk r! r! r" r. � s2 � zC14NWriterTarget.__init__c c s ||�D ]}|r|E d H qd S r7 r! )r, Zns_stackZ _reversedrY r! r! r" �_iter_namespaces s z!C14NWriterTarget._iter_namespacesc C s\ |� dd�\}}| �| j�D ]$\}}||kr d|� d|� � S q td|� d|� d���d S )Nr� r r� r� zPrefix z of QName "�" is not declared in scope)�splitr} rv r� )r, Z
prefixed_namer� rS r� �pr! r! r" �_resolve_prefix_name s
z%C14NWriterTarget._resolve_prefix_namec C s� |d kr:|d d� dkr,|dd � � dd�nd|f\}}n|}t� }| �| j�D ]B\}}||kr�||kr�|rz|� d|� �n|||f S |�|� qP| jr�|| jkr�| j| }ndt| j�� � }| j|< | jd �||f� |� d|� �||fS |�s d|k�r |||fS | �| j �D ]J\}}||k�r| jd �||f� |�rR|� d|� �n|||f S �q|�st|||fS t
d|� d ���d S )
Nr r� r� r� r� r` r� z Namespace "r~ ) r� rc r} ru �addrq rw r8 rJ rv r� )r, r� r� r# Z
prefixes_seen�ur� r! r! r" �_qname s. 2
&
zC14NWriterTarget._qnamec C s | j s| j�|� d S r7 )r| r rJ r' r! r! r" r� C s zC14NWriterTarget.datar� c C s� || j �}| j d d �= | jr.| jd s.|�� }| jd k rv| jd }| _|rVt|�rV|nd }| j||f�� |d k rvd S |r�| jr�| �t |�� d S �Nr� )
r rn rx r^ ry �_looks_like_prefix_namer; rz rl �_escape_cdata_c14n)r, Z
_join_textr� r/ �
qname_textr! r! r" r& G s
zC14NWriterTarget._flushc C s0 | j r
d S | jr| �� | jd �||f� d S r� )r| r r& rv rJ rU r! r! r" r2 U s
zC14NWriterTarget.start_nsc C s� | j d k r,| js|| j kr,| jd7 _d S | jr:| �� g }| j�|� | jd k rn|| jkrn|||f| _d S | �|||� d S r� ) rp r| r r& ru rJ rr ry r; )r, r# r( �new_namespacesr! r! r" r) ] s
�� zC14NWriterTarget.startc s �j d k r$|r$�fdd�|�� D �}|h|�}i }|d k rV��|� }||< |�|� �jd k r�|r���|�}|r�|D ]0} || }
t|
�rv��|
� }||
< |�|� qvq�d }nd }�j� � fdd�t|dd� d�D �} |r�dd� |D �} | �� ng } |�rjt|�� �D ]^\}
}|d k �r@|
|k�r@||k�r@| || d }| |
\}} }| � |�r\|n| |f� �q
|�
d
�}�j � |�r�|d kn�j d � �j }|d
| | d � | �r�|d�
dd� | D ��� |d� |d k �r�|t| || d �� d�_�j� g � d S )Nc s i | ]\}}|� j kr||�qS r! )ro ��.0r� r� r0 r! r" �
<dictcomp>p s
z+C14NWriterTarget._start.<locals>.<dictcomp>c s i | ]}|� |��qS r! r! )r� r` )� parse_qnamer! r" r� � s c S s | � dd�S )Nr� r )r )r` r! r! r" r� � r� z)C14NWriterTarget._start.<locals>.<lambda>r� c S s$ g | ] \}}|rd | nd|f�qS )zxmlns:Zxmlnsr! )r� r� r� r! r! r" �
<listcomp>� s �z+C14NWriterTarget._start.<locals>.<listcomp>r z+{http://www.w3.org/XML/1998/namespace}spaceZpreserver� r� r� c S s& g | ] \}}d |� dt |�� d��qS )rp z="r� )�_escape_attrib_c14nr� r! r! r" r� � s r� T)ro re r� r� rt r� r� r� �sortrJ r` rx rl r$ r� rz rv )r, r# r( r� r� r� Zresolved_namesr� ZqattrsZ attr_namerb Z
parsed_qnamesrW r� r� Z
attr_qnamer� Zspace_behaviourr� r! )r� r, r" r; n s`
�
�
�
zC14NWriterTarget._startc C st | j r| j d8 _ d S | jr&| �� | �d| �|�d � d�� | j�� t| j�dk| _| j �� | j
�� d S )Nr r� r r� ) r| r r& rl r� rx r* r8 r{ ru rv rj r! r! r" r
� s
zC14NWriterTarget.endc C sd | j s
d S | jrd S | jr&| �d� n| jr:| jr:| �� | �dt|�� d�� | js`| �d� d S )Nr� z<!--z-->)rm r| r{ rl rz r r& r� r% r! r! r" r, � s zC14NWriterTarget.commentc C sp | j r
d S | jr | �d� n| jr0| jr0| �� | �|rNd|� dt|�� d�n
d|� d�� | jsl| �d� d S )Nr� z<?rp z?>)r| r{ rl rz r r& r� )r, rq r� r! r! r" r- � s $�zC14NWriterTarget.pi)N)N)r r r r r. �reversedr} r� r� r� r$ r& r2 r) r; r
r, r- r! r! r! r" r � s( � %
%
E
c C s| zVd| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} | W S ttfk
rv t| � Y nX d S ) Nr� r� r� r� r� r� r� �
r� rr r! r! r" r� � s r� c C s� z~d| kr| � dd�} d| kr*| � dd�} d| kr>| � dd�} d| krR| � dd�} d | krf| � d d
�} d | krz| � d d �} | W S ttfk
r� t| � Y nX d S )
Nr� r� r� r� r� r� r� z	r� z
r� r� r� rr r! r! r" r� � s r� )rf )�_set_factories)N)N)N)NN)NN)N)NN)N)N)N)N)@r �__all__r r� r� r= r� r Zcollections.abcr� r� r r r
r r r r r r r
r �contextmanagerr� r� r� r� rc � NameErrorr� r� r� r r� r� r� r� r� r r� r� r r r r r r r r r r r r �compile�UNICODEr� r� r r� r� rP Z _elementtreer� r5 r! r! r! r" �<module> s� J � >
0 s
3
=2 2� �
� �
05
z g U
e5d � @ sP d dl Z ddlmZ dZed Zed ZG dd� de�Zd d d
�Zd
d d�Z dS )� N� )� ElementTreez!{http://www.w3.org/2001/XInclude}�includeZfallbackc @ s e Zd ZdS )�FatalIncludeErrorN)�__name__�
__module__� __qualname__� r r �0/usr/lib64/python3.8/xml/etree/ElementInclude.pyr > s r c C s\ |dkr.t | d��}t�|��� }W 5 Q R X n*|s6d}t | d|d��}|�� }W 5 Q R X |S )N�xml�rbzUTF-8�r)�encoding)�openr �parseZgetroot�read)�hrefr r �file�datar r r
�default_loaderM s r c C sh |d kr t }d}|t| �k �rd| | }|jtk�r4|�d�}|�dd�}|dkr�|||�}|d krrtd||f ��t�|�}|jr�|jp�d|j |_|| |< n�|dk�r&||||�d��}|d kr�td||f ��|r�| |d }|jp�d| |jp�d |_n | j�pd| |j�pd | _| |= qn td
| ��n&|jt k�rPtd |j ��n
t
||� |d }qd S ) Nr r r r zcannot load %r as %r� �textr r z)unknown parse type in xi:include tag (%r)z0xi:fallback tag must be child of xi:include (%r)) r �len�tag�XINCLUDE_INCLUDE�getr �copy�tailr �XINCLUDE_FALLBACKr )�elem�loader�i�er r Znoder r r r
r c sN
�
� � �
)N)N)
r r r ZXINCLUDEr r � SyntaxErrorr r r r r r r
�<module>3 s
# $Id: __init__.py 3375 2008-02-13 08:05:08Z fredrik $
# elementtree package
# --------------------------------------------------------------------
# The ElementTree toolkit is
#
# Copyright (c) 1999-2008 by Fredrik Lundh
#
# By obtaining, using, and/or copying this software and/or its
# associated documentation, you agree that you have read, understood,
# and will comply with the following terms and conditions:
#
# Permission to use, copy, modify, and distribute this software and
# its associated documentation for any purpose and without fee is
# hereby granted, provided that the above copyright notice appears in
# all copies, and that both that copyright notice and this permission
# notice appear in supporting documentation, and that the name of
# Secret Labs AB or the author not be used in advertising or publicity
# pertaining to distribution of the software without specific, written
# prior permission.
#
# SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
# ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR
# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
# OF THIS SOFTWARE.
# --------------------------------------------------------------------
# Licensed to PSF under a Contributor Agreement.
# See http://www.python.org/psf/license for licensing details.
"""Lightweight XML support for Python.
XML is an inherently hierarchical data format, and the most natural way to
represent it is with a tree. This module has two classes for this purpose:
1. ElementTree represents the whole XML document as a tree and
2. Element represents a single node in this tree.
Interactions with the whole document (reading and writing to/from files) are
usually done on the ElementTree level. Interactions with a single XML element
and its sub-elements are done on the Element level.
Element is a flexible container object designed to store hierarchical data
structures in memory. It can be described as a cross between a list and a
dictionary. Each Element has a number of properties associated with it:
'tag' - a string containing the element's name.
'attributes' - a Python dictionary storing the element's attributes.
'text' - a string containing the element's text content.
'tail' - an optional string containing text after the element's end tag.
And a number of child elements stored in a Python sequence.
To create an element instance, use the Element constructor,
or the SubElement factory function.
You can also use the ElementTree class to wrap an element structure
and convert it to and from XML.
"""
#---------------------------------------------------------------------
# Licensed to PSF under a Contributor Agreement.
# See http://www.python.org/psf/license for licensing details.
#
# ElementTree
# Copyright (c) 1999-2008 by Fredrik Lundh. All rights reserved.
#
# fredrik@pythonware.com
# http://www.pythonware.com
# --------------------------------------------------------------------
# The ElementTree toolkit is
#
# Copyright (c) 1999-2008 by Fredrik Lundh
#
# By obtaining, using, and/or copying this software and/or its
# associated documentation, you agree that you have read, understood,
# and will comply with the following terms and conditions:
#
# Permission to use, copy, modify, and distribute this software and
# its associated documentation for any purpose and without fee is
# hereby granted, provided that the above copyright notice appears in
# all copies, and that both that copyright notice and this permission
# notice appear in supporting documentation, and that the name of
# Secret Labs AB or the author not be used in advertising or publicity
# pertaining to distribution of the software without specific, written
# prior permission.
#
# SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
# ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR
# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
# OF THIS SOFTWARE.
# --------------------------------------------------------------------
__all__ = [
# public symbols
"Comment",
"dump",
"Element", "ElementTree",
"fromstring", "fromstringlist",
"iselement", "iterparse",
"parse", "ParseError",
"PI", "ProcessingInstruction",
"QName",
"SubElement",
"tostring", "tostringlist",
"TreeBuilder",
"VERSION",
"XML", "XMLID",
"XMLParser", "XMLPullParser",
"register_namespace",
"canonicalize", "C14NWriterTarget",
]
VERSION = "1.3.0"
import sys
import re
import warnings
import io
import collections
import collections.abc
import contextlib
from . import ElementPath
class ParseError(SyntaxError):
"""An error when parsing an XML document.
In addition to its exception value, a ParseError contains
two extra attributes:
'code' - the specific exception code
'position' - the line and column of the error
"""
pass
# --------------------------------------------------------------------
def iselement(element):
"""Return True if *element* appears to be an Element."""
return hasattr(element, 'tag')
class Element:
"""An XML element.
This class is the reference implementation of the Element interface.
An element's length is its number of subelements. That means if you
want to check if an element is truly empty, you should check BOTH
its length AND its text attribute.
The element tag, attribute names, and attribute values can be either
bytes or strings.
*tag* is the element name. *attrib* is an optional dictionary containing
element attributes. *extra* are additional element attributes given as
keyword arguments.
Example form:
<tag attrib>text<child/>...</tag>tail
"""
tag = None
"""The element's name."""
attrib = None
"""Dictionary of the element's attributes."""
text = None
"""
Text before first subelement. This is either a string or the value None.
Note that if there is no text, this attribute may be either
None or the empty string, depending on the parser.
"""
tail = None
"""
Text after this element's end tag, but before the next sibling element's
start tag. This is either a string or the value None. Note that if there
was no text, this attribute may be either None or an empty string,
depending on the parser.
"""
def __init__(self, tag, attrib={}, **extra):
if not isinstance(attrib, dict):
raise TypeError("attrib must be dict, not %s" % (
attrib.__class__.__name__,))
self.tag = tag
self.attrib = {**attrib, **extra}
self._children = []
def __repr__(self):
return "<%s %r at %#x>" % (self.__class__.__name__, self.tag, id(self))
def makeelement(self, tag, attrib):
"""Create a new element with the same type.
*tag* is a string containing the element name.
*attrib* is a dictionary containing the element attributes.
Do not call this method, use the SubElement factory function instead.
"""
return self.__class__(tag, attrib)
def copy(self):
"""Return copy of current element.
This creates a shallow copy. Subelements will be shared with the
original tree.
"""
elem = self.makeelement(self.tag, self.attrib)
elem.text = self.text
elem.tail = self.tail
elem[:] = self
return elem
def __len__(self):
return len(self._children)
def __bool__(self):
warnings.warn(
"The behavior of this method will change in future versions. "
"Use specific 'len(elem)' or 'elem is not None' test instead.",
FutureWarning, stacklevel=2
)
return len(self._children) != 0 # emulate old behaviour, for now
def __getitem__(self, index):
return self._children[index]
def __setitem__(self, index, element):
if isinstance(index, slice):
for elt in element:
self._assert_is_element(elt)
else:
self._assert_is_element(element)
self._children[index] = element
def __delitem__(self, index):
del self._children[index]
def append(self, subelement):
"""Add *subelement* to the end of this element.
The new element will appear in document order after the last existing
subelement (or directly after the text, if it's the first subelement),
but before the end tag for this element.
"""
self._assert_is_element(subelement)
self._children.append(subelement)
def extend(self, elements):
"""Append subelements from a sequence.
*elements* is a sequence with zero or more elements.
"""
for element in elements:
self._assert_is_element(element)
self._children.append(element)
def insert(self, index, subelement):
"""Insert *subelement* at position *index*."""
self._assert_is_element(subelement)
self._children.insert(index, subelement)
def _assert_is_element(self, e):
# Need to refer to the actual Python implementation, not the
# shadowing C implementation.
if not isinstance(e, _Element_Py):
raise TypeError('expected an Element, not %s' % type(e).__name__)
def remove(self, subelement):
"""Remove matching subelement.
Unlike the find methods, this method compares elements based on
identity, NOT ON tag value or contents. To remove subelements by
other means, the easiest way is to use a list comprehension to
select what elements to keep, and then use slice assignment to update
the parent element.
ValueError is raised if a matching element could not be found.
"""
# assert iselement(element)
self._children.remove(subelement)
def getchildren(self):
"""(Deprecated) Return all subelements.
Elements are returned in document order.
"""
warnings.warn(
"This method will be removed in future versions. "
"Use 'list(elem)' or iteration over elem instead.",
DeprecationWarning, stacklevel=2
)
return self._children
def find(self, path, namespaces=None):
"""Find first matching element by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
"""
return ElementPath.find(self, path, namespaces)
def findtext(self, path, default=None, namespaces=None):
"""Find text for first matching element by tag name or path.
*path* is a string having either an element tag or an XPath,
*default* is the value to return if the element was not found,
*namespaces* is an optional mapping from namespace prefix to full name.
Return text content of first matching element, or default value if
none was found. Note that if an element is found having no text
content, the empty string is returned.
"""
return ElementPath.findtext(self, path, default, namespaces)
def findall(self, path, namespaces=None):
"""Find all matching subelements by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Returns list containing all matching elements in document order.
"""
return ElementPath.findall(self, path, namespaces)
def iterfind(self, path, namespaces=None):
"""Find all matching subelements by tag name or path.
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return an iterable yielding all matching elements in document order.
"""
return ElementPath.iterfind(self, path, namespaces)
def clear(self):
"""Reset element.
This function removes all subelements, clears all attributes, and sets
the text and tail attributes to None.
"""
self.attrib.clear()
self._children = []
self.text = self.tail = None
def get(self, key, default=None):
"""Get element attribute.
Equivalent to attrib.get, but some implementations may handle this a
bit more efficiently. *key* is what attribute to look for, and
*default* is what to return if the attribute was not found.
Returns a string containing the attribute value, or the default if
attribute was not found.
"""
return self.attrib.get(key, default)
def set(self, key, value):
"""Set element attribute.
Equivalent to attrib[key] = value, but some implementations may handle
this a bit more efficiently. *key* is what attribute to set, and
*value* is the attribute value to set it to.
"""
self.attrib[key] = value
def keys(self):
"""Get list of attribute names.
Names are returned in an arbitrary order, just like an ordinary
Python dict. Equivalent to attrib.keys()
"""
return self.attrib.keys()
def items(self):
"""Get element attributes as a sequence.
The attributes are returned in arbitrary order. Equivalent to
attrib.items().
Return a list of (name, value) tuples.
"""
return self.attrib.items()
def iter(self, tag=None):
"""Create tree iterator.
The iterator loops over the element and all subelements in document
order, returning all elements with a matching tag.
If the tree structure is modified during iteration, new or removed
elements may or may not be included. To get a stable set, use the
list() function on the iterator, and loop over the resulting list.
*tag* is what tags to look for (default is to return all elements)
Return an iterator containing all the matching elements.
"""
if tag == "*":
tag = None
if tag is None or self.tag == tag:
yield self
for e in self._children:
yield from e.iter(tag)
# compatibility
def getiterator(self, tag=None):
warnings.warn(
"This method will be removed in future versions. "
"Use 'elem.iter()' or 'list(elem.iter())' instead.",
DeprecationWarning, stacklevel=2
)
return list(self.iter(tag))
def itertext(self):
"""Create text iterator.
The iterator loops over the element and all subelements in document
order, returning all inner text.
"""
tag = self.tag
if not isinstance(tag, str) and tag is not None:
return
t = self.text
if t:
yield t
for e in self:
yield from e.itertext()
t = e.tail
if t:
yield t
def SubElement(parent, tag, attrib={}, **extra):
"""Subelement factory which creates an element instance, and appends it
to an existing parent.
The element tag, attribute names, and attribute values can be either
bytes or Unicode strings.
*parent* is the parent element, *tag* is the subelements name, *attrib* is
an optional directory containing element attributes, *extra* are
additional attributes given as keyword arguments.
"""
attrib = {**attrib, **extra}
element = parent.makeelement(tag, attrib)
parent.append(element)
return element
def Comment(text=None):
"""Comment element factory.
This function creates a special element which the standard serializer
serializes as an XML comment.
*text* is a string containing the comment string.
"""
element = Element(Comment)
element.text = text
return element
def ProcessingInstruction(target, text=None):
"""Processing Instruction element factory.
This function creates a special element which the standard serializer
serializes as an XML comment.
*target* is a string containing the processing instruction, *text* is a
string containing the processing instruction contents, if any.
"""
element = Element(ProcessingInstruction)
element.text = target
if text:
element.text = element.text + " " + text
return element
PI = ProcessingInstruction
class QName:
"""Qualified name wrapper.
This class can be used to wrap a QName attribute value in order to get
proper namespace handing on output.
*text_or_uri* is a string containing the QName value either in the form
{uri}local, or if the tag argument is given, the URI part of a QName.
*tag* is an optional argument which if given, will make the first
argument (text_or_uri) be interpreted as a URI, and this argument (tag)
be interpreted as a local name.
"""
def __init__(self, text_or_uri, tag=None):
if tag:
text_or_uri = "{%s}%s" % (text_or_uri, tag)
self.text = text_or_uri
def __str__(self):
return self.text
def __repr__(self):
return '<%s %r>' % (self.__class__.__name__, self.text)
def __hash__(self):
return hash(self.text)
def __le__(self, other):
if isinstance(other, QName):
return self.text <= other.text
return self.text <= other
def __lt__(self, other):
if isinstance(other, QName):
return self.text < other.text
return self.text < other
def __ge__(self, other):
if isinstance(other, QName):
return self.text >= other.text
return self.text >= other
def __gt__(self, other):
if isinstance(other, QName):
return self.text > other.text
return self.text > other
def __eq__(self, other):
if isinstance(other, QName):
return self.text == other.text
return self.text == other
# --------------------------------------------------------------------
class ElementTree:
"""An XML element hierarchy.
This class also provides support for serialization to and from
standard XML.
*element* is an optional root element node,
*file* is an optional file handle or file name of an XML file whose
contents will be used to initialize the tree with.
"""
def __init__(self, element=None, file=None):
# assert element is None or iselement(element)
self._root = element # first node
if file:
self.parse(file)
def getroot(self):
"""Return root element of this tree."""
return self._root
def _setroot(self, element):
"""Replace root element of this tree.
This will discard the current contents of the tree and replace it
with the given element. Use with care!
"""
# assert iselement(element)
self._root = element
def parse(self, source, parser=None):
"""Load external XML document into element tree.
*source* is a file name or file object, *parser* is an optional parser
instance that defaults to XMLParser.
ParseError is raised if the parser fails to parse the document.
Returns the root element of the given source document.
"""
close_source = False
if not hasattr(source, "read"):
source = open(source, "rb")
close_source = True
try:
if parser is None:
# If no parser was specified, create a default XMLParser
parser = XMLParser()
if hasattr(parser, '_parse_whole'):
# The default XMLParser, when it comes from an accelerator,
# can define an internal _parse_whole API for efficiency.
# It can be used to parse the whole source without feeding
# it with chunks.
self._root = parser._parse_whole(source)
return self._root
while True:
data = source.read(65536)
if not data:
break
parser.feed(data)
self._root = parser.close()
return self._root
finally:
if close_source:
source.close()
def iter(self, tag=None):
"""Create and return tree iterator for the root element.
The iterator loops over all elements in this tree, in document order.
*tag* is a string with the tag name to iterate over
(default is to return all elements).
"""
# assert self._root is not None
return self._root.iter(tag)
# compatibility
def getiterator(self, tag=None):
warnings.warn(
"This method will be removed in future versions. "
"Use 'tree.iter()' or 'list(tree.iter())' instead.",
DeprecationWarning, stacklevel=2
)
return list(self.iter(tag))
def find(self, path, namespaces=None):
"""Find first matching element by tag name or path.
Same as getroot().find(path), which is Element.find()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
"""
# assert self._root is not None
if path[:1] == "/":
path = "." + path
warnings.warn(
"This search is broken in 1.3 and earlier, and will be "
"fixed in a future version. If you rely on the current "
"behaviour, change it to %r" % path,
FutureWarning, stacklevel=2
)
return self._root.find(path, namespaces)
def findtext(self, path, default=None, namespaces=None):
"""Find first matching element by tag name or path.
Same as getroot().findtext(path), which is Element.findtext()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return the first matching element, or None if no element was found.
"""
# assert self._root is not None
if path[:1] == "/":
path = "." + path
warnings.warn(
"This search is broken in 1.3 and earlier, and will be "
"fixed in a future version. If you rely on the current "
"behaviour, change it to %r" % path,
FutureWarning, stacklevel=2
)
return self._root.findtext(path, default, namespaces)
def findall(self, path, namespaces=None):
"""Find all matching subelements by tag name or path.
Same as getroot().findall(path), which is Element.findall().
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return list containing all matching elements in document order.
"""
# assert self._root is not None
if path[:1] == "/":
path = "." + path
warnings.warn(
"This search is broken in 1.3 and earlier, and will be "
"fixed in a future version. If you rely on the current "
"behaviour, change it to %r" % path,
FutureWarning, stacklevel=2
)
return self._root.findall(path, namespaces)
def iterfind(self, path, namespaces=None):
"""Find all matching subelements by tag name or path.
Same as getroot().iterfind(path), which is element.iterfind()
*path* is a string having either an element tag or an XPath,
*namespaces* is an optional mapping from namespace prefix to full name.
Return an iterable yielding all matching elements in document order.
"""
# assert self._root is not None
if path[:1] == "/":
path = "." + path
warnings.warn(
"This search is broken in 1.3 and earlier, and will be "
"fixed in a future version. If you rely on the current "
"behaviour, change it to %r" % path,
FutureWarning, stacklevel=2
)
return self._root.iterfind(path, namespaces)
def write(self, file_or_filename,
encoding=None,
xml_declaration=None,
default_namespace=None,
method=None, *,
short_empty_elements=True):
"""Write element tree to a file as XML.
Arguments:
*file_or_filename* -- file name or a file object opened for writing
*encoding* -- the output encoding (default: US-ASCII)
*xml_declaration* -- bool indicating if an XML declaration should be
added to the output. If None, an XML declaration
is added if encoding IS NOT either of:
US-ASCII, UTF-8, or Unicode
*default_namespace* -- sets the default XML namespace (for "xmlns")
*method* -- either "xml" (default), "html, "text", or "c14n"
*short_empty_elements* -- controls the formatting of elements
that contain no content. If True (default)
they are emitted as a single self-closed
tag, otherwise they are emitted as a pair
of start/end tags
"""
if not method:
method = "xml"
elif method not in _serialize:
raise ValueError("unknown method %r" % method)
if not encoding:
if method == "c14n":
encoding = "utf-8"
else:
encoding = "us-ascii"
enc_lower = encoding.lower()
with _get_writer(file_or_filename, enc_lower) as write:
if method == "xml" and (xml_declaration or
(xml_declaration is None and
enc_lower not in ("utf-8", "us-ascii", "unicode"))):
declared_encoding = encoding
if enc_lower == "unicode":
# Retrieve the default encoding for the xml declaration
import locale
declared_encoding = locale.getpreferredencoding()
write("<?xml version='1.0' encoding='%s'?>\n" % (
declared_encoding,))
if method == "text":
_serialize_text(write, self._root)
else:
qnames, namespaces = _namespaces(self._root, default_namespace)
serialize = _serialize[method]
serialize(write, self._root, qnames, namespaces,
short_empty_elements=short_empty_elements)
def write_c14n(self, file):
# lxml.etree compatibility. use output method instead
return self.write(file, method="c14n")
# --------------------------------------------------------------------
# serialization support
@contextlib.contextmanager
def _get_writer(file_or_filename, encoding):
# returns text write method and release all resources after using
try:
write = file_or_filename.write
except AttributeError:
# file_or_filename is a file name
if encoding == "unicode":
file = open(file_or_filename, "w")
else:
file = open(file_or_filename, "w", encoding=encoding,
errors="xmlcharrefreplace")
with file:
yield file.write
else:
# file_or_filename is a file-like object
# encoding determines if it is a text or binary writer
if encoding == "unicode":
# use a text writer as is
yield write
else:
# wrap a binary writer with TextIOWrapper
with contextlib.ExitStack() as stack:
if isinstance(file_or_filename, io.BufferedIOBase):
file = file_or_filename
elif isinstance(file_or_filename, io.RawIOBase):
file = io.BufferedWriter(file_or_filename)
# Keep the original file open when the BufferedWriter is
# destroyed
stack.callback(file.detach)
else:
# This is to handle passed objects that aren't in the
# IOBase hierarchy, but just have a write method
file = io.BufferedIOBase()
file.writable = lambda: True
file.write = write
try:
# TextIOWrapper uses this methods to determine
# if BOM (for UTF-16, etc) should be added
file.seekable = file_or_filename.seekable
file.tell = file_or_filename.tell
except AttributeError:
pass
file = io.TextIOWrapper(file,
encoding=encoding,
errors="xmlcharrefreplace",
newline="\n")
# Keep the original file open when the TextIOWrapper is
# destroyed
stack.callback(file.detach)
yield file.write
def _namespaces(elem, default_namespace=None):
# identify namespaces used in this tree
# maps qnames to *encoded* prefix:local names
qnames = {None: None}
# maps uri:s to prefixes
namespaces = {}
if default_namespace:
namespaces[default_namespace] = ""
def add_qname(qname):
# calculate serialized qname representation
try:
if qname[:1] == "{":
uri, tag = qname[1:].rsplit("}", 1)
prefix = namespaces.get(uri)
if prefix is None:
prefix = _namespace_map.get(uri)
if prefix is None:
prefix = "ns%d" % len(namespaces)
if prefix != "xml":
namespaces[uri] = prefix
if prefix:
qnames[qname] = "%s:%s" % (prefix, tag)
else:
qnames[qname] = tag # default element
else:
if default_namespace:
# FIXME: can this be handled in XML 1.0?
raise ValueError(
"cannot use non-qualified names with "
"default_namespace option"
)
qnames[qname] = qname
except TypeError:
_raise_serialization_error(qname)
# populate qname and namespaces table
for elem in elem.iter():
tag = elem.tag
if isinstance(tag, QName):
if tag.text not in qnames:
add_qname(tag.text)
elif isinstance(tag, str):
if tag not in qnames:
add_qname(tag)
elif tag is not None and tag is not Comment and tag is not PI:
_raise_serialization_error(tag)
for key, value in elem.items():
if isinstance(key, QName):
key = key.text
if key not in qnames:
add_qname(key)
if isinstance(value, QName) and value.text not in qnames:
add_qname(value.text)
text = elem.text
if isinstance(text, QName) and text.text not in qnames:
add_qname(text.text)
return qnames, namespaces
def _serialize_xml(write, elem, qnames, namespaces,
short_empty_elements, **kwargs):
tag = elem.tag
text = elem.text
if tag is Comment:
write("<!--%s-->" % text)
elif tag is ProcessingInstruction:
write("<?%s?>" % text)
else:
tag = qnames[tag]
if tag is None:
if text:
write(_escape_cdata(text))
for e in elem:
_serialize_xml(write, e, qnames, None,
short_empty_elements=short_empty_elements)
else:
write("<" + tag)
items = list(elem.items())
if items or namespaces:
if namespaces:
for v, k in sorted(namespaces.items(),
key=lambda x: x[1]): # sort on prefix
if k:
k = ":" + k
write(" xmlns%s=\"%s\"" % (
k,
_escape_attrib(v)
))
for k, v in items:
if isinstance(k, QName):
k = k.text
if isinstance(v, QName):
v = qnames[v.text]
else:
v = _escape_attrib(v)
write(" %s=\"%s\"" % (qnames[k], v))
if text or len(elem) or not short_empty_elements:
write(">")
if text:
write(_escape_cdata(text))
for e in elem:
_serialize_xml(write, e, qnames, None,
short_empty_elements=short_empty_elements)
write("</" + tag + ">")
else:
write(" />")
if elem.tail:
write(_escape_cdata(elem.tail))
HTML_EMPTY = ("area", "base", "basefont", "br", "col", "frame", "hr",
"img", "input", "isindex", "link", "meta", "param")
try:
HTML_EMPTY = set(HTML_EMPTY)
except NameError:
pass
def _serialize_html(write, elem, qnames, namespaces, **kwargs):
tag = elem.tag
text = elem.text
if tag is Comment:
write("<!--%s-->" % _escape_cdata(text))
elif tag is ProcessingInstruction:
write("<?%s?>" % _escape_cdata(text))
else:
tag = qnames[tag]
if tag is None:
if text:
write(_escape_cdata(text))
for e in elem:
_serialize_html(write, e, qnames, None)
else:
write("<" + tag)
items = list(elem.items())
if items or namespaces:
if namespaces:
for v, k in sorted(namespaces.items(),
key=lambda x: x[1]): # sort on prefix
if k:
k = ":" + k
write(" xmlns%s=\"%s\"" % (
k,
_escape_attrib(v)
))
for k, v in items:
if isinstance(k, QName):
k = k.text
if isinstance(v, QName):
v = qnames[v.text]
else:
v = _escape_attrib_html(v)
# FIXME: handle boolean attributes
write(" %s=\"%s\"" % (qnames[k], v))
write(">")
ltag = tag.lower()
if text:
if ltag == "script" or ltag == "style":
write(text)
else:
write(_escape_cdata(text))
for e in elem:
_serialize_html(write, e, qnames, None)
if ltag not in HTML_EMPTY:
write("</" + tag + ">")
if elem.tail:
write(_escape_cdata(elem.tail))
def _serialize_text(write, elem):
for part in elem.itertext():
write(part)
if elem.tail:
write(elem.tail)
_serialize = {
"xml": _serialize_xml,
"html": _serialize_html,
"text": _serialize_text,
# this optional method is imported at the end of the module
# "c14n": _serialize_c14n,
}
def register_namespace(prefix, uri):
"""Register a namespace prefix.
The registry is global, and any existing mapping for either the
given prefix or the namespace URI will be removed.
*prefix* is the namespace prefix, *uri* is a namespace uri. Tags and
attributes in this namespace will be serialized with prefix if possible.
ValueError is raised if prefix is reserved or is invalid.
"""
if re.match(r"ns\d+$", prefix):
raise ValueError("Prefix format reserved for internal use")
for k, v in list(_namespace_map.items()):
if k == uri or v == prefix:
del _namespace_map[k]
_namespace_map[uri] = prefix
_namespace_map = {
# "well-known" namespace prefixes
"http://www.w3.org/XML/1998/namespace": "xml",
"http://www.w3.org/1999/xhtml": "html",
"http://www.w3.org/1999/02/22-rdf-syntax-ns#": "rdf",
"http://schemas.xmlsoap.org/wsdl/": "wsdl",
# xml schema
"http://www.w3.org/2001/XMLSchema": "xs",
"http://www.w3.org/2001/XMLSchema-instance": "xsi",
# dublin core
"http://purl.org/dc/elements/1.1/": "dc",
}
# For tests and troubleshooting
register_namespace._namespace_map = _namespace_map
def _raise_serialization_error(text):
raise TypeError(
"cannot serialize %r (type %s)" % (text, type(text).__name__)
)
def _escape_cdata(text):
# escape character data
try:
# it's worth avoiding do-nothing calls for strings that are
# shorter than 500 characters, or so. assume that's, by far,
# the most common case in most applications.
if "&" in text:
text = text.replace("&", "&")
if "<" in text:
text = text.replace("<", "<")
if ">" in text:
text = text.replace(">", ">")
return text
except (TypeError, AttributeError):
_raise_serialization_error(text)
def _escape_attrib(text):
# escape attribute value
try:
if "&" in text:
text = text.replace("&", "&")
if "<" in text:
text = text.replace("<", "<")
if ">" in text:
text = text.replace(">", ">")
if "\"" in text:
text = text.replace("\"", """)
# The following business with carriage returns is to satisfy
# Section 2.11 of the XML specification, stating that
# CR or CR LN should be replaced with just LN
# http://www.w3.org/TR/REC-xml/#sec-line-ends
if "\r\n" in text:
text = text.replace("\r\n", "\n")
if "\r" in text:
text = text.replace("\r", "\n")
#The following four lines are issue 17582
if "\n" in text:
text = text.replace("\n", " ")
if "\t" in text:
text = text.replace("\t", "	")
return text
except (TypeError, AttributeError):
_raise_serialization_error(text)
def _escape_attrib_html(text):
# escape attribute value
try:
if "&" in text:
text = text.replace("&", "&")
if ">" in text:
text = text.replace(">", ">")
if "\"" in text:
text = text.replace("\"", """)
return text
except (TypeError, AttributeError):
_raise_serialization_error(text)
# --------------------------------------------------------------------
def tostring(element, encoding=None, method=None, *,
xml_declaration=None, default_namespace=None,
short_empty_elements=True):
"""Generate string representation of XML element.
All subelements are included. If encoding is "unicode", a string
is returned. Otherwise a bytestring is returned.
*element* is an Element instance, *encoding* is an optional output
encoding defaulting to US-ASCII, *method* is an optional output which can
be one of "xml" (default), "html", "text" or "c14n", *default_namespace*
sets the default XML namespace (for "xmlns").
Returns an (optionally) encoded string containing the XML data.
"""
stream = io.StringIO() if encoding == 'unicode' else io.BytesIO()
ElementTree(element).write(stream, encoding,
xml_declaration=xml_declaration,
default_namespace=default_namespace,
method=method,
short_empty_elements=short_empty_elements)
return stream.getvalue()
class _ListDataStream(io.BufferedIOBase):
"""An auxiliary stream accumulating into a list reference."""
def __init__(self, lst):
self.lst = lst
def writable(self):
return True
def seekable(self):
return True
def write(self, b):
self.lst.append(b)
def tell(self):
return len(self.lst)
def tostringlist(element, encoding=None, method=None, *,
xml_declaration=None, default_namespace=None,
short_empty_elements=True):
lst = []
stream = _ListDataStream(lst)
ElementTree(element).write(stream, encoding,
xml_declaration=xml_declaration,
default_namespace=default_namespace,
method=method,
short_empty_elements=short_empty_elements)
return lst
def dump(elem):
"""Write element tree or element structure to sys.stdout.
This function should be used for debugging only.
*elem* is either an ElementTree, or a single Element. The exact output
format is implementation dependent. In this version, it's written as an
ordinary XML file.
"""
# debugging
if not isinstance(elem, ElementTree):
elem = ElementTree(elem)
elem.write(sys.stdout, encoding="unicode")
tail = elem.getroot().tail
if not tail or tail[-1] != "\n":
sys.stdout.write("\n")
# --------------------------------------------------------------------
# parsing
def parse(source, parser=None):
"""Parse XML document into element tree.
*source* is a filename or file object containing XML data,
*parser* is an optional parser instance defaulting to XMLParser.
Return an ElementTree instance.
"""
tree = ElementTree()
tree.parse(source, parser)
return tree
def iterparse(source, events=None, parser=None):
"""Incrementally parse XML document into ElementTree.
This class also reports what's going on to the user based on the
*events* it is initialized with. The supported events are the strings
"start", "end", "start-ns" and "end-ns" (the "ns" events are used to get
detailed namespace information). If *events* is omitted, only
"end" events are reported.
*source* is a filename or file object containing XML data, *events* is
a list of events to report back, *parser* is an optional parser instance.
Returns an iterator providing (event, elem) pairs.
"""
# Use the internal, undocumented _parser argument for now; When the
# parser argument of iterparse is removed, this can be killed.
pullparser = XMLPullParser(events=events, _parser=parser)
def iterator():
try:
while True:
yield from pullparser.read_events()
# load event buffer
data = source.read(16 * 1024)
if not data:
break
pullparser.feed(data)
root = pullparser._close_and_return_root()
yield from pullparser.read_events()
it.root = root
finally:
if close_source:
source.close()
class IterParseIterator(collections.abc.Iterator):
__next__ = iterator().__next__
it = IterParseIterator()
it.root = None
del iterator, IterParseIterator
close_source = False
if not hasattr(source, "read"):
source = open(source, "rb")
close_source = True
return it
class XMLPullParser:
def __init__(self, events=None, *, _parser=None):
# The _parser argument is for internal use only and must not be relied
# upon in user code. It will be removed in a future release.
# See http://bugs.python.org/issue17741 for more details.
self._events_queue = collections.deque()
self._parser = _parser or XMLParser(target=TreeBuilder())
# wire up the parser for event reporting
if events is None:
events = ("end",)
self._parser._setevents(self._events_queue, events)
def feed(self, data):
"""Feed encoded data to parser."""
if self._parser is None:
raise ValueError("feed() called after end of stream")
if data:
try:
self._parser.feed(data)
except SyntaxError as exc:
self._events_queue.append(exc)
def _close_and_return_root(self):
# iterparse needs this to set its root attribute properly :(
root = self._parser.close()
self._parser = None
return root
def close(self):
"""Finish feeding data to parser.
Unlike XMLParser, does not return the root element. Use
read_events() to consume elements from XMLPullParser.
"""
self._close_and_return_root()
def read_events(self):
"""Return an iterator over currently available (event, elem) pairs.
Events are consumed from the internal event queue as they are
retrieved from the iterator.
"""
events = self._events_queue
while events:
event = events.popleft()
if isinstance(event, Exception):
raise event
else:
yield event
def XML(text, parser=None):
"""Parse XML document from string constant.
This function can be used to embed "XML Literals" in Python code.
*text* is a string containing XML data, *parser* is an
optional parser instance, defaulting to the standard XMLParser.
Returns an Element instance.
"""
if not parser:
parser = XMLParser(target=TreeBuilder())
parser.feed(text)
return parser.close()
def XMLID(text, parser=None):
"""Parse XML document from string constant for its IDs.
*text* is a string containing XML data, *parser* is an
optional parser instance, defaulting to the standard XMLParser.
Returns an (Element, dict) tuple, in which the
dict maps element id:s to elements.
"""
if not parser:
parser = XMLParser(target=TreeBuilder())
parser.feed(text)
tree = parser.close()
ids = {}
for elem in tree.iter():
id = elem.get("id")
if id:
ids[id] = elem
return tree, ids
# Parse XML document from string constant. Alias for XML().
fromstring = XML
def fromstringlist(sequence, parser=None):
"""Parse XML document from sequence of string fragments.
*sequence* is a list of other sequence, *parser* is an optional parser
instance, defaulting to the standard XMLParser.
Returns an Element instance.
"""
if not parser:
parser = XMLParser(target=TreeBuilder())
for text in sequence:
parser.feed(text)
return parser.close()
# --------------------------------------------------------------------
class TreeBuilder:
"""Generic element structure builder.
This builder converts a sequence of start, data, and end method
calls to a well-formed element structure.
You can use this class to build an element structure using a custom XML
parser, or a parser for some other XML-like format.
*element_factory* is an optional element factory which is called
to create new Element instances, as necessary.
*comment_factory* is a factory to create comments to be used instead of
the standard factory. If *insert_comments* is false (the default),
comments will not be inserted into the tree.
*pi_factory* is a factory to create processing instructions to be used
instead of the standard factory. If *insert_pis* is false (the default),
processing instructions will not be inserted into the tree.
"""
def __init__(self, element_factory=None, *,
comment_factory=None, pi_factory=None,
insert_comments=False, insert_pis=False):
self._data = [] # data collector
self._elem = [] # element stack
self._last = None # last element
self._root = None # root element
self._tail = None # true if we're after an end tag
if comment_factory is None:
comment_factory = Comment
self._comment_factory = comment_factory
self.insert_comments = insert_comments
if pi_factory is None:
pi_factory = ProcessingInstruction
self._pi_factory = pi_factory
self.insert_pis = insert_pis
if element_factory is None:
element_factory = Element
self._factory = element_factory
def close(self):
"""Flush builder buffers and return toplevel document Element."""
assert len(self._elem) == 0, "missing end tags"
assert self._root is not None, "missing toplevel element"
return self._root
def _flush(self):
if self._data:
if self._last is not None:
text = "".join(self._data)
if self._tail:
assert self._last.tail is None, "internal error (tail)"
self._last.tail = text
else:
assert self._last.text is None, "internal error (text)"
self._last.text = text
self._data = []
def data(self, data):
"""Add text to current element."""
self._data.append(data)
def start(self, tag, attrs):
"""Open new element and return it.
*tag* is the element name, *attrs* is a dict containing element
attributes.
"""
self._flush()
self._last = elem = self._factory(tag, attrs)
if self._elem:
self._elem[-1].append(elem)
elif self._root is None:
self._root = elem
self._elem.append(elem)
self._tail = 0
return elem
def end(self, tag):
"""Close and return current Element.
*tag* is the element name.
"""
self._flush()
self._last = self._elem.pop()
assert self._last.tag == tag,\
"end tag mismatch (expected %s, got %s)" % (
self._last.tag, tag)
self._tail = 1
return self._last
def comment(self, text):
"""Create a comment using the comment_factory.
*text* is the text of the comment.
"""
return self._handle_single(
self._comment_factory, self.insert_comments, text)
def pi(self, target, text=None):
"""Create a processing instruction using the pi_factory.
*target* is the target name of the processing instruction.
*text* is the data of the processing instruction, or ''.
"""
return self._handle_single(
self._pi_factory, self.insert_pis, target, text)
def _handle_single(self, factory, insert, *args):
elem = factory(*args)
if insert:
self._flush()
self._last = elem
if self._elem:
self._elem[-1].append(elem)
self._tail = 1
return elem
# also see ElementTree and TreeBuilder
class XMLParser:
"""Element structure builder for XML source data based on the expat parser.
*target* is an optional target object which defaults to an instance of the
standard TreeBuilder class, *encoding* is an optional encoding string
which if given, overrides the encoding specified in the XML file:
http://www.iana.org/assignments/character-sets
"""
def __init__(self, *, target=None, encoding=None):
try:
from xml.parsers import expat
except ImportError:
try:
import pyexpat as expat
except ImportError:
raise ImportError(
"No module named expat; use SimpleXMLTreeBuilder instead"
)
parser = expat.ParserCreate(encoding, "}")
if target is None:
target = TreeBuilder()
# underscored names are provided for compatibility only
self.parser = self._parser = parser
self.target = self._target = target
self._error = expat.error
self._names = {} # name memo cache
# main callbacks
parser.DefaultHandlerExpand = self._default
if hasattr(target, 'start'):
parser.StartElementHandler = self._start
if hasattr(target, 'end'):
parser.EndElementHandler = self._end
if hasattr(target, 'start_ns'):
parser.StartNamespaceDeclHandler = self._start_ns
if hasattr(target, 'end_ns'):
parser.EndNamespaceDeclHandler = self._end_ns
if hasattr(target, 'data'):
parser.CharacterDataHandler = target.data
# miscellaneous callbacks
if hasattr(target, 'comment'):
parser.CommentHandler = target.comment
if hasattr(target, 'pi'):
parser.ProcessingInstructionHandler = target.pi
# Configure pyexpat: buffering, new-style attribute handling.
parser.buffer_text = 1
parser.ordered_attributes = 1
parser.specified_attributes = 1
self._doctype = None
self.entity = {}
try:
self.version = "Expat %d.%d.%d" % expat.version_info
except AttributeError:
pass # unknown
def _setevents(self, events_queue, events_to_report):
# Internal API for XMLPullParser
# events_to_report: a list of events to report during parsing (same as
# the *events* of XMLPullParser's constructor.
# events_queue: a list of actual parsing events that will be populated
# by the underlying parser.
#
parser = self._parser
append = events_queue.append
for event_name in events_to_report:
if event_name == "start":
parser.ordered_attributes = 1
parser.specified_attributes = 1
def handler(tag, attrib_in, event=event_name, append=append,
start=self._start):
append((event, start(tag, attrib_in)))
parser.StartElementHandler = handler
elif event_name == "end":
def handler(tag, event=event_name, append=append,
end=self._end):
append((event, end(tag)))
parser.EndElementHandler = handler
elif event_name == "start-ns":
# TreeBuilder does not implement .start_ns()
if hasattr(self.target, "start_ns"):
def handler(prefix, uri, event=event_name, append=append,
start_ns=self._start_ns):
append((event, start_ns(prefix, uri)))
else:
def handler(prefix, uri, event=event_name, append=append):
append((event, (prefix or '', uri or '')))
parser.StartNamespaceDeclHandler = handler
elif event_name == "end-ns":
# TreeBuilder does not implement .end_ns()
if hasattr(self.target, "end_ns"):
def handler(prefix, event=event_name, append=append,
end_ns=self._end_ns):
append((event, end_ns(prefix)))
else:
def handler(prefix, event=event_name, append=append):
append((event, None))
parser.EndNamespaceDeclHandler = handler
elif event_name == 'comment':
def handler(text, event=event_name, append=append, self=self):
append((event, self.target.comment(text)))
parser.CommentHandler = handler
elif event_name == 'pi':
def handler(pi_target, data, event=event_name, append=append,
self=self):
append((event, self.target.pi(pi_target, data)))
parser.ProcessingInstructionHandler = handler
else:
raise ValueError("unknown event %r" % event_name)
def _raiseerror(self, value):
err = ParseError(value)
err.code = value.code
err.position = value.lineno, value.offset
raise err
def _fixname(self, key):
# expand qname, and convert name string to ascii, if possible
try:
name = self._names[key]
except KeyError:
name = key
if "}" in name:
name = "{" + name
self._names[key] = name
return name
def _start_ns(self, prefix, uri):
return self.target.start_ns(prefix or '', uri or '')
def _end_ns(self, prefix):
return self.target.end_ns(prefix or '')
def _start(self, tag, attr_list):
# Handler for expat's StartElementHandler. Since ordered_attributes
# is set, the attributes are reported as a list of alternating
# attribute name,value.
fixname = self._fixname
tag = fixname(tag)
attrib = {}
if attr_list:
for i in range(0, len(attr_list), 2):
attrib[fixname(attr_list[i])] = attr_list[i+1]
return self.target.start(tag, attrib)
def _end(self, tag):
return self.target.end(self._fixname(tag))
def _default(self, text):
prefix = text[:1]
if prefix == "&":
# deal with undefined entities
try:
data_handler = self.target.data
except AttributeError:
return
try:
data_handler(self.entity[text[1:-1]])
except KeyError:
from xml.parsers import expat
err = expat.error(
"undefined entity %s: line %d, column %d" %
(text, self.parser.ErrorLineNumber,
self.parser.ErrorColumnNumber)
)
err.code = 11 # XML_ERROR_UNDEFINED_ENTITY
err.lineno = self.parser.ErrorLineNumber
err.offset = self.parser.ErrorColumnNumber
raise err
elif prefix == "<" and text[:9] == "<!DOCTYPE":
self._doctype = [] # inside a doctype declaration
elif self._doctype is not None:
# parse doctype contents
if prefix == ">":
self._doctype = None
return
text = text.strip()
if not text:
return
self._doctype.append(text)
n = len(self._doctype)
if n > 2:
type = self._doctype[1]
if type == "PUBLIC" and n == 4:
name, type, pubid, system = self._doctype
if pubid:
pubid = pubid[1:-1]
elif type == "SYSTEM" and n == 3:
name, type, system = self._doctype
pubid = None
else:
return
if hasattr(self.target, "doctype"):
self.target.doctype(name, pubid, system[1:-1])
elif hasattr(self, "doctype"):
warnings.warn(
"The doctype() method of XMLParser is ignored. "
"Define doctype() method on the TreeBuilder target.",
RuntimeWarning)
self._doctype = None
def feed(self, data):
"""Feed encoded data to parser."""
try:
self.parser.Parse(data, 0)
except self._error as v:
self._raiseerror(v)
def close(self):
"""Finish feeding data to parser and return element structure."""
try:
self.parser.Parse("", 1) # end of data
except self._error as v:
self._raiseerror(v)
try:
close_handler = self.target.close
except AttributeError:
pass
else:
return close_handler()
finally:
# get rid of circular references
del self.parser, self._parser
del self.target, self._target
# --------------------------------------------------------------------
# C14N 2.0
def canonicalize(xml_data=None, *, out=None, from_file=None, **options):
"""Convert XML to its C14N 2.0 serialised form.
If *out* is provided, it must be a file or file-like object that receives
the serialised canonical XML output (text, not bytes) through its ``.write()``
method. To write to a file, open it in text mode with encoding "utf-8".
If *out* is not provided, this function returns the output as text string.
Either *xml_data* (an XML string) or *from_file* (a file path or
file-like object) must be provided as input.
The configuration options are the same as for the ``C14NWriterTarget``.
"""
if xml_data is None and from_file is None:
raise ValueError("Either 'xml_data' or 'from_file' must be provided as input")
sio = None
if out is None:
sio = out = io.StringIO()
parser = XMLParser(target=C14NWriterTarget(out.write, **options))
if xml_data is not None:
parser.feed(xml_data)
parser.close()
elif from_file is not None:
parse(from_file, parser=parser)
return sio.getvalue() if sio is not None else None
_looks_like_prefix_name = re.compile(r'^\w+:\w+$', re.UNICODE).match
class C14NWriterTarget:
"""
Canonicalization writer target for the XMLParser.
Serialises parse events to XML C14N 2.0.
The *write* function is used for writing out the resulting data stream
as text (not bytes). To write to a file, open it in text mode with encoding
"utf-8" and pass its ``.write`` method.
Configuration options:
- *with_comments*: set to true to include comments
- *strip_text*: set to true to strip whitespace before and after text content
- *rewrite_prefixes*: set to true to replace namespace prefixes by "n{number}"
- *qname_aware_tags*: a set of qname aware tag names in which prefixes
should be replaced in text content
- *qname_aware_attrs*: a set of qname aware attribute names in which prefixes
should be replaced in text content
- *exclude_attrs*: a set of attribute names that should not be serialised
- *exclude_tags*: a set of tag names that should not be serialised
"""
def __init__(self, write, *,
with_comments=False, strip_text=False, rewrite_prefixes=False,
qname_aware_tags=None, qname_aware_attrs=None,
exclude_attrs=None, exclude_tags=None):
self._write = write
self._data = []
self._with_comments = with_comments
self._strip_text = strip_text
self._exclude_attrs = set(exclude_attrs) if exclude_attrs else None
self._exclude_tags = set(exclude_tags) if exclude_tags else None
self._rewrite_prefixes = rewrite_prefixes
if qname_aware_tags:
self._qname_aware_tags = set(qname_aware_tags)
else:
self._qname_aware_tags = None
if qname_aware_attrs:
self._find_qname_aware_attrs = set(qname_aware_attrs).intersection
else:
self._find_qname_aware_attrs = None
# Stack with globally and newly declared namespaces as (uri, prefix) pairs.
self._declared_ns_stack = [[
("http://www.w3.org/XML/1998/namespace", "xml"),
]]
# Stack with user declared namespace prefixes as (uri, prefix) pairs.
self._ns_stack = []
if not rewrite_prefixes:
self._ns_stack.append(list(_namespace_map.items()))
self._ns_stack.append([])
self._prefix_map = {}
self._preserve_space = [False]
self._pending_start = None
self._root_seen = False
self._root_done = False
self._ignored_depth = 0
def _iter_namespaces(self, ns_stack, _reversed=reversed):
for namespaces in _reversed(ns_stack):
if namespaces: # almost no element declares new namespaces
yield from namespaces
def _resolve_prefix_name(self, prefixed_name):
prefix, name = prefixed_name.split(':', 1)
for uri, p in self._iter_namespaces(self._ns_stack):
if p == prefix:
return f'{{{uri}}}{name}'
raise ValueError(f'Prefix {prefix} of QName "{prefixed_name}" is not declared in scope')
def _qname(self, qname, uri=None):
if uri is None:
uri, tag = qname[1:].rsplit('}', 1) if qname[:1] == '{' else ('', qname)
else:
tag = qname
prefixes_seen = set()
for u, prefix in self._iter_namespaces(self._declared_ns_stack):
if u == uri and prefix not in prefixes_seen:
return f'{prefix}:{tag}' if prefix else tag, tag, uri
prefixes_seen.add(prefix)
# Not declared yet => add new declaration.
if self._rewrite_prefixes:
if uri in self._prefix_map:
prefix = self._prefix_map[uri]
else:
prefix = self._prefix_map[uri] = f'n{len(self._prefix_map)}'
self._declared_ns_stack[-1].append((uri, prefix))
return f'{prefix}:{tag}', tag, uri
if not uri and '' not in prefixes_seen:
# No default namespace declared => no prefix needed.
return tag, tag, uri
for u, prefix in self._iter_namespaces(self._ns_stack):
if u == uri:
self._declared_ns_stack[-1].append((uri, prefix))
return f'{prefix}:{tag}' if prefix else tag, tag, uri
if not uri:
# As soon as a default namespace is defined,
# anything that has no namespace (and thus, no prefix) goes there.
return tag, tag, uri
raise ValueError(f'Namespace "{uri}" is not declared in scope')
def data(self, data):
if not self._ignored_depth:
self._data.append(data)
def _flush(self, _join_text=''.join):
data = _join_text(self._data)
del self._data[:]
if self._strip_text and not self._preserve_space[-1]:
data = data.strip()
if self._pending_start is not None:
args, self._pending_start = self._pending_start, None
qname_text = data if data and _looks_like_prefix_name(data) else None
self._start(*args, qname_text)
if qname_text is not None:
return
if data and self._root_seen:
self._write(_escape_cdata_c14n(data))
def start_ns(self, prefix, uri):
if self._ignored_depth:
return
# we may have to resolve qnames in text content
if self._data:
self._flush()
self._ns_stack[-1].append((uri, prefix))
def start(self, tag, attrs):
if self._exclude_tags is not None and (
self._ignored_depth or tag in self._exclude_tags):
self._ignored_depth += 1
return
if self._data:
self._flush()
new_namespaces = []
self._declared_ns_stack.append(new_namespaces)
if self._qname_aware_tags is not None and tag in self._qname_aware_tags:
# Need to parse text first to see if it requires a prefix declaration.
self._pending_start = (tag, attrs, new_namespaces)
return
self._start(tag, attrs, new_namespaces)
def _start(self, tag, attrs, new_namespaces, qname_text=None):
if self._exclude_attrs is not None and attrs:
attrs = {k: v for k, v in attrs.items() if k not in self._exclude_attrs}
qnames = {tag, *attrs}
resolved_names = {}
# Resolve prefixes in attribute and tag text.
if qname_text is not None:
qname = resolved_names[qname_text] = self._resolve_prefix_name(qname_text)
qnames.add(qname)
if self._find_qname_aware_attrs is not None and attrs:
qattrs = self._find_qname_aware_attrs(attrs)
if qattrs:
for attr_name in qattrs:
value = attrs[attr_name]
if _looks_like_prefix_name(value):
qname = resolved_names[value] = self._resolve_prefix_name(value)
qnames.add(qname)
else:
qattrs = None
else:
qattrs = None
# Assign prefixes in lexicographical order of used URIs.
parse_qname = self._qname
parsed_qnames = {n: parse_qname(n) for n in sorted(
qnames, key=lambda n: n.split('}', 1))}
# Write namespace declarations in prefix order ...
if new_namespaces:
attr_list = [
('xmlns:' + prefix if prefix else 'xmlns', uri)
for uri, prefix in new_namespaces
]
attr_list.sort()
else:
# almost always empty
attr_list = []
# ... followed by attributes in URI+name order
if attrs:
for k, v in sorted(attrs.items()):
if qattrs is not None and k in qattrs and v in resolved_names:
v = parsed_qnames[resolved_names[v]][0]
attr_qname, attr_name, uri = parsed_qnames[k]
# No prefix for attributes in default ('') namespace.
attr_list.append((attr_qname if uri else attr_name, v))
# Honour xml:space attributes.
space_behaviour = attrs.get('{http://www.w3.org/XML/1998/namespace}space')
self._preserve_space.append(
space_behaviour == 'preserve' if space_behaviour
else self._preserve_space[-1])
# Write the tag.
write = self._write
write('<' + parsed_qnames[tag][0])
if attr_list:
write(''.join([f' {k}="{_escape_attrib_c14n(v)}"' for k, v in attr_list]))
write('>')
# Write the resolved qname text content.
if qname_text is not None:
write(_escape_cdata_c14n(parsed_qnames[resolved_names[qname_text]][0]))
self._root_seen = True
self._ns_stack.append([])
def end(self, tag):
if self._ignored_depth:
self._ignored_depth -= 1
return
if self._data:
self._flush()
self._write(f'</{self._qname(tag)[0]}>')
self._preserve_space.pop()
self._root_done = len(self._preserve_space) == 1
self._declared_ns_stack.pop()
self._ns_stack.pop()
def comment(self, text):
if not self._with_comments:
return
if self._ignored_depth:
return
if self._root_done:
self._write('\n')
elif self._root_seen and self._data:
self._flush()
self._write(f'<!--{_escape_cdata_c14n(text)}-->')
if not self._root_seen:
self._write('\n')
def pi(self, target, data):
if self._ignored_depth:
return
if self._root_done:
self._write('\n')
elif self._root_seen and self._data:
self._flush()
self._write(
f'<?{target} {_escape_cdata_c14n(data)}?>' if data else f'<?{target}?>')
if not self._root_seen:
self._write('\n')
def _escape_cdata_c14n(text):
# escape character data
try:
# it's worth avoiding do-nothing calls for strings that are
# shorter than 500 character, or so. assume that's, by far,
# the most common case in most applications.
if '&' in text:
text = text.replace('&', '&')
if '<' in text:
text = text.replace('<', '<')
if '>' in text:
text = text.replace('>', '>')
if '\r' in text:
text = text.replace('\r', '
')
return text
except (TypeError, AttributeError):
_raise_serialization_error(text)
def _escape_attrib_c14n(text):
# escape attribute value
try:
if '&' in text:
text = text.replace('&', '&')
if '<' in text:
text = text.replace('<', '<')
if '"' in text:
text = text.replace('"', '"')
if '\t' in text:
text = text.replace('\t', '	')
if '\n' in text:
text = text.replace('\n', '
')
if '\r' in text:
text = text.replace('\r', '
')
return text
except (TypeError, AttributeError):
_raise_serialization_error(text)
# --------------------------------------------------------------------
# Import the C accelerators
try:
# Element is going to be shadowed by the C implementation. We need to keep
# the Python version of it accessible for some "creative" by external code
# (see tests)
_Element_Py = Element
# Element, SubElement, ParseError, TreeBuilder, XMLParser, _set_factories
from _elementtree import *
from _elementtree import _set_factories
except ImportError:
pass
else:
_set_factories(Comment, ProcessingInstruction)
# Deprecated alias for xml.etree.ElementTree
from xml.etree.ElementTree import *
U
e5d- � @ s d dddgZ dS )ZdomZparsersZsaxZetreeN)�__all__� r r �$/usr/lib64/python3.8/xml/__init__.py�<module> � U
e5d- � @ s d Z ddddgZdS )a� Core XML support for Python.
This package contains four sub-packages:
dom -- The W3C Document Object Model. This supports DOM Level 1 +
Namespaces.
parsers -- Python wrappers for XML parsers (currently only supports Expat).
sax -- The Simple API for XML, developed by XML-Dev, led by David
Megginson and ported to Python by Lars Marius Garshol. This
supports the SAX 2 API.
etree -- The ElementTree XML library. This is a subset of the full
ElementTree XML release.
ZdomZparsersZsaxZetreeN)�__doc__�__all__� r r �$/usr/lib64/python3.8/xml/__init__.py�<module> s U
e5d- � @ s d Z ddddgZdS )a� Core XML support for Python.
This package contains four sub-packages:
dom -- The W3C Document Object Model. This supports DOM Level 1 +
Namespaces.
parsers -- Python wrappers for XML parsers (currently only supports Expat).
sax -- The Simple API for XML, developed by XML-Dev, led by David
Megginson and ported to Python by Lars Marius Garshol. This
supports the SAX 2 API.
etree -- The ElementTree XML library. This is a subset of the full
ElementTree XML release.
ZdomZparsersZsaxZetreeN)�__doc__�__all__� r r �$/usr/lib64/python3.8/xml/__init__.py�<module> s """Core XML support for Python.
This package contains four sub-packages:
dom -- The W3C Document Object Model. This supports DOM Level 1 +
Namespaces.
parsers -- Python wrappers for XML parsers (currently only supports Expat).
sax -- The Simple API for XML, developed by XML-Dev, led by David
Megginson and ported to Python by Lars Marius Garshol. This
supports the SAX 2 API.
etree -- The ElementTree XML library. This is a subset of the full
ElementTree XML release.
"""
__all__ = ["dom", "parsers", "sax", "etree"]
"""An XML Reader is the SAX 2 name for an XML parser. XML Parsers
should be based on this code. """
from . import handler
from ._exceptions import SAXNotSupportedException, SAXNotRecognizedException
# ===== XMLREADER =====
class XMLReader:
"""Interface for reading an XML document using callbacks.
XMLReader is the interface that an XML parser's SAX2 driver must
implement. This interface allows an application to set and query
features and properties in the parser, to register event handlers
for document processing, and to initiate a document parse.
All SAX interfaces are assumed to be synchronous: the parse
methods must not return until parsing is complete, and readers
must wait for an event-handler callback to return before reporting
the next event."""
def __init__(self):
self._cont_handler = handler.ContentHandler()
self._dtd_handler = handler.DTDHandler()
self._ent_handler = handler.EntityResolver()
self._err_handler = handler.ErrorHandler()
def parse(self, source):
"Parse an XML document from a system identifier or an InputSource."
raise NotImplementedError("This method must be implemented!")
def getContentHandler(self):
"Returns the current ContentHandler."
return self._cont_handler
def setContentHandler(self, handler):
"Registers a new object to receive document content events."
self._cont_handler = handler
def getDTDHandler(self):
"Returns the current DTD handler."
return self._dtd_handler
def setDTDHandler(self, handler):
"Register an object to receive basic DTD-related events."
self._dtd_handler = handler
def getEntityResolver(self):
"Returns the current EntityResolver."
return self._ent_handler
def setEntityResolver(self, resolver):
"Register an object to resolve external entities."
self._ent_handler = resolver
def getErrorHandler(self):
"Returns the current ErrorHandler."
return self._err_handler
def setErrorHandler(self, handler):
"Register an object to receive error-message events."
self._err_handler = handler
def setLocale(self, locale):
"""Allow an application to set the locale for errors and warnings.
SAX parsers are not required to provide localization for errors
and warnings; if they cannot support the requested locale,
however, they must raise a SAX exception. Applications may
request a locale change in the middle of a parse."""
raise SAXNotSupportedException("Locale support not implemented")
def getFeature(self, name):
"Looks up and returns the state of a SAX2 feature."
raise SAXNotRecognizedException("Feature '%s' not recognized" % name)
def setFeature(self, name, state):
"Sets the state of a SAX2 feature."
raise SAXNotRecognizedException("Feature '%s' not recognized" % name)
def getProperty(self, name):
"Looks up and returns the value of a SAX2 property."
raise SAXNotRecognizedException("Property '%s' not recognized" % name)
def setProperty(self, name, value):
"Sets the value of a SAX2 property."
raise SAXNotRecognizedException("Property '%s' not recognized" % name)
class IncrementalParser(XMLReader):
"""This interface adds three extra methods to the XMLReader
interface that allow XML parsers to support incremental
parsing. Support for this interface is optional, since not all
underlying XML parsers support this functionality.
When the parser is instantiated it is ready to begin accepting
data from the feed method immediately. After parsing has been
finished with a call to close the reset method must be called to
make the parser ready to accept new data, either from feed or
using the parse method.
Note that these methods must _not_ be called during parsing, that
is, after parse has been called and before it returns.
By default, the class also implements the parse method of the XMLReader
interface using the feed, close and reset methods of the
IncrementalParser interface as a convenience to SAX 2.0 driver
writers."""
def __init__(self, bufsize=2**16):
self._bufsize = bufsize
XMLReader.__init__(self)
def parse(self, source):
from . import saxutils
source = saxutils.prepare_input_source(source)
self.prepareParser(source)
file = source.getCharacterStream()
if file is None:
file = source.getByteStream()
buffer = file.read(self._bufsize)
while buffer:
self.feed(buffer)
buffer = file.read(self._bufsize)
self.close()
def feed(self, data):
"""This method gives the raw XML data in the data parameter to
the parser and makes it parse the data, emitting the
corresponding events. It is allowed for XML constructs to be
split across several calls to feed.
feed may raise SAXException."""
raise NotImplementedError("This method must be implemented!")
def prepareParser(self, source):
"""This method is called by the parse implementation to allow
the SAX 2.0 driver to prepare itself for parsing."""
raise NotImplementedError("prepareParser must be overridden!")
def close(self):
"""This method is called when the entire XML document has been
passed to the parser through the feed method, to notify the
parser that there are no more data. This allows the parser to
do the final checks on the document and empty the internal
data buffer.
The parser will not be ready to parse another document until
the reset method has been called.
close may raise SAXException."""
raise NotImplementedError("This method must be implemented!")
def reset(self):
"""This method is called after close has been called to reset
the parser so that it is ready to parse new documents. The
results of calling parse or feed after close without calling
reset are undefined."""
raise NotImplementedError("This method must be implemented!")
# ===== LOCATOR =====
class Locator:
"""Interface for associating a SAX event with a document
location. A locator object will return valid results only during
calls to DocumentHandler methods; at any other time, the
results are unpredictable."""
def getColumnNumber(self):
"Return the column number where the current event ends."
return -1
def getLineNumber(self):
"Return the line number where the current event ends."
return -1
def getPublicId(self):
"Return the public identifier for the current event."
return None
def getSystemId(self):
"Return the system identifier for the current event."
return None
# ===== INPUTSOURCE =====
class InputSource:
"""Encapsulation of the information needed by the XMLReader to
read entities.
This class may include information about the public identifier,
system identifier, byte stream (possibly with character encoding
information) and/or the character stream of an entity.
Applications will create objects of this class for use in the
XMLReader.parse method and for returning from
EntityResolver.resolveEntity.
An InputSource belongs to the application, the XMLReader is not
allowed to modify InputSource objects passed to it from the
application, although it may make copies and modify those."""
def __init__(self, system_id = None):
self.__system_id = system_id
self.__public_id = None
self.__encoding = None
self.__bytefile = None
self.__charfile = None
def setPublicId(self, public_id):
"Sets the public identifier of this InputSource."
self.__public_id = public_id
def getPublicId(self):
"Returns the public identifier of this InputSource."
return self.__public_id
def setSystemId(self, system_id):
"Sets the system identifier of this InputSource."
self.__system_id = system_id
def getSystemId(self):
"Returns the system identifier of this InputSource."
return self.__system_id
def setEncoding(self, encoding):
"""Sets the character encoding of this InputSource.
The encoding must be a string acceptable for an XML encoding
declaration (see section 4.3.3 of the XML recommendation).
The encoding attribute of the InputSource is ignored if the
InputSource also contains a character stream."""
self.__encoding = encoding
def getEncoding(self):
"Get the character encoding of this InputSource."
return self.__encoding
def setByteStream(self, bytefile):
"""Set the byte stream (a Python file-like object which does
not perform byte-to-character conversion) for this input
source.
The SAX parser will ignore this if there is also a character
stream specified, but it will use a byte stream in preference
to opening a URI connection itself.
If the application knows the character encoding of the byte
stream, it should set it with the setEncoding method."""
self.__bytefile = bytefile
def getByteStream(self):
"""Get the byte stream for this input source.
The getEncoding method will return the character encoding for
this byte stream, or None if unknown."""
return self.__bytefile
def setCharacterStream(self, charfile):
"""Set the character stream for this input source. (The stream
must be a Python 2.0 Unicode-wrapped file-like that performs
conversion to Unicode strings.)
If there is a character stream specified, the SAX parser will
ignore any byte stream and will not attempt to open a URI
connection to the system identifier."""
self.__charfile = charfile
def getCharacterStream(self):
"Get the character stream for this input source."
return self.__charfile
# ===== ATTRIBUTESIMPL =====
class AttributesImpl:
def __init__(self, attrs):
"""Non-NS-aware implementation.
attrs should be of the form {name : value}."""
self._attrs = attrs
def getLength(self):
return len(self._attrs)
def getType(self, name):
return "CDATA"
def getValue(self, name):
return self._attrs[name]
def getValueByQName(self, name):
return self._attrs[name]
def getNameByQName(self, name):
if name not in self._attrs:
raise KeyError(name)
return name
def getQNameByName(self, name):
if name not in self._attrs:
raise KeyError(name)
return name
def getNames(self):
return list(self._attrs.keys())
def getQNames(self):
return list(self._attrs.keys())
def __len__(self):
return len(self._attrs)
def __getitem__(self, name):
return self._attrs[name]
def keys(self):
return list(self._attrs.keys())
def __contains__(self, name):
return name in self._attrs
def get(self, name, alternative=None):
return self._attrs.get(name, alternative)
def copy(self):
return self.__class__(self._attrs)
def items(self):
return list(self._attrs.items())
def values(self):
return list(self._attrs.values())
# ===== ATTRIBUTESNSIMPL =====
class AttributesNSImpl(AttributesImpl):
def __init__(self, attrs, qnames):
"""NS-aware implementation.
attrs should be of the form {(ns_uri, lname): value, ...}.
qnames of the form {(ns_uri, lname): qname, ...}."""
self._attrs = attrs
self._qnames = qnames
def getValueByQName(self, name):
for (nsname, qname) in self._qnames.items():
if qname == name:
return self._attrs[nsname]
raise KeyError(name)
def getNameByQName(self, name):
for (nsname, qname) in self._qnames.items():
if qname == name:
return nsname
raise KeyError(name)
def getQNameByName(self, name):
return self._qnames[name]
def getQNames(self):
return list(self._qnames.values())
def copy(self):
return self.__class__(self._attrs, self._qnames)
def _test():
XMLReader()
IncrementalParser()
Locator()
if __name__ == "__main__":
_test()
"""\
A library of useful helper classes to the SAX classes, for the
convenience of application and driver writers.
"""
import os, urllib.parse, urllib.request
import io
import codecs
from . import handler
from . import xmlreader
def __dict_replace(s, d):
"""Replace substrings of a string using a dictionary."""
for key, value in d.items():
s = s.replace(key, value)
return s
def escape(data, entities={}):
"""Escape &, <, and > in a string of data.
You can escape other strings of data by passing a dictionary as
the optional entities parameter. The keys and values must all be
strings; each key will be replaced with its corresponding value.
"""
# must do ampersand first
data = data.replace("&", "&")
data = data.replace(">", ">")
data = data.replace("<", "<")
if entities:
data = __dict_replace(data, entities)
return data
def unescape(data, entities={}):
"""Unescape &, <, and > in a string of data.
You can unescape other strings of data by passing a dictionary as
the optional entities parameter. The keys and values must all be
strings; each key will be replaced with its corresponding value.
"""
data = data.replace("<", "<")
data = data.replace(">", ">")
if entities:
data = __dict_replace(data, entities)
# must do ampersand last
return data.replace("&", "&")
def quoteattr(data, entities={}):
"""Escape and quote an attribute value.
Escape &, <, and > in a string of data, then quote it for use as
an attribute value. The \" character will be escaped as well, if
necessary.
You can escape other strings of data by passing a dictionary as
the optional entities parameter. The keys and values must all be
strings; each key will be replaced with its corresponding value.
"""
entities = {**entities, '\n': ' ', '\r': ' ', '\t':'	'}
data = escape(data, entities)
if '"' in data:
if "'" in data:
data = '"%s"' % data.replace('"', """)
else:
data = "'%s'" % data
else:
data = '"%s"' % data
return data
def _gettextwriter(out, encoding):
if out is None:
import sys
return sys.stdout
if isinstance(out, io.TextIOBase):
# use a text writer as is
return out
if isinstance(out, (codecs.StreamWriter, codecs.StreamReaderWriter)):
# use a codecs stream writer as is
return out
# wrap a binary writer with TextIOWrapper
if isinstance(out, io.RawIOBase):
# Keep the original file open when the TextIOWrapper is
# destroyed
class _wrapper:
__class__ = out.__class__
def __getattr__(self, name):
return getattr(out, name)
buffer = _wrapper()
buffer.close = lambda: None
else:
# This is to handle passed objects that aren't in the
# IOBase hierarchy, but just have a write method
buffer = io.BufferedIOBase()
buffer.writable = lambda: True
buffer.write = out.write
try:
# TextIOWrapper uses this methods to determine
# if BOM (for UTF-16, etc) should be added
buffer.seekable = out.seekable
buffer.tell = out.tell
except AttributeError:
pass
return io.TextIOWrapper(buffer, encoding=encoding,
errors='xmlcharrefreplace',
newline='\n',
write_through=True)
class XMLGenerator(handler.ContentHandler):
def __init__(self, out=None, encoding="iso-8859-1", short_empty_elements=False):
handler.ContentHandler.__init__(self)
out = _gettextwriter(out, encoding)
self._write = out.write
self._flush = out.flush
self._ns_contexts = [{}] # contains uri -> prefix dicts
self._current_context = self._ns_contexts[-1]
self._undeclared_ns_maps = []
self._encoding = encoding
self._short_empty_elements = short_empty_elements
self._pending_start_element = False
def _qname(self, name):
"""Builds a qualified name from a (ns_url, localname) pair"""
if name[0]:
# Per http://www.w3.org/XML/1998/namespace, The 'xml' prefix is
# bound by definition to http://www.w3.org/XML/1998/namespace. It
# does not need to be declared and will not usually be found in
# self._current_context.
if 'http://www.w3.org/XML/1998/namespace' == name[0]:
return 'xml:' + name[1]
# The name is in a non-empty namespace
prefix = self._current_context[name[0]]
if prefix:
# If it is not the default namespace, prepend the prefix
return prefix + ":" + name[1]
# Return the unqualified name
return name[1]
def _finish_pending_start_element(self,endElement=False):
if self._pending_start_element:
self._write('>')
self._pending_start_element = False
# ContentHandler methods
def startDocument(self):
self._write('<?xml version="1.0" encoding="%s"?>\n' %
self._encoding)
def endDocument(self):
self._flush()
def startPrefixMapping(self, prefix, uri):
self._ns_contexts.append(self._current_context.copy())
self._current_context[uri] = prefix
self._undeclared_ns_maps.append((prefix, uri))
def endPrefixMapping(self, prefix):
self._current_context = self._ns_contexts[-1]
del self._ns_contexts[-1]
def startElement(self, name, attrs):
self._finish_pending_start_element()
self._write('<' + name)
for (name, value) in attrs.items():
self._write(' %s=%s' % (name, quoteattr(value)))
if self._short_empty_elements:
self._pending_start_element = True
else:
self._write(">")
def endElement(self, name):
if self._pending_start_element:
self._write('/>')
self._pending_start_element = False
else:
self._write('</%s>' % name)
def startElementNS(self, name, qname, attrs):
self._finish_pending_start_element()
self._write('<' + self._qname(name))
for prefix, uri in self._undeclared_ns_maps:
if prefix:
self._write(' xmlns:%s="%s"' % (prefix, uri))
else:
self._write(' xmlns="%s"' % uri)
self._undeclared_ns_maps = []
for (name, value) in attrs.items():
self._write(' %s=%s' % (self._qname(name), quoteattr(value)))
if self._short_empty_elements:
self._pending_start_element = True
else:
self._write(">")
def endElementNS(self, name, qname):
if self._pending_start_element:
self._write('/>')
self._pending_start_element = False
else:
self._write('</%s>' % self._qname(name))
def characters(self, content):
if content:
self._finish_pending_start_element()
if not isinstance(content, str):
content = str(content, self._encoding)
self._write(escape(content))
def ignorableWhitespace(self, content):
if content:
self._finish_pending_start_element()
if not isinstance(content, str):
content = str(content, self._encoding)
self._write(content)
def processingInstruction(self, target, data):
self._finish_pending_start_element()
self._write('<?%s %s?>' % (target, data))
class XMLFilterBase(xmlreader.XMLReader):
"""This class is designed to sit between an XMLReader and the
client application's event handlers. By default, it does nothing
but pass requests up to the reader and events on to the handlers
unmodified, but subclasses can override specific methods to modify
the event stream or the configuration requests as they pass
through."""
def __init__(self, parent = None):
xmlreader.XMLReader.__init__(self)
self._parent = parent
# ErrorHandler methods
def error(self, exception):
self._err_handler.error(exception)
def fatalError(self, exception):
self._err_handler.fatalError(exception)
def warning(self, exception):
self._err_handler.warning(exception)
# ContentHandler methods
def setDocumentLocator(self, locator):
self._cont_handler.setDocumentLocator(locator)
def startDocument(self):
self._cont_handler.startDocument()
def endDocument(self):
self._cont_handler.endDocument()
def startPrefixMapping(self, prefix, uri):
self._cont_handler.startPrefixMapping(prefix, uri)
def endPrefixMapping(self, prefix):
self._cont_handler.endPrefixMapping(prefix)
def startElement(self, name, attrs):
self._cont_handler.startElement(name, attrs)
def endElement(self, name):
self._cont_handler.endElement(name)
def startElementNS(self, name, qname, attrs):
self._cont_handler.startElementNS(name, qname, attrs)
def endElementNS(self, name, qname):
self._cont_handler.endElementNS(name, qname)
def characters(self, content):
self._cont_handler.characters(content)
def ignorableWhitespace(self, chars):
self._cont_handler.ignorableWhitespace(chars)
def processingInstruction(self, target, data):
self._cont_handler.processingInstruction(target, data)
def skippedEntity(self, name):
self._cont_handler.skippedEntity(name)
# DTDHandler methods
def notationDecl(self, name, publicId, systemId):
self._dtd_handler.notationDecl(name, publicId, systemId)
def unparsedEntityDecl(self, name, publicId, systemId, ndata):
self._dtd_handler.unparsedEntityDecl(name, publicId, systemId, ndata)
# EntityResolver methods
def resolveEntity(self, publicId, systemId):
return self._ent_handler.resolveEntity(publicId, systemId)
# XMLReader methods
def parse(self, source):
self._parent.setContentHandler(self)
self._parent.setErrorHandler(self)
self._parent.setEntityResolver(self)
self._parent.setDTDHandler(self)
self._parent.parse(source)
def setLocale(self, locale):
self._parent.setLocale(locale)
def getFeature(self, name):
return self._parent.getFeature(name)
def setFeature(self, name, state):
self._parent.setFeature(name, state)
def getProperty(self, name):
return self._parent.getProperty(name)
def setProperty(self, name, value):
self._parent.setProperty(name, value)
# XMLFilter methods
def getParent(self):
return self._parent
def setParent(self, parent):
self._parent = parent
# --- Utility functions
def prepare_input_source(source, base=""):
"""This function takes an InputSource and an optional base URL and
returns a fully resolved InputSource object ready for reading."""
if isinstance(source, os.PathLike):
source = os.fspath(source)
if isinstance(source, str):
source = xmlreader.InputSource(source)
elif hasattr(source, "read"):
f = source
source = xmlreader.InputSource()
if isinstance(f.read(0), str):
source.setCharacterStream(f)
else:
source.setByteStream(f)
if hasattr(f, "name") and isinstance(f.name, str):
source.setSystemId(f.name)
if source.getCharacterStream() is None and source.getByteStream() is None:
sysid = source.getSystemId()
basehead = os.path.dirname(os.path.normpath(base))
sysidfilename = os.path.join(basehead, sysid)
if os.path.isfile(sysidfilename):
source.setSystemId(sysidfilename)
f = open(sysidfilename, "rb")
else:
source.setSystemId(urllib.parse.urljoin(base, sysid))
f = urllib.request.urlopen(source.getSystemId())
source.setByteStream(f)
return source
U
e5d�/ � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z dd� Z
i fdd �Z i fd
d �Z i fd d
�Z
dd� ZG dd� dej�ZG dd� de j�Zddd�ZdS )znA library of useful helper classes to the SAX classes, for the
convenience of application and driver writers.
� N� )�handler)� xmlreaderc C s" |� � D ]\}}| �||�} q| S )z2Replace substrings of a string using a dictionary.)�items�replace)�s�d�key�value� r �(/usr/lib64/python3.8/xml/sax/saxutils.py�__dict_replace s r
c C s6 | � dd�} | � dd�} | � dd�} |r2t| |�} | S )z�Escape &, <, and > in a string of data.
You can escape other strings of data by passing a dictionary as
the optional entities parameter. The keys and values must all be
strings; each key will be replaced with its corresponding value.
�&�&�>�>�<�<�r r
��dataZentitiesr r r �escape s
r c C s2 | � dd�} | � dd�} |r&t| |�} | � dd�S )a
Unescape &, <, and > in a string of data.
You can unescape other strings of data by passing a dictionary as
the optional entities parameter. The keys and values must all be
strings; each key will be replaced with its corresponding value.
r r r r r r r r r r r �unescape" s
r c C sR |dddd��}t | |�} d| krFd| kr<d| �dd� } qNd | } nd| } | S )
a� Escape and quote an attribute value.
Escape &, <, and > in a string of data, then quote it for use as
an attribute value. The " character will be escaped as well, if
necessary.
You can escape other strings of data by passing a dictionary as
the optional entities parameter. The keys and values must all be
strings; each key will be replaced with its corresponding value.
z z z	)�
�
� �"�'z"%s"z"z'%s')r r r r r r � quoteattr0 s
r c s� � d krdd l }|jS t� tj�r&� S t� tjtjf�r<� S t� tj�rlG � fdd�d�}|� }dd� |_ nDt�
� }dd� |_ � j |_ z� j
|_
� j|_W n tk
r� Y nX tj||ddd d
�S ) Nr c s e Zd Z� jZ� fdd�ZdS )z _gettextwriter.<locals>._wrapperc s
t � |�S �N)�getattr��self�name��outr r � __getattr__Z s z,_gettextwriter.<locals>._wrapper.__getattr__N)�__name__�
__module__� __qualname__� __class__r& r r$ r r �_wrapperX s r+ c S s d S r r r r r r �<lambda>] � z _gettextwriter.<locals>.<lambda>c S s dS )NTr r r r r r, b r- �xmlcharrefreplacer T)�encoding�errors�newline�
write_through)�sys�stdout�
isinstance�io�
TextIOBase�codecs� StreamWriter�StreamReaderWriter� RawIOBase�close�BufferedIOBase�writable�write�seekable�tell�AttributeError�
TextIOWrapper)r% r/ r3 r+ �bufferr r$ r �_gettextwriterG s0
�rE c @ s� e Zd Zd dd�Zdd� Zd!dd �Zd
d � Zd d
� Zdd� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zd d � Zd d � ZdS )"� XMLGeneratorN�
iso-8859-1Fc C sV t j�| � t||�}|j| _|j| _i g| _| jd | _ g | _
|| _ || _ d| _
d S )N���F)r �ContentHandler�__init__rE r? �_write�flush�_flush� _ns_contexts�_current_context�_undeclared_ns_maps� _encoding�_short_empty_elements�_pending_start_element)r" r% r/ Zshort_empty_elementsr r r rJ r s
zXMLGenerator.__init__c C sJ |d rBd|d kr d|d S | j |d }|rB|d |d S |d S )z7Builds a qualified name from a (ns_url, localname) pairr z$http://www.w3.org/XML/1998/namespacezxml:r �:)rO )r" r# �prefixr r r �_qname~ s zXMLGenerator._qnamec C s | j r| �d� d| _ d S )Nr F�rS rK )r" �
endElementr r r � _finish_pending_start_element� s
z*XMLGenerator._finish_pending_start_elementc C s | � d| j � d S )Nz$<?xml version="1.0" encoding="%s"?>
)rK rQ �r" r r r �
startDocument� s �zXMLGenerator.startDocumentc C s | � � d S r )rM rZ r r r � endDocument� s zXMLGenerator.endDocumentc C s0 | j �| j�� � || j|< | j�||f� d S r )rN �appendrO �copyrP �r" rU �urir r r �startPrefixMapping� s
z XMLGenerator.startPrefixMappingc C s | j d | _| j d= d S )NrH )rN rO �r" rU r r r �endPrefixMapping� s z XMLGenerator.endPrefixMappingc C sZ | � � | �d| � |�� D ] \}}| �d|t|�f � q | jrLd| _n
| �d� d S )Nr � %s=%sTr )rY rK r r rR rS )r" r# �attrsr
r r r � startElement� s zXMLGenerator.startElementc C s* | j r| �d� d| _ n| �d| � d S �Nz/>Fz</%s>rW r! r r r rX � s
zXMLGenerator.endElementc C s� | � � | �d| �|� � | jD ].\}}|rB| �d||f � q"| �d| � q"g | _|�� D ]$\}}| �d| �|�t|�f � q`| jr�d| _n
| �d� d S )Nr z xmlns:%s="%s"z xmlns="%s"rd Tr )rY rK rV rP r r rR rS )r" r# �qnamere rU r` r
r r r �startElementNS� s zXMLGenerator.startElementNSc C s0 | j r| �d� d| _ n| �d| �|� � d S rg )rS rK rV �r" r# rh r r r � endElementNS� s
zXMLGenerator.endElementNSc C s4 |r0| � � t|t�s"t|| j�}| �t|�� d S r )rY r5 �strrQ rK r �r" Zcontentr r r �
characters� s
zXMLGenerator.charactersc C s0 |r,| � � t|t�s"t|| j�}| �|� d S r )rY r5 rl rQ rK rm r r r �ignorableWhitespace� s
z XMLGenerator.ignorableWhitespacec C s | � � | �d||f � d S )Nz <?%s %s?>)rY rK �r" �targetr r r r �processingInstruction� s z"XMLGenerator.processingInstruction)NrG F)F)r' r( r) rJ rV rY r[ r\ ra rc rf rX ri rk rn ro rr r r r r rF p s
rF c @ s� e Zd ZdZd;dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Zd3d4� Z d5d6� Z d7d8� Z d9d:� Z dS )<�
XMLFilterBaseaY This class is designed to sit between an XMLReader and the
client application's event handlers. By default, it does nothing
but pass requests up to the reader and events on to the handlers
unmodified, but subclasses can override specific methods to modify
the event stream or the configuration requests as they pass
through.Nc C s t j�| � || _d S r )r � XMLReaderrJ �_parent�r" �parentr r r rJ � s zXMLFilterBase.__init__c C s | j �|� d S r )� _err_handler�error�r" Z exceptionr r r ry � s zXMLFilterBase.errorc C s | j �|� d S r )rx �
fatalErrorrz r r r r{ � s zXMLFilterBase.fatalErrorc C s | j �|� d S r )rx �warningrz r r r r| � s zXMLFilterBase.warningc C s | j �|� d S r )�
_cont_handler�setDocumentLocator)r" Zlocatorr r r r~ � s z XMLFilterBase.setDocumentLocatorc C s | j �� d S r )r} r[ rZ r r r r[ � s zXMLFilterBase.startDocumentc C s | j �� d S r )r} r\ rZ r r r r\ s zXMLFilterBase.endDocumentc C s | j �||� d S r )r} ra r_ r r r ra s z XMLFilterBase.startPrefixMappingc C s | j �|� d S r )r} rc rb r r r rc s z XMLFilterBase.endPrefixMappingc C s | j �||� d S r )r} rf )r" r# re r r r rf s zXMLFilterBase.startElementc C s | j �|� d S r )r} rX r! r r r rX s zXMLFilterBase.endElementc C s | j �|||� d S r )r} ri )r" r# rh re r r r ri s z XMLFilterBase.startElementNSc C s | j �||� d S r )r} rk rj r r r rk s zXMLFilterBase.endElementNSc C s | j �|� d S r )r} rn rm r r r rn s zXMLFilterBase.charactersc C s | j �|� d S r )r} ro )r" �charsr r r ro s z!XMLFilterBase.ignorableWhitespacec C s | j �||� d S r )r} rr rp r r r rr s z#XMLFilterBase.processingInstructionc C s | j �|� d S r )r} �
skippedEntityr! r r r r� s zXMLFilterBase.skippedEntityc C s | j �|||� d S r )� _dtd_handler� notationDecl)r" r# �publicId�systemIdr r r r� % s zXMLFilterBase.notationDeclc C s | j �||||� d S r )r� �unparsedEntityDecl)r" r# r� r� Zndatar r r r� ( s z XMLFilterBase.unparsedEntityDeclc C s | j �||�S r )Z _ent_handler�
resolveEntity)r" r� r� r r r r� - s zXMLFilterBase.resolveEntityc C s@ | j �| � | j �| � | j �| � | j �| � | j �|� d S r )ru ZsetContentHandlerZsetErrorHandlerZsetEntityResolverZ
setDTDHandler�parse)r" �sourcer r r r� 2 s
zXMLFilterBase.parsec C s | j �|� d S r )ru � setLocale)r" Zlocaler r r r� 9 s zXMLFilterBase.setLocalec C s | j �|�S r )ru �
getFeaturer! r r r r� < s zXMLFilterBase.getFeaturec C s | j �||� d S r )ru �
setFeature)r" r# �stater r r r� ? s zXMLFilterBase.setFeaturec C s | j �|�S r )ru � getPropertyr! r r r r� B s zXMLFilterBase.getPropertyc C s | j �||� d S r )ru � setProperty)r" r# r
r r r r� E s zXMLFilterBase.setPropertyc C s | j S r �ru rZ r r r � getParentJ s zXMLFilterBase.getParentc C s
|| _ d S r r� rv r r r � setParentM s zXMLFilterBase.setParent)N) r' r( r) �__doc__rJ ry r{ r| r~ r[ r\ ra rc rf rX ri rk rn ro rr r� r� r� r� r� r� r� r� r� r� r� r� r r r r rs � s:
rs � c C s$ t | tj�rt�| �} t | t�r,t�| �} n^t| d�r�| }t�� } t |�d�t�r^| � |� n
| �
|� t|d�r�t |j t�r�| � |j � | �
� dk�r | �� dk�r | �� }tj�tj�|��}tj�||�}tj�|�r�| � |� t|d�}n$| � tj�||�� tj�| �� �}| �
|� | S )z�This function takes an InputSource and an optional base URL and
returns a fully resolved InputSource object ready for reading.�readr r# N�rb)r5 �os�PathLike�fspathrl r Z InputSource�hasattrr� ZsetCharacterStreamZ
setByteStreamr# Z setSystemIdZgetCharacterStreamZ
getByteStreamZ getSystemId�path�dirname�normpath�join�isfile�open�urllibr� ZurljoinZrequestZurlopen)r� �base�fZsysidZbaseheadZ
sysidfilenamer r r �prepare_input_sourceR s.
r� )r� )r� r� Z urllib.parser� Zurllib.requestr6 r8 r� r r r
r r r rE rI rF rt rs r� r r r r �<module> s )so