Viewing File: /opt/alt/python35/lib64/python3.5/xml/etree/__pycache__/ElementTree.cpython-35.pyc



Yf@swdZddddddddd	d
ddd
dddddddddgZdZddlZddlZddlZddlZddlZddlm	Z	Gdd
d
e
ZddZGdddZ
iddZdd dZdd!dZeZGd"d
d
ZGd#ddZejd$d%Zdd&d'Zd(d)Zd*d+d,d-d.d/d0d1d2d3d4d5d6f
ZyeeZWnek
rYnXd7d8Zd9d:Zd;ed<ed=eiZd>dZd?d;d@d<dAdBdCdDdEdFdGdHdIdJiZee_dKdLZ dMdNZ!dOdPZ"dQdRZ#dddSdTdUdZ$GdVdWdWej%Z&dddSdTdXdZ'dYdZ(ddZd	Z)ddd[dZ*Gd\d]d]Z+Gd^d_d_Z,dd`dZ-ddadZ.e-Z/ddbdZ0GdcddZ1GddddZ2ye
Z3ddel4TWne5k
rrYnXdS)faLightweight 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.

CommentdumpElementElementTree
fromstringfromstringlist	iselement	iterparseparse
ParseErrorPIProcessingInstructionQName
SubElementtostringtostringlistTreeBuilderVERSIONXMLXMLID	XMLParserregister_namespacez1.3.0N)ElementPathc@seZdZdZdS)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__rr:/opt/alt/python35/lib64/python3.5/xml/etree/ElementTree.pyr
gscCs
t|dS)z2Return True if *element* appears to be an Element.tag)hasattr)elementrrrrusc@seZdZdZdZdZdZdZiddZddZ	ddZ
d	d
ZddZd
dZ
ddZddZddZddZddZddZddZddZdd Zdd!d"Zddd#d$Zdd%d&Zdd'd(Zd)d*Zdd+d,Zd-d.Zd/d0Zd1d2Zdd3d4Z dd5d6Z!d7d8Z"dS)9rahAn 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

    NcKs`t|ts(td|jjf|j}|j|||_||_g|_	dS)Nzattrib must be dict, not %s)

isinstancedict	TypeError	__class__rcopyupdater attrib	_children)selfr r)extrarrr__init__s
		zElement.__init__cCs d|jj|jt|fS)Nz<%s %r at %#x>)r&rr id)r+rrr__repr__szElement.__repr__cCs|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)rrrmakeelements	zElement.makeelementcCsD|j|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)r0r r)texttail)r+elemrrrr's
zElement.copycCs
t|jS)N)lenr*)r+rrr__len__szElement.__len__cCs)tjdtddt|jdkS)NzyThe behavior of this method will change in future versions.  Use specific 'len(elem)' or 'elem is not None' test instead.
stacklevelr)warningswarn
FutureWarningr4r*)r+rrr__bool__s
zElement.__bool__cCs|j|S)N)r*)r+indexrrr__getitem__szElement.__getitem__cCs||j|<dS)N)r*)r+r<r"rrr__setitem__szElement.__setitem__cCs|j|=dS)N)r*)r+r<rrr__delitem__szElement.__delitem__cCs!|j||jj|dS)aAdd *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)_assert_is_elementr*append)r+
subelementrrrrAs
zElement.appendcCs2x|D]}|j|qW|jj|dS)zkAppend subelements from a sequence.

        *elements* is a sequence with zero or more elements.

        N)r@r*extend)r+elementsr"rrrrCs
zElement.extendcCs$|j||jj||dS)z(Insert *subelement* at position *index*.N)r@r*insert)r+r<rBrrrrEs
zElement.insertcCs,t|ts(tdt|jdS)Nzexpected an Element, not %s)r#_Element_Pyr%typer)r+errrr@szElement._assert_is_elementcCs|jj|dS)aRemove 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*remove)r+rBrrrrIs
zElement.removecCstjdtdd|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.r6r7)r8r9DeprecationWarningr*)r+rrrgetchildrens
zElement.getchildrencCstj|||S)aFind 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.

        )rfind)r+path
namespacesrrrrL s	zElement.findcCstj||||S)aFind 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.

        )rfindtext)r+rMdefaultrNrrrrO+szElement.findtextcCstj|||S)aFind 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.

        )rfindall)r+rMrNrrrrQ9s	zElement.findallcCstj|||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.

        )riterfind)r+rMrNrrrrRDs	zElement.iterfindcCs*|jjg|_d|_|_dS)zReset element.

        This function removes all subelements, clears all attributes, and sets
        the text and tail attributes to None.

        N)r)clearr*r1r2)r+rrrrSOs
	z
Element.clearcCs|jj||S)agGet 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+keyrPrrrrTZszElement.getcCs||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+rUvaluerrrsetgszElement.setcCs
|jjS)zGet list of attribute names.

        Names are returned in an arbitrary order, just like an ordinary
        Python dict.  Equivalent to attrib.keys()

        )r)keys)r+rrrrXqszElement.keyscCs
|jjS)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)items)r+rrrrYzs	z
Element.itemsccs\|dkrd}|dks-|j|kr2|Vx#|jD]}|j|EdHq<WdS)aCreate 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 rHrrrr[szElement.itercCs)tjdtddt|j|S)NzbThis method will be removed in future versions.  Use 'elem.iter()' or 'list(elem.iter())' instead.r6r7)r8r9PendingDeprecationWarninglistr[)r+r rrrgetiterators
zElement.getiteratorccsu|j}t|tr)|dk	r)dS|j}|r=|Vx1|D])}|jEdH|j}|rD|VqDWdS)zCreate text iterator.

        The iterator loops over the element and all subelements in document
        order, returning all inner text.

        N)r r#strr1itertextr2)r+r trHrrrr`s		
	zElement.itertext)#rrrrr r)r1r2r-r/r0r'r5r;r=r>r?rArCrEr@rIrKrLrOrQrRrSrTrWrXrYr[r^r`rrrrrzs@	





		cKs<|j}|j||j||}|j||S)aSubelement 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(r0rA)parentr r)r,r"rrrrs


