a
    ¢Ž$iCE  ã                   @   s.  d Z ddlmZ ddlZddlZddlZzddlmZ W n e	yV   ddl
mZ Y n0 g d¢Ze d¡Ze d¡Ze d¡ZejZd	d
„ Zdd„ ZejdddZdd„ Ze d¡Ze d¡ZG dd„ deƒZG dd„ deƒZd#dd„Zd$dd„ZG dd„ dƒZdd„ Zd d!iZe d"kr*ddlZe !¡  dS )%aÑ  
lxml-based doctest output comparison.

Note: normally, you should just import the `lxml.usedoctest` and
`lxml.html.usedoctest` modules from within a doctest, instead of this
one::

    >>> import lxml.usedoctest # for XML output

    >>> import lxml.html.usedoctest # for HTML output

To use this module directly, you must call ``lxmldoctest.install()``,
which will cause doctest to use this in all subsequent calls.

This changes the way output is checked and comparisons are made for
XML or HTML-like content.

XML or HTML content is noticed because the example starts with ``<``
(it's HTML if it starts with ``<html``).  You can also use the
``PARSE_HTML`` and ``PARSE_XML`` flags to force parsing.

Some rough wildcard-like things are allowed.  Whitespace is generally
ignored (except in attributes).  In text (attributes and text in the
body) you can use ``...`` as a wildcard.  In an example it also
matches any trailing tags in the element, though it does not match
leading tags.  You may create a tag ``<any>`` or include an ``any``
attribute in the tag.  An ``any`` tag matches any tag, while the
attribute matches any and all attributes.

When a match fails, the reformatted example and gotten text is
displayed (indented), and a rough diff-like output is given.  Anything
marked with ``+`` is in the output but wasn't supposed to be, and
similarly ``-`` means its in the example but wasn't in the output.

You can disable parsing on one line with ``# doctest:+NOPARSE_MARKUP``
é    )ÚetreeN)Úescape)Ú
PARSE_HTMLÚ	PARSE_XMLÚNOPARSE_MARKUPÚLXMLOutputCheckerÚLHTMLOutputCheckerÚinstallÚtemp_installr   r   r   c                 C   s   | d u rd S |   ¡ S d S ©N)Ústrip©Úv© r   úa/var/www/staging/api/virtual_environments/venv/lib/python3.9/site-packages/lxml/doctestcompare.pyr   8   s    r   c                 C   s   t  d| ¡S )Nú )Ú_norm_whitespace_reÚsubr   r   r   r   Únorm_whitespace>   s    r   FT)ZrecoverZremove_blank_textc                 C   s   t  | t¡S r   )r   Z
fromstringÚ_html_parser©Úhtmlr   r   r   Úhtml_fromstringC   s    r   z^<[^>]+ (at|object) z[ \t\n][ \t\n]+c                   @   s    e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Z	dd„ Z
dd„ Zd'dd„Zd(dd„Zd)dd„Zdd„ Zdd„ Zdd„ Zd d!„ Zd"d#„ Zd*d$d%„Zd&S )+r   )
ÚparamZimgZareaÚbrZbasefontÚinputÚbaseÚmetaÚlinkÚcolc                 C   s   t jS r   )r   ÚXML©Úselfr   r   r   Úget_default_parserP   s    z$LXMLOutputChecker.get_default_parserc           	      C   sš   t | dd ƒ}|d ur | j}|} ntj}|  |||¡}|sF|| |||ƒS z||ƒ}W n tjyh   Y dS 0 z||ƒ}W n tjyŒ   Y dS 0 |  ||¡S )NÚ_temp_override_selfF)ÚgetattrÚ_temp_call_super_check_outputÚOutputCheckerÚcheck_outputÚ
get_parserr   ÚXMLSyntaxErrorÚcompare_docs)	r"   ÚwantÚgotÚoptionflagsZalt_selfZsuper_methodÚparserÚwant_docÚgot_docr   r   r   r(   S   s&    ÿzLXMLOutputChecker.check_outputc                 C   st   d }t |@ rd S t|@ rt}nRt|@ r.tj}nB| ¡  ¡  d¡rT| ¡  d¡rTt}n|  	|¡rp|  	|¡rp|  
¡ }|S )Nz<html)r   r   r   r   r   r    r   ÚlowerÚ
startswithÚ_looks_like_markupr#   )r"   r,   r-   r.   r/   r   r   r   r)   h   s     ÿ
ÿzLXMLOutputChecker.get_parserc                 C   s   |  ¡ }| d¡ot |¡ S )Nú<)r   r3   Ú_repr_reÚsearch)r"   Úsr   r   r   r4   x   s    

