j f @ s d Z d d d d d d d d d d
d d d
d d d d d d d d d g Z d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z Gd d
d
e
Z d d Z Gd d d Z
i d d Z d d d Z d d! d Z e Z Gd" d
d
Z Gd# d d Z e j d$ d% Z d d& d' Z d( d) Z d* d+ d, d- d. d/ d0 d1 d2 d3 d4 d5 d6 f
Z y e e Z Wn e k
rYn Xd7 d8 Z d9 d: Z i e d; 6e d< 6e d= 6Z d> d Z i d; d? 6d< d@ 6dA dB 6dC dD 6dE dF 6dG dH 6dI dJ 6Z e e _ dK dL Z dM dN Z! dO dP Z" dQ dR Z# d d dS dT dU d Z$ GdV dW dW e j% Z& d d dS dT dX d Z' dY d Z( d dZ d Z) d d d[ d Z* Gd\ d] d] Z+ Gd^ d_ d_ Z, d d` d Z- d da d Z. e- Z/ d db d Z0 Gdc d d Z1 Gdd d d Z2 y e
Z3 d de l4 TWn e5 k
r|Yn Xd S)fa 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 XMLParserregister_namespacez1.3.0 N ) ElementPathc @ s e Z d Z d Z d S)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 :/opt/alt/python34/lib64/python3.4/xml/etree/ElementTree.pyr
g s c C s
t | d S)z2Return True if *element* appears to be an Element.tag)hasattr)elementr r r r u s c @ s e Z d Z d Z d Z d Z d Z d Z i 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 Z d d Z d d Z d d Z d d Z d d Z d d! d" Z d d d# d$ Z d d% d& Z d d' d( Z d) d* Z d d+ d, Z d- d. Z d/ d0 Z d1 d2 Z d d3 d4 Z d d5 d6 Z! d7 d8 Z" d S)9r 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 sc t | t s+ t d | j j f n | j } | j | | | _ | | _ g | _ d S)Nzattrib must be dict, not %s)
isinstancedict TypeError __class__r copyupdater attrib _children)selfr r) extrar r r __init__ s
zElement.__init__c C s d t | j t | f S)Nz)reprr id)r+ r r r __repr__ s zElement.__repr__c C s | j | | 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 sD | j | j | j } | j | _ | j | _ | | d d <| S)zReturn copy of current element.
This creates a shallow copy. Subelements will be shared with the
original tree.
N)r1 r r) texttail)r+ elemr r r r' s
z Element.copyc C s
t | j S)N)lenr* )r+ r r r __len__ s zElement.__len__c C s) t j d t d d t | j d k S)NzyThe behavior of this method will change in future versions. Use specific 'len(elem)' or 'elem is not None' test instead.
stacklevel r )warningswarn
FutureWarningr5 r* )r+ r r r __bool__ s
zElement.__bool__c C s | j | S)N)r* )r+ indexr r r __getitem__ s zElement.__getitem__c C s | | j | r? r@ rB rD rF rA rJ rL rM rP rR rS rT rU rX rY rZ r\ r_ ra r r r r r z s@
c K s< | j } | j | | j | | } | j | | 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.
)r' r( r1 rB )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 r2 )r2 r" r r r r s c C s6 t t } | | _ | r2 | j d | | _ n | 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 r2 )targetr2 r" r r r r s
c @ s e Z d Z d Z d 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 Z
d S)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& | r d | | f } n | | _ d S)Nz{%s}%s)r2 )r+ Z text_or_urir r r r r- s zQName.__init__c C s | j S)N)r2 )r+ r r r __str__ s z
QName.__str__c C s d | j f S)Nz
)r2 )r+ r r r r0 s zQName.__repr__c C s
t | j S)N)hashr2 )r+ r r r __hash__ s zQName.__hash__c C s, t | t r | j | j k S| j | k S)N)r# r
r2 )r+ otherr r r __le__ s z QName.__le__c C s, t | t r | j | j k S| j | k S)N)r# r
r2 )r+ rh r r r __lt__ s z QName.__lt__c C s, t | t r | j | j k S| j | k S)N)r# r
r2 )r+ rh r r r __ge__ s z QName.__ge__c C s, t | t r | j | j k S| j | k S)N)r# r
r2 )r+ rh r r r __gt__ s z QName.__gt__c C s, t | t r | j | j k S| j | k S)N)r# r
r2 )r+ rh r r r __eq__ s z QName.__eq__c C s, t | t r | j | j k S| j | k S)N)r# r
r2 )r+ rh r r r __ne__ s z QName.__ne__)r r r r r- re r0 rg ri rj rk rl rm rn r r r r r
s
c @ s e Z d Z d Z d d d d Z d d Z d d Z d d d
Z d d d Z d d
d Z d d d Z
d d d d Z d d d Z d d d Z
d d d d d d d d Z d d Z d S) 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 | j | n d S)N)_rootr )r+ r" filer r r r- * s zElementTree.__init__c C s | j S)z!Return root element of this tree.)ro )r+ r r r getroot0 s zElementTree.getrootc C s
| | _ d S)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!
N)ro )r+ r" r r r _setroot4 s zElementTree._setrootc
C s d } t | d s- t | d } d } n z | d k rp t } t | d rp | j | | _ | j Sn x* | j d } | s Pn | j | qs W| j | _ | j SWd | r | j n Xd S)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! openr ru ro rs feedclose)r+ sourceparser close_sourcedatar r r r > s&
zElementTree.parsec C s | j 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).
)ro r\ )r+ r r r r r\ c s
zElementTree.iterc C s) t j d t d d t | j | S)NzbThis method will be removed in future versions. Use 'tree.iter()' or 'list(tree.iter())' instead.r7 r8 )r9 r: r] r^ r\ )r+ r r r r r_ p s
zElementTree.getiteratorc C sP | d d d k r= d | } t j d | t d d n | j 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 /.zThis 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 %rr7 r8 )r9 r: r; ro rM )r+ rN rO r r r rM y s
zElementTree.findc C sS | d d d k r= d | } t j d | t d d n | j 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~ zThis 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 %rr7 r8 )r9 r: r; ro rP )r+ rN rQ rO r r r rP s
zElementTree.findtextc C sP | d d d k r= d | } t j d | t d d n | j 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~ zThis 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 %rr7 r8 )r9 r: r; ro rR )r+ rN rO r r r rR s
zElementTree.findallc C sP | d d d k r= d | } t j d | t d d n | j 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~ zThis 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 %rr7 r8 )r9 r: r; ro rS )r+ rN rO r r r rS s
zElementTree.iterfindshort_empty_elementsTc C sB | s d } n | t k r. t d | n | sR | d k rI d } qR d } n | j } t | | } | d k r | s | d k r | d k r | } | d k r d d l }
|
j } n | d | f n | d
k r t | | j n> t | j | \ } } t | }
|
| | j | | d | Wd QXd S)
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-asciiNunicoder z$
r2 r )r r r )
_serialize
ValueErrorlower _get_writerlocalegetpreferredencoding_serialize_textro _namespaces)r+ file_or_filenameencodingZxml_declarationdefault_namespacemethodr Z enc_lowerwriteZdeclared_encodingr qnamesrO Z serializer r r r s2
zElementTree.writec C s | j | d d S)Nr r )r )r+ rp r r r
write_c14n s zElementTree.write_c14n)r r r r r- rq rr r r\ r_ rM rP rR rS r r r r r r r s"
%
5c c sz y
| j } Wn` t k
ro | d k r; t | d } n t | d d | d d } |
| j VWd QXYnX| d k r | Vn t j } t | t j r | } n t | t j r t j | } | j
| j nU t j } d d | _ | | _ y | j
| _
| j | _ Wn t k
r6Yn Xt j | d | d d d d } | j
| j | j VWd QXd S)
Nr wr errorsxmlcharrefreplacec S s d S)NTr r r r r 4 s z _get_writer..newline
)r AttributeErrorrv
contextlib ExitStackr# ioBufferedIOBase RawIOBaseBufferedWritercallbackdetachwritableseekabletell
TextIOWrapper)r r r rp stackr r r r s>
r c s i d d 6 i r& d .add_qname)
r\ r r# r
r2 r` r r r rZ )r4 r r r rV rW r2 r )r rO r r r F s4
$
r c K s_ | j } | j } | t k r/ | d | n
| t k rL | d | n| | } | d k r | r{ | t | n x| D] } t | | | d d | q Wn| d | t | j } | s | r| r9x\ t | j d d d D]9 \ }
} | rd | } n | d | t |
f q Wn x{ t | D]j \ } }
t
| t rm| j } n t
|
t r| |
j }
n t |
}
| d
| | |
f qFWn | st | s| r2| d | r| t | n x' | D] } t | | | d d | qW| d | d n
| d
| j
r[| t | j
n d S)Nz zr .:z
xmlns%s="%s"z %s="%s">z)r r2 r r
_escape_cdata_serialize_xmlr^ rZ sorted_escape_attribr# r
r5 r3 ) r r4 r rO r kwargsr r2 rI rZ vkr r r r sT
r ZareabaseZbasefontZbrcolZframeZhrZimginputZisindexlinkmetaZparamc K sy | j } | j } | t k r5 | d t | n!| t k rX | d t | n| | } | d k r | r | t | n x| D] } t | | | d q Wn| d | t | j } | s | r| r?x\ t | j d d d D]9 \ } }
|
r d |
}
n | d |
t | f q Wn x{ t | D]j \ }
} t
|
t rs|
j }
n t
| t r| | j } n t | } | d | |
| f qLWn | d
| j
} | r| d k s| d k r| | q| t | n x! | D] } t | | | d qW| t k rV| d
| d
n | j ru| t | j n d S)Nz zr rV c S s | d S)Nr r )r r r r r s z!_serialize_html..r z
xmlns%s="%s"z %s="%s"r ZscriptZstylez x | j D] } | | q
W| j r: | | j n d S)N)ra r3 )r r4 partr r r r s r r htmlr2 c C st t j d | r! t d n xB t t j D]. \ } } | | k sX | | k r4 t | =q4 q4 W| t | t d | d | | _ | | _ | | _ d | _ | _ d S)Nr r )r r _file _close_filer ro )r+ ry r rz r{ r r r r- s z_IterParseIterator.__init__c C s y xr x | j j D] } | SW| j j d k r7 Pn | j j d } | rb | j j | q | j j | _ q W| j | _ Wn$ | j r | j j n Yn X| j r | j j n t
d S)N i i @ ) r r r rs rw r ro r r rx
StopIteration)r+ r r| r r r __next__ s$ z_IterParseIterator.__next__c C s | S)Nr )r+ r r r __iter__& s z_IterParseIterator.__iter__N)r r r r- r r r r r r r s r c C s2 | s t d t } n | j | | j 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.
rd )r r rw rx )r2 rz r r r r * s
c C s} | s t d t } n | j | | j } i } x6 | j D]( } | j d } | rG | | | .handlerr c S s | | | | f d S)Nr )r r rB r r r r r
s zstart-nsc S s& | | | p d | p d f f d S)Nr r )r r r rB r r r r
s zend-nsc S s | | d f d S)Nr )r r rB r r r r
s zunknown event %r) r rB r r r r r r ZStartNamespaceDeclHandlerZEndNamespaceDeclHandlerr )r+ Z events_queueZevents_to_reportrz rB Z
event_namer
r r r r s(
zXMLParser._seteventsc C s7 t | } | j | _ | j | j f | _ | d S)N)r
codelinenooffsetZposition)r+ rW errr r r _raiseerror s zXMLParser._raiseerrorc C sV y | j | } Wn> t k
rQ | } d | k r@ d | } n | | j | " s ) >44= 2
2
E$K