*j$ S r / SQrSrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK
r
SSK J r " S S\
5 rS r " S
S 5 r0 4S jrSDS
jrSDS jr\r " S S5 r " S S5 r\ R. S 5 rSDS jrS r1 Skr1 Skr S r S r \\ \ S.r S r S S S S S S!S"S#.r!\!\ l! S$ r"S% r#S& r$S' r%SESSS(S).S* jjr& " S+ S,\RN 5 r(SESSS(S).S- jjr)S. r*SFS/ jr+SDS0 jr,SES1 jr- " S2 S35 r.SDS4 jr/SDS5 jr0\/r1SDS6 jr2 " S7 S85 r3 " S9 S:5 r4SDSSS;.S< jjr5\Rl " S=\Rn 5 Rp r9 " S> S?5 r:S@ r;SA r< \r=SSBK>7 SSCK>J?r? \?" \\5 g! \@ a gf = f)Ga 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
fromstringfromstringlistindent iselement iterparseparse
ParseErrorPIProcessingInstructionQName
SubElementtostring tostringlist TreeBuilderVERSIONXMLXMLID XMLParser
XMLPullParserregister_namespace canonicalizeC14NWriterTargetz1.3.0 N ) ElementPathc \ rS rSrSrSrg)r k 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____firstlineno____doc____static_attributes__r! text...tail
Nc [ U[ 5 ( d# [ SUR R < 35 eXl 0 UEUEU l / U l g )Nzattrib must be dict, not )
isinstancedict TypeError __class__r" r+ attrib _children)selfr+ r5 extras r) __init__Element.__init__ sM &$'' )) , -
-))5) r( c ` SU R R U R [ U 5 4- $ )Nz<%s %r at %#x>)r4 r" r+ idr7 s r) __repr__Element.__repr__ s& 4>>#:#:DHHbh"OOOr( c $ U R X5 $ )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.
)r4 )r7 r+ r5 s r) makeelementElement.makeelement s ~~c**r( c U R U R U R 5 nU R Ul U R Ul XS S & U$ N)rA r+ r5 texttail)r7 elems r) __copy__Element.__copy__ s> $++6II II Q r( c , [ U R 5 $ rD )lenr6 r= s r) __len__Element.__len__ s 4>>""r( c f [ R " S[ SS9 [ U R 5 S:g $ )NzTesting an element's truth value will always return True in future versions. Use specific 'len(elem)' or 'elem is not None' test instead.
stacklevelr )warningswarnDeprecationWarningrK r6 r= s r) __bool__Element.__bool__ s1
K
1 4>>"a''r( c U R U $ rD r6 r7 indexs r) __getitem__Element.__getitem__ s ~~e$$r( c [ U[ 5 ( a U H nU R U5 M OU R U5 X R U' g rD )r1 slice_assert_is_elementr6 )r7 rZ r- elts r) __setitem__Element.__setitem__ sC eU # # '',
# #G , 'u r( c U R U g rD rX rY s r) __delitem__Element.__delitem__ s NN5 !r( c \ U R U5 U R R U5 g)zAdd *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.
Nr_ r6 appendr7
subelements r) rh Element.append s$
+ j)r( c n U H/ nU R U5 U R R U5 M1 g)z[Append subelements from a sequence.
*elements* is a sequence with zero or more elements.
Nrg )r7 elementsr- s r) extendElement.extend s. G # #G , NN ! !' * r( c \ U R U5 U R R X5 g)z(Insert *subelement* at position *index*.N)r_ r6 insert)r7 rZ rj s r) rq Element.insert s"
+ e0r( c p [ U[ 5 ( d! [ S[ U5 R - 5 eg Nexpected an Element, not %s)r1 _Element_Pyr3 typer" )r7 es r) r_ Element._assert_is_element s1 ![)) 9DG rA rH rL rU r[ ra rd rh rn rq r_ r{ r~ r r r r r r r r r r r' r! r( r) r r ~ s ( C
F1 D D $& P +#(%(" *+1
N
*
8
E
;
< % -!" ##,r( r c V 0 UEUEnU R X5 nU R U5 U$ )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.
)rA rh )parentr+ r5 r8 r- s r) r r s4 !
%
F -G
MM' Nr( c 0 [ [ 5 nXl U$ )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 rE )rE r- s r) r r s g GL Nr( c l [ [ 5 nXl U( a UR S- U- Ul U$ )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 rE )targetrE r- s r) r r s1 +,GL ||c)D0 Nr( c R \ rS rSrSrSS jrS rS rS rS r S r
S
r S r S r
S
rg)r i 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 2 U( a
SU< SU< 3nXl g )N{}rE )r7 text_or_urir+ s r) r9 QName.__init__ s &137K r( c U R $ rD r r= s r) __str__
QName.__str__ s yyr( c T SU R R < SU R < S3$ )N)r4 r" rE r= s r) r> QName.__repr__ s NN 3 3TYY??r( c , [ U R 5 $ rD )hashrE r= s r) __hash__QName.__hash__ s DII r( c | [ U[ 5 ( a U R UR :* $ U R U:* $ rD r1 r rE r7 others r) __le__ QName.__le__ 1 eU # #99
* *yyE!!r( c | [ U[ 5 ( a U R UR : $ U R U: $ rD r r s r) __lt__ QName.__lt__ 1 eU # #99uzz) )yy5 r( c | [ U[ 5 ( a U R UR : $ U R U: $ rD r r s r) __ge__ QName.__ge__ r r( c | [ U[ 5 ( a U R UR : $ U R U: $ rD r r s r) __gt__ QName.__gt__ r r( c | [ U[ 5 ( a U R UR :H $ U R U:H $ rD r r s r) __eq__ QName.__eq__ r r( r rD )r" r# r$ r% r& r9 r r> r r r r r r r' r! r( r) r r s5 @ "!"!"r( r c \ rS rSrSrSS jrS rS rSS jrSS jr SS jr
SS
jr SS jr SS jr
SS
S.S jjrS rSrg)r i 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 Ub1 [ U5 ( d! [ S[ U5 R - 5 eXl U( a U R U5 g g rt )r r3 rw r" _rootr )r7 r- files r) r9 ElementTree.__init__ sM y'9'9 9 M 2 2 3 4
4
JJt r( c U R $ )z!Return root element of this tree.r r= s r) getrootElementTree.getroot s zzr( c r [ U5 ( d! [ S[ U5 R - 5 eXl g)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!
ru N)r r3 rw r" r )r7 r- s r) _setrootElementTree._setroot s6 !! 9 "7m 4 4 5 6
6
r( c ( Sn[ US5 ( d [ US5 nSn UcU [ 5 n[ US5 ( a: UR U5 U l U R U( a UR 5 $ $ UR
S5 =n( a+ UR U5 UR
S5 =n( a M+ UR 5 U l U R U( a UR 5 $ $ ! U( a UR 5 f f = f)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.
FreadrbT _parse_wholei )r, openr r r closer feed)r7 sourceparser close_sourcedatas r) r ElementTree.parse) s vv&&&$'F L ~"6>22
"(!4!4V! C7 7Dc 8 U R R U5 $ )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 r r7 r+ s r) r ElementTree.iterK s zzs##r( c USS S:X a" SU- n[ R " SU- [ SS9 U R R X5 $ )a4 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 %rrO rP )rR rS
FutureWarningr r~ r s r) r~ ElementTree.findX sO 8s?:D MM-/34 !
zzt00r( c USS S:X a" SU- n[ R " SU- [ SS9 U R R XU5 $ )a= 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 rO rP )rR rS r r r r s r) r ElementTree.findtexto sS 8s?:D MM-/34 !
zz""4*==r( c USS S:X a" SU- n[ R " SU- [ SS9 U R R X5 $ )a9 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 rO rP )rR rS r r r r s r) r ElementTree.findall sQ 8s?:D MM-/34 !
zz!!$33r( c USS S:X a" SU- n[ R " SU- [ SS9 U R R X5 $ )a? 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 rO rP )rR rS r r r r s r) r ElementTree.iterfind sQ 8s?:D MM-/34 !
zz""444r( Tshort_empty_elementsc U R c [ S5 eU( d SnOU[ ; a [ SU- 5 eU( d US:X a SnOSn[ X5 u pxUS:X a? U( d+ Uc5 UR 5 S:w a! UR 5 S ; a
U" S
U< S 35 US :X a [
XpR 5 O3[ U R U5 u p[ U n U " XpR XUS
9 SSS5 g! , ( d f g= f)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
NzElementTree not initializedxmlzunknown method %rc14nutf-8us-asciiunicode)r r z
rE r )r r3
_serialize
ValueError _get_writerlower_serialize_text _namespaces) r7 file_or_filenameencodingxml_declarationdefault_namespacemethodr writedeclared_encodingqnamesr serializes r) r ElementTree.write s > :: 9: :F
:
% 06 9: : "%
)
48RO$, ^^%2&,,.6KK%( ) zz2%0=N%O" &v . %V/CE 5
4
4s
BC88
Dc " U R USS9$ )Nr )r )r )r7 r s r)
write_c14nElementTree.write_c14n s zz$vz..r( r r rD )NNNN)r" r# r$ r% r& r9 r r r r r~ r r r r r r' r! r( r) r r sZ
D $1.>.4.5. " $ 7E
$( 7Er/r( r c # # U R nUR 5 S:X a U[ U SS 5 =( d S4v g [ R " 5 n[ U [ R 5 ( a U nO[ U [ R 5 ( a2 [ R " U 5 nUR UR 5 OF[ R " 5 nS Ul X$l U R Ul
U R Ul [ R " UUSSS9nUR UR 5 UR U4v S S S 5 g ! [ a NWf = f! , ( d f g = f! [ aP UR 5 S:X a Sn[# U SUSS 9 nUR U4v S S S 5 g ! , ( d f g = ff = f7f)
Nr r r c gNTr! r! r( r) _get_writer.. s Dr( xmlcharrefreplace
)r errorsnewlinew)r r )r r getattr
contextlib ExitStackr1 ioBufferedIOBase RawIOBaseBufferedWritercallbackdetachwritableseekabletellAttributeError
TextIOWrapperr )r
r r stackr s r) r r s -+ && >> y (!1:tDOO O %%'5 .0A0ABB+D 0",,?? ,,-=>D NN4;;/ ,,.D$0DM!&J )9(A(A
$4$9$9 ''19/B046 t{{+jj(**9 ('& * ' (' ' >> y ( H
"C(,.15**h& &. . . . 's G E: AGBE),"EAE) G
E&#E)%E&&E))
E73G:,G&G7G?G
G GGGGc ^^^ S S 0m0 mT( a STT' UUU4S jnU R 5 GHX n U R n[ U[ 5 ( a# UR T; a U" UR 5 OD[ U[
5 ( a UT; a U" U5 O Ub U[ La U[ La [ U5 U R 5 Ho u pE[ U[ 5 ( a UR nUT; a U" U5 [ U[ 5 ( d MK UR T; d M] U" UR 5 Mq U R n[ U[ 5 ( d GM3 UR T; d GMF U" UR 5 GM[ TT4$ )N c j > U S S S:X av U SS R SS5 u pTR U5 nUc1 [ R U5 nUc S[ T5 - nUS:w a UTU' U( a
U< SU< 3TU ' g UTU ' g T( a [ S5 eU TU ' g ! [
a [
U 5 g f = f)Nr r r zns%dr :z.add_qname0 s .RayC 9++C3# ,> + / / 4F ~!'#j/!9 *0
3/5s$;F5M$'F5M$$3 !&u
. &u - .s A8B <B B B21B2)
r r+ r1 r rE r r r
r6 r ) rG r
r: r+ r r rE r r s ` @@r) r r % s7 D\F J(*
$%.8 hh c5 ! !xxv%#((#
S
!
!& #
_G!32
&s + **,JC#u%%hh& #%''EJJf,D%**%
' yy dE " "tyy'> dii ' ( : r( c UR nUR nU[ L a
U " SU- 5 GOU[ L a
U " SU- 5 GOX& nUc/ U( a U " [ U5 5 U H n[ XUS US9 M GOYU " SU- 5 [
UR 5 5 n U ( d U( a U( aH [ UR 5 S S9 H+ u pU ( a SU - n U " SU < S [ U
5 < S
35 M- U Hh u p[ U [ 5 ( a U R n [ U
[ 5 ( a X*R n
O [ U
5 n
U " S X+ < S U
< S
35 Mj U( d [ U5 ( d U( dD U " S 5 U( a U " [ U5 5 U H n[ XUS US9 M U " S
U- S - 5 OU " S5 UR ( a U " [ UR 5 5 g g )N r r c U S $ Nr r! xs r) r _serialize_xml..x QqTr( r r3 xmlns=""r r )r+ rE r r
_escape_cdata_serialize_xmllistr sorted_escape_attribr1 r rK rF ) r rG r r r kwargsr+ rE rx r vks r) rK rK b s
((C 99D
g~
kD ! % %
ho k ;mD)* u4HJ
#) &E
&z'7'7'9+9!; #aA *1 - !; "DA!!U++ FF!!U++ "66N *1 -&)Q78 " s4yy(<c
--. A"5VT8LN dSj3&'e yy
mDII&' r( > xmpstyleiframescriptnoembednoframes plaintext> brhrcolimgwbrareabaselinkmetaembedframeinputparamtrackr isindexbasefontrX c 8 UR nUR nU[ L a U " S[ U5 - 5 GOU[ L a U " S[ U5 - 5 GOX% nUc0 U( a U " [ U5 5 U H n[ XUS 5 M GO`U " SU- 5 [
UR 5 5 nU( d U( a U( aH [ UR 5 S S9 H+ u pU
( a SU
- n
U " SU
< S[ U 5 < S 35 M- U Hh u p[ U
[ 5 ( a U
R n
[ U [ 5 ( a X)R n O [ U 5 n U " S
X* < SU < S 35 Mj U " S 5 UR 5 n U( a$ U [ ; a U " U5 OU " [ U5 5 U H n[ XUS 5 M U [ ; a U " S U- S - 5 UR ( a U " [ UR 5 5 g g )
Nr= r> r c U S $ r@ r! rA s r) r !_serialize_html.. rD r( rE r3 rF rG rH r r rI )r+ rE r rJ r _serialize_htmlrL r rM rN r1 r _escape_attrib_htmlr _CDATA_CONTENT_ELEMENTS
HTML_EMPTYrF ) r rG r r rO r+ rE rx r rP rQ ltags r) rl rl s
((C 99D
g~
kM$ //0 % %
h t,,-k ;mD)* &$7
#) &E
&z'7'7'9+9!; #aA *1 - !; "DA!!U++ FF!!U++ "66N / 2&)Q78 "
#J99;D22$K--. &$7 :%dSj3&' yy
mDII&' r( c UR 5 H nU " U5 M
UR ( a U " UR 5 g g rD )r rF )r rG parts r) r r s1
d yy
dii r( )r htmlrE c [ R " SU 5 ( a [ S5 e[ [ R 5 5 H u p#X!:X d X0:X d M [ U M U [ U' g)a\ 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 rL r5 r )r9 r8 rQ rP s r) r r sX
xx 6""BCC^))+, 8q{ q! - !N3r( r rs rdfwsdlxsxsidc)$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 P [ SU < S[ U 5 R < S35 e)Nzcannot serialize z (type ))r3 rw r" r s r) r6 r6 s!
+/d1D1DE
r( c SU ; a U R SS5 n SU ; a U R SS5 n SU ; a U R SS5 n U $ ! [ [ 4 a [ U 5 g f = f)N&&r <r >replacer3 r- r6 r s r) rJ rJ so ) $;<<W-D $;<<V,D $;<<V,D ~ & )"4() A A A*)A*c SU ; a U R SS5 n SU ; a U R SS5 n SU ; a U R SS5 n SU ; a U R SS5 n S U ; a U R S S
5 n S U ; a U R S S 5 n S
U ; a U R S
S5 n U $ ! [ [ 4 a [ U 5 g f = f)Nr r r r r r rH "
z
r z
z r r s r) rN rN s ) $;<<W-D $;<<V,D $;<<V,D 4<<<h/D 4<<<g.D 4<<<g.D 4<<<g.D ~ & )"4()s B)B, ,C
C
c SU ; a U R SS5 n SU ; a U R SS5 n SU ; a U R SS5 n U $ ! [ [ 4 a [ U 5 g f = f)Nr r r r rH r r r s r) rm rm / sm ) $;<<W-D $;<<V,D 4<<<h/D ~ & )"4()r T)r r
r c US:X a [ R " 5 O[ R " 5 n[ U 5 R XaUUUUS9 UR 5 $ )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 streams r) r r > sT ') 3R[[] F v/>1B&,4H J
?? r( c 6 \ rS rSrSrS rS rS rS rS r Sr
g )
_ListDataStreamiV z7An auxiliary stream accumulating into a list reference.c Xl g rD lst)r7 r s r) r9 _ListDataStream.__init__X s r( c gr r! r= s r) r* _ListDataStream.writable[ r( c gr r! r= s r) r+ _ListDataStream.seekable^ r r( c : U R R U5 g rD )r rh )r7 bs r) r _ListDataStream.writea s r( c , [ U R 5 $ rD )rK r r= s r) r, _ListDataStream.telld s 488} r( r N) r" r# r$ r% r& r9 r* r+ r r, r' r! r( r) r r V s A r( r c X / n[ U5 n[ U 5 R XqUUUUS9 U$ )Nr )r r r )r- r r r r
r r r s r) r r g sA
C
S
!F v/>1B&,4H J
Jr( c [ U [ 5 ( d [ U 5 n U R [ R SS9 U R 5 R nU( a US S:w a [ R R S5 gg)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)r1 r r sysstdoutr rF )rG rF s r) r r t se dK ( (4 JJszzIJ. <<> D 48t#
$r( c ^^^ [ U [ 5 ( a U R 5 n US: a [ SU 35 e[ U 5 ( d gSUT- - /mUUU4S jmT" U S5 g)a Indent an XML document by inserting newlines and indentation space
after elements.
*tree* is the ElementTree or Element to modify. The (root) element
itself will not be changed, but the tail text of all elements in its
subtree will be adapted.
*space* is the whitespace to insert for each indentation level, two
space characters by default.
*level* is the initial indentation level. Setting this to a higher
value than 0 can be used for indenting subtrees that are more deeply
nested inside of a document.
r z,Initial indentation level must be >= 0, got Nr c > US- n TU nU R ( a U R R 5 ( d X0l U HS n[ U5 ( a T" XB5 UR
( a! UR
R 5 ( a MM X4l MU WR
R 5 ( d TU Ul g g ! [ a TU T- nTR U5 Nf = fr@ )
IndexErrorrh rE striprK rF )rG level child_levelchild_indentationchild_indent_children indentationsspaces r) r indent.._indent_children s ai 3 ,[ 9
yy 1 1)IE5zz 4::UZZ%5%5%7%7 .
zz !!%e,EJ " 3 ,U 3e ; 1 2 3s C #C-,C-)r1 r r r rK )treer r r r s ` @@r) r r sg $ $$||~ qyGwOPP t99 55=()L-, T1 r( c < [ 5 nUR X5 U$ )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 r s r) r r s =DJJv Kr( c ^ ^^^^ [ XS9m[ T S5 ( d [ T S5 m SmOSmUUU 4S jnU" T 5 m " UUU 4S jS[ R R
5 nU" 5 nS Ul [ R " U5 m U$ )
a& 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_parserr r TFc 3 | ># TR 5 S h vN U R S5 nU( d OTR U5 MD TR 5 nTR 5 S h vN T" 5 nUb X#l T( a U R 5 g g N N/! T( a U R 5 f f = f7f)Ni @ ) read_eventsr r _close_and_return_rootrootr )r r r itr
pullparserwrs r) iteratoriterparse..iterator s %11333 {{9-%
446D!--/ / /B~ 4
0
s? B<B BAB -B .B B<B B B99B<c N > \ rS rSr YR rU UU4S jrU U4S jrSrg)$iterparse..IterParseIteratori c T > T( a TR 5 TR 5 g rD r )r7 r genr s r) r *iterparse..IterParseIterator.close s IIKr( c 6 > T( a TR 5 g g rD r )r7 r r s r) __del__,iterparse..IterParseIterator.__del__ s r( r! N)r" r# r$ r% __next__r r r' )r r r s r) IterParseIteratorr s <<
r( r N) r r, r collectionsabcIteratorr weakrefref)
r r r r r r r r r r s
` @@@@r) r
r
s $ f=J 66 " "fd# $ 6
C KOO 4 4
BBG R B
Ir( c D \ rS rSrS SS.S jjrS rS rS rS rS r S
r
g) r i N)r c [ R " 5 U l U=( d [ [ 5 S9U l Uc SnU R
R
U R U5 g )Nr )end)r deque
_events_queuer r r
_setevents)r7 r r s r) r9 XMLPullParser.__init__
sL
) . . 0 A);="A > F 2 2F;r( c U R c [ S5 eU( a U R R U5 gg! [ a% nU R R U5 SnAgSnAff = f) Feed encoded data to parser.Nz!feed() called after end of stream)r r r SyntaxErrorr rh )r7 r excs r) r XMLPullParser.feed s` << @A A
/ !!$'
/""))#..
/s >
A-A((A-c H U R R 5 nS U l U$ rD )r r )r7 r s r) r $XMLPullParser._close_and_return_root# s ||!!# r( c $ U R 5 g)zFinish feeding data to parser.
Unlike XMLParser, does not return the root element. Use
read_events() to consume elements from XMLPullParser.
N)r r= s r) r XMLPullParser.close) s
##%r( c # # U R nU( a5 UR 5 n[ U[ 5 ( a UeUv U( a M4 gg7f)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 popleftr1 Exception)r7 r events r) r XMLPullParser.read_events1 s? ##NN$E%++ fs AA
A c h U R c [ S5 eU R R 5 g )Nz"flush() called after end of stream)r r flushr= s r) r XMLPullParser.flush? s( << AB B r( )r r rD ) r" r# r$ r% r9 r r r r r r' r! r( r) r r s'
r( c U( d [ [ 5 S9nUR U 5 UR 5 n0 nUR 5 H! nUR S5 nU( d M XCU' M# X#4$ )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 r r )rE r r idsrG r< s r) r r V sb +-0
KK <<>D
C
XXd^
2G 9r( c U( d [ [ 5 S9nU H nUR U5 M UR 5 $ )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 )sequencer rE s r) r r n s5 +-0 D <<>r( c d \ rS rSrSrSSSSSS.S jjrS rS rS rS
r S r
S r SS
jr S r
Srg)r i a 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 / U l / U l S U l S U l S U l Uc [
nX l X@l Uc [ nX0l XPl
Uc [ nXl g rD )
_data_elem_lastr _tailr _comment_factoryr r _pi_factoryr r _factory)r7 element_factoryr r r r s r) r9 TreeBuilder.__init__ sd
" %O / . .J%$ " %O'
r( c U R $ )z;Flush builder buffers and return toplevel document Element.r r= s r) r TreeBuilder.close s zzr( c U R ( ab U R bM SR U R 5 nU R ( a XR l OXR l / U l g g Nr1 )r r joinr rF rE r7 rE s r) _flushTreeBuilder._flush sL ::zz%wwtzz*::&*JJO '+JJODJ r( c : U R R U5 g)z Add text to current element.N)r rh r7 r s r) r TreeBuilder.data s
$ r( c U R 5 U R X5 =U l nU R ( a U R S R U5 OU R
c X0l U R R U5 SU l U$ )znOpen new element and return it.
*tag* is the element name, *attrs* is a dict containing element
attributes.
r r )r r r r rh r r )r7 r+ attrsrG s r) startTreeBuilder.start sl
MM# 55
T :: JJrN ! !$ '
ZZ
J
$
r( c U R 5 U R R 5 U l SU l U R $ )z?Close and return current Element.
*tag* is the element name.
r )r r popr r r s r) r TreeBuilder.end s2
ZZ^^%
zzr( c P U R U R U R U5 $ )zPCreate a comment using the comment_factory.
*text* is the text of the comment.
)_handle_singler r r s r) commentTreeBuilder.comment s*
"" ! !4#7#7? ?r( c P U R U R U R X5 $ )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 )r7 r rE s r) piTreeBuilder.pi s( "" doov= =r( c U" U6 nU( aL U R 5 X@l U R ( a U R S R U5 SU l U$ )Nr r )r r r rh r )r7 factoryrq argsrG s r) r TreeBuilder._handle_single sE ~ KKM Jzz
2%%d+DJ r( )
r r r r r r r r r r rD )r" r# r$ r% r& r9 r r r r r r r r r' r! r( r) r r sC &(!%$!&5((
" ?=r( r c j \ rS rSrSrSSS.S jrS rS rS rS r S
r
S r S r S
r
S rS rS rSrg)r i aM 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)r r c SSK Jn UR US5 nUc
[ 5 nU=U l U l U=U l U l UR U l 0 U l U R Ul [ US5 ( a U R Ul [ US5 ( a U R$ Ul [ US5 ( a U R( Ul [ US5 ( a U R, Ul [ US 5 ( a UR0 Ul [ US
5 ( a UR4 Ul [ US 5 ( a UR8 Ul S Ul S Ul S U l 0 U l! S
URD - U l# g ! [ a" SS Kn GN! [ a [ S5 ef = ff = f! [H a g f = f)Nr expatz7No module named expat; use SimpleXMLTreeBuilder insteadr r r start_nsend_nsr r r r zExpat %d.%d.%d)% xml.parsersr ImportErrorpyexpat ParserCreater r r r _targeterror_error_names_defaultDefaultHandlerExpandr, _startStartElementHandler_endEndElementHandler _start_nsStartNamespaceDeclHandler_end_nsEndNamespaceDeclHandlerr CharacterDataHandlerr CommentHandlerr ProcessingInstructionHandler buffer_textordered_attributes_doctypeentity version_infoversionr- )r7 r r r r s r) r9 XMLParser.__init__ s ) ##Hc2 > ]F%++ dl%++ dlkk &*mm# 67 # #)-F & 65 ! !'+yyF $ 6: & &/3~~F , 68 $ $-1\\F * 66 " "*0++F ' 69 % %$*NNF ! 64 28))F / $%!
+e.@.@@DLM
'
!M
N s/ F 7F;
F8F F44F8;
GGc B U R nUR nU GH nUS:X a SUl XTU R 4S jnXcl M* US:X a XTU R
4S jnXcl MI US:X a; [ U R S5 ( a XTU R 4S jnOXT4S jnXcl
M US
:X a; [ U R S 5 ( a XTU R 4S jnOXT4S
jnXcl M US:X a XTU 4S jnXcl
M US:X a XTU 4S jnXcl M [ SU- 5 e g )Nr r c " U" X$" X5 45 g rD r! )r+ attrib_inr rh r s r) handler%XMLParser._setevents..handler= s E5#89:r( r c " U" X" U 5 45 g rD r! )r+ r rh r s r) rA rB B s E3s8,-r( zstart-nsr c " U" X$" X5 45 g rD r! )r9 r8 r rh r s r) rA rB I s x'< =>r( c > U" X =( d SU=( d S445 g r r! )r9 r8 r rh s r) rA rB M s "ciR'@ ABr( zend-nsr! c " U" X" U 5 45 g rD r! )r9 r rh r! s r) rA rB S s vf~ 67r( c U" US 45 g rD r! )r9 r rh s r) rA rB W s t}-r( r c H U" XR R U 5 45 g rD )r r )rE r rh r7 s r) rA rB [ s E;;#6#6t#<=>r( r c H U" X$R R X5 45 g rD )r r ) pi_targetr r rh r7 s r) rA rB _ s E;;>>)#BCDr( zunknown event %r)r rh r8 r, r- r. r/ r, r r0 r1 r2 r3 r5 r6 r )r7 events_queueevents_to_reportr rh
event_namerA s r) r XMLParser._setevents1 s $$*JW$,-)2<"&++; .5*u$'1 $ . ,3(z)4;;
333=)- ? 4> C3:0x'4;;11.8'+||8 /9 .18.y((2 ?(/%t#3=!%E 7>3 !3j!@AAU +r( c x [ U5 nUR Ul UR UR 4Ul UerD )r codelinenooffsetposition)r7 r errs r) _raiseerrorXMLParser._raiseerrorf s0 :: ||U\\1 r( c ~ U R U nU$ ! [ a UnSU; a SU- nX R U' U$ f = f)Nr r )r) KeyError)r7 r names r) _fixnameXMLParser._fixnamel sS $;;s#D $Dd{Tz #KK $s %<<c ^ U R R U=( d SU=( d S5 $ r )r r r7 r9 r8 s r) r0 XMLParser._start_nsw s! {{##FLb#)<A??B
Bc z U R R 5 n U R R S5 U R R SS5 U R R U5 g ! U R a nU R U5 S nANBS nAff = f! U R R U5 f = f)NFr( )r GetReparseDeferralEnabledSetReparseDeferralEnabledrz r( rU )r7 was_enabledrP s r) r XMLParser.flush s kk;;= ? KK 1 1% 8 KK c5 )
KK 1 1+ > {{ Q
KK 1 1+ >s) 7A/ /B?BB BB B:) r9 r( r) r r& r: r r r< )r" r# r$ r% r& r9 r rU rZ r0 r2 r, r. r* r r r r' r! r( r) r r sN "& +Z3Bj =0
.34%l *"?r( r )out from_filec U c Uc [ S5 eSnUc [ R " 5 =pA[ [ UR
40 UD6S9nU b" UR
U 5 UR 5 O Ub [ X%S9 Ub UR 5 $ S$ )a 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 )xml_datar r optionssior s r) r r s I -UVV
C
{KKM!
.syy DG D
EF H
i' _3<<>6$6r( z ^\w+:\w+$c \ rS rSrSrSSSSSSSS.S jr\4S jrS rSS jr S
r
S R 4S jr S
r
S rSS jrS rS rS rSrg)r i 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 \ Xl / U l X l X0l U( a [ U5 OS U l U( a [ U5 OS U l X@l U( a [ U5 U l OS U l U( a [ U5 R U l
OS U l
S//U l / U l U( d6 U R R [ [ R! 5 5 5 U R R / 5 0 U l S/U l S U l SU l SU l SU l g )N)r| r Fr )_writer _with_comments _strip_textr _exclude_attrs
_exclude_tags_rewrite_prefixes_qname_aware_tags intersection_find_qname_aware_attrs_declared_ns_stack _ns_stackrh rL r5 r _prefix_map_preserve_space_pending_start
_root_seen
_root_done_ignored_depth) r7 r r r r r r r r s r) r9 C14NWriterTarget.__init__" s
+%4Ac- 0t2>S .D!1 %()9%:D "%)D " +./@+A+N+ND (+/D (
<$
# NN ! !$~';';'="> ? b! %w " r( c # T # U" U5 H nU( d M U S h vN M g N 7frD r! )r7 ns_stack _reversedr s r) _iter_namespaces!C14NWriterTarget._iter_namespacesG s% #H-Jz%%% .%s ((&
(c UR SS5 u p#U R U R 5 H u pEXR:X d M SU SU 3s $ [ SU SU S35 e)Nr3 r r r zPrefix z of QName "" is not declared in scope)splitr r r )r7
prefixed_namer9 rY r8 ps r) _resolve_prefix_name%C14NWriterTarget._resolve_prefix_nameL sf $**32 ++DNN;FC{C54&)) < 76(+m_D^_``r( c Uc% US S S:X a USS R SS5 OSU4u p#OUn[ 5 nU R U R 5 H4 u pVXR:X a Xd; a U( a U SU 3OUX24s $ UR U5 M6 U R
( am X R ; a U R U nO&S[ U R 5 3=o`R U' U R S R X&45 U SU 3X24$ U( d
SU; a X3U4$ U R U R 5 H= u pVXR:X d M U R S R X&45 U( a U SU 3OUX24s $ U( d X3U4$ [ SU S 35 e)
Nr r r r1 r3 ru r z Namespace "r ) r4 r r r addr r rK rh r r )r7 r7 r8 r+
prefixes_seenur9 s r) _qnameC14NWriterTarget._qnameS s ;38!93CuQRy''Q/"eHCC
..t/F/FGIAxF 7,2&3%(SEE f % H ! !&&& ))#.34S9I9I5J4K1LL))#. # #B ' . .} = XQse$c. .r .S= ..t~~>IAx''+22C=A,2&3%(SEE ?
S= ;se+EFGGr( c ^ U R ( d U R R U5 g g rD )r r rh r s r) r C14NWriterTarget.datax s" "" JJ d # #r( r1 c U" U R 5 nU R S S 2 U R ( a$ U R S ( d UR 5 nU R bF U R S so0l U( a [ U5 ( a UOS nU R " / UQUP76 Ub g U( a- U R ( a U R [ U5 5 g g g Nr )
r r r r r _looks_like_prefix_namer, r r _escape_cdata_c14n)r7
_join_textr r
qname_texts r) r C14NWriterTarget._flush| s $**% JJqM D$8$8$<::D C/r( c U R b< U( a5 UR 5 VVs0 s H u pVXPR ; d M XV_M nnnU1Ukn0 nUb& U R U5 =oU' UR U 5 U R bh U( aa U R U5 n
U
( aF U
H? n X+ n [ U 5 ( d M U R U 5 =oU ' UR U 5 MA OS n
OS n
U R n
[ US S9 Vs0 s H oU
" U5 _M
nnU( a6 U VVs/ s H u nnU( a SU- OSU4PM nnnUR 5 O/ nU( a] [ UR 5 5 H@ u pVU
b XZ; a Xh; a
XU S nX u nn nUR U( a UOU U45 MB UR S5 nU R R U( a US:H OU R S 5 U R nU" S X S - 5 U( a< U" S
R U VVs/ s H u pVS U S [ U5 S
3PM snn5 5 U" S5 Ub U" [ XU S 5 5 SU l U R" R / 5 g s snnf s snf s snnf s snnf )Nc & U R SS5 $ )Nr r )r )ru s r) r )C14NWriterTarget._start.. s !''#q/r( rE zxmlns:xmlnsr z+{http://www.w3.org/XML/1998/namespace}spacepreserver r r1 r rG rH r T)r r r r r r r rM sortrh r r r r _escape_attrib_c14nr r r )r7 r+ r r r rQ rP r resolved_namesr7 qattrs attr_namer parse_qnameru
parsed_qnamesr8 r9 rc
attr_qnamespace_behaviourr s r) r, C14NWriterTarget._start s *u&+kkmTmdaq@S@S7STQTmET !151J1J:1V VE:. JJu ' ' 311%8F!'I ! ,E.u558<8Q8QRW8XXu 5
5) "( F kk 4: 153 4 53qKN* 53
4 $2#1KC '-F"'3?#1
NN I u{{}-%!+!:M%Q&78;A-:-=*
Is *A!FG . ))$QR ##-)r r r r r r r r r s r) r C14NWriterTarget.comment sw "" ?? KK
__ KKM d-d34C89 KK r( c t U R ( a g U R ( a U R S5 O2U R ( a! U R ( a U R 5 U R U( a SU S[
U5 S3OSU S35 U R ( d U R S5 g g )Nr z)r r r r r r r )r7 r r s r) r C14NWriterTarget.pi s ?? KK
__ KKM :>b,T232 6bPRO U KK r( )r r r r r r r r r r r r r r r r r rD )r" r# r$ r% r& r9 reversedr r r r r r r r r, r r r r' r! r( r) r r sj 2 %"&$ #$# J 4< &
a#HJ$ !# 2 10"C"J
r( r c
SU ; a U R SS5 n SU ; a U R SS5 n SU ; a U R SS5 n SU ; a U R SS5 n U $ ! [ [ 4 a [ U 5 g f = f) Nr r r r r r r
r r s r) r r s ) $;<<W-D $;<<V,D $;<<V,D 4<<<g.D ~ & )"4()s A!A$ $BBc j SU ; a U R SS5 n SU ; a U R SS5 n SU ; a U R SS5 n SU ; a U R SS5 n S U ; a U R S S
5 n S U ; a U R S S 5 n U $ ! [ [ 4 a [ U 5 g f = f)
Nr r r r rH r r z r z
r r r r s r) r r ! s ) $;<<W-D $;<<V,D $;<<X.D 4<<<g.D 4<<<g.D 4<<<g.D ~ & )"4()s BB B21B2)r )_set_factoriesrD r )z r )Ar& __all__r r ru rR r$ r collections.abcr" r r1 r r r r r r r r r
r r contextmanagerr r rK rn ro rl r r r r5 r6 rJ rN rm r r% r r r r r r
r r r r r r r r compileUNICODErv r r r r rv _elementtreer r# r! r( r) r s !P (
#
b bJ $& $ +" +"`h/ h/Z /+ /+b; z0(d4 +
0(d
!* -2$*38(.(,16(, %3 !
) )8 ) !T"& 0 b'' "
!%&*
&/ l =@7 7 t",
$v vth? h?Z 7tt 7> **\2::>DD B B J)&). 3 K + 7 12 s )
F F F