hyb
2025-11-18 7539e6f48c75dcaeb808359cccfd1c0d0d182ce8
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
Ë
nñúh>ãó4—dZddlmZddlZddlZddlmZmZmZddl    Z    ddl
m Z ddl m Z mZddlmZddlmZdd    lmZdd
lmZdd lmZmZerdd lmZmZmZmZmZdd l m!Z!eededdz¬«Gd„d««Z"Gd„de"«Z#Gd„de"«Z$y)zF
:mod:`pandas.io.formats.xml` is a module for formatting data in XML.
é)Ú annotationsN)Ú TYPE_CHECKINGÚAnyÚfinal©ÚAbstractMethodError)Úcache_readonlyÚdoc)Ú is_list_like)Úisna)Ú _shared_docs)Ú
get_handle)Úget_data_from_filepathÚpreprocess_data)ÚCompressionOptionsÚFilePathÚ
ReadBufferÚStorageOptionsÚ WriteBuffer)Ú    DataFrameÚstorage_optionsÚcompression_optionsÚpath_or_buffer)rrcó<—eZdZdZ                                                            d                                                                                                                                    dd„Zdd„Zedd„«Zedd„«Zedd„«Z    edd„«Z
dd    „Z edd
„«Z edd „«Z edd „«Zed „«Zedd„«Zedd„«Zy)Ú_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_options}
 
        .. versionchanged:: 1.4.0 Zstandard support.
 
    {storage_options}
 
    See also
    --------
    pandas.io.formats.xml.EtreeXMLFormatter
    pandas.io.formats.xml.LxmlXMLFormatter
 
    Ncóê—||_||_||_||_||_||_||_||_|    |_|
|_    | |_
| |_ | |_ ||_ ||_||_|jj j#«|_|j'«|_|j+«|j-«|j/«|_|j3«y©N)ÚframerÚindexÚ    root_nameÚrow_nameÚna_repÚ    attr_colsÚ    elem_colsÚ
namespacesÚprefixÚencodingÚxml_declarationÚ pretty_printÚ
stylesheetÚ compressionrÚcolumnsÚtolistÚ    orig_colsÚ_process_dataframeÚ frame_dictsÚ_validate_columnsÚ_validate_encodingÚ_get_prefix_uriÚ
prefix_uriÚ_handle_indexes)Úselfrrrr r!r"r#r$r%r&r'r(r)r*r+rs                 úHH:\Change_password\venv_build\Lib\site-packages\pandas/io/formats/xml.pyÚ__init__z_BaseXMLFormatter.__init__ls؀ð&ˆŒ
Ø,ˆÔ؈Œ
Ø"ˆŒØ ˆŒ ؈Œ Ø"ˆŒØ"ˆŒØ$ˆŒØˆŒ Ø ˆŒ Ø.ˆÔØ(ˆÔØ$ˆŒØ/:ˆÔØ.ˆÔàŸ™×+Ñ+×2Ñ2Ó4ˆŒØ×2Ñ2Ó4ˆÔà ×ÑÔ Ø ×ÑÔ!Ø×.Ñ.Ó0ˆŒØ ×ÑÕócó—t|«‚)ú—
        Build tree from  data.
 
        This method initializes the root and builds attributes and elements
        with optional namespaces.
        r©r6s r7Ú _build_treez_BaseXMLFormatter._build_tree˜s€ô" $Ó'Ð'r9có6—|jr@t|j«s+tt|j«j›d«‚|j
rAt|j
«s+tt|j
«j›d«‚yy)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)r#r Ú    TypeErrorÚtypeÚ__name__r$r<s r7r1z#_BaseXMLFormatter._validate_columns¡s€ð >Š>¤,¨t¯~©~Ô">ÜܘŸ™Ó'×0Ñ0Ð1Ð1SÐTóð ð >Š>¤,¨t¯~©~Ô">ÜܘŸ™Ó'×0Ñ0Ð1Ð1SÐTóð ð#?ˆ>r9cóB—tj|j«y)z×
        Validate encoding.
 
        This method will check if encoding is among listed under codecs.
 
        Raises
        ------
        LookupError
            * If encoding is not available in codecs.
        N)ÚcodecsÚlookupr'r<s r7r2z$_BaseXMLFormatter._validate_encoding·s€ô     ‰ d—m‘mÕ$r9cóN—|j}|jr|j«}|jTt    j