cCstt}||_|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.

    )rrr1)r1r"rrrrs		cCs3tt}||_|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.

     )rrr1)targetr1r"rrrrs

	c@seZdZdZdddZddZddZd	d
ZddZd
dZ	ddZ
ddZddZdS)r
aQualified 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.

    NcCs#|rd||f}||_dS)Nz{%s}%s)r1)r+Ztext_or_urir rrrr-szQName.__init__cCs|jS)N)r1)r+rrr__str__sz
QName.__str__cCsd|jj|jfS)Nz<%s %r>)r&rr1)r+rrrr/szQName.__repr__cCs
t|jS)N)hashr1)r+rrr__hash__szQName.__hash__cCs,t|tr|j|jkS|j|kS)N)r#r
r1)r+otherrrr__le__szQName.__le__cCs,t|tr|j|jkS|j|kS)N)r#r
r1)r+rhrrr__lt__	szQName.__lt__cCs,t|tr|j|jkS|j|kS)N)r#r
r1)r+rhrrr__ge__
szQName.__ge__cCs,t|tr|j|jkS|j|kS)N)r#r
r1)r+rhrrr__gt__szQName.__gt__cCs,t|tr|j|jkS|j|kS)N)r#r
r1)r+rhrrr__eq__szQName.__eq__)
rrrrr-rer/rgrirjrkrlrmrrrrr
s
c@seZdZdZddddZddZddZdd	d
ZdddZdd
dZ	dddZ
ddddZdddZdddZ
ddddddddZddZdS)ra%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.

    NcCs ||_|r|j|dS)N)_rootr	)r+r"filerrrr-(s	zElementTree.__init__cCs|jS)z!Return root element of this tree.)rn)r+rrrgetroot.szElementTree.getrootcCs
||_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!

        N)rn)r+r"rrr_setroot2szElementTree._setrootc
Csd}t|ds*t|d}d}z|dkrjt}t|drj|j||_|jSx'|jd}|sP|j|qmW|j|_|jSWd|r|jXdS)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!openrrtrnrrfeedclose)r+sourceparserclose_sourcedatarrrr	<s&	zElementTree.parsecCs|jj|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).

        )rnr[)r+r rrrr[as
zElementTree.itercCs)tjdtddt|j|S)NzbThis method will be removed in future versions.  Use 'tree.iter()' or 'list(tree.iter())' instead.r6r7)r8r9r\r]r[)r+r rrrr^ns
zElementTree.getiteratorcCsM|dddkr:d|}tjd|tdd|jj||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 %rr6r7)r8r9r:rnrL)r+rMrNrrrrLws