ÿz$LXMLOutputChecker._looks_like_markupc           
      C   s  |   |j|j¡sdS |  |j|jd¡s*dS |  |j|jd¡s@dS d|jvrœt|j ¡ ƒ}t|j ¡ ƒ}||krrdS |D ]$}|  |j| |j| d¡sv dS qv|jdks°t|ƒrt	|ƒ}t	|ƒ}|sÊ|r|rÒ|sÖdS | 
d¡}| 
d¡}	|  ||	¡súdS |sÀ|jdkrÀqqÀdS )NFTÚanyz...r   )Útag_compareÚtagÚtext_compareÚtextÚtailÚattribÚsortedÚkeysÚlenÚlistÚpopr+   )
r"   r,   r-   Z	want_keysZgot_keysÚkeyÚwant_childrenÚgot_childrenZ
want_firstZ	got_firstr   r   r   r+   }   s6    



zLXMLOutputChecker.compare_docsc                 C   s^   |pd}|pd}|r,t |ƒ ¡ }t |ƒ ¡ }dt |¡ }| dd¡}t ||¡rVdS dS d S )NÚ z^%s$z\.\.\.z.*TF)r   r   Úrer   Úreplacer7   )r"   r,   r-   r   r   r   r   r<   š   s    zLXMLOutputChecker.text_comparec                 C   sr   |dkrdS t |ttfƒr(t |ttfƒs0||kS |p6d}|p>d}| d¡rf| d¡d | d¡d kS ||kS d S )Nr9   TrH   z{...}Ú}éÿÿÿÿ)Ú
isinstanceÚstrÚbytesr3   Úsplit)r"   r,   r-   r   r   r   r:   §   s    ÿ
zLXMLOutputChecker.tag_comparec                 C   s  |j }|  |||¡}g }|d ur˜z||ƒ}W n. tjyZ   t ¡ d }| d| ¡ Y n0 z||ƒ}	W n. tjy–   t ¡ d }| d| ¡ Y n0 |d u s¤|rÐt | |||¡}
|rÌ| |
¡ d 	|¡S |
S |t
u }d|  ||d¡d|  |	|d¡d|  ||	|d¡g}d 	|¡S )	Né   zIn example: %szIn actual output: %sÚ
z	Expected:é   zGot:zDiff:)r,   r)   r   r*   ÚsysÚexc_infoÚappendr'   Úoutput_differenceÚjoinr   Ú
format_docÚcollect_diff)r"   Zexampler-   r.   r,   r/   Úerrorsr0   Úer1   Úvaluer   Z
diff_partsr   r   r   rW   µ   s>    ÿ