«5t    j ddt¬«|j|j«}ddd«|jd¬«S#1swYŒxYw)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.
        NÚignorezDowncasting object dtype arrays)Úcategoryr)Úorient)
rrÚ reset_indexr"ÚwarningsÚcatch_warningsÚfilterwarningsÚ FutureWarningÚfillnaÚto_dict)r6Údfs  r7r/z$_BaseXMLFormatter._process_dataframeÆs‰€ðZ‰Zˆà :Š:Ø—‘Ó!ˆBà ;‰;Ð "Ü×(Ñ(Ó*ñ ,Ü×'Ñ'ØØ5Ü*õð
—Y‘Y˜tŸ{™{Ó+÷  ,ðz‰z ˆzÓ)Ð)÷ ,ð ,ús Á    8BÂB$cóX—|jsytt|j««}|j|j    «Dcgc]}||j
vsŒ|‘Œ}}|j r||j z|_|jr||jz|_yycc}w)zd
        Handle indexes.
 
        This method will add indexes into attr_cols or elem_cols.
        N)rÚnextÚiterr0Úkeysr.r#r$)r6Ú    first_keyÚxÚindexess    r7r5z!_BaseXMLFormatter._handle_indexesßs–€ðzŠzØ äœ˜d×.Ñ.Ó/Ó0ˆ    à×'Ñ'¨    Ñ2×7Ñ7Ó9ö
ظQÀdÇnÁnÒ=TŠAð
ˆð
ð >Š>Ø$ t§~¡~Ñ5ˆDŒNà >Š>Ø$ t§~¡~Ñ5ˆDNð ùò
s Á B'ÁB'có—t|«‚)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 r7r3z!_BaseXMLFormatter._get_prefix_uriõs€ô" $Ó'Ð'r9cóƗi}|jrL|jj«Dcic]'\}}||jddk7rd|dk(r|nd|››|“Œ)}}}|Scc}}w)zÃ
        Define other namespaces.
 
        This method will build dictionary of namespaces attributes
        for root element, conditionally with optional namespaces and
        prefix.
        ééÿÿÿÿÚxmlnsÚú:)r%Úitemsr4)r6Ú    nmsp_dictÚpÚns    r7Ú_other_namespacesz#_BaseXMLFormatter._other_namespacess{€ð%'ˆ    Ø ?Š?ð!ŸO™O×1Ñ1Ó3÷áAqؘŸ™¨¨"Ð-Ò-ð˜Q šU™¨!¨A¨3¨Ð0Ð1°1Ñ4ðˆIñð Ðùó s¬,Acóð—|js|S|jD]=}|j|«}    t||«st||«|j|<Œ?|S#t
