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 dZi fd"dZd]d#dZd^d$d ZeZG d%d
d
ZG d&d dZe jd'd( Zd_d)d*Zd+d, Zd-Zz eeZW n e k
r. Y nX d.d/ Z d0d1 Z ee e d2Z d3d Z d4d5d6d7d8d9d:d;Z!e!e _!dd? Z#d@dA Z$dBdC Z%d`d d dDdEdFdZ&G dGdH dHej'Z(dad d dDdEdIdZ)dJd Z*dbdKd Z+dcdLdZ,G dMd dZ-dddNdZ.dedOdZ/e.Z0dfdPdZ1G dQd dZ2G dRd dZ3dgd d dSdTdZ4e5dUej6j7Z8G dVd dZ9dWdX Z:dYdZ Z;z eZZ> 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.
CommentdumpElement ElementTree
fromstringfromstringlist iselement iterparseparse
ParseErrorPIProcessingInstructionQName
SubElementtostring tostringlist TreeBuilderVERSIONXMLXMLID XMLParser
XMLPullParserregister_namespace canonicalizeC14NWriterTargetz1.3.0 N ) ElementPathc @ s e Zd ZdZdS )r
zAn 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 | dS )z2Return True if *element* appears to be an Element.tag)hasattr)elementr! r! r" r x s c @ s
e Zd ZdZdZdZdZdZi fddZdd 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&Zdd3d4Z d?d5d6Z!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:
text...tail
Nc K s6 t |ts td|jjf || _||| _g | _d S )Nzattrib must be dict, not %s)
isinstancedict 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# idr, r! r! r" __repr__ s zElement.__repr__c C s | ||S )zCreate 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 )zReturn copy of current element.
This creates a shallow copy. Subelements will be shared with the
original tree.
N)r2 r# r* texttail)r, elemr! r! r" copy s
z Element.copyc C s
t | jS N)lenr+ r0 r! r! r" __len__ s zElement.__len__c C s t jdtdd t| jdkS )NzyThe behavior of this method will change in future versions. Use specific 'len(elem)' or 'elem is not None' test instead.
stacklevelr )warningswarn
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 |tr |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.
NrF r+ appendr,
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 |ts 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 findr, 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 findtextr, 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 )zReset 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 )zSet 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 )zGet 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 )zGet 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|ts |dk r dS | j}|r,|V | D ]"}| E dH |j}|r0|V q0dS )zCreate 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 )zComment 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 ZdZdddZdd 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}%sr3 )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 | jS r7 )hashr3 r0 r! r! r" __hash__ s zQName.__hash__c C s t |tr| j|jkS | j|kS r7 r& r
r3 r, otherr! r! r" __le__ s
z QName.__le__c C s t |tr| j|jk S | j|k S r7 rv rw r! r! r" __lt__ s
z QName.__lt__c C s t |tr| j|jkS | j|kS r7 rv rw r! r! r" __ge__ s
z QName.__ge__c C s t |tr| j|jkS | j|kS r7 rv rw r! r! r" __gt__ s
z QName.__gt__c C s t |tr| 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 ddZdd Zdd Zd d d
Zd d d Zd d
dZ d!ddZ
d"ddZ d#ddZ d$ddZ
d%ddddZdd 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 )zReplace 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 |ds t|d}d}z^|dkrLt }t |drL||| _| 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.
FreadrbTN _parse_wholei )r$ opencloser r r~ r feed)r, sourceparser close_sourcedatar! r! r" r ; s$
zElementTree.parsec C s | j |S )zCreate 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.iterfindTshort_empty_elementsc C s |s
d}n|t kr td| |s4|dkr0d}nd}| }t||}|dkr|sd|dkr|dkr|} |dkrd dl}
|
} |d
| f |d krt|| 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 %rc14nutf-8us-asciiN)r r unicoder r z$
r3 r )
_serialize
ValueErrorlower _get_writerlocaleZgetpreferredencoding_serialize_textr~ _namespaces)r, file_or_filenameencodingxml_declarationdefault_namespacemethodr Z enc_lowerwriteZdeclared_encodingr qnamesrY Z serializer! r! r" r s: zElementTree.writec C s | j |ddS )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 nX |dkrl|V nt }t| tjr| }nft| tjrt | }|
|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 wxmlcharrefreplace)r errorsc S s dS NTr! r! r! r! r" 0 z _get_writer..
)r r newline)r AttributeErrorr
contextlib ExitStackr& ioBufferedIOBase RawIOBaseBufferedWritercallbackdetachwritableseekabletell
TextIOWrapper)r r r r stackr! r! r" r sB
r c s d d ii rd < fdd}| D ]} | j}t|trZ|jkr||j n.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|rt| dd dD ](\}
} | rd| } | 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 r .ra :
xmlns%s="%s" %s="%s">)r# r3 r r
_escape_cdata_serialize_xmlri re sorted_escape_attribr& r
r8 r4 ) r r5 r rY r kwargsr# r3 rR re vkr! r! r" r s\
r )
ZareabaseZbasefontbrcolframeZhrZimginputZisindexlinkmetaZparamc K s |j }|j}|tkr(| dt| n|tkrD| dt| nh|| }|d kr|rd| t| |D ]}t| ||d qhn,| d| t| }|s|r8|rt| dd dD ](\} }
|
rd|
}
| d|
t | f q|D ]N\}
} t
|
t r|
j}
t
| t r|| j } nt | } | d ||
| f q| d
|
} |rx| d ksb| d krl| | n | t| |D ]}t| ||d q|| tkr| d
| d
|jr| t|j d S )Nr r r c S s | d S r r! r r! r! r" r r z!_serialize_html..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| rtdtt 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)rematchr 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 zd| 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 StringIOBytesIOr 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 | jS 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 | tst| } | jtjdd | j}|r<|d dkrHtjd 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 sysstdoutr r4 )r5 r4 r! r! r" r s
c C s t }|| | |S )zParse 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 fddG fdddtjj}| d_~d tdsbtd 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_rootroot)r r )r it
pullparserr r! r" iterator s
ziterparse..iteratorc s e Zd Z jZdS )z$iterparse..IterParseIteratorN)r r r __next__r! )r r! r" IterParseIterator s r NFr r T)r collectionsabcIteratorr r$ r )r r r r r! )r r r r r r" r s
c @ s< e Zd Zd
ddddZdd Zdd Zd d
Zd d ZdS )r N)r c C s< t | _|ptt d| _|d kr(d}| j| j| d S )Nrq )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 )zFinish 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|tr"|q|V qdS )zReturn 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 )zParse 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 ZdZddddddddZdd Zd d
Zd d Zd
d Zdd Z dd Z
dddZ 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_factoryinsert_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 )zOpen 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 )zCreate 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 ZdZdddddZdd 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 tdY nX Y nX ||d}|d krjt }| | _| _| | _| _ |j
| _ i | _ | j
|_t|dr| j|_t|dr| j|_t|dr| j|_t|dr| 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_nsend_nsr r, r- r zExpat %d.%d.%d)& xml.parsersr1 ImportErrorZpyexpatZ ParserCreater r r rq _targeterror_error_names_defaultZDefaultHandlerExpandr$ _startStartElementHandler_endEndElementHandler _start_nsStartNamespaceDeclHandler_end_nsEndNamespaceDeclHandlerr ZCharacterDataHandlerr, CommentHandlerr- ProcessingInstructionHandlerZ buffer_textordered_attributesspecified_attributes_doctypeentity version_infoversionr )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|dkrt| j dr||| j
fd d}n||fd
d}||_ q|d krt| j d r||| j fd
d}n||fdd}||_
q|dkr||| fdd}||_q|dkr&||| 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..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
codelinenooffsetZposition)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|pdS r# )rq r2 r, r r r! r! r" r? O s zXMLParser._start_nsc C s | j |p dS r# )rq r3 )r, r r! r! r" rA R s zXMLParser._end_nsc C sR | j }||}i }|rDtdt|dD ] }||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 }|dkrz | 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
krg | _n | jd k r|d krd | _d S | }|sd S | j| t| j}|d kr| jd }|d
krd|dkrd| j\}}} }
| r| dd } n*|dkr|dkr| j\}}}
d } nd S t| j dr| j || |
dd nt| drtdt d | _d S )Nr r r r r0 z'undefined entity %s: line %d, column %d r z RuntimeWarning) r, r3 r Z data_handlerr1 rO nrQ rR Zpubidsystemr! 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 dd}|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 ZdZddddddddddZefddZd d
Zd d d Zd
d Z dj
fddZ dd Z dd Z
d ddZdd 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_textrewrite_prefixesqname_aware_tagsqname_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\}}| | jD ]$\}}||kr d| d| S q td| d| dd 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 ddnd|f\}}n|}t }| | jD ]B\}}||kr||kr|rz| d| n|||f S || qP| jr|| jkr| j| }ndt| j }| j|< | jd ||f | d| ||fS |s d|kr |||fS | | j D ]J\}}||kr| 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_seenur 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|
}||
< || qvqd }nd }j fddt|dd dD } |rdd |D } | ng } |rjt| D ]^\}
}|d k r@|
|kr@||kr@| || d }| |
\}} }| |r\|n| |f q
|
d
}j |r|d knj 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"
p s
z+C14NWriterTarget._start..c s i | ]}| |qS r! r! )r r_ ) parse_qnamer! r" r s c S s | ddS )Nr r )r~ )r_ r! r! r" r r z)C14NWriterTarget._start..r c S s$ g | ] \}}|rd | nd|fqS )zxmlns:Zxmlnsr! )r r r r! r! r"
s z+C14NWriterTarget._start..r z+{http://www.w3.org/XML/1998/namespace}spaceZpreserver r r c S s& g | ] \}}d | dt | dqS )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| jdk| _| 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)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| dn
d| d | jsl| d d S )Nr 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 compileUNICODEr r r r r rP Z _elementtreer r5 r! r! r! r" s J >
0 s
3
=2 2
05
z g