o
    pjÉ:  ã                   @   s*  d Z ddlZddlmZ ddlmZ ddlmZ ddlm	Z	m
Z
 ddlmZmZ ddlmZ dd	lmZ dd
lmZ ddlmZmZmZ ddlmZmZ ddlmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$ G dd„ de
ƒZ%G dd„ de	ƒZ&G dd„ de
ƒZ'G dd„ de
ƒZ(G dd„ dej)ƒZ*G dd„ de	ƒZ+dS )z 
Tests for L{twisted.web.util}.
é    N)Údefer)ÚnetworkString)ÚFailure)ÚSynchronousTestCaseÚTestCase)ÚresourceÚutil)ÚFlattenerError)ÚFOUND)ÚRequest)Ú	TagLoaderÚflattenStringÚtags)ÚDummyChannelÚDummyRequest)	ÚDeferredResourceÚFailureElementÚParentRedirectÚ_FrameElementÚ_SourceFragmentElementÚ_SourceLineElementÚ_StackElementÚformatFailureÚ
redirectToc                   @   s0   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
S )ÚRedirectToTestsz"
    Tests for L{redirectTo}.
    c                 C   s^   t tƒ dƒ}d|_d}t||ƒ |  |jt¡ |  |j d¡|g¡ |  |j d¡dg¡ dS )z¾
        L{redirectTo} will set the C{Location} and C{Content-Type} headers on
        its request, and set the response code to C{FOUND}, so the browser will
        be redirected.
        Tó   GETs   http://target.example.com/4321s   locations   content-types   text/html; charset=utf-8N)	r   r   Úmethodr   ÚassertEqualÚcoder
   ÚresponseHeadersÚgetRawHeaders©ÚselfÚrequestÚ	targetURL© r%   ú</usr/lib/python3/dist-packages/twisted/web/test/test_util.pyÚtest_headersAndCode&   s   
ÿ
þz#RedirectToTests.test_headersAndCodec                 C   s*   t tƒ dƒ}d|_d}|  tt||¡ dS )zW
        L{redirectTo} will raise TypeError if unicode object is passed in URL
        Tr   zhttp://target.example.com/4321N)r   r   r   ÚassertRaisesÚ	TypeErrorr   r!   r%   r%   r&   Útest_redirectToUnicodeURL9   s   z)RedirectToTests.test_redirectToUnicodeURLc                 C   ó(   t dgƒ}td|ƒ}d}|  ||¡ dS )zq
        Legitimate URLs are fully interpolated in the `redirectTo` response body without transformation
        ó    s   https://twisted.org/sÚ   
<html>
    <head>
        <meta http-equiv="refresh" content="0;URL=https://twisted.org/">
    </head>
    <body bgcolor="#FFFFFF" text="#000000">
    <a href="https://twisted.org/">click here</a>
    </body>
</html>
N©r   r   r   ©r"   r#   ÚhtmlÚexpectedr%   r%   r&   Útest_legitimateRedirectB   s   


z'RedirectToTests.test_legitimateRedirectc                 C   r+   )zm
        Malicious URLs are HTML-escaped before interpolating them in the `redirectTo` response body
        r,   s?   https://twisted.org/"><script>alert(document.location)</script>sX  
<html>
    <head>
        <meta http-equiv="refresh" content="0;URL=https://twisted.org/&quot;&gt;&lt;script&gt;alert(document.location)&lt;/script&gt;">
    </head>
    <body bgcolor="#FFFFFF" text="#000000">
    <a href="https://twisted.org/&quot;&gt;&lt;script&gt;alert(document.location)&lt;/script&gt;">click here</a>
    </body>
</html>
Nr-   r.   r%   r%   r&   Útest_maliciousRedirectT   s   
ÿ
z&RedirectToTests.test_maliciousRedirectN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r'   r*   r1   r2   r%   r%   r%   r&   r   !   s    	r   c                   @   s6   e Zd ZdZdefdd„Zdd„ Zdd„ Zd	d
„ ZdS )ÚParentRedirectTestsz!
    Test L{ParentRedirect}.
    ÚrequestPathc                 C   sF   t tƒ dƒ}d|_| d¡ d¡|_tƒ }| |¡ |j 	d¡\}|S )zÉ
        Render a response to a request with path *requestPath*

        @param requestPath: A slash-separated path like C{b'/foo/bar'}.

        @returns: The value of the I{Location} header.
        Tr   ó   /s   Location)
