Ë
    òT•jß/  ã                   óÎ   — d Z ddlZddlZddlZddlZddlZddlmZ ddlm	Z	 d„ Z
i fd„Zi fd„Zi fd	„Zd
„ Z G d„ dej                  «      Z G d„ de	j"                  «      Zdd„Zy)znA library of useful helper classes to the SAX classes, for the
convenience of application and driver writers.
é    Né   )Úhandler)Ú	xmlreaderc                 óZ   — |j                  «       D ]  \  }}| j                  ||«      } Œ | S )z2Replace substrings of a string using a dictionary.)ÚitemsÚreplace)ÚsÚdÚkeyÚvalues       ú'/usr/lib/python3.12/xml/sax/saxutils.pyÚ__dict_replacer      s0   € à—g‘g“iò "‰
ˆˆUØ�I‰I�c˜5Ó!‰ð"à€Hó    c                 óŽ   — | j                  dd«      } | j                  dd«      } | j                  dd«      } |rt        | |«      } | S )züEscape &, <, and > in a string of data.

    You can escape other strings of data by passing a dictionary as
    the optional entities parameter.  The keys and values must all be
    strings; each key will be replaced with its corresponding value.
    ú&ú&amp;ú>ú&gt;ú<ú&lt;©r   r   ©ÚdataÚentitiess     r   Úescaper      sH   € ð �<‰<˜˜WÓ%€DØ�<‰<˜˜VÓ$€DØ�<‰<˜˜VÓ$€DÙÜ˜d HÓ-ˆØ€Kr   c                 óŠ   — | j                  dd«      } | j                  dd«      } |rt        | |«      } | j                  dd«      S )a
  Unescape &amp;, &lt;, and &gt; in a string of data.

    You can unescape other strings of data by passing a dictionary as
    the optional entities parameter.  The keys and values must all be
    strings; each key will be replaced with its corresponding value.
    r   r   r   r   r   r   r   r   s     r   Úunescaper   "   sD   € ð �<‰<˜ Ó$€DØ�<‰<˜ Ó$€DÙÜ˜d HÓ-ˆà�<‰<˜ Ó%Ð%r   c                 óˆ   — i |¥ddddœ¥}t        | |«      } d| v r"d| v rd| j                  dd«      z  } | S d	| z  } | S d| z  } | S )
a“  Escape and quote an attribute value.

    Escape &, <, and > in a string of data, then quote it for use as
    an attribute value.  The " character will be escaped as well, if
    necessary.

    You can escape other strings of data by passing a dictionary as
    the optional entities parameter.  The keys and values must all be
    strings; each key will be replaced with its corresponding value.
    z&#10;z&#13;z&#9;)ú
úú	ú"ú'z"%s"z&quot;z'%s')r   r   r   s     r   Ú	quoteattrr$   0   sp   € ð G�(ÐF '°¸vÒF€HÜ�$˜Ó!€DØ
ˆd�{Ø�$‰;Ø˜DŸL™L¨¨hÓ7Ñ7ˆDð
 €Kð ˜D‘=ˆDð €Kð ˜‰}ˆØ€Kr   c                 ó  ‡ — ‰ €dd l }|j                  S t        ‰ t        j                  «      r‰ S t        ‰ t
        j                  t
        j                  f«      r‰ S t        ‰ t        j                  «      r G ˆ fd„d«      } |«       }d„ |_	        nPt        j                  «       }d„ |_        ‰ j                  |_        	 ‰ j                  |_        ‰ j                  |_        t        j                   ||ddd¬	«      S # t        $ r Y Œ%w xY w)
