+ NV-jCRt^RIHt^RIt^RIt^RIHtHtHt^RI H t ^RI H t ^RI Ht^RIHt^RIHt^R IHt]'d^R IHtHtHtHtHt^R IHt!R R 4t!RR]4t!RR]4tR#)zF :mod:`pandas.io.formats.xml` is a module for formatting data in XML. ) annotationsN) TYPE_CHECKINGAnyfinalAbstractMethodError)cache_readonly) is_list_like)isna) get_handle)get_data_from_filepath)CompressionOptionsFilePath ReadBufferStorageOptions WriteBuffer) DataFramec]tRt^$tRtRRRlltRRlt]RRl4t]R R l4t ]R R l4t ]R Rl4t RRlt ]RRl4t ]RRl4t]RRl4t]R4t]RRl4t]RRl4tRtR#)_BaseXMLFormattera Subclass for formatting data in XML. Parameters ---------- path_or_buffer : str or file-like This can be either a string of raw XML, a valid URL, file or file-like object. index : bool Whether to include index in xml document. row_name : str Name for root of xml document. Default is 'data'. root_name : str Name for row elements of xml document. Default is 'row'. na_rep : str Missing data representation. attrs_cols : list List of columns to write as attributes in row element. elem_cols : list List of columns to write as children in row element. namespaces : dict The namespaces to define in XML document as dicts with key being namespace and value the URI. prefix : str The prefix for each element in XML document including root. encoding : str Encoding of xml object or document. xml_declaration : bool Whether to include xml declaration at top line item in xml. pretty_print : bool Whether to write xml document with line breaks and indentation. stylesheet : str or file-like A URL, file, file-like object, or a raw string containing XSLT. compression : str or dict, default 'infer' For on-the-fly compression of the output data. If 'infer' and 'path_or_buffer' is path-like, then detect compression from the following extensions: '.gz', '.bz2', '.zip', '.xz', '.zst', '.tar', '.tar.gz', '.tar.xz' or '.tar.bz2' (otherwise no compression). Set to ``None`` for no compression. Can also be a dict with key ``'method'`` set to one of {``'zip'``, ``'gzip'``, ``'bz2'``, ``'zstd'``, ``'xz'``, ``'tar'``} and other key-value pairs are forwarded to ``zipfile.ZipFile``, ``gzip.GzipFile``, ``bz2.BZ2File``, ``zstandard.ZstdCompressor``, ``lzma.LZMAFile`` or ``tarfile.TarFile``, respectively. As an example, the following could be passed for faster compression and to create a reproducible gzip archive: ``compression={'method': 'gzip', 'compresslevel': 1, 'mtime': 1}``. storage_options : dict, optional Extra options that make sense for a particular storage connection, e.g. host, port, username, password, etc. For HTTP(S) URLs the key-value pairs are forwarded to ``urllib.request.Request`` as header options. For other URLs (e.g. starting with "s3://", and "gcs://") the key-value pairs are forwarded to ``fsspec.open``. Please see ``fsspec`` and ``urllib`` for more details, and for more examples on storage options refer `here `_. See also -------- pandas.io.formats.xml.EtreeXMLFormatter pandas.io.formats.xml.LxmlXMLFormatter Nc"\V^8dQhRRRRRRRRR RR RR R R R RRRRRRRRRRRRRRRRRR/#)framerpath_or_bufferz7FilePath | WriteBuffer[bytes] | WriteBuffer[str] | Noneindexbool root_name str | Nonerow_namena_rep attr_colszlist[str] | None elem_cols namespaceszdict[str | None, str] | Noneprefixencodingstrxml_declarationz bool | None pretty_print stylesheetz5FilePath | ReadBuffer[str] | ReadBuffer[bytes] | None compressionr storage_optionszStorageOptions | NonereturnNone)formats"f/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/pandas/io/formats/xml.py __annotate___BaseXMLFormatter.__annotate__ts***P* *  *  **$*$*1***%*"*J* (!*"/#*$ %*c WnW nW0nW@nWPnW`nWpnWnWnWn Wn Wn Wn Wn WnVVnVPP P#4VnVP'4VnVP+4VP-4VP/4VnVP34R#N)rrrrrrrr r!r"r#r%r&r'r(r)columnstolist orig_cols_process_dataframe frame_dicts_validate_columns_validate_encoding_get_prefix_uri prefix_uri_handle_indexes)selfrrrrrrrr r!r"r#r%r&r'r(r)s&&&&&&&&&&&&&&&&&r.__init___BaseXMLFormatter.__init__ts& , "  ""$  .($/:.++224224   !..0 r1cV^8dQhRR/#rr*bytesr,)r-s"r.r/r0s((U(r1c \V4h)w Build tree from data. This method initializes the root and builds attributes and elements with optional namespaces. rr>s&r. _build_tree_BaseXMLFormatter._build_trees"$''r1cV^8dQhRR/#rr*r+r,)r-s"r.r/r0s4r1c jVP'dG\VP4'g,\\VP4P R24hVP 'dI\VP 4'g,\\VP 4P R24hR#R#)z Validate elems_cols and attrs_cols. This method will check if columns is list-like. Raises ------ ValueError * If value is not a list and less then length of nodes. z" is not a valid type for attr_colsz" is not a valid type for elem_colsN)rr TypeErrortype__name__r rFs&r.r9#_BaseXMLFormatter._validate_columnss >>>,t~~">">'0011ST  >>>,t~~">">'0011ST #?>r1cV^8dQhRR/#rJr,)r-s"r.r/r0s % %D %r1c F\P!VP4R#)z Validate encoding. This method will check if encoding is among listed under codecs. Raises ------ LookupError * If encoding is not available in codecs. N)codecslookupr#rFs&r.r:$_BaseXMLFormatter._validate_encodings  dmm$r1cV^8dQhRR/#)rr*zdict[int | str, dict[str, Any]]r,)r-s"r.r/r0s**$C*r1c VPpVP'dVP4pVPeVP VP4pVP RR7#)z Adjust Data Frame to fit xml output. This method will adjust underlying data frame for xml output, including optionally replacing missing values and including indexes. r)orient)rr reset_indexrfillnato_dict)r>dfs& r.r7$_BaseXMLFormatter._process_dataframesOZZ :::!B ;; "4;;'Bzzz))r1cV^8dQhRR/#rJr,)r-s"r.r/r0s666r1c VP'gR#\\VP44pVPV,P 4Uu.uFq"VP 9gKVNK ppVP 'dW0P ,VnVP'dW0P,VnR#R#uupi)zL Handle indexes. This method will add indexes into attr_cols or elem_cols. N)rnextiterr8keysr6rr )r> first_keyxindexess& r.r=!_BaseXMLFormatter._handle_indexesszzz d../0 '' 2779 9!dnn=TAA9   >>>$~~5DN >>>$~~5DN  s C -C cV^8dQhRR/#rr*r$r,)r-s"r.r/r0s ( ( (r1c \V4h)z Get uri of namespace prefix. This method retrieves corresponding URI to prefix in namespaces. Raises ------ KeyError *If prefix is not included in namespace dict. rrFs&r.r;!_BaseXMLFormatter._get_prefix_uris"$''r1cV^8dQhRR/#)rr*dictr,)r-s"r.r/r0s4r1c /pVP'dSVPP4UUu/uF,wr#W0P^R8wgKRVR8XdTMRV 2 2VbK. pppV#uuppi)z Define other namespaces. This method will build dictionary of namespaces attributes for root element, conditionally with optional namespaces and prefix. xmlns:)r!itemsr<)r> nmsp_dictpns& r._other_namespaces#_BaseXMLFormatter._other_namespacess~%' ???!OO1133DA"--7%Q"WAaS'23Q63   s A)A)c$V^8dQhRRRRRR/#)rddict[str, Any]elem_rowrr*r,)r-s"r.r/r0s!##r1c *VP'gV#VPFLpVPV4p\W,4'g!\W,4VPV&KLKN V# \ dp\ RT 24ThRp?ii;i)z Create attributes of row. This method adds attributes using attr_cols to row element and works with tuples for multindex or hierarchical columns. no valid column, N)r_get_flat_col_namer r$attribKeyError)r>rxrzcol attr_nameerrs&&& r._build_attribs _BaseXMLFormatter._build_attribss~~~O>>C//4I CAF||14QVHOOI.$" C!23%89sB Cs5A33 B>B  Bc V^8dQhRRRR/#)rrz str | tupler*r$r,)r-s"r.r/r0/s..k.c.r1c TTp\V\4'dxRV9d9RPVUu.uFp\V4NK up4P 4M7RPVUu.uFp\V4NK up4P 4pVP V 2#uupiuupi)rn_) isinstancetuplejoinr$stripr<)r>rflat_colcs&& r.r}$_BaseXMLFormatter._get_flat_col_name.s c5 ! !9-AQ-.446XXs3s!s1vs34::<  //"8*-- .3s B 'B%c \V4hr3rrFs&r._sub_element_cls"_BaseXMLFormatter._sub_element_cls9s !$''r1c$V^8dQhRRRRRR/#)rrxryrzrr*r+r,)r-s"r.r/r0>s&CCnCCCr1c ZVPpVP'gR#VPFXpVPV4p\W,4'gW,R8XdRM\ W,4pWc!W%4nKZ R# \ dp\ RT 24ThRp?ii;i)z Create child elements of row. This method adds child elements using elem_cols to row element and works with tuples for multindex or hierarchical columns. Nrnr|)rr r}r r$textr)r>rxrzsub_element_clsr elem_namevalrs&&& r. _build_elems_BaseXMLFormatter._build_elems=s//~~~ >>C//4I C"16llafldAF xml_dochandless& r. write_output_BaseXMLFormatter.write_outputRs""$    *## ,, $ 4 4  $$W->>$--0779 9s B$$ B5 )rr(r r#rr8rrr!r6rr"r<r&rrr)r'r%)NTdatarowNNNNNzutf-8TTNinferN)rN __module__ __qualname____firstlineno____doc__r?rGrr9r:r7r=r;rurr}rrrr__static_attributes__r,r1r.rr$sM^*X(  *  %  % * *$ 6 6* (  &  ( . .(( C C( : :r1rcN]tRtRtRtRRltRRlt]R4tRR lt R t R #) EtreeXMLFormatteriex Class for formatting data in xml using Python standard library modules: `xml.etree.ElementTree` and `xml.dom.minidom`. cV^8dQhRR/#rBr,)r-s"r.r/EtreeXMLFormatter.__annotate__k%%U%r1c ^RIHpHpHpV!VP VP 2VP 4R7VnVPP4FpV!VPVP VP 24pVP'gDVP'g2\VP44Vn VPWE4KVP!WE4pVPWE4K V!VPRVP"VP$R7VnVP('dVP+4VnVP,e \/R4hVP&#)Element SubElementtostring)r~xml)methodr#r%zBTo use stylesheet, you need lxml installed and selected as parser.)xml.etree.ElementTreerrrr<rrurootr8valuesrrr listrarrr#r%out_xmlr&_prettify_treer' ValueErrorr>rrrrxrzs& r.rGEtreeXMLFormatter._build_treeks4  / 09O9O9Q  !!((*A!$))/@-PQH>>>$...!%affh!!!. ..q;!!!.+ II]] 00       ..0DL ?? &T ||r1cV^8dQhRR/#rgr,)r-s"r.r/rsr1c ^RIHpRpVP'dVPP4F=wr4\ V\ 4'gK\ V\ 4'gK5V!W44K? VP 'd%RVPVP , R2pV#RVP9dRVPR, R2pV#RpV# \dp\TP R24ThRp?ii;i)r)register_namespacern{} is not included in namespacesN)rrr!rqrr$r"r)r>rurirsrtrs& r.r;!EtreeXMLFormatter._get_prefix_uris< ???--/a%%*Q*<*<&q,0{{{tt{{;>Dc ^RIHpV#r)r)rrr>rs& r.r"EtreeXMLFormatter._sub_element_clss 4r1cV^8dQhRR/#rBr,)r-s"r.r/rs D D Dr1c l^RIHpV!VP4pVPRVPR7#)zk Output tree for pretty print format. This method will pretty print xml with line breaks and indentation. ) parseStringz )indentr#)xml.dom.minidomrr toprettyxmlr#)r>rdoms& r.r EtreeXMLFormatter._prettify_trees, 0$,,'dT]]CCr1r rrN) rNrrrrrGr;rrrrr,r1r.rres2 %N, D Dr1rcra]tRtRtRtRV3RlltRRltRRltR R lt] R 4t R R lt Rt V;t #)LxmlXMLFormatterircV^8dQhRR/#rJr,)r-s"r.r/LxmlXMLFormatter.__annotate__s&&4&r1c H<\SV`!V/VBVP4R#r3)superr?_convert_empty_str_key)r>argskwargs __class__s&*,r.r?LxmlXMLFormatter.__init__s! $)&) ##%r1cV^8dQhRR/#rBr,)r-s"r.r/rrr1c ^RIHpHpHpV!VP VP 2VP R7VnVPP4FpV!VPVP VP 24pVP'gDVP'g2\VP44Vn VPWE4KVP!WE4pVPWE4K V!VPVP"RVP$VP&R7VnVP*eVP-4VnVP(#)rEr)nsmapr)r&rr#r%) lxml.etreerrrr<rr!rr8rrrr rrarrr&r#r%rr'_transform_docrs& r.rGLxmlXMLFormatter._build_trees  t//?@X !!((*A!$))/@-PQH>>>$...!%affh!!!. ..q;!!!.+ II**]] 00    ?? &..0DL||r1cV^8dQhRR/#rJr,)r-s"r.r/rs G G Gr1c VP'dMRVPP49d,VPPRR4VPR&R#R#R#)z Replace zero-length string in `namespaces`. This method will replace '' with None to align to `lxml` requirement that empty string prefixes are not allowed. rndefaultN)r!rapoprFs&r.r'LxmlXMLFormatter._convert_empty_str_keysG ???rT__%9%9%;;$(OO$7$7I$FDOOD ! rrs& r.r; LxmlXMLFormatter._get_prefix_uris ???{{{tt{{;rrrr style_doc handle_dataxml_data curr_parserxsl_doc transformernew_docs & r.rLxmlXMLFormatter._transform_docs  OO $$$,(]](( 00  [H#T]];K(BKK00$%%'..t}}=k =7m dii(W~[s A/C22 D r)rNrrrrr?rGrr;rrrr __classcell__)rs@r.rrsA && %N G" &&r1r) r __future__rrRrtypingrrr pandas.errorsrpandas.util._decoratorsrpandas.core.dtypes.commonr pandas.core.dtypes.missingr pandas.io.commonr pandas.io.xmlr pandas._typingr rrrrpandasrrrrr,r1r.rss#  .22+'0!~:~:B TD)TDnz(zr1