r   r   r   ÚlstripÚsplitÚprepathr   Úrenderr   r    )r"   r8   r#   r   Úlocationr%   r%   r&   ÚdoLocationTestn   s   
z"ParentRedirectTests.doLocationTestc                 C   ó(   |   d|  d¡¡ |   d|  d¡¡ dS )zi
        At the URL root issue a redirect to the current URL, removing any query
        string.
        ó   http://10.0.0.1/r9   s   /?biff=baffN©r   r?   ©r"   r%   r%   r&   Útest_locationRoot€   s   z%ParentRedirectTests.test_locationRootc                 C   r@   )zt
        A request for a resource one level down from the URL root produces
        a redirect to the root.
        rA   s   /foos   /foo?bar=sproiiingNrB   rC   r%   r%   r&   Útest_locationToRootˆ   s   
ÿz'ParentRedirectTests.test_locationToRootc                 C   s:   |   d|  d¡¡ |   d|  d¡¡ |   d|  d¡¡ dS )zp
        Requests for resources directly under the path C{/foo/} produce
        redirects to C{/foo/}.
        s   http://10.0.0.1/foo/s   /foo/s   /foo/bars   /foo/bar?biz=bazNrB   rC   r%   r%   r&   Útest_locationUpOne’   s
   
ÿz&ParentRedirectTests.test_locationUpOneN)	r3   r4   r5   r6   Úbytesr?   rD   rE   rF   r%   r%   r%   r&   r7   i   s    
r7   c                   @   sh   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„ Zdd„ Zdd„ ZdS )ÚFailureElementTestszn
    Tests for L{FailureElement} and related helpers which can render a
    L{Failure} as an HTML string.
    c                 C   sR   dd„ }|j jd | _z|ƒ  W dS  ty(   tdd�| _| jjd | _Y dS w )zO
        Create a L{Failure} which can be used by the rendering tests.
        c                  S   s   d} t | ƒ‚)NzThis is a problem)Ú	Exception)Úmessager%   r%   r&   ÚlineNumberProbeAlsoBroken©   s   z<FailureElementTests.setUp.<locals>.lineNumberProbeAlsoBrokené   T)ÚcaptureVarséÿÿÿÿN)Ú__code__Úco_firstlinenoÚbaseÚBaseExceptionr   ÚfailureÚframesÚframe)r"   rK   r%   r%   r&   ÚsetUp¤   s   þzFailureElementTests.setUpc                 C   sN   t tt tjdd�tjdd�¡ƒddƒ}td|ƒ}d}| | j| d¡¡ |S )	zN
        L{_SourceLineElement} renders a source line and line number.
        Ú
lineNumber©r=   Ú
sourceLineé2   z    print 'hello'Nu:   <div><span>50</span><span> Â  Â print 'hello'</span></div>zutf-8)	r   r   r   ÚdivÚspanr   ÚaddCallbackr   Úencode)r"   ÚelementÚdr0   r%   r%   r&   Útest_sourceLineElement¶   s   ÿû
ÿz*FailureElementTests.test_sourceLineElementc           	      C   sÂ   t ttjtjdd�tjdd�dd�ƒ| jƒ}g d¢}td|ƒ}d}t|ƒD ]-\}}d}|d	krD|| dd
g|d	k | j	| d| ¡7 }q%|| d| j	| d| ¡7 }q%| 
d¡}| | j|¡ |S )zƒ
        L{_SourceFragmentElement} renders source lines at and around the line
        number indicated by a frame object.
        rW   rX   rY   ÚsourceLines)u#    Â  Â message = "This is a problem"u    Â  Â raise Exception(message)Ú Nrc   z?<div class="snippet{}Line"><span>{}</span><span>{}</span></div>rL   Ú	Highlightu    Â  Â  Â  Â Úutf8)r   r   r   r[   r\   rU   r   Ú	enumerateÚformatrQ   r^   r]   r   )	r"   r_   Úsourcer`   ÚstringToCheckForrW   rY   ÚtemplateÚbytesToCheckForr%   r%   r&   Útest_sourceFragmentElementÉ   s6   

ýÿø
ýÿ
z.FailureElementTests.test_sourceFragmentElementc                 C   sF   t ttjdd�ƒ| jƒ}td|ƒ}| | jdtt	 
d¡ƒ d ¡ |S )z­
        The I{filename} renderer of L{_FrameElement} renders the filename
        associated with the frame object used to initialize the
        L{_FrameElement}.
        ÚfilenamerX   Nó   <span>Úcó   </span>)r   r   r   r\   rU   r   r]   r   r   Ú__file__Úrstrip©r"   r_   r`   r%   r%   r&   Útest_frameElementFilenameó   s   