ûz#LXMLOutputChecker.output_differenceTc                 C   s.   |sdS |j | jvrdS |js&t|ƒr*dS dS )NFT)r;   Ú
empty_tagsr=   rB   )r"   Úelr   r   r   r   Úhtml_empty_tagÕ   s    z LXMLOutputChecker.html_empty_tagrH   c              	   C   sž  g }t |ƒsœ| d| ¡ | |¡ | |  |¡¡ |  ||¡slt|jƒr\| |  |j¡¡ | |  |¡¡ t|jƒrˆ| |  |j¡¡ | d¡ d 	|¡S | d| ¡ | |¡ | |  |¡¡ |  ||¡s^| d¡ t|jƒr| d| ¡ | |  |j¡¡ | d¡ |D ]}| |  
|||d ¡¡ q| d| ¡ | |  |¡¡ | d¡ t|jƒr”| d| ¡ | |  |j¡¡ | d¡ d 	|¡S )Nr   rR   rH   rS   )rB   rV   Ú
format_tagr`   r   r=   Úformat_textÚformat_end_tagr>   rX   rY   )r"   Údocr   ÚindentÚprefixÚpartsr_   r   r   r   rY   ß   s@    









zLXMLOutputChecker.format_docc                 C   s"   |d u rdS |r|  ¡ }t|dƒS )NrH   rQ   )r   Úhtml_escape)r"   r=   r   r   r   r   rb     s
    zLXMLOutputChecker.format_textc              	   C   sh   g }t |tjƒrdS t|j ¡ ƒD ]"\}}| d||  |d¡f ¡ q"|sTd|j S d|jd 	|¡f S )Nz<!--ú%s="%s"Fú<%s>ú<%s %s>r   )
rM   r   ÚCommentBaser@   r?   ÚitemsrV   rb   r;   rX   )r"   r_   ÚattrsÚnamer]   r   r   r   ra   	  s    
zLXMLOutputChecker.format_tagc                 C   s   t |tjƒrdS d|j S )Nz-->ú</%s>)rM   r   rl   r;   )r"   r_   r   r   r   rc     s    z LXMLOutputChecker.format_end_tagc              	   C   s  g }t |ƒs’t |ƒs’| d| ¡ | |  ||¡¡ |  ||¡sh| |  |j|j¡¡ | |  ||¡¡ | |  |j|j¡¡ | d¡ d |¡S | d| ¡ | |  ||¡¡ | d¡ t	|jƒsÐt	|jƒrþ| d| ¡ | |  |j|j¡¡ | d¡ t
|ƒ}t
|ƒ}|s|r˜|sD| |  | d¡||d d¡¡ q|sn| |  | d¡||d d¡¡ q| |  | d¡| d¡||d ¡¡ q| d| ¡ | |  ||¡¡ | d¡ t	|jƒsÚt	|jƒr| d| ¡ | |  |j|j¡¡ | d¡ d |¡S )Nr   rR   rH   r   rS   ú+ú-)rB   rV   Úcollect_diff_tagr`   Úcollect_diff_textr=   Úcollect_diff_end_tagr>   rX   r   rC   rY   rD   rZ   )r"   r,   r-   r   re   rg   rF   rG   r   r   r   rZ     sJ    



  ÿ


zLXMLOutputChecker.collect_diffc           	   	   C   s*  |   |j|j¡s"d|j|jf }n|j}g }|jdkp>d|jv }t|j ¡ ƒD ]p\}}||jvr€|s€| d||  |d¡f ¡ qN||jv r |  |j| |d¡}n|  |d¡}| d||f ¡ qN|st|j ¡ ƒD ].\}}||jv rèqÔ| d||  |d¡f ¡ qÔ|rd|d |¡f }nd	| }|S )
Nú%s (got: %s)r9   z+%s="%s"Fri   z-%s="%s"rk   r   rj   )	r:   r;   r?   r@   rm   rV   rb   rt   rX   )	r"   r,   r-   r;   rn   r9   ro   r]   r=   r   r   r   rs   @  s*    

z"LXMLOutputChecker.collect_diff_tagc                 C   s,   |j |j krd|j |j f }n|j }d| S )Nrv   rp   )r;   )r"   r,   r-   r;   r   r   r   ru   [  s    z&LXMLOutputChecker.collect_diff_end_tagc                 C   s:   |   |||¡r"|sdS |  ||¡S d||f }|  ||¡S )NrH   rv   )r<   rb   )r"   r,   r-   r   r=   r   r   r   rt   b  s    z#LXMLOutputChecker.collect_diff_textN)T)rH   )T)T)Ú__name__Ú
__module__Ú__qualname__r^   r#   r(   r)   r4   r+   r<   r:   rW   r`   rY   rb   ra   rc   rZ   rs   ru   rt   r   r   r   r   r   J   s$    


#
&r   c                   @   s   e Zd Zdd„ ZdS )r   c                 C   s   t S r   )r   r!   r   r   r   r#   k  s    z%LHTMLOutputChecker.get_default_parserN)rw   rx   ry   r#   r   r   r   r   r   j  s   r   c                 C   s   | rt t_ntt_dS )z£
    Install doctestcompare for all future doctests.

    If html is true, then by default the HTML parser will be used;
    otherwise the XML parser is used.
    N)r   Údoctestr'   r   r   r   r   r   r	   n  s    r	   c           	      C   s`   | r
