U s@g0@s@dZddlmZmZddlZddlmZddlmZm Z m Z m Z ddl m Z ddlmZddlmZmZmZmZdd lmZd d Zd d ZGdddejZGdddeZGdddejZGdddejZGdddeZGdddeZGdddeZGdddeZ GdddeZ!d d!Z"d dddddd!gZ#dS)"z0 An assortment of web server-related utilities. )divisionabsolute_importN)urlpath)_PY3unicode nativeStringescape)fullyQualifiedName)resource) TagLoader XMLStringElementrenderer) flattenStringcCsdt|fS)aK Wraps 
 tags around some text and HTML-escape it.

    This is here since once twisted.web.html was deprecated it was hard to
    migrate the html.PRE from current code to twisted.web.template.

    For new code consider using twisted.web.template.

    @return: Escaped text wrapped in 
 tags.
    @rtype: C{str}
    z

%s
)r)textr2/usr/lib/python3/dist-packages/twisted/web/util.py_PREsrcCsZt|trtd|dd||ddtt|ddi}t	rV|d}|S)a
    Generate a redirect to the given location.

    @param URL: A L{bytes} giving the location to which to redirect.
    @type URL: L{bytes}

    @param request: The request object to use to generate the redirect.
    @type request: L{IRequest} provider

    @raise TypeError: If the type of C{URL} a L{unicode} instead of L{bytes}.

    @return: A C{bytes} containing HTML which tries to convince the client agent
        to visit the new location even if it doesn't respect the I{FOUND}
        response code.  This is intended to be returned from a render method,
        eg::

            def render_GET(self, request):
                return redirectTo(b"http://example.com/", request)
    z!Unicode object not allowed as URLsContent-Typestext/html; charset=utf-8z

    
        
    
    
    click here
    

urlutf-8utf8)

isinstancer	TypeErrorZ	setHeaderZredirectrrdecodeencoder)ZURLrequestZcontentrrr
redirectTo(s

	

rc@s(eZdZdZddZddZddZdS)	RedirectTcCstj|||_dSN)r
Resource__init__rselfrrrrr RszRedirect.__init__cCst|j|Sr)rrr"rrrrrenderVszRedirect.rendercCs|Srrr"namerrrrgetChildYszRedirect.getChildN)__name__
__module____qualname__isLeafr r$r'rrrrrOsrc@s eZdZdZddZddZdS)ChildRedirectorrcCs>|ddkr.|ds.|ds.td|t||dS)Nz://z../zvIt seems you've given me a redirect (%s) that is a child of myself! That's not good, it'll cause an infinite redirect.)find
startswith
ValueErrorrr r!rrrr _szChildRedirector.__init__cCs(|j}|ds|d7}||7}t|S)Nr.)rendswithr,)r"r&rZnewUrlrrrr'gs

zChildRedirector.getChildN)r(r)r*r+r r'rrrrr,]sr,c@s$eZdZdZdZddZddZdS)ParentRedirectz'
    I redirect to URLPath.here().
    cCsttj||Sr)rrZURLPathZfromRequestherer#rrrr$tszParentRedirect.rendercCs|Srrr#rrrr'wszParentRedirect.getChildN)r(r)r*__doc__r+r$r'rrrrr3osr3c@s<eZdZdZdZddZddZddZd	d
ZddZ	d
S)DeferredResourcezT
    I wrap up a Deferred that will eventually result in a Resource
    object.
    r4cCstj|||_dSr)r
rr d)r"r8rrrr szDeferredResource.__init__cCs|Srrr%rrrr'szDeferredResource.getChildcCs*|j|j||j|ddlm}|S)Nr)NOT_DONE_YET)r8ZaddCallback_cbChildZ
addErrback_ebChildZtwisted.web.serverr9)r"rr9rrrr$szDeferredResource.rendercCs|t||dSr)r$r
ZgetChildForRequest)r"Zchildrrrrr:szDeferredResource._cbChildcCs||dSr)ZprocessingFailed)r"reasonrrrrr;szDeferredResource._ebChildN)
r(r)r*r6r+r r'r$r:r;rrrrr7{sr7c@s0eZdZdZddZeddZeddZdS)	_SourceLineElementa
    L{_SourceLineElement} is an L{IRenderable} which can render a single line of
    source code.

    @ivar number: A C{int} giving the line number of the source code to be
        rendered.
    @ivar source: A C{str} giving the source code to be rendered.
    cCst||||_||_dSr)r
r numbersource)r"loaderr>r?rrrr sz_SourceLineElement.__init__cCs||jddS)zA
        Render the line of source as a child of C{tag}.
        z  u  )r?replacer"rtagrrr
sourceLinesz_SourceLineElement.sourceLinecCs|t|jS)z>
        Render the line number as a child of C{tag}.
        )strr>rBrrr