zElementTree.findcCsP|dddkr:d|}tjd|tdd|jj|||S)aeFind 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.

        Nrr|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 %rr6r7)r8r9r:rnrO)r+rMrPrNrrrrOs

zElementTree.findtextcCsM|dddkr:d|}tjd|tdd|jj||S)aaFind 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.

        Nrr|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 %rr6r7)r8r9r:rnrQ)r+rMrNrrrrQs

zElementTree.findallcCsM|dddkr:d|}tjd|tdd|jj||S)agFind 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.

        Nrr|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 %rr6r7)r8r9r:rnrR)r+rMrNrrrrRs

zElementTree.iterfindshort_empty_elementsTcCs7|sd}n|tkr+td||sL|dkrFd}nd}|j}t||}|dkr|s|dkr|dkr|}	|dkrddl}
|
j}	|d	|	f|d
krt||jn>t|j|\}}t|}
|
||j||d|WdQRXdS)
aWrite 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-asciiNunicoderz$<?xml version='1.0' encoding='%s'?>
r1r~)rrr)	
_serialize
ValueErrorlower_get_writerlocalegetpreferredencoding_serialize_textrn_namespaces)r+file_or_filenameencodingZxml_declarationdefault_namespacemethodr~Z	enc_lowerwriteZdeclared_encodingrqnamesrNZ	serializerrrrs2		
zElementTree.writecCs|j|ddS)Nrr)r)r+rorrr
write_c14n	szElementTree.write_c14n)rrrrr-rprqr	r[r^rLrOrQrRrrrrrrrs"

%
	5ccs|y
|j}Wnatk
rp|dkr;t|d}nt|dd|dd}|
|jVWdQRXYnX|dkr|Vntj}t|tjr|}nt|tjrtj	|}|j
|jnUtj}dd|_||_y|j
|_
|j|_Wntk
r7YnXtj|d|dddd	}|j
|j|jVWdQRXdS)
NrwrerrorsxmlcharrefreplacecSsdS)NTrrrrr<lambda>2sz_get_writer.<locals>.<lambda>newline
)rAttributeErrorru
contextlib	ExitStackr#ioBufferedIOBase	RawIOBaseBufferedWritercallbackdetachwritableseekabletell
TextIOWrapper)rrrrostackrrrrs>

			
	rcsddiir"d<fdd}xK|jD]=}|j}t|tr|jkr||jnVt|tr|kr||n.|dk	r|tk	r|tk	rt|xs|j	D]e\}}t|tr|j}|kr!||t|tr|jkr||jqW|j}t|trG|jkrG||jqGWfS)Ncsy|dddkr|ddjdd\}}j|}|dkrtj|}|dkrdt}|dkr||<|rd||f|<q||<nrtd||<Wntk
rt|YnXdS)Nr{}zns%drz%s:%sz<cannot use non-qualified names with default_namespace option)rsplitrT_namespace_mapr4rr%_raise_serialization_error)Zqnameurir prefix)rrNrrr	add_qnameOs&"

	
z_namespaces.<locals>.add_qname)
r[r r#r
r1r_rrrrY)r3rrr rUrVr1r)rrNrrrDs4
	
$
	
	rcKsJ|j}|j}|tkr/|d|n|tkrL|d|n||}|dkr|rx|t|x|D]}t|||dd|qWn|d|t|j}	|	s|r|r0xVt|jdddD]6\}
}|rd|}|d	|t	|
fqWxut|	D]g\}}
t
|tra|j}t
|
tr||
j}
nt	|
}
|d
|||
fq=W|st|s|r |d|r|t|x'|D]}t|||dd|qW|d|dn
|d
|j
rF|t|j
dS)Nz	<!--%s-->z<?%s?>r~<rUcSs|dS)Nrr)xrrrrsz _serialize_xml.<locals>.<lambda>:z
 xmlns%s="%s"z %s="%s">z</z />)r r1rr
_escape_cdata_serialize_xmlr]rYsorted_escape_attribr#r
r4r2)rr3rrNr~kwargsr r1rHrYvkrrrrsT		


	


	rZareabaseZbasefontZbrcolframeZhrZimginputZisindexlinkmetaZparamcKsa|j}|j}|tkr5|dt|n|tkrX|dt|n||}|dkr|r|t|x|D]}t|||dqWn|d|t|j}|s|r|r6xVt|jdddD]6\}	}
