A>iCSrSSKJr SSKrSSKrSSKJrJrJr SSK J r SSK J r SSK Jr SSKJr SS KJr SS KJr \(aSS KJrJrJrJrJr SS KJr "S S5r"SS\5r"SS\5rg)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^\rSrSrSrSSSjjrSSjr\SSj5r\SSj5r \SSj5r \SS j5r SS jr \SS j5r \SS j5r\SS j5r\S5r\SSj5r\SSj5rSrg)_BaseXMLFormatter$a 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 NcXlX lX0lX@lXPlX`lXplXlXlXl Xl Xl Xl Xl XlUUlURR R#5UlUR'5UlUR+5 UR-5 UR/5UlUR35 gN)framepath_or_bufferindex root_namerow_namena_rep attr_cols elem_cols namespacesprefixencodingxml_declaration pretty_print stylesheet compressionstorage_optionscolumnstolist 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 T/var/www/html/land-tabula/venv/lib/python3.13/site-packages/pandas/io/formats/xml.py__init___BaseXMLFormatter.__init__ts& , "  ""$  .($/:.++224224   !..0 c[U5e)w Build tree from data. This method initializes the root and builds attributes and elements with optional namespaces. rr3s r4 _build_tree_BaseXMLFormatter._build_trees"$''r7c^UR(aE[UR5(d+[[UR5RS35eUR (aF[UR 5(d+[[UR 5RS35egg)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 r:s r4r.#_BaseXMLFormatter._validate_columnss >>,t~~">">'0011ST  >>,t~~">">'0011ST #?>r7cD[R"UR5 g)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#r:s r4r/$_BaseXMLFormatter._validate_encodings  dmm$r7cURnUR(aUR5nURbUR UR5nUR SS9$)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)r3dfs r4r,$_BaseXMLFormatter._process_dataframesMZZ ::!B ;; "4;;'Bzzz))r7c|UR(dg[[UR55nURUR 5Vs/sHo"UR ;dMUPM nnUR (aX0R -UlUR(aX0R-Ulggs snf)zL Handle indexes. This method will add indexes into attr_cols or elem_cols. N)rnextiterr-keysr+rr )r3 first_keyxindexess r4r2!_BaseXMLFormatter._handle_indexesszz d../0 '' 2779 9!dnn=TA9   >>$~~5DN >>$~~5DN  s B9'B9c[U5e)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. rr:s r4r0!_BaseXMLFormatter._get_prefix_uris"$''r7c0nUR(aQURR5VVs0sH*up#X0RSS:wdMSUS:XaUOSU33U_M, nnnU$s snnf)z Define other namespaces. This method will build dictionary of namespaces attributes for root element, conditionally with optional namespaces and prefix. xmlns:)r!itemsr1)r3 nmsp_dictpns r4_other_namespaces#_BaseXMLFormatter._other_namespacess|%' ??!OO1133DA"--7%Q"WAaS'23Q63   s A' A'cUR(dU$URHCnURU5n[X5(d[X5URU'MCME U$![ an[ SU35UeSnAff=f)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 strattribKeyError)r3delem_rowcol attr_nameerrs r4_build_attribs _BaseXMLFormatter._build_attribss~~O>>C//4I CAF||14QVHOOI.$" C!23%89sB Cs,A)) B3BBcTUn[U[5(axSU;a9SRUVs/sHn[U5PM sn5R 5O8SRUVs/sHn[U5PM sn5R 5nUR U3$s snfs snf)Nr[_) isinstancetuplejoinrfstripr1)r3rkflat_colcs r4re$_BaseXMLFormatter._get_flat_col_name.s c5 ! !9-AQ-.446XXs3s!s1vs34::<  //"8*-- .3s B &B%c[U5errr:s r4_sub_element_cls"_BaseXMLFormatter._sub_element_cls9s !$''r7c6URnUR(dgURHJnURU5n[X5(dXS:XaSO [ X5nXc"X%5lML g![ an[ SU35UeSnAff=f)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. Nr[rd)rzr rer rftextrh)r3rirjsub_element_clsrk elem_namevalrms r4 _build_elems_BaseXMLFormatter._build_elems=s//~~ >>C//4I C"16llafldAF >$--0779 9s B B%)rr'r r#rr-rrr!r+rr"r1r%rrr(r&r$)NTdatarowNNNNNzutf-8TTNinferN)"rrrz7FilePath | WriteBuffer[bytes] | WriteBuffer[str] | Nonerboolr str | Nonerrrrrlist[str] | Noner rr!zdict[str | None, str] | Noner"rr#rfr$ bool | Noner%rr&z5FilePath | ReadBuffer[str] | ReadBuffer[bytes] | Noner'rr(zStorageOptions | NonereturnNonerbytesrr)rzdict[int | str, dict[str, Any]]rrf)rdict)ridict[str, Any]rjrrr)rkz str | tuplerrf)rirrjrrr)rr)r@ __module__ __qualname____firstlineno____doc__r5r;rr.r/r,r2r0rarnrer rzrr__static_attributes__r7r4rr$sMdSW &$!&*&*37!'+$(LP*115#**P* *  *  **$*$*1***%*"*J* (!*"/#*$ %*X(  *  %  % * *$ 6 6* (  &  ( . .(( C C( : :r7rcF\rSrSrSrS SjrS Sjr\S5rS Sjr Sr g) EtreeXMLFormatteriex Class for formatting data in xml using Python standard library modules: `xml.etree.ElementTree` and `xml.dom.minidom`. cSSKJnJnJn U"URUR 3UR 5S9UlURR5HnU"URURUR35nUR(dBUR(d1[UR55Ul URXE5 MUR!XE5nURXE5 M U"URSUR"UR$S9UlUR((aUR+5UlUR,b [/S5eUR&$)NrElement SubElementtostring)rgxml)methodr#r$zBTo use stylesheet, you need lxml installed and selected as parser.)xml.etree.ElementTreerrrr1rrarootr-valuesrrr listrPrrnr#r$out_xmlr%_prettify_treer& ValueErrorr3rrrrirjs r4r;EtreeXMLFormatter._build_treeks-  / 09O9O9Q  !!((*A!$))/@-PQH>>$..!%affh!!!. ..q;!!!.+ II]] 00      ..0DL ?? &T ||r7cSSKJn SnUR(aURR5H;up4[ U[ 5(dM[ U[ 5(dM3U"X45 M= UR (a SURUR S3nU$SUR;aSURSS3nU$SnU$![an[UR S35UeSnAff=f)Nr)register_namespacer[{} is not included in namespaces)rrr!r]rrrfr"rh)r3rurir_r`rms r4r0!EtreeXMLFormatter._get_prefix_uris< ??--/a%%*Q*<*<&q,0{{tt{{;[TU]"U0UD6 UR5 gr)superr5_convert_empty_str_key)r3argskwargs __class__s r4r5LxmlXMLFormatter.__init__s! $)&) ##%r7cSSKJnJnJn U"URUR 3UR S9UlURR5HnU"URURUR35nUR(dBUR(d1[UR55Ul URXE5 MUR!XE5nURXE5 M U"URUR"SUR$UR&S9UlUR*bUR-5UlUR($)r9rr)nsmapr)r%rr#r$) lxml.etreerrrr1rr!rr-rrrr rrPrrnr%r#r$rr&_transform_docrs r4r;LxmlXMLFormatter._build_trees  t//?@X !!((*A!$))/@-PQH>>$..!%affh!!!. ..q;!!!.+ II**]] 00    ?? &..0DL||r7cUR(aISURR5;a*URRSS5URS'ggg)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. r[defaultN)r!rPpopr:s r4r'LxmlXMLFormatter._convert_empty_str_keysE ??rT__%9%9%;;$(OO$7$7I$FDOOD ! rss#  .22+'0!~:~:B TD)TDnz(zr7