t }nt}tƒ }|jd }|ƒ }|j}||_|jd j}|jj}tt_t	||||||ƒ dS )zÁ
    Use this *inside* a doctest to enable this checker for this
    doctest only.

    If html is true, then by default the HTML parser will be used;
    otherwise the XML parser is used.
    r"   ÚcheckN)
r   r   Ú_find_doctest_frameÚf_localsZ_checkerÚ__func__r(   r   rz   Ú_RestoreChecker)	r   Ú
del_moduleZCheckerÚframeÚdt_selfÚcheckerÚold_checkerÚ
check_funcZchecker_check_funcr   r   r   r
   z  s    

þr
   c                   @   sL   e Zd Zdd„ Zdd„ Zdd„ Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dS )r   c                 C   sD   || _ || _| j| j_|| j_|| _|| _|| _|  ¡  |  	¡  d S r   )
r‚   rƒ   Ú
call_superr&   r$   r…   Ú
clone_funcr€   Úinstall_cloneÚinstall_dt_self)r"   r‚   r„   Znew_checkerr…   r‡   r€   r   r   r   Ú__init__ž  s    
z_RestoreChecker.__init__c                 C   s$   | j j| _| j j| _| jj| j _d S r   )r…   Ú__code__Ú	func_codeÚ__globals__Zfunc_globalsr‡   r!   r   r   r   rˆ   ©  s    

z_RestoreChecker.install_clonec                 C   s   | j | j_d S r   )rŒ   r…   r‹   r!   r   r   r   Úuninstall_clone­  s    z_RestoreChecker.uninstall_clonec                 C   s   | j j| _| | j _d S r   )r‚   Ú_DocTestRunner__record_outcomeÚ	prev_funcr!   r   r   r   r‰   ¯  s    
z_RestoreChecker.install_dt_selfc                 C   s   | j | j_d S r   )r   r‚   r   r!   r   r   r   Úuninstall_dt_self²  s    z!_RestoreChecker.uninstall_dt_selfc                 C   sL   | j rHdd l}|j| j = d| j v rH| j  dd¡\}}|j| }t||ƒ d S )Nr   Ú.rQ   )r€   rT   ÚmodulesÚrsplitÚdelattr)r"   rT   ÚpackageÚmoduleZpackage_modr   r   r   Úuninstall_module´  s    


z _RestoreChecker.uninstall_modulec                 O   s8   |   ¡  |  ¡  | j`| j`| j|i |¤Ž}|  ¡  |S r   )rŽ   r‘   rƒ   r$   r&   r   r˜   )r"   ÚargsÚkwÚresultr   r   r   Ú__call__¼  s    z_RestoreChecker.__call__c                 O   s2   |   ¡  z| j|i |¤ŽW |  ¡  S |  ¡  0 d S r   )rŽ   r…   rˆ   )r"   r™   rš   r   r   r   r†   Ä  s    þz_RestoreChecker.call_superN)rw   rx   ry   rŠ   rˆ   rŽ   r‰   r‘   r˜   rœ   r†   r   r   r   r   r     s   r   c                  C   s<   dd l } |  d¡}|r0|j}d|v r(|S |j}qtdƒ‚d S )Nr   rQ   ZBOOMzBCould not find doctest (only use this function *inside* a doctest))rT   Ú	_getframer}   Úf_backÚLookupError)rT   r   Úlr   r   r   r|   Ë  s    
ÿr|   Úbasicai  
    >>> temp_install()
    >>> print """<xml a="1" b="2">stuff</xml>"""
    <xml b="2" a="1">...</xml>
    >>> print """<xml xmlns="http://example.com"><tag   attr="bar"   /></xml>"""
    <xml xmlns="...">
      <tag attr="..." />
    </xml>
    >>> print """<xml>blahblahblah<foo /></xml>""" # doctest: +NOPARSE_MARKUP, +ELLIPSIS
    <xml>...foo /></xml>
    Ú__main__)F)FN)"Ú__doc__Zlxmlr   rT   rI   rz   r   r   rh   ÚImportErrorÚcgiÚ__all__Zregister_optionflagr   r   r   r'   r   r   Ú
HTMLParserr   r   Úcompiler6   r   r   r   r	   r
   r   r|   Z__test__rw   Útestmodr   r   r   r   Ú<module>   s@   %




  "

#.ÿ