$rt d|›«‚wxYw)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, )r#Ú_get_flat_col_namer ÚstrÚattribÚKeyError)r6ÚdÚelem_rowÚcolÚ    attr_names     r7Ú_build_attribsz _BaseXMLFormatter._build_attribss…€ð~Š~؈Oà—>‘>ò    :ˆCØ×/Ñ/°Ó4ˆIð :ܘA˜c™F”|Ü14°Q°s±V³H—O‘O IÑ.øð        :ðˆøôò :ÜÐ!2°3°%Ð8Ó9Ð9ð :ús °)AÁA5có:—|}t|t«rpd|vr6dj|Dcgc] }t|«‘Œc}«j    «n5dj|Dcgc] }t|«‘Œc}«j    «}|j
›|›Scc}wcc}w)Nr]Ú_)Ú
isinstanceÚtupleÚjoinrgÚstripr4)r6rlÚflat_colÚcs    r7rfz$_BaseXMLFormatter._get_flat_col_name,s‡€àˆÜ cœ5Ô !ð˜‘9𗑨Ö- Aœ˜QÒ-Ó.×4Ñ4Ô6à—X‘X¨sÖ3¨!œs 1vÒ3Ó4×:Ñ:Ó<ð ð
—/‘/Ð" 8 *Ð-Ð-ùò    .ùâ3s ¦BÁBcó—t|«‚rrr<s r7Ú_sub_element_clsz"_BaseXMLFormatter._sub_element_cls7s €ä! $Ó'Ð'r9có—|j}|jsy|jD]H}|j|«}    t||«s||dk(rdn t    ||«}||||«_ŒJy#t $rt d|›«‚wxYw)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]re)rxr$rfr rgÚtextri)r6rjrkÚsub_element_clsrlÚ    elem_nameÚvals       r7Ú _build_elemsz_BaseXMLFormatter._build_elems;s—€ð×/Ñ/ˆà~Š~Ø à—>‘>ò    :ˆCØ×/Ñ/°Ó4ˆIð :Ü" 1 S¡6œl¨a°©f¸ªl‘dÄÀAÀcÁFà Ø<?‘ ¨)Ó4Õ9ñ        :øô
ò :ÜÐ!2°3°%Ð8Ó9Ð9ð :ús »4A2Á2B
cóJ—|j«}|jSt|jd|j|jd¬«5}|j
j |«ddd«y|j|j«j«S#1swYyxYw)NÚwbF)r+rÚis_text)
r=rrr+rÚhandleÚwriteÚdecoder'Úrstrip)r6Úxml_docÚhandless   r7Ú write_outputz_BaseXMLFormatter.write_outputPs”€à×"Ñ"Ó$ˆà × Ñ Ð *ÜØ×#Ñ#ØØ ×,Ñ,Ø $× 4Ñ 4Øô ð .ð Ø—‘×$Ñ$ WÔ-÷ .ðð—>‘> $§-¡-Ó0×7Ñ7Ó9Ð 9÷ .ðús Á BÂB")NTÚdataÚrowNNNNNzutf-8TTNÚinferN)"rrrz7FilePath | WriteBuffer[bytes] | WriteBuffer[str] | NonerÚboolr ú
str | Noner!rr"rr#úlist[str] | Noner$rŽr%zdict[str | None, str] | Noner&rr'rgr(ú bool | Noner)rr*z5FilePath | ReadBuffer[str] | ReadBuffer[bytes] | Noner+rrzStorageOptions | NoneÚreturnÚNone©rÚbytes©rr‘)rzdict[int | str, dict[str, Any]]©rrg)rÚdict)rjúdict[str, Any]rkrrr)rlz str | tuplerrg)rjr—rkrrr‘)rr)rAÚ
__module__Ú __qualname__Ú__doc__r8r=rr1r2r/r5r3rcrnrfr    rxr~rˆ©r9r7rr,s»„ñ
9ð|SWØØ &Ø$Ø!Ø&*Ø&*Ø37Ø!ØØ'+Ø$(ØLPØ*1Ø15ð#*àð*ðPð*ðð    *ð
ð *ð ð *ðð*ð$ð*ð$ð*ð1ð*ðð*ðð*ð%ð*ð"ð*ðJð*ð (ð!*ð"/ð#*ð$
ó%*óX(ð òó ðð* ò %ó ð %ð ò*ó ð*ð0 ò6ó ð6ó* (ð òó ðð& òó ðð( ò.ó ð.ðñ(óð(ð ò:ó ð:ð( ò:ó ñ:r9rcó8—eZdZdZdd„Zdd„Zed„«Zdd„Zy)    ÚEtreeXMLFormatterú„
    Class for formatting data in xml using Python standard library
    modules: `xml.etree.ElementTree` and `xml.dom.minidom`.
    cóÔ—ddlm}m}m}||j›|j
›|j «¬«|_|jj«D]š}||j|j›|j›«}|js=|js1t|j««|_ |j||«Œw|j!||«}|j||«Œœ||jd|j"|j$¬«|_|j(r|j+«|_|j, t/d«‚|j&S)Nr©ÚElementÚ
SubElementÚtostring)rhÚxml)Úmethodr'r(zBTo use stylesheet, you need lxml installed and selected as parser.)Úxml.etree.ElementTreer¡r¢r£r4r rcÚrootr0Úvaluesr!r#r$ÚlistrTr~rnr'r(Úout_xmlr)Ú_prettify_treer*Ú
ValueError©r6r¡r¢r£rjrks      r7r=zEtreeXMLFormatter._build_treeis8€÷    
ñ    
ñ ؏‰Ð §¡Ð/Ð 0¸×9OÑ9OÓ9Qô
ˆŒ    ð×!Ñ!×(Ñ(Ó*ò        /ˆAÙ! $§)¡)°·±Ð/@ÀÇÁÀÐ-PÓQˆHà—>’>¨$¯.ª.Ü!% a§f¡f£h£”Ø×!Ñ! ! XÕ.ð ×.Ñ.¨q°(Ó;Ø×!Ñ! ! XÕ.ð        /ñ Ø I‰IØØ—]‘]Ø ×0Ñ0ô    
ˆŒ ð × Ò Ø×.Ñ.Ó0ˆDŒLà ?‰?Ð &ÜØTóð ð|‰|Ðr9có´—ddlm}d}|jrž|jj«D]0\}}t    |t
«sŒt    |t
«sŒ(|||«Œ2|j r     d|j|j ›d}|Sd|jvrd|jd›d}|Sd}|S#t$rt|j ›d«‚wxYw)Nr)Úregister_namespacer]ú{ú}ú is not included in namespaces)r¦r¯r%r_rqrgr&ri)r6r¯Úurirarbs     r7r3z!EtreeXMLFormatter._get_prefix_urisã€Ý<àˆØ ?Š?ØŸ™×-Ñ-Ó/ò -‘1ܘa¤Õ%¬*°Q¼Õ*<Ù& q¨!Õ,ð -ð{Š{ðSؘtŸ™¨t¯{©{Ñ;Ð<¸BÐ?Cðˆ
ð t—‘Ñ&ؘ4Ÿ?™?¨2Ñ.Ð/¨rÐ2ðˆ
ðàˆ
øô òSÜ" d§k¡k ]Ð2PÐ#QÓRÐRðSús Á/B5Â5"Ccó—ddlm}|S©Nr)r¢)r¦r¢©r6r¢s  r7rxz"EtreeXMLFormatter._sub_element_cls¤s €å4àÐr9cól—ddlm}||j«}|jd|j¬«S)zƒ
        Output tree for pretty print format.
 
        This method will pretty print xml with line breaks and indentation.
        r)Ú parseStringz  )Úindentr')Úxml.dom.minidomr¸rªÚ toprettyxmlr')r6r¸Údoms   r7r«z EtreeXMLFormatter._prettify_treeªs,€õ    0á˜$Ÿ,™,Ó'ˆà‰ d°T·]±]ˆÓCÐCr9Nr’r•)    rAr˜r™ršr=r3r    rxr«r›r9r7rrcs,„ñó
