mhWdZddlmZddlmZmZddlmZddlm Z ddl m Z Gdde Z Gd d Zd ed d dd fdZdZdZdZd"dZ d#dZGddeZ d$dZedkrqdd lZdd lZejjZejjZejdd \ZeeZd Z eeee e!!Z"edkre ge"d Sd S#e#$rYd SwxYwd S)%z:Makes working with XML feel like you are working with JSON)expat) XMLGeneratorescape)AttributesImpl)StringIO) isgeneratorceZdZdS)ParsingInterruptedN)__name__ __module__ __qualname__4/usr/local/lib/python3.11/site-packages/xmltodict.pyr r sDrr cpeZdZddddddddedd ddd fd Zd Zd ZdZdZdZ dZ dZ dZ dZ dZdS)_DictSAXHandlerrcdSNTr)argss rz_DictSAXHandler.sDrT@#textFN:#commentc g|_g|_g|_d|_||_||_||_||_||_||_ ||_ ||_ | |_ | |_ | |_| |_| |_| |_||_dSN)pathstackdataitem item_depth xml_attribs item_callback attr_prefix cdata_key force_cdatacdata_separator postprocessordict_constructorstrip_whitespacenamespace_separator namespacesnamespace_declarations force_list comment_key)selfr"r$r#r%r&r'r(r)r*r+r,r-r/r0s r__init__z_DictSAXHandler.__init__s"    $&*&"&.* 0 0#6 $&6&6&8&8#$&rc|j|S||j}|dkr|S|d|||dzd}} |j|}n#t$r|}YnwxYw|s|S|j||fS)N)r-rfindr,KeyErrorjoin)r1 full_namei namespacenameshort_namespaces r _build_namez_DictSAXHandler._build_name4s ? "  OOD4 5 5 77 #BQB-1Q3444  ("oi8OO ( ( ('OOO ( JK+00/41HII Is A A! A!c t|tr|S|t|ddd|dddS)Nrr5) isinstancedictr*zip)r1attrss r_attrs_to_dictz_DictSAXHandler._attrs_to_dictDsK eT " " L$$Sqt!teADqDk%B%BCCCrc||j|pd<dS)Nr)r.)r1prefixuris rstartNamespaceDeclz"_DictSAXHandler.startNamespaceDeclIs47#FLb111rc||}||}|jr9|s|}|j|d<||_|j||pdft |j|jkr|j|j |j f|j rg}| D]a\}}|j ||z}|jr||j||}n||f}|r||b||}nd}|pd|_ g|_ dSdS)Nxmlns)r>rEr.r*rappendlenr"rr!r r#itemsr%r))r1r9rDr< attr_entrieskeyvalueentrys r startElementz_DictSAXHandler.startElementLs **##E**  & B 0--//!8E'N*.*?*?*A*AD ' $ ./// ty>>T_ , , J  ty$)4 5 5 5 ! "'++--33JC*4+;+;C+@+@@C)- $ 2 249c5 I I!$e 3$++E222--l;; DIDIII! - ,rc,||}t|j|jkr|j}|(|jsdn|j|j}||j|}|st|j r'|j \|_|_nd|_g|_|j dS|j r|jsdn|j|j}|j}|j \|_|_|j r|r| pd}|r,|||r||}|@|r|||j|||j|||_n0||j|||_nd|_g|_|j dSr)r>rMrr"r!r r(r8r$r rpopr+strip_should_force_cdatar* push_datar&)r1r9r<r!should_continuer s r endElementz_DictSAXHandler.endElementgs ** ty>>T_ , ,9D|$(IB!166tyAA#00DAAO" )((z '+z~~'7'7$ 499   IMMOOO F :  $ >DD-2249== 9D#':>>#3#3 DIty$ , ,zz||+t /00t<< /,,..?NN4>>> NN49dDAA  NN49dDAA DIDI rc\|js |g|_dS|j|dSr)r rLr1r s r charactersz_DictSAXHandler.characterss5y #DIII I  T " " " " "rc|jr|}||j|j||_dSr)r+rVrXr!r0r\s rcommentsz_DictSAXHandler.commentss:   ::<EE rcf|j%||j||}||S|\}}||} ||}t|tr||n||g||<n2#t $r%|||r|g||<n|||<YnwxYw|Sr)r)rr*rAlistrLr7_should_force_list)r1r!rPr resultrQs rrXz_DictSAXHandler.push_datas   )'' 3==F~ IC <((**D !IE%&& * T"""""DMS  ! ! !&&sD11 !!FS  S  !  s:A??,B.-B.c|jsdSt|jtr|jS ||jvS#t$r'||jdd||cYSwxYwNFr4)r/rAbool TypeErrorrr1rPrQs rrbz"_DictSAXHandler._should_force_lists 5 dot , , #? " ?$/) ) ? ? ???49SbS>3>> > > > ?5.A&%A&c|jsdSt|jtr|jS ||jvS#t$r'||jdd||cYSwxYwre)r'rArfrgrrhs rrWz#_DictSAXHandler._should_force_cdatas 5 d& - - $# # @$** * @ @ @##DIcrcNC?? ? ? ? @ri)r r r rBr2r>rErIrSrZr]r_rXrbrWrrrrrs((#'#'#'#'JJJJ DDD 8886)))V### FFF *???@@@@@rrNFrTc \td d|i|}t|tr|pd}||}|sd}|j||} d| _|j| _|j| _ |j | _ |j | _ |r |j| _d| _|r d} | | _t%|dr| |nWt)|r2|D]} | | d| ddn| |d|jS) aParse the given XML input and convert it into a dictionary. `xml_input` can either be a `string`, a file-like object, or a generator of strings. If `xml_attribs` is `True`, element attributes are put in the dictionary among regular child elements, using `@` as a prefix to avoid collisions. If set to `False`, they are just ignored. Simple example:: >>> import xmltodict >>> doc = xmltodict.parse(""" ... ... 1 ... 2 ... ... """) >>> doc['a']['@prop'] 'x' >>> doc['a']['b'] ['1', '2'] If `item_depth` is `0`, the function returns a dictionary for the root element (default behavior). Otherwise, it calls `item_callback` every time an item at the specified depth is found and returns `None` in the end (streaming mode). The callback function receives two parameters: the `path` from the document root to the item (name-attribs pairs), and the `item` (dict). If the callback's return value is false-ish, parsing will be stopped with the :class:`ParsingInterrupted` exception. Streaming example:: >>> def handle(path, item): ... print('path:%s item:%s' % (path, item)) ... return True ... >>> xmltodict.parse(""" ... ... 1 ... 2 ... """, item_depth=2, item_callback=handle) path:[('a', {'prop': 'x'}), ('b', None)] item:1 path:[('a', {'prop': 'x'}), ('b', None)] item:2 The optional argument `postprocessor` is a function that takes `path`, `key` and `value` as positional arguments and returns a new `(key, value)` pair where both `key` and `value` may have changed. Usage example:: >>> def postprocessor(path, key, value): ... try: ... return key + ':int', int(value) ... except (ValueError, TypeError): ... return key, value >>> xmltodict.parse('12x', ... postprocessor=postprocessor) {'a': {'b:int': [1, 2], 'b': 'x'}} You can pass an alternate version of `expat` (such as `defusedexpat`) by using the `expat` parameter. E.g: >>> import defusedexpat >>> xmltodict.parse('hello', expat=defusedexpat.pyexpat) {'a': 'hello'} You can use the force_list argument to force lists to be created even when there is only a single child of a given level of hierarchy. The force_list argument is a tuple of keys. If the key for a given level of hierarchy is in the force_list argument, that level of hierarchy will have a list as a child (even if there is only one sub-element). The index_keys operation takes precedence over this. This is applied after any user-supplied postprocessor has already run. For example, given this input: host1 Linux em0 10.0.0.1 If called with force_list=('interface',), it will produce this dictionary: {'servers': {'server': {'name': 'host1', 'os': 'Linux'}, 'interfaces': {'interface': [ {'name': 'em0', 'ip_address': '10.0.0.1' } ] } } } `force_list` can also be a callable that receives `path`, `key` and `value`. This is helpful in cases where the logic that decides whether a list should be forced is more complex. If `process_comments` is `True`, comments will be added using `comment_key` (default=`'#comment'`) to the tag that contains the comment. For example, given this input: 1 2 If called with `process_comments=True`, it will produce this dictionary: 'a': { 'b': { '#comment': 'b comment', 'c': { '#comment': 'c comment', '#text': '1', }, 'd': '2', }, } Comment text is subject to the `strip_whitespace` flag: when it is left at the default `True`, comments will have leading and trailing whitespace removed. Disable `strip_whitespace` to keep comment indentation or padding intact. r,utf-8NTc td)Nzentities are disabled) ValueError)_args_kwargss r_forbid_entitieszparse.._forbid_entitieses455 5rreadFrr)rrAstrencode ParserCreateordered_attributesrIStartNamespaceDeclHandlerrSStartElementHandlerrZEndElementHandlerr]CharacterDataHandlerr_CommentHandler buffer_textEntityDeclHandlerhasattr ParseFilerParser!) xml_inputencodingrprocess_namespacesr,disable_entitiesprocess_commentskwargshandlerparserrqchunks rparsersT((2E( &((G)S!!/&w$$X.. #" U F!%F'.'AF$!(!5F&1F")"4F1 ' 0F4 6 6 6$4 y&!!&#### Y  & ' 'E LL & & & & S$ Y%%% <rct|ttfr|St|tr|rdndSt|S)zConvert a value to its string representation for XML output. Handles boolean values consistently by converting them to lowercase. truefalse)rArsbytesrf)rQs r_convert_value_to_stringrtsL %#u&& %,+vvG+ u::rct|tst|d|ds|drtd|dd|vsd|vrtd|dd |vrtd|d d |vsd |vrtd|d d|vrtd|dt d|Drtd|ddS)zValidate an element/attribute name for XML safety. Raises ValueError with a specific reason when invalid. kind: 'element' or 'attribute' (used in error messages) z name must be a string?!zInvalid z# name: cannot start with "?" or "!"<>z name: "<" or ">" not allowed/z name: "/" not allowed"'z name: quotes not allowed=z name: "=" not allowedc3>K|]}|VdSr)isspace).0chs r z!_validate_name..s* ( (B2::<< ( ( ( ( ( (rz name: whitespace not allowedN)rArsrn startswithany)rQkinds r_validate_namer~sV eS ! !:D888999 O 0 0 5 5OMDMMMNNN e||se||GDGGGHHH e||@D@@@AAA e||se||CDCCCDDD e||@D@@@AAA ( (% ( ( (((IGDGGGHHHIIrcXt|tr9 |d}n"#t$r}t d|d}~wwxYwt|t st dd|vrt d|drt d|S)Nrlz Comment text must be valid UTF-8zComment text must be a stringz--z Comment text cannot contain '--'-z Comment text cannot end with '-')rArdecodeUnicodeDecodeErrorrnrsendswith)rQexcs r_validate_commentrs%J JLL))EE! J J J?@@c I J eS ! !:8999 u}};<<< ~~c=;<<< Ls- A AA rcHt|ts|S|s|S ||d\}}|||}|r/d||r|nd|||n|}n#t$rYnwxYw|S)Nr5z{}{}{}{}r)rArsrsplitgetrVformatrrn)r<r-ns_sepr%nsns_ress r_process_namespacers dC   6;;vq))D 5 566&,6z  ==55 =KK2 FD"""15        KsB BBr  rc&t|tr||krt|tr|n|g}t| trd| z} |D]]}|t |}|s|r||| z|||r||^dSt|| | |}||||}|dS|\}}t|dt|drt|ttfr|g}t|D]\}}| r|dkr|dkrtd|i}nBt|ttfs&| rt|dr| |i}nt |}t|tr||i}d}i}g}| D]N\}}||krt |}t|tr||rt|| | |}|dkrnt|trY| D]C\}}t|dd|rd |nd }t|||<Dt|tst|}|t!|d}t|d|||<t|tr|s7|||fPt| trd| z} |r||| z||t'||r|r|||D]%\}}t)||||||d z|||| | | | | &||||r|r||| z|||r|r||dS) N element__iter__rzdocument with multiple rootsz@xmlns attributezxmlns{}rrr5)r-r, expand_iterr0)rArsraintrignorableWhitespacecommentrrr~rB enumeraternrNrrrMrLrSr_emitr]rZ)rPrQcontent_handlerr%r&depth preprocessorprettynewlindentr,r- full_documentrr0 comments_list comment_textrcindexvcdatarDchildrenikivkattr attr_name child_key child_values rrrs#s{ 2 2!+E4!8!8Eug fc " " "6\F) : :L#3LAAL  D33EFNCCC  # #L 1 1 1 :33D999 S*.A; O OCc5)) > F U3 """ 5* % %EC;)G)Ge$$8686q  =UaZZEAII;<< < 9AAAc{++ 0 0wq*55 0 !$,Q// a   AAggii & &FBY044"c"" r}}['A'A 'J8K(355>>jT&:&:> " --1&q+666(//10DA"EE&)!ffd !"c**!RBs;//112 y+666#%i "d## B  OORH % % % % fc " " "6\F  @  / / ? ? ?$$S.*?*?@@@  6h 6  / / 5 5 5&. D D "I{ )[/y%'<$:&9){  D D D D D    & &u - - -  @h @  / / ? ? ?""3'''  6e 6  / / 5 5 5q8686rceZdZdZdS) _XMLGeneratorcpt|}|dt|ddS)Nz)r_writer)r1texts rrz_XMLGenerator.comments9 && ,6$<<,,,-----rN)r r r rrrrrrs#.....rrrlc d}|t}d}|rt||d}nt||}|r|d} |D]8\} } | |kr|r| rt dt | | |f||d|| |krd} 9|r| st d|r||r=|} | |} n#t$rYnwxYw| SdS)aFEmit an XML document for the given `input_dict` (reverse of `parse`). The resulting XML document is returned as a string, but if `output` (a file-like object) is specified, it is written there instead. Dictionary keys prefixed with `attr_prefix` (default=`'@'`) are interpreted as XML node attributes, whereas keys equal to `cdata_key` (default=`'#text'`) are treated as character data. Empty lists are omitted entirely: ``{"a": []}`` produces no ```` element. Provide a placeholder entry (for example ``{"a": [""]}``) when an explicit empty container element must be emitted. The `pretty` parameter (default=`False`) enables pretty-printing. In this mode, lines are terminated with `' '` and indented with `' '`, but this can be customized with the `newl` and `indent` parameters. FNTz$Document must have exactly one root.)rr0) rr startDocumentrNrnr endDocumentgetvaluerAttributeError) input_dictoutputrrshort_empty_elementsr0r must_returnr seen_rootrPrQs runparserst*K ~ :'$??'99(%%'''I &&(( U +  - I CDD D c5/jT_jjcijjj +  IAYA?@@@&##%%%!! LL**EE    D  sC44 DD__main__r5c>tj||ftdSr)marshaldumpstdout)rr!s r handle_itemr[s dD\6***tr)r"r$r*)rr) rrrNFrrrNTNr)NrlTFr)$__doc__ xml.parsersrxml.sax.saxutilsrrxml.sax.xmlreaderriorinspectr Exceptionr rrrrrrrrrr rsysstdinbufferrargvr"rrrBrootKeyboardInterruptrrrrs<<11111111,,,,,,        v@v@v@v@v@v@v@v@r#%E!D5jjjjZ   III.   $! `6`6`6`6F.....L... FJ4>0000f zNNNJJJ I E Z FHQRRLMZZJ uU *#.&*,,, ?? KD ! ! ! ! ! ?      +s?!C$$C-,C-