|
rd|
}
|d|
t	|	fqWxut|D]g\}
}	t
|
trg|
j}
t
|	tr||	j}	nt|	}	|d	||
|	fqCW|d
|j
}|r|dks|dkr||n|t|x!|D]}t|||dqW|tkrA|d
|d
|jr]|t|jdS)Nz	<!--%s-->z<?%s?>rrUcSs|dS)Nrr)rrrrrsz!_serialize_html.<locals>.<lambda>rz
 xmlns%s="%s"z %s="%s"rZscriptZstylez</)r r1rrr_serialize_htmlr]rYrrr#r
_escape_attrib_htmlr
HTML_EMPTYr2)rr3rrNrr r1rHrYrrZltagrrrrsT		


	


	rcCs;x|jD]}||q
W|jr7||jdS)N)r`r2)rr3partrrrrs	rrhtmlr1cCsntjd|rtdx?ttjD]+\}}||ksU||kr1t|=q1W|t|<dS)atRegister 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)rematchrr]rrY)rrrrrrrrsz$http://www.w3.org/XML/1998/namespacezhttp://www.w3.org/1999/xhtmlz+http://www.w3.org/1999/02/22-rdf-syntax-ns#Zrdfz http://schemas.xmlsoap.org/wsdl/Zwsdlz http://www.w3.org/2001/XMLSchemaZxsz)http://www.w3.org/2001/XMLSchema-instanceZxsiz http://purl.org/dc/elements/1.1/ZdccCs#td|t|jfdS)Nzcannot serialize %r (type %s))r%rGr)r1rrrrsrcCsybd|kr!|jdd}d|kr?|jdd}d|kr]|jdd}|SWn"ttfk
rt|YnXdS)N&z&amp;rz&lt;rz&gt;)replacer%rr)r1rrrr#srcCs!yd|kr!|jdd}d|kr?|jdd}d|kr]|jdd}d|kr{|jdd}d	|kr|jd	d
}d|kr|jdd
}d
|kr|jd
d}d
|kr|jd
d}|SWn"ttfk
rt|YnXdS)Nrz&amp;rz&lt;rz&gt;"z&quot;z
r
z&#10;	z&#09;)rr%rr)r1rrrr3s(rcCsybd|kr!|jdd}d|kr?|jdd}d|kr]|jdd}|SWn"ttfk
rt|YnXdS)Nrz&amp;rz&gt;rz&quot;)rr%rr)r1rrrrOsrr~TcCsP|dkrtjn	tj}t|j||d|d||jS)aGenerate 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".

    Returns an (optionally) encoded string containing the XML data.

    rrr~)rStringIOBytesIOrrgetvalue)r"rrr~streamrrrr^s$c@sReZdZdZddZddZddZdd	Zd
dZdS)
_ListDataStreamz7An auxiliary stream accumulating into a list reference.cCs
||_dS)N)lst)r+rrrrr-ssz_ListDataStream.__init__cCsdS)NTr)r+rrrrvsz_ListDataStream.writablecCsdS)NTr)r+rrrrysz_ListDataStream.seekablecCs|jj|dS)N)rrA)r+brrrr|sz_ListDataStream.writecCs
t|jS)N)r4r)r+rrrrsz_ListDataStream.tellN)	rrrrr-rrrrrrrrrqsrcCs8g}t|}t|j||d|d||S)Nrr~)rrr)r"rrr~rrrrrrs
cCskt|tst|}|jtjdd|jj}|sW|ddkrgtjjddS)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.

    rrrrN)r#rrsysstdoutrpr2)r3r2rrrrscCst}|j|||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.

    )rr	)rxrytreerrrr	s		cCscd}t|ds*t|d}d}yt||||SWn|rW|jYnXdS)aJIncrementally 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.

    FrrrsTN)r!ru_IterParseIteratorrw)rxeventsryrzrrrrs
c@sUeZdZdddddZddZddZd	d
ZddZdS)

XMLPullParserN_parsercCsYg|_d|_|p'tdt|_|dkr?d}|jj|j|dS)Nrrdend)r)
_events_queue_indexrrr
_setevents)r+rrrrrr-s		zXMLPullParser.__init__cCsq|jdkrtd|rmy|jj|Wn5tk
rl}z|jj|WYdd}~XnXdS)zFeed encoded data to parser.Nz!feed() called after end of stream)rrrvSyntaxErrorrrA)r+r{excrrrrvszXMLPullParser.feedcCs|jj}d|_|S)N)rrw)r+rootrrr_close_and_return_roots	z$XMLPullParser._close_and_return_rootcCs|jdS)zFinish feeding data to parser.

        Unlike XMLParser, does not return the root element. Use
        read_events() to consume elements from XMLPullParser.
        N)r)r+rrrrwszXMLPullParser.closeccs|j}x|j}y||j}d||j<Wntk
rHPYnX|d7}|dt|krg|d|<d|_n	||_t|tr|q|VqWdS)zReturn an iterator over currently available (event, elem) pairs.

        Events are consumed from the internal event queue as they are
        retrieved from the iterator.
        Nrr7r)rr
IndexErrorr4r#	Exception)r+rr<eventrrrread_eventss 		


		zXMLPullParser.read_events)rrrr-rvrrwrrrrrrs

rc@s7eZdZdddZddZddZdS)	rFcCs>td|d||_||_||_d|_|_dS)Nrr)rr_file_close_filerrn)r+rxrryrzrrrr-s		z_IterParseIterator.__init__c	Csyxox|jjD]}|SW|jjdkr4P|jjd}|r_|jj|q|jj|_qW|j|_Wn!|jr|jj	YnX|jr|jj	t
dS)Nii@)rrrrrrvrrnrrrw
StopIteration)r+rr{rrr__next__s$	
	
z_IterParseIterator.__next__cCs|S)Nr)r+rrr__iter__/sz_IterParseIterator.__iter__N)rrrr-rrrrrrrsrcCs/|stdt}|j||jS)aParse 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)rrrvrw)r1ryrrrr3s
cCsw|stdt}|j||j}i}x3|jD]%}|jd}|rD|||<qDW||fS)aParse 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.

    rdr.)rrrvrwr[rT)r1ryrZidsr3r.rrrrDs

cCs@|stdt}x|D]}|j|qW|jS)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.

    rd)rrrvrw)Zsequenceryr1rrrr\s
	
c@saeZdZdZdddZddZddZd	d
ZddZd
dZ	dS)raGeneric 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.

    NcCsCg|_g|_d|_d|_|dkr6t}||_dS)N)_data_elem_last_tailr_factory)r+Zelement_factoryrrrr-{s				zTreeBuilder.__init__cCsCt|jdks!td|jdk	s<td|jS)z;Flush builder buffers and return toplevel document Element.rzmissing end tagsNzmissing toplevel element)r4rAssertionErrorr)r+rrrrws!zTreeBuilder.closecCs|jr|jdk	rdj|j}|jr`|jjdksQtd||j_n*|jjdks~td||j_g|_dS)Nrzinternal error (tail)zinternal error (text))rrjoinrr2rr1)r+r1rrr_flushs		zTreeBuilder._flushcCs|jj|dS)zAdd text to current element.N)rrA)r+r{rrrr{szTreeBuilder.datacCs]|j|j|||_}|jr@|jdj||jj|d|_|S)zOpen new element and return it.

        *tag* is the element name, *attrs* is a dict containing element
        attributes.

        rrr)rrrrrAr)r+r Zattrsr3rrrstarts
		zTreeBuilder.startcCsZ|j|jj|_|jj|ksJtd|jj|fd|_|jS)zOClose and return current Element.

        *tag* is the element name.

        z&end tag mismatch (expected %s, got %s)r)rrpoprr rr)r+r rrrrs
	zTreeBuilder.end)