%óNð(ñóðô
Dr9rcóT‡—eZdZdZdˆfd„ Zd    d„Zdd„Zd
d„Zed„«Z    d    d„Z
ˆxZ S) ÚLxmlXMLFormatterržcóD•—t‰||i|¤Ž|j«yr)Úsuperr8Ú_convert_empty_str_key)r6ÚargsÚkwargsÚ    __class__s   €r7r8zLxmlXMLFormatter.__init__¾s!ø€Ü ‰Ñ˜$Ð) &Ò)à ×#Ñ#Õ%r9có´—ddlm}m}m}||j›|j
›|j ¬«|_|jj«D]š}||j|j›|j›«}|js=|js1t|j««|_ |j||«Œw|j!||«}|j||«Œœ||j|j"d|j$|j&¬«|_|j*|j-«|_|j(S)r;rr )Únsmapr¤)r)r¥r'r()Ú
lxml.etreer¡r¢r£r4r r%r§r0r¨r!r#r$r©rTr~rnr)r'r(rªr*Ú_transform_docr­s      r7r=zLxmlXMLFormatter._build_treeÃs€÷    
ñ    
ñ ˜tŸ™Ð/°·±Ð/?Ð@ÈÏÉÔXˆŒ    à×!Ñ!×(Ñ(Ó*ò        /ˆAÙ! $§)¡)°·±Ð/@ÀÇÁÀÐ-PÓQˆHà—>’>¨$¯.ª.Ü!% a§f¡f£h£”Ø×!Ñ! ! XÕ.ð ×.Ñ.¨q°(Ó;Ø×!Ñ! ! XÕ.ð        /ñ Ø I‰IØ×*Ñ*ØØ—]‘]Ø ×0Ñ0ô 
ˆŒ ð ?‰?Ð &Ø×.Ñ.Ó0ˆDŒLà|‰|Ðr9cóª—|jrGd|jj«vr*|jjdd«|jd<yyy)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%rTÚpopr<s r7rÁz'LxmlXMLFormatter._convert_empty_str_keyêsE€ð ?Š?˜r T§_¡_×%9Ñ%9Ó%;Ñ;Ø$(§O¡O×$7Ñ$7¸¸IÓ$FˆDO‰O˜DÒ !ð <ˆ?r9có—d}|jrQ|jr     d|j|j›d}|Sd|jvrd|jd›d}|Sd}|S#t$rt|j›d«‚wxYw)Nr]r°r±r²)r%r&ri)r6r³s  r7r3z LxmlXMLFormatter._get_prefix_uriõs¡€ØˆØ ?Š?؏{Š{ðSؘtŸ™¨t¯{©{Ñ;Ð<¸BÐ?Cðˆ
ð t—‘Ñ&ؘ4Ÿ?™?¨2Ñ.Ð/¨rÐ2ðˆ
ðàˆ
øô òSÜ" d§k¡k ]Ð2PÐ#QÓRÐRðSús œA"Á""Bcó—ddlm}|Srµ)rÇr¢r¶s  r7rxz!LxmlXMLFormatter._sub_element_clss €å)àÐr9cóð—ddlm}m}m}m}|j
}|€J‚t ||j|j|j¬«}t|«5}||j¬«}t|tj«r2||j«j|j«|¬«}    n
|||¬«}    ddd«|    «}
|
|j «} t#| «S#1swYŒ.xYw)zõ
        Parse stylesheet from file or buffer and run it.
 
        This method will parse stylesheet object into tree for parsing
        conditionally by its specific object type, then transforms
        original tree with XSLT script.
        r)ÚXSLTÚ    XMLParserÚ