Nr   c                   ó2   •— e Zd ZW ° j                  Zˆ fd„Zy)ú _gettextwriter.<locals>._wrapperc                 ó   •— t        ‰|«      S ©N)Úgetattr)ÚselfÚnameÚouts     €r   Ú__getattr__z,_gettextwriter.<locals>._wrapper.__getattr__Z   s   ø€ Ü˜s DÓ)Ð)r   N)Ú__name__Ú
__module__Ú__qualname__Ú	__class__r.   )r-   s   €r   Ú_wrapperr'   X   s   ø„ ÙŸ™ˆIõ*r   r3   c                   ó   — y r)   © r5   r   r   ú<lambda>z _gettextwriter.<locals>.<lambda>]   ó   � r   c                   ó   — y)NTr5   r5   r   r   r6   z _gettextwriter.<locals>.<lambda>b   r7   r   Úxmlcharrefreplacer   T)ÚencodingÚerrorsÚnewlineÚwrite_through)ÚsysÚstdoutÚ
isinstanceÚioÚ
TextIOBaseÚcodecsÚStreamWriterÚStreamReaderWriterÚ	RawIOBaseÚcloseÚBufferedIOBaseÚwritableÚwriteÚseekableÚtellÚAttributeErrorÚTextIOWrapper)r-   r:   r>   r3   Úbuffers   `    r   Ú_gettextwriterrP   G   sç   ø€ Ø
€{ÛØ�z‰zÐä�#”r—}‘}Ô%àˆ
ä�#œ×+Ñ+¬V×-FÑ-FÐGÔHàˆ
ô �#”r—|‘|Ô$÷	*ó 	*ñ “ˆÙ#ˆ�ô ×"Ñ"Ó$ˆÙ&ˆŒØ—y‘yˆŒð	ð "Ÿl™lˆFŒOØŸ(™(ˆFŒKô ×Ñ˜F¨XØ#6Ø$(Ø*.ô0ð 0øô ò 	Ùð	ús   Ã "C< Ã<	DÄDc                   ód   — e Zd Zdd„Zd„ Zdd„Zd„ Zd„ Zd„ Zd„ Z	d	„ Z
d
„ Zd„ Zd„ Zd„ Zd„ Zd„ Zy)ÚXMLGeneratorNc                 ó  — t         j                  j                  | «       t        ||«      }|j                  | _        |j                  | _        i g| _        | j                  d   | _	        g | _
        || _        || _        d| _        y )NéÿÿÿÿF)r   ÚContentHandlerÚ__init__rP   rJ   Ú_writeÚflushÚ_flushÚ_ns_contextsÚ_current_contextÚ_undeclared_ns_mapsÚ	_encodingÚ_short_empty_elementsÚ_pending_start_element)r+   r-   r:   Úshort_empty_elementss       r   rV   zXMLGenerator.__init__r   st   € Ü×Ñ×'Ñ'¨Ô-Ü˜S (Ó+ˆØ—i‘iˆŒØ—i‘iˆŒØ˜DˆÔØ $× 1Ñ 1°"Ñ 5ˆÔØ#%ˆÔ Ø!ˆŒØ%9ˆÔ"Ø&+ˆÕ#r   c                 ót   — |d   r/d|d   k(  rd|d   z   S | j                   |d      }|r|dz   |d   z   S |d   S )z7Builds a qualified name from a (ns_url, localname) pairr   z$http://www.w3.org/XML/1998/namespacezxml:r   ú:)r[   )r+   r,   Úprefixs      r   Ú_qnamezXMLGenerator._qname~   sY   € à�Š7ð
 6¸¸a¹Ò@Ø  Q¡Ñ'Ð'à×*Ñ*¨4°©7Ñ3ˆFÙà ‘| d¨1¡gÑ-Ð-à�A‰wˆr   c                 óN   — | j                   r| j                  d«       d| _         y y )Nr   F©r_   rW   )r+   Ú
endElements     r   Ú_finish_pending_start_elementz*XMLGenerator._finish_pending_start_element�   s$   € Ø×&Ò&Ø�K‰K˜ÔØ*/ˆDÕ'ð 'r   c                 ó@   — | j                  d| j                  z  «       y )Nz$<?xml version="1.0" encoding="%s"?>
)rW   r]   ©r+   s    r   ÚstartDocumentzXMLGenerator.startDocument–   s   € Ø�‰Ð;ØŸ™ñ'õ 	(r   c                 ó$   — | j                  «        y r)   )rY   rj   s    r   ÚendDocumentzXMLGenerator.endDocumentš   s   € Ø�‰�r   c                 óÂ   — | j                   j                  | j                  j                  «       «       || j                  |<   | j                  j                  ||f«       y r)   )rZ   Úappendr[   Úcopyr\   ©r+   rc   Úuris      r   ÚstartPrefixMappingzXMLGenerator.startPrefixMapping�   sM   € Ø×Ñ× Ñ  ×!6Ñ!6×!;Ñ!;Ó!=Ô>Ø%+ˆ×Ñ˜cÑ"Ø× Ñ ×'Ñ'¨°¨Õ6r   c                 óF   — | j                   d   | _        | j                   d= y )NrT   )rZ   r[   ©r+   rc   s     r   ÚendPrefixMappingzXMLGenerator.endPrefixMapping¢   s#   € Ø $× 1Ñ 1°"Ñ 5ˆÔØ×Ñ˜bÑ!r   c           	      ó  — | j                  «        | j                  d|z   «       |j                  «       D ]%  \  }}| j                  d|›dt        |«      ›�«       Œ' | j                  rd| _        y | j                  d«       y )Nr   ú ú=Tr   )rh   rW   r   r$   r^   r_   )r+   r,   Úattrsr   s       r   ÚstartElementzXMLGenerator.startElement¦   sj   € Ø×*Ñ*Ô,Ø�‰�C˜$‘JÔØ"Ÿ[™[›]ò 	=‰MˆT�5Ø�KŠK¢D¬)°EÔ*:Ð;Õ<ð	=à×%Ò%Ø*.ˆDÕ'à�K‰K˜Õr   c                 óv   — | j                   r| j                  d«       d| _         y | j                  d|z  «       y ©Nz/>Fz</%s>rf   ©r+   r,   s     r   rg   zXMLGenerator.endElement°   s/   € Ø×&Ò&Ø�K‰K˜ÔØ*/ˆDÕ'à�K‰K˜ $™Õ'r   c           	      óÖ  — | j                  «        | j                  d| j                  |«      z   «       | j                  D ]4  \  }}|r| j                  d|›d|›d�«       Œ!| j                  d|z  «       Œ6 g | _        |j	                  «       D ]4  \  }}| j                  d| j                  |«      ›dt        |«      ›�«       Œ6 | j                  rd| _        y | j                  d	«       y )
Nr   z xmlns:z="r"   z xmlns="%s"rx   ry   Tr   )rh   rW   rd   r\   r   r$   r^   r_   )r+   r,   Úqnamerz   rc   rr   r   s          r   ÚstartElementNSzXMLGenerator.startElementNS·   sÇ   € Ø×*Ñ*Ô,Ø�‰�C˜$Ÿ+™+ dÓ+Ñ+Ô,à×3Ñ3ò 	1‰KˆF�CÙØ—’²ºÐ<Õ=à—‘˜M¨CÑ/Õ0ð		1ð
 $&ˆÔ à"Ÿ[™[›]ò 	J‰MˆT�5Ø�KŠK D§K¡K°Õ$5´yÀÔ7GÐHÕIð	Jà×%Ò%Ø*.ˆDÕ'à�K‰K˜Õr   c                 ó”   — | j                   r| j                  d«       d| _         y | j                  d| j                  |«      z  «       y r}   )r_   rW   rd   ©r+   r,   r€   s      r   ÚendElementNSzXMLGenerator.endElementNSÉ   s9   € Ø×&Ò&Ø�K‰K˜ÔØ*/ˆDÕ'à�K‰K˜ $§+¡+¨dÓ"3Ñ3Õ4r   c                 óª   — |rQ| j                  «        t        |t        «      st        || j                  «      }| j	                  t        |«      «       y y r)   )rh   r@   Ústrr]   rW   r   ©r+   Úcontents     r   Ú
characterszXMLGenerator.charactersÐ   s@   € ÙØ×.Ñ.Ô0Ü˜g¤sÔ+Ü˜g t§~¡~Ó6�Ø�K‰Kœ˜w›Õ(ð	 r   c                 ó˜   — |rH| j                  «        t        |t        «      st        || j                  «      }| j	                  |«       y y r)   )rh   r@   r†   r]   rW   r‡   s     r   ÚignorableWhitespacez XMLGenerator.ignorableWhitespace×   s<   € ÙØ×.Ñ.Ô0Ü˜g¤sÔ+Ü˜g t§~¡~Ó6�Ø�K‰K˜Õ ð	 r   c                 óT   — | j                  «        | j                  d|›d|›d�«       y )Nz<?rx   z?>)rh   rW   ©r+   Útargetr   s      r   ÚprocessingInstructionz"XMLGenerator.processingInstructionÞ   s   € Ø×*Ñ*Ô,Ø�Š¢6ª4Ð0Õ1r   )Nz
iso-8859-1F)F)r/   r0   r1   rV   rd   rh   rk   rm   rs   rv   r{   rg   r�   r„   r‰   r‹   r�   r5   r   r   rR   rR   p   sH   „ ó
,òó"0ò(òò7ò
"òò(òò$5ò)ò!ó2r   rR   c                   óº   — e Zd ZdZdd„Zd„ Zd„ Zd„ Zd„ Zd„ Z	d	„ Z
d
„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zy) ÚXMLFilterBaseaY  This class is designed to sit between an XMLReader and the
    client application's event handlers.  By default, it does nothing
    but pass requests up to the reader and events on to the handlers
    unmodified, but subclasses can override specific methods to modify
    the event stream or the configuration requests as they pass
    through.Nc                 óP   — t         j                  j                  | «       || _        y r)   )r   Ú	XMLReaderrV   Ú_parent©r+   Úparents     r   rV   zXMLFilterBase.__init__ë   s   € Ü×Ñ×$Ñ$ TÔ*Øˆ�r   c                 ó:   — | j                   j                  |«       y r)   )Ú_err_handlerÚerror©r+   Ú	exceptions     r   r™   zXMLFilterBase.errorñ   s   € Ø×Ñ×Ñ 	Õ*r   c                 ó:   — | j                   j                  |«       y r)   )r˜   Ú
fatalErrorrš   s     r   r�   zXMLFilterBase.fatalErrorô   s   € Ø×Ñ×$Ñ$ YÕ/r   c                 ó:   — | j                   j                  |«       y r)   )r˜   Úwarningrš   s     r   rŸ   zXMLFilterBase.warning÷   s   € Ø×Ñ×!Ñ! )Õ,r   c                 ó:   — | j                   j                  |«       y r)   )Ú_cont_handlerÚsetDocumentLocator)r+   Úlocators     r   r¢   z XMLFilterBase.setDocumentLocatorü   s   € Ø×Ñ×-Ñ-¨gÕ6r   c                 ó8   — | j                   j                  «        y r)   )r¡   rk   rj   s    r   rk   zXMLFilterBase.startDocumentÿ   s   € Ø×Ñ×(Ñ(Õ*r   c                 ó8   — | j                   j                  «        y r)   )r¡   rm   rj   s    r   rm   zXMLFilterBase.endDocument  s   € Ø×Ñ×&Ñ&Õ(r   c                 ó<   — | j                   j                  ||«       y r)   )r¡   rs   rq   s      r   rs   z XMLFilterBase.startPrefixMapping  s   € Ø×Ñ×-Ñ-¨f°cÕ:r   c                 ó:   — | j                   j                  |«       y r)   )r¡   rv   ru   s     r   rv   zXMLFilterBase.endPrefixMapping  s   € Ø×Ñ×+Ñ+¨FÕ3r   c                 ó<   — | j                   j                  ||«       y r)   )r¡   r{   )r+   r,   rz   s      r   r{   zXMLFilterBase.startElement  ó   € Ø×Ñ×'Ñ'¨¨eÕ4r   c                 ó:   — | j                   j                  |«       y r)   )r¡   rg   r~   s     r   rg   zXMLFilterBase.endElement  s   € Ø×Ñ×%Ñ% dÕ+r   c                 ó>   — | j                   j                  |||«       y r)   )r¡   r�   )r+   r,   r€   rz   s       r   r�   zXMLFilterBase.startElementNS  s   € Ø×Ñ×)Ñ)¨$°°uÕ=r   c                 ó<   — | j                   j                  ||«       y r)   )r¡   r„   rƒ   s      r   r„   zXMLFilterBase.endElementNS  r©   r   c                 ó:   — | j                   j                  |«       y r)   )r¡   r‰   r‡   s     r   r‰   zXMLFilterBase.characters  s   € Ø×Ñ×%Ñ% gÕ.r   c                 ó:   — | j                   j                  |«       y r)   )r¡   r‹   )r+   Úcharss     r   r‹   z!XMLFilterBase.ignorableWhitespace  s   € Ø×Ñ×.Ñ.¨uÕ5r   c                 ó<   — | j                   j                  ||«       y r)   )r¡   r�   r�   s      r   r�   z#XMLFilterBase.processingInstruction  s   € Ø×Ñ×0Ñ0°¸Õ>r   c                 ó:   — | j                   j                  |«       y r)   )r¡   ÚskippedEntityr~   s     r   r²   zXMLFilterBase.skippedEntity   s   € Ø×Ñ×(Ñ(¨Õ.r   c                 ó>   — | j                   j                  |||«       y r)   )Ú_dtd_handlerÚnotationDecl)r+   r,   ÚpublicIdÚsystemIds       r   rµ   zXMLFilterBase.notationDecl%  s   € Ø×Ñ×&Ñ& t¨X°xÕ@r   c                 ó@   — | j                   j                  ||||«       y r)   )r´   ÚunparsedEntityDecl)r+   r,   r¶   r·   Úndatas        r   r¹   z XMLFilterBase.unparsedEntityDecl(  s   € Ø×Ñ×,Ñ,¨T°8¸XÀuÕMr   c                 ó:   — | j                   j                  ||«      S r)   )Ú_ent_handlerÚresolveEntity)r+   r¶   r·   s      r   r½   zXMLFilterBase.resolveEntity-  s   € Ø× Ñ ×.Ñ.¨x¸ÓBÐBr   c                 ó  — | j                   j                  | «       | j                   j                  | «       | j                   j                  | «       | j                   j	                  | «       | j                   j                  |«       y r)   )r”   ÚsetContentHandlerÚsetErrorHandlerÚsetEntityResolverÚsetDTDHandlerÚparse)r+   Úsources     r   rÃ   zXMLFilterBase.parse2  s\   € Ø�‰×&Ñ& tÔ,Ø�‰×$Ñ$ TÔ*Ø�‰×&Ñ& tÔ,Ø�‰×"Ñ" 4Ô(Ø�‰×Ñ˜6Õ"r   c                 ó:   — | j                   j                  |«       y r)   )r”   Ú	setLocale)r+   Úlocales     r   rÆ   zXMLFilterBase.setLocale9  s   € Ø�‰×Ñ˜vÕ&r   c                 ó8   — | j                   j                  |«      S r)   )r”   Ú
getFeaturer~   s     r   rÉ   zXMLFilterBase.getFeature<  s   € Ø�|‰|×&Ñ& tÓ,Ð,r   c                 ó<   — | j                   j                  ||«       y r)   )r”   Ú
setFeature)r+   r,   Ústates      r   rË   zXMLFilterBase.setFeature?  s   € Ø�‰×Ñ  eÕ,r   c                 ó8   — | j                   j                  |«      S r)   )r”   ÚgetPropertyr~   s     r   rÎ   zXMLFilterBase.getPropertyB  s   € Ø�|‰|×'Ñ'¨Ó-Ð-r   c                 ó<   — | j                   j                  ||«       y r)   )r”   ÚsetProperty)r+   r,   r   s      r   rÐ   zXMLFilterBase.setPropertyE  s   € Ø�‰× Ñ   uÕ-r   c                 ó   — | j                   S r)   ©r”   rj   s    r   Ú	getParentzXMLFilterBase.getParentJ  s   € Ø�|‰|Ðr   c                 ó   — || _         y r)   rÒ   r•   s     r   Ú	setParentzXMLFilterBase.setParentM  s	   € Øˆ�r   r)   ) r/   r0   r1   Ú__doc__rV   r™   r�   rŸ   r¢   rk   rm   rs   rv   r{   rg   r�   r„   r‰   r‹   r�   r²   rµ   r¹   r½   rÃ   rÆ   rÉ   rË   rÎ   rÐ   rÓ   rÕ   r5   r   r   r‘   r‘   ã   s–   „ ñóò+ò0ò-ò
7ò+ò)ò;ò4ò5ò,ò>ò5ò/ò6ò?ò/ò
AòNò
Cò
#ò'ò-ò-ò.ò.ò
ór   r‘   c                 ój  — t        | t        j                  «      rt        j                  | «      } t        | t        «      rt        j                  | «      } n¥t        | d«      r™| }t        j                  «       } t        |j                  d«      t        «      r| j                  |«       n| j                  |«       t        |d«      r5t        |j                  t        «      r| j                  |j                  «       | j                  «       �€'| j                  «       �€| j                  «       }t        j                   j#                  t        j                   j%                  |«      «      }t        j                   j'                  ||«      }t        j                   j)                  |«      r| j                  |«       t+        |d«      }n\| j                  t,        j.                  j1                  ||«      «       t,        j2                  j5                  | j                  «       «      }| j                  |«       | S )z‚This function takes an InputSource and an optional base URL and
    returns a fully resolved InputSource object ready for reading.Úreadr   r,   Úrb)r@   ÚosÚPathLikeÚfspathr†   r   ÚInputSourceÚhasattrrØ   ÚsetCharacterStreamÚsetByteStreamr,   ÚsetSystemIdÚgetCharacterStreamÚgetByteStreamÚgetSystemIdÚpathÚdirnameÚnormpathÚjoinÚisfileÚopenÚurllibrÃ   ÚurljoinÚrequestÚurlopen)rÄ   ÚbaseÚfÚsysidÚbaseheadÚsysidfilenames         r   Úprepare_input_sourcerô   R  s‡  € ô �&œ"Ÿ+™+Ô&Ü—‘˜6Ó"ˆÜ�&œ#ÔÜ×&Ñ& vÓ.‰Ü	�˜Ô	 ØˆÜ×&Ñ&Ó(ˆÜ�a—f‘f˜Q“i¤Ô%Ø×%Ñ% aÕ(à× Ñ  Ô#Ü�1�fÔ¤*¨Q¯V©V´SÔ"9Ø×Ñ˜qŸv™vÔ&à× Ñ Ó"Ñ*¨v×/CÑ/CÓ/EÑ/MØ×"Ñ"Ó$ˆÜ—7‘7—?‘?¤2§7¡7×#3Ñ#3°DÓ#9Ó:ˆÜŸ™Ÿ™ X¨uÓ5ˆÜ�7‰7�>‰>˜-Ô(Ø×Ñ˜}Ô-Ü�] DÓ)‰Aà×ÑœvŸ|™|×3Ñ3°D¸%Ó@ÔAÜ—‘×&Ñ& v×'9Ñ'9Ó';Ó<ˆAà×Ñ˜QÔà€Mr   )Ú )rÖ   rÚ   Úurllib.parserë   Úurllib.requestrA   rC   rõ   r   r   r   r   r   r$   rP   rU   rR   r“   r‘   rô   r5   r   r   ú<module>rø      sv   ðñ÷
 (Ó 'Û 	Û Ý Ý òð ó ð  ó &ð  ó ò.'0ôRp2�7×)Ñ)ô p2ôfk�I×'Ñ'ô kô^r   