rrrrr-rwrr{rrrrrrrns	c@seZdZdZdddddZddZdd	Zd
dZdd
ZddZ	ddZ
ddZeZddZ
ddZdS)raElement structure builder for XML source data based on the expat parser.

    *html* are predefined HTML entities (deprecated and not supported),
    *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

    rNcCsyddlm}WnCtk
rYyddl}Wntk
rTtdYnXYnX|j|d}|dkrt}||_|_||_|_	|j
|_i|_|j
|_t|dr|j|_t|dr|j|_t|dr|j|_t|dr.|j|_t|d	rI|j|_d
|_d
|_d
|_d|_i|_yd|j|_ Wnt!k
rYnXdS)Nr)expatz7No module named expat; use SimpleXMLTreeBuilder insteadrrrr{commentpirzExpat %d.%d.%d)"xml.parsersrImportErrorZpyexpatZParserCreaterryrrd_targeterror_error_names_defaultZDefaultHandlerExpandr!_startStartElementHandler_endEndElementHandlerr{ZCharacterDataHandlerrZCommentHandlerrZProcessingInstructionHandlerZbuffer_textordered_attributesspecified_attributes_doctypeentityversion_infoversionr)r+rrdrrryrrrr-sF

							
zXMLParser.__init__cCs|j}|j}x|D]}|dkrad|_d|_|||jdd}||_q|dkr|||jdd}||_q|dkr||dd}||_q|d	kr||d
d}||_	qt
d|qWdS)NrrcSs|||||fdS)Nr)r Z	attrib_inrrArrrrhandlersz%XMLParser._setevents.<locals>.handlerrcSs||||fdS)Nr)r rrArrrrrszstart-nscSs&|||pd|pdffdS)Nrr)rrrrArrrrszend-nscSs||dfdS)Nr)rrrArrrr	szunknown event %r)rrArrrrrrZStartNamespaceDeclHandlerZEndNamespaceDeclHandlerr)r+Zevents_queueZevents_to_reportryrAZ
event_namerrrrrs(		
		zXMLParser._seteventscCs7t|}|j|_|j|jf|_|dS)N)r