fromstringÚparseN)Úfilepath_or_bufferr'r+r)r')Úparser)rÇrÏrÐrÑrÒr*rr'r+rrrqÚioÚStringIOÚgetvalueÚencoder§r“) r6rÏrÐrÑrÒÚ    style_docÚ handle_dataÚxml_dataÚ curr_parserÚxsl_docÚ transformerÚnew_docs             r7rÈzLxmlXMLFormatter._transform_doc
sހ÷    
ó    
ð—O‘Oˆ    ØÐ$Ð$Ð$ä,Ø(Ø—]‘]Ø×(Ñ(Ø ×0Ñ0ô    
ˆ ô˜[Ó )ð    >¨XÙ#¨T¯]©]Ô;ˆKä˜(¤B§K¡KÔ0Ù$Ø×%Ñ%Ó'×.Ñ.¨t¯}©}Ó=Àkô‘ñ  °Ô=÷    >ñ˜7“mˆ Ù˜dŸi™iÓ(ˆäW‹~Ð÷    >ð    >ús ÁA*C,Ã,C5r”r’r•) rAr˜r™ršr8r=rÁr3r    rxrÈÚ __classcell__)rÄs@r7r¾r¾¸s7ø„ñõ
&ó
%óN    Gó ðñóð÷
&r9r¾)%ršÚ
__future__rrCrÕÚtypingrrrrJÚ pandas.errorsrÚpandas.util._decoratorsr    r
Úpandas.core.dtypes.commonr Úpandas.core.dtypes.missingr Úpandas.core.shared_docsr Úpandas.io.commonrÚ pandas.io.xmlrrÚpandas._typingrrrrrÚpandasrrrr¾r›r9r7ú<module>rìs®ðñõ#ã Û    ÷ñó
å-÷õ
3Ý+å0å'÷ñ
÷õõ!ñØ Ð!2Ñ3Ø$Ð%:Ñ;Ð>NÑNô÷p:ðp:ó    ðp:ôf    RDÐ)ôRDôjxÐ(õxr9