lineNumbersz_SourceLineElement.lineNumberN)r(r)r*r6r rrDrFrrrrr=s
r=c@s,eZdZdZddZddZeddZdS)	_SourceFragmentElementa
    L{_SourceFragmentElement} is an L{IRenderable} which can render several lines
    of source code near the line number of a particular frame object.

    @ivar frame: A L{Failure}-style frame object
        for which to load a source line to render.  This is really a tuple
        holding some information from a frame object.  See
        L{Failure.frames} for specifics.
    cCst||||_dSrr
r framer"r@rIrrrr sz_SourceFragmentElement.__init__ccsF|jd}|jd}t|d|dD]}|t||fVq&dS)a$
        Find the source line references by C{self.frame} and yield, in source
        line order, it and the previous and following lines.

        @return: A generator which yields two-tuples.  Each tuple gives a source
            line number and the contents of that source line.
        r4N)rIrange	linecachegetlinerstrip)r"filenamerFZsnipLineNumberrrr_getSourceLiness

z&_SourceFragmentElement._getSourceLinesccsV|D]H\}}|}||jdkr,d}nd}t|fd|i}t|||VqdS)z
        Render the source line indicated by C{self.frame} and several
        surrounding lines.  The active line will be given a I{class} of
        C{"snippetHighlightLine"}.  Other lines will be given a I{class} of
        C{"snippetLine"}.
        rKZsnippetHighlightLineZsnippetLineclassN)rQclonerIrr=)r"rrCrFrDZnewTagZcssClassr@rrrsourceLinessz"_SourceFragmentElement.sourceLinesN)r(r)r*r6r rQrrTrrrrrGs
	rGc@sHeZdZdZddZeddZeddZedd	Zed
dZ	dS)

_FrameElementa
    L{_FrameElement} is an L{IRenderable} which can render details about one
    frame from a L{Failure}.

    @ivar frame: A L{Failure}-style frame object
        for which to load a source line to render.  This is really a tuple
        holding some information from a frame object.  See
        L{Failure.frames} for specifics.
    cCst||||_dSrrHrJrrrr sz_FrameElement.__init__cCs||jdS)zY
        Render the name of the file this frame references as a child of C{tag}.
        r4rIrBrrrrPsz_FrameElement.filenamecCs|t|jdS)zc
        Render the source line number this frame references as a child of
        C{tag}.
        rK)rErIrBrrrrFsz_FrameElement.lineNumbercCs||jdS)zV
        Render the function name this frame references as a child of C{tag}.
        rrVrBrrrfunctionsz_FrameElement.functioncCstt||jS)zn
        Render the source code surrounding the line this frame references,
        replacing C{tag}.
        )rGrrIrBrrrr?sz_FrameElement.sourceN)
r(r)r*r6r rrPrFrWr?rrrrrUs	


rUc@s$eZdZdZddZeddZdS)
_StackElementzW
    L{_StackElement} renders an L{IRenderable} which can render a list of frames.
    cCst||||_dSr)r
r stackFrames)r"r@rYrrrr sz_StackElement.__init__csfdd|jDS)zW
        Render the list of frames in this L{_StackElement}, replacing C{tag}.
        csg|]}tt|qSr)rUrrS).0rIrCrr
(sz(_StackElement.frames..)rYrBrr[rframes#s
z_StackElement.framesN)r(r)r*r6r rr]rrrrrXsrXc@sFeZdZdZedZdddZeddZedd	Z	ed
dZ
dS)
FailureElementa
    L{FailureElement} is an L{IRenderable} which can render detailed information
    about a L{Failure}.

    @ivar failure: The L{Failure} instance which
        will be rendered.

    @since: 12.1
    ao


  

  

    : 
  

  

    

      

        : in
        
      

      

        

          
          
        

      

    

  

  

    : 
  



NcCst||||_dSr)r
r failure)r"r_r@rrrr szFailureElement.__init__cCs|t|jjS)zA
        Render the exception type as a child of C{tag}.
        )r	r_typerBrrrr`szFailureElement.typecCs|t|jjdS)zB
        Render the exception value as a child of C{tag}.
        r)rr_valuerrBrrrraszFailureElement.valuecCstt||jjS)z
        Render all the frames in the wrapped
        L{Failure}'s traceback stack, replacing
        C{tag}.
        )rXrr_r]rBrrr	tracebackszFailureElement.traceback)N)r(r)r*r6rr@r rr`rarbrrrrr^/s	K


r^cCsNg}tdt||jt|dtr>|ddddS|ddS)a
    Construct an HTML representation of the given failure.

    Consider using L{FailureElement} instead.

    @type myFailure: L{Failure}

    @rtype: C{bytes}
    @return: A string containing the HTML representation of the given failure.
    Nrrasciixmlcharrefreplace)	rr^ZaddBothappendrbytesrrZraiseException)Z	myFailureresultrrr
formatFailures
rh)$r6Z
__future__rrrMZtwisted.pythonrZtwisted.python.compatrrrrZtwisted.python.reflectr	Ztwisted.webr
Ztwisted.web.templaterrr
rrrrrrr,r3r7r=rGrUrXr^rh__all__rrrrs8' 12u