codelinenooffsetZposition)r+rVerrrrr_raiseerrorszXMLParser._raiseerrorcCsSy|j|}Wn;tk
rN|}d|kr=d|}||j|<YnX|S)Nrr)rKeyError)r+rUnamerrr_fixnames

zXMLParser._fixnamecCss|j}||}i}|r`x<tdt|dD]"}||d||||<q:W|jj||S)Nrr7r)rranger4rdr)r+r Z	attr_listZfixnamer)irrrr s	 zXMLParser._startcCs|jj|j|S)N)rdrr)r+r rrrr,szXMLParser._endcCs|dd}|dkry|jj}Wntk
rDdSYnXy||j|ddWqtk
rddlm}|jd||jj	|jj
f}d|_|jj	|_|jj
|_
|YqXn|dkr|ddd	krg|_n}|jdk	r|d
kr7d|_dS|j}|sMdS|jj|t|j}|dkr|jd}|dkr|d
kr|j\}}}	}
|	r|	dd}	n7|dkr|dkr|j\}}}
d}	ndSt|jdr7|jj||	|
ddnL|j|jkr|j||	|
dd|j||	|
ddd|_dS)Nrrr)rz'undefined entity %s: line %d, column %dr	z	<!DOCTYPErr7ZPUBLICZSYSTEMdoctyperrrrr)rdr{rr	rrrrryZErrorLineNumberZErrorColumnNumberr
rrrstriprAr4r!r_XMLParser__doctype)r+r1rZdata_handlerrrnrGrpubidsystemrrrr/sZ
	
	"	
	#zXMLParser._defaultcCstjdtdS)z(Deprecated)  Handle doctype declaration

        *name* is the Doctype name, *pubid* is the public identifier,
        and *system* is the system identifier.

        z[This method of XMLParser is deprecated.  Define doctype() method on the TreeBuilder target.N)r8r9rJ)r+rrr rrrrcszXMLParser.doctypecCsSy|jj|dWn5|jk
rN}z|j|WYdd}~XnXdS)zFeed encoded data to parser.rN)ryParserr)r+r{rrrrrvsszXMLParser.feedcCsy|jjddWn5|jk
rN}z|j|WYdd}~XnXz0y|jj}Wntk
rvYnX|SWd|`|`|`|`XdS)z;Finish feeding data to parser and return element structure.rrN)	ryr!rrrdrwrrr)r+rZ
close_handlerrrrrwzs 
zXMLParser.close)rrrrr-rrrrrrrrrvrwrrrrrs	*!4)rZ)6r__all__rrrr8rrrrrr
rrrrrrr
rcontextmanagerrrrrrW	NameErrorrrrrrrrrrrrrrrr	rrrrrrrrrrFZ_elementtreerrrrr<module>"s)	@04=2
2			E$K

Back to Directory File Manager