üz-FailureElementTests.test_frameElementFilenamec                 C   s@   t ttjdd�ƒ| jƒ}td|ƒ}| | jd| jd f ¡ |S )z²
        The I{lineNumber} renderer of L{_FrameElement} renders the line number
        associated with the frame object used to initialize the
        L{_FrameElement}.
        rW   rX   Ns   <span>%d</span>rL   )	r   r   r   r\   rU   r   r]   r   rQ   rs   r%   r%   r&   Útest_frameElementLineNumber  s   
z/FailureElementTests.test_frameElementLineNumberc                 C   s4   t ttjdd�ƒ| jƒ}td|ƒ}| | jd¡ |S )z°
        The I{function} renderer of L{_FrameElement} renders the line number
        associated with the frame object used to initialize the
        L{_FrameElement}.
        ÚfunctionrX   Ns&   <span>lineNumberProbeAlsoBroken</span>)r   r   r   r\   rU   r   r]   r   rs   r%   r%   r&   Útest_frameElementFunction  s   
z-FailureElementTests.test_frameElementFunctionc                 C   s\   t d| jƒ}| d¡}t ¡ }|d|ƒ}|  |t¡ |  |j| j¡ |  |g|j	 
¡ ¡ dS )zÓ
        The I{source} renderer of L{_FrameElement} renders the source code near
        the source filename/line number associated with the frame object used to
        initialize the L{_FrameElement}.
        Nrh   )r   rU   ÚlookupRenderMethodr   r[   ÚassertIsInstancer   ÚassertIdenticalr   ÚloaderÚload©r"   r_   ÚrendererÚtagÚresultr%   r%   r&   Útest_frameElementSource  s   

z+FailureElementTests.test_frameElementSourcec                 C   sÆ   t d| jjdd… ƒ}| d¡}t ¡ }|d|ƒ}|  |t¡ |  |d t¡ |  	|d j
| jjd ¡ |  |d t¡ |  	|d j
| jjd ¡ |  |d j ¡ |d j ¡ ¡ |  dt|ƒ¡ dS )zœ
        The I{frames} renderer of L{_StackElement} renders each stack frame in
        the list of frames used to initialize the L{_StackElement}.
        Né   rT   r   rL   )r   rS   rT   rx   r   r[   ry   Úlistr   rz   rU   ÚassertNotEqualr{   r|   r   Úlenr}   r%   r%   r&   Útest_stackElement'  s   

 z%FailureElementTests.test_stackElementc                 C   s\   t | jƒ}| d¡}t ¡ }|d|ƒ}|  |t¡ |  |j| jj	¡ |  
|g|j ¡ ¡ dS )zƒ
        The I{traceback} renderer of L{FailureElement} renders the failure's
        stack frames using L{_StackElement}.
        Ú	tracebackN)r   rS   rx   r   r[   ry   r   rz   ÚstackFramesrT   r   r{   r|   r}   r%   r%   r&   Útest_failureElementTraceback9  s   


z0FailureElementTests.test_failureElementTracebackc                 C   s@   t | jttjdd�ƒƒ}td|ƒ}d}| | jd| d ¡ |S )zi
        The I{type} renderer of L{FailureElement} renders the failure's
        exception type.
        ÚtyperX   Ns   builtins.Exceptionrn   rp   ©r   rS   r   r   r\   r   r]   r   )r"   r_   r`   Úexcr%   r%   r&   Útest_failureElementTypeF  s
   
z+FailureElementTests.test_failureElementTypec                 C   s4   t | jttjdd�ƒƒ}td|ƒ}| | jd¡ |S )zi
        The I{value} renderer of L{FailureElement} renders the value's exception
        value.
        ÚvaluerX   Ns   <span>This is a problem</span>r‹   rs   r%   r%   r&   Útest_failureElementValueQ  s   
z,FailureElementTests.test_failureElementValueN)r3   r4   r5   r6   rV   ra   rl   rt   ru   rw   r�   r†   r‰   r�   r�   r%   r%   r%   r&   rH   ž   s    *rH   c                   @   s    e Zd ZdZdd„ Zdd„ ZdS )ÚFormatFailureTestsz‰
    Tests for L{twisted.web.util.formatFailure} which returns an HTML string
    representing the L{Failure} instance passed to it.
    c                 C   s   |   tttƒ ¡ dS )z}
        If there is an error flattening the L{Failure} instance,
        L{formatFailure} raises L{FlattenerError}.
        N)r(   r	   r   ÚobjectrC   r%   r%   r&   Útest_flattenerErrorb  s   z&FormatFailureTests.test_flattenerErrorc                 C   sZ   zt dƒ‚ ty   ttƒ ƒ}Y nw |  |t¡ |  tdd„ |D ƒƒ¡ |  d|¡ dS )zÕ
        The return value of L{formatFailure} is a C{str} instance (not a
        C{unicode} instance) with numeric character references for any non-ASCII
        characters meant to appear in the output.
        zFake bugc                 s   s   � | ]}|d k V  qdS )é€   Nr%   )Ú.0Úchr%   r%   r&   Ú	<genexpr>u  s   € z7FormatFailureTests.test_returnsBytes.<locals>.<genexpr>s   &#160;N)	rI   rR   r   r   ry   rG   Ú
assertTrueÚallÚassertIn)r"   r€   r%   r%   r&   Útest_returnsBytesi  s   ÿz$FormatFailureTests.test_returnsBytesN)r3   r4   r5   r6   r’   rš   r%   r%   r%   r&   r�   \  s    r�   c                   @   s   e Zd Zdd„ Zdd„ ZdS )Ú
SDResourcec                 C   s
   || _ d S ©N)Údefault)r"   r�   r%   r%   r&   Ú__init__{  s   
zSDResource.__init__c                 C   s"   t  | j¡}t |¡}| ||¡S rœ   )r   Úsucceedr�   r   r   ÚgetChildWithDefault)r"   Únamer#   r`   r   r%   r%   r&   r    ~  s   
zSDResource.getChildWithDefaultN)r3   r4   r5   rž   r    r%   r%   r%   r&   r›   z  s    r›   c                   @   s(   e Zd ZdZdd„ Zdd„ Zdd„ ZdS )	ÚDeferredResourceTestsz(
    Tests for L{DeferredResource}.
    c                 C   sD   t  ¡ }d|_t|ƒ}tg d¢ƒ}t  ||¡ |  |jddg¡ d S )NrL   )ÚfooÚbarÚbazr¤   r¥   )r   ÚResourceÚisLeafr›   r   ÚgetChildForRequestr   Úpostpath)r"   ÚrÚsr`   r%   r%   r&   ÚtestDeferredResource‰  s   z*DeferredResourceTests.testDeferredResourcec                 C   sF   g }t g ƒ}|j|_t ¡ }tt |¡ƒ}| |¡ |  ||g¡ dS )z­
        L{DeferredResource} uses the request object's C{render} method to
        render the resource which is the result of the L{Deferred} being
        handled.
        N)	r   Úappendr=   r   r¦   r   r   rŸ   r   )r"   Úrenderedr#   r€   ÚdeferredResourcer%   r%   r&   Útest_render‘  s   
z!DeferredResourceTests.test_renderc                 C   sh   t g ƒ}| ¡ }ttƒ ƒ}tt |¡ƒ}| |¡ |  |  	|¡|¡ ~t
 ¡  |  t¡}|  |g ¡ dS )z°
        If the L{Deferred} fails, L{DeferredResource} reports the failure via
        C{processingFailed}, and does not cause an unhandled error to be
        logged.
        N)r   ÚnotifyFinishr   ÚRuntimeErrorr   r   Úfailr=   r   ÚfailureResultOfÚgcÚcollectÚflushLoggedErrors)r"   r#   r`   rS   r¯   Úerrorsr%   r%   r&   Útest_renderNoFailure   s   


z*DeferredResourceTests.test_renderNoFailureN)r3   r4   r5   r6   r¬   r°   r¹   r%   r%   r%   r&   r¢   „  s
    r¢   ),r6   rµ   Útwisted.internetr   Útwisted.python.compatr   Útwisted.python.failurer   Útwisted.trial.unittestr   r   Útwisted.webr   r   Útwisted.web.errorr	   Útwisted.web.httpr
   Útwisted.web.serverr   Útwisted.web.templater   r   r   Útwisted.web.test.requesthelperr   r   Útwisted.web.utilr   r   r   r   r   r   r   r   r   r   r7   rH   r�   r¦   r›   r¢   r%   r%   r%   r&   Ú<module>   s(   ,H5 ?
