U P|jwx@sdZddlZddlZddlZddlmZddlmZddlm Z m Z m Z m Z m Z mZmZmZmZmZmZddlmZmZddlmZmZddlmZdd lmZdd lmZdd l m!Z!dd l"m#Z#dd l$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+m,Z,ddl-m.Z.m/Z/m0Z0ddl1m2Z2m3Z3m4Z4m5Z5ddl6m7Z7m8Z8m9Z9ddZ:e;e8e;dddZGddde)j=Z?Gddde)j=Z@Gdd d e+ZAGd!d"d"e+ZBGd#d$d$e+ZCGd%d&d&e+ZDGd'd(d(ZEd)ZFGd*d+d+ejGejHZIee e eJfed,d-d.d/ZKee9Gd0d1d1ZLGd2d3d3e+ZMd4d5ZNd6ZOeZPee9Gd7d8d8ZQee9Gd9d:d:ZRd;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~ddddddddddddddddddddddddddddddddddddddddddddddddddddhxZSGdddZTeTZUde8e7ee;ee e#gdfeVdddZWdS)zG twisted.web.util and twisted.web.template merged to avoid cyclic deps N) OrderedDictescape) IOAnyAnyStrCallableDictListMappingOptionalTupleUnioncast)handler make_parser)AttributesNSImplLocator) implementer)Deferred)Logger)urlpath)Failure)FilePath)fullyQualifiedName)resource)Elementrenderer) Flattenableflatten flattenString)CDATACommentTagslot) IRenderableIRequestITemplateLoadercCsdt|dS)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
z
r)textr)>/tmp/pip-unpacked-wheel-audpp6lv/twisted/web/_template_util.py_PRE,sr+)URLrequestreturncCsHt|tstd|dd||ddt|ddi}|S)a
    Generate a redirect to the given location.

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

    @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{str} instead of L{bytes}.

    @return: A L{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)
    zURL must be bytessContent-Typestext/html; charset=utf-8s

    
        
    
    
    click here
    

surlutf-8)
isinstancebytes	TypeErrorZ	setHeaderredirectrdecodeencode)r,r-contentr)r)r*
redirectTo;s


r7cs:eZdZdZdZedfddZddZdd	ZZ	S)
Redirectz
    Resource that redirects to a specific URL.

    @ivar url: Redirect target URL to put in the I{Location} response header.
    @type url: L{bytes}
    T)urlcst||_dSN)super__init__r9)selfr9	__class__r)r*r<ns
zRedirect.__init__cCst|j|Sr:)r7r9)r=r-r)r)r*renderrszRedirect.rendercCs|Sr:r)r=namer-r)r)r*getChilduszRedirect.getChild)
__name__
__module____qualname____doc__isLeafr1r<r@rC
__classcell__r)r)r>r*r8ds
r8c@s$eZdZdZdZeedddZdS)ParentRedirectu
    Redirect to the nearest directory and strip any query string.

    This generates redirects like::

        /              →  /
        /foo           →  /
        /foo?bar       →  /
        /foo/          →  /foo/
        /foo/bar       →  /foo/
        /foo/bar?baz   →  /foo/

    However, the generated I{Location} header contains an absolute URL rather
    than a path.

    The response is the same regardless of HTTP method.
    )r-r.cCs$ttj|d}t||S)zN
        Respond to all requests by redirecting to nearest directory.
        ascii)strrZURLPathZfromRequestherer5r7)r=r-rNr)r)r*r@szParentRedirect.renderN)rDrErFrGrHr&r1r@r)r)r)r*rJysrJc@s<eZdZdZdZddZddZddZd	d
ZddZ	d
S)DeferredResourcezT
    I wrap up a Deferred that will eventually result in a Resource
    object.
    rKcCstj|||_dSr:)rResourcer<d)r=rQr)r)r*r<szDeferredResource.__init__cCs|Sr:r)rAr)r)r*rCszDeferredResource.getChildcCs*|j|j||j|ddlm}|S)Nr)NOT_DONE_YET)rQZaddCallback_cbChild
addErrback_ebChildZtwisted.web.serverrR)r=r-rRr)r)r*r@szDeferredResource.rendercCs|t||dSr:)r@rZgetChildForRequest)r=childr-r)r)r*rSszDeferredResource._cbChildcCs||dSr:)ZprocessingFailed)r=reasonr-r)r)r*rUszDeferredResource._ebChildN)
rDrErFrGrHr<rCr@rSrUr)r)r)r*rOsrOc@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:)rr<numbersource)r=loaderrYrZr)r)r*r<sz_SourceLineElement.__init__cCs||jddS)zA
        Render the line of source as a child of C{tag}.
        z  u  )rZreplacer=r-tagr)r)r*
sourceLinesz_SourceLineElement.sourceLinecCs|t|jS)z>
        Render the line number as a child of C{tag}.
        )rMrYr]r)r)r*
lineNumbersz_SourceLineElement.lineNumberN)rDrErFrGr<rr_r`r)r)r)r*rXs	
rXc@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||||_dSr:rr<framer=r[rcr)r)r*r<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.
        rKN)rcrange	linecachegetlinerstrip)r=filenamer`ZsnipLineNumberr)r)r*_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"}.
        reZsnippetHighlightLineZsnippetLineclassN)rkclonerc	TagLoaderrX)r=r-r^r`r_ZnewTagZcssClassr[r)r)r*sourceLinessz"_SourceFragmentElement.sourceLinesN)rDrErFrGr<rkrror)r)r)r*ras


rac@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||||_dSr:rbrdr)r)r*r<	sz_FrameElement.__init__cCs||jdS)zY
        Render the name of the file this frame references as a child of C{tag}.
        rKrcr]r)r)r*rj
sz_FrameElement.filenamecCs|t|jdS)zc
        Render the source line number this frame references as a child of
        C{tag}.
        re)rMrcr]r)r)r*r`sz_FrameElement.lineNumbercCs||jdS)zV
        Render the function name this frame references as a child of C{tag}.
        rrqr]r)r)r*functionsz_FrameElement.functioncCstt||jS)zn
        Render the source code surrounding the line this frame references,
        replacing C{tag}.
        )rarnrcr]r)r)r*rZ#sz_FrameElement.sourceN)
rDrErFrGr<rrjr`rrrZr)r)r)r*rps



rpc@s$eZdZdZddZeddZdS)
_StackElementzW
    L{_StackElement} renders an L{IRenderable} which can render a list of frames.
    cCst||||_dSr:)rr<stackFrames)r=r[rtr)r)r*r<1sz_StackElement.__init__csfdd|jDS)zW
        Render the list of frames in this L{_StackElement}, replacing C{tag}.
        csg|]}tt|qSr))rprnrm).0rcr^r)r*
:sz(_StackElement.frames..)rtr]r)rvr*frames5s
z_StackElement.framesN)rDrErFrGr<rrxr)r)r)r*rs,srsc@sveZdZdZdeddddZdeeeeeedddZeeeedd	d
dZeeeedd
dZ	dS)
_NSContextzL
    A mapping from XML namespaces onto their prefixes in the document.
    N)parentcCs*||_|dk	rt|j|_n
ddi|_dS)ze
        Pull out the parent's namespaces, if there's no parent then default to
        XML.
        Nz$http://www.w3.org/XML/1998/namespacexml)rzrnss)r=rzr)r)r*r<Dsz_NSContext.__init__)krQr.cCs|j||S)z\
        Get a prefix for a namespace.

        @param d: The default prefix value.
        )r|get)r=r}rQr)r)r*r~Osz_NSContext.get)r}vr.cCs|j||dS)zH
        Proxy through to setting the prefix for the namespace.
        N)r|__setitem__)r=r}rr)r)r*rWsz_NSContext.__setitem__)r}r.cCs|j|S)zH
        Proxy through to getting the prefix for the namespace.
        )r|__getitem__)r=r}r)r)r*r]sz_NSContext.__getitem__)N)N)
rDrErFrGrr<rMr~rrr)r)r)r*ry?s
 ryz4http://twistedmatrix.com/ns/twisted.web.template/0.1c@s(eZdZdZeedddZeddddZdd	d
dZ	dd	dd
Z
eeddddZeeeddddZeeddddZ
eeefeeeddddZeddddZeeefeeddddZeeedd d!d"Zedd#d$d%Zdd	d&d'Zdd	d(d)Zedd*d+d,ZdS)-_ToStanzd
    A SAX parser which converts an XML document to the Twisted STAN
    Document Object Model.
    )sourceFilenamecCs||_t|_d|_dS)zP
        @param sourceFilename: the filename the XML was loaded out of.
        FN)rry	prefixMapinCDATA)r=rr)r)r*r<msz_ToStan.__init__N)locatorr.cCs
||_dS)zY
        Set the document locator, which knows about line and character numbers.
        N)r)r=rr)r)r*setDocumentLocatorusz_ToStan.setDocumentLocatorr.cCsg|_|j|_g|_g|_dS)z*
        Initialise the document.
        N)documentcurrentstack
xmlnsAttrsr=r)r)r*
startDocument{sz_ToStan.startDocumentcCsdS)z!
        Document ended.
        Nr)rr)r)r*endDocumentsz_ToStan.endDocument)targetdatar.cCsdS)z6
        Processing instructions are ignored.
        Nr))r=rrr)r)r*processingInstructionsz_ToStan.processingInstruction)prefixurir.cCsTt|j|_||j|<|tkr"dS|dkr<|jd|fn|jd||fdS)z
        Set up the prefix mapping, which maps fully qualified namespace URIs
        onto namespace prefixes.

        This gets called before startElementNS whenever an C{xmlns} attribute
        is seen.
        Nxmlnszxmlns:%s)ryrTEMPLATE_NAMESPACErappend)r=rrr)r)r*startPrefixMappings	
z_ToStan.startPrefixMapping)rr.cCs"|jj}|dk	std||_dS)zb
        "Pops the stack" on the prefix mapping.

        Gets called after endElementNS.
        Nz$More prefix mapping ends than starts)rrzAssertionError)r=rrzr)r)r*endPrefixMappingsz_ToStan.endPrefixMapping)namespaceAndNameqnameattrsr.cCsd|j}|j}|j}|\}}|tkr|dkr8d}nh|dkrz|d}	Wntk
rdd}	YnXt|d|	|||d}
|j|
|j	|
|
j
|_	dSd}t|}t|
D],\}
}|
\}}|tkrq|dkr|}||
=qt}|
D]>\\}}}|j|}|dkr|}n|d	|}|||<q|tkr|d
kr|js`tdtdd
|krztdtdtd||||d}||jdj|d
<|j||j
|_	dS|jr|t|jg|_|tkr|dk	r|j|}|dk	r|j|d	|}t|ttttttftf|||||d}|j||j	||j
|_	dS)a]
        Gets called when we encounter a new xmlns attribute.

        @param namespaceAndName: a (namespace, name) tuple, where name
            determines which type of action to take, if the namespace matches
            L{TEMPLATE_NAMESPACE}.
        @param qname: ignored.
        @param attrs: attributes on the element being started.
        transparentr$)NdefaultN)NrB)rrjr`columnNumberr@:attrz<{z}attr> as top-level elementrBz }attr> requires a name attribute)r@rjr`r)
attributesr@rjr`r)rr
getLineNumbergetColumnNumberrKeyErrorr$rrrchildrenrlistitemsrr~rr#rrupdaterrrr1rM)r=rrrrjr`rnsrBrslr@Zorderedr}rZattrNSZjustTheNameZnonTemplateAttrsZattrNsattrNameZnsPrefixZattrKeyelrr)r)r*startElementNSs


	







z_ToStan.startElementNS)chr.cCs*|jr|jd|dS|j|dS)zm
        Called when we receive some characters.  CDATA characters get passed
        through as is.
        rN)rrrr)r=rr)r)r*
characters)sz_ToStan.characters)rBrr.cCs,|j|jr |jdj|_n|j|_dS)z
        A namespace tag is closed.  Pop the stack, if there's anything left in
        it, otherwise return to the document's namespace.
        rN)rpoprrr)r=rBrr)r)r*endElementNS3s
z_ToStan.endElementNS)rBpublicIdsystemIdr.cCsdSz#
        DTDs are ignored.
        Nr))r=rBrrr)r)r*startDTD>sz_ToStan.startDTD)argsr.cGsdSrr))r=rr)r)r*endDTDCsz_ToStan.endDTDcCsd|_|jgdS)zO
        We're starting to be in a CDATA element, make a note of this.
        TN)rrrrr)r)r*
startCDATAHsz_ToStan.startCDATAcCs*d|_d|j}|jt|dS)z
        We're no longer in a CDATA element.  Collect up the characters we've
        parsed and put them in a new CDATA object.
        FrN)rjoinrrrrr!)r=commentr)r)r*endCDATAOsz_ToStan.endCDATA)r6r.cCs|jt|dS)z=
        Add an XML comment which we've encountered.
        N)rrr")r=r6r)r)r*rXsz_ToStan.comment)rDrErFrGrrMr<rrrrrrrr
rrrrrobjectrrrrr)r)r)r*rgs(
x
	rr)flr.cCst}|tjd|tjd|tjd|tjdtt|dd}|	||
||tj||
||jS)z
    Perform a SAX parse of an XML document with the _ToStan class.

    @param fl: The XML document to be parsed.

    @return: a C{list} of Stan objects.
    rrKrBN)r
setFeaturerfeature_validationfeature_namespacesfeature_external_gesfeature_external_pesrgetattrsetContentHandlersetEntityResolversetPropertyproperty_lexical_handlerparser)rparsersr)r)r*
_flatsaxParse_s


rc@s8eZdZdZeeefdddZeddddZ	d	S)
	XMLStringzH
    An L{ITemplateLoader} that loads and parses XML from a string.
    )rcCs(t|ts|d}tt||_dS)z
        Run the parser on a L{io.StringIO} copy of the string.

        @param s: The string from which to load the XML.
        @type s: L{str}, or a UTF-8 encoded L{bytes}.
        utf8N)r0rMr4rioStringIO_loadedTemplate)r=rr)r)r*r<}s

zXMLString.__init__rrcCs|jS)zM
        Return the document.

        @return: the loaded document.
        )rrr)r)r*loadszXMLString.loadN)
rDrErFrGrrMr1r<r
rr)r)r)r*rws
rc@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:)rr<failure)r=rr[r)r)r*r<szFailureElement.__init__cCs|t|jjS)zA
        Render the exception type as a child of C{tag}.
        )rrtyper]r)r)r*rszFailureElement.typecCs|t|jjdS)zB
        Render the exception value as a child of C{tag}.
        r)rMrvaluer5r]r)r)r*rszFailureElement.valuecCstt||jjS)z
        Render all the frames in the wrapped
        L{Failure}'s traceback stack, replacing
        C{tag}.
        )rsrnrrxr]r)r)r*	tracebackszFailureElement.traceback)N)rDrErFrGrr[r<rrrrr)r)r)r*rs
M


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

    Consider using L{FailureElement} instead.

    @type myFailure: L{Failure}

    @rtype: L{bytes}
    @return: A string containing the HTML representation of the given failure.
    Nrr/rLxmlcharrefreplace)	r raddBothrr0r1r4r5ZraiseException)Z	myFailureresultr)r)r*
formatFailures
rrKc@s0eZdZdZddddZeddddZd	S)
rnzJ
    An L{ITemplateLoader} that loads an existing flattenable object.
    rrvcCs
||_dS)z>
        @param tag: The object which will be loaded.
        Nrv)r=r^r)r)r*r<-szTagLoader.__init__rcCs|jgSr:rvrr)r)r*r5szTagLoader.loadN)rDrErFrGr<r
rr)r)r)r*rn'srnc@sTeZdZdZeedddZeddddZe	dd	d
Z
eddddZd
S)XMLFilezF
    An L{ITemplateLoader} that loads and parses XML from a file.
    )pathcCs*t|tstjdtddd|_||_dS)zf
        Run the parser on a file.

        @param path: The file from which to load the XML.
        zhPassing filenames or file objects to XMLFile is deprecated since Twisted 12.1.  Pass a FilePath instead.re)category
stacklevelN)r0rwarningswarnDeprecationWarningr_path)r=rr)r)r*r<?s
zXMLFile.__init__rrc
CsBt|jtst|jS|jd}t|W5QRSQRXdS)zP
        Read and parse the XML.

        @return: the loaded document.
        rN)r0rrropen)r=fr)r)r*_loadDocSs
zXMLFile._loadDoccCsd|jdS)Nz)rrr)r)r*__repr___szXMLFile.__repr__cCs|jdkr||_|jS)zl
        Return the document, first loading it if necessary.

        @return: the loaded document.
        N)rrrr)r)r*rbs

zXMLFile.loadN)rDrErFrGrrr<r
rrMrrr)r)r)r*r9s
raZabbrZacronymaddressappletareaarticleasideaudiobbasebasefontZbdiZbdobig
blockquotebodybrbuttonZcanvascaptioncenterZcitecodecolcolgroupcommandZdatalistdddeldetailsdfndirdivdldtemembedfieldset
figcaptionfigurefontfooterformrcframeseth1h2h3h4h5h6headheaderhgrouphrhtmliiframeimginputZinsisindexkeygenZkbdlabelZlegendlilinkmapmarkmenumetaZmeternavnoframesnoscriptroloptgroupoptionoutputpparampreprogressqrprtrubyrZsampscriptsectionselectsmallrZspanstrikestrongstylesubsummarysuptabletbodytdtextareatfootththeadtimetitletrttuulvarvideowbrc@s eZdZdZeedddZdS)_TagFactorya
    A factory for L{Tag} objects; the implementation of the L{tags} object.

    This allows for the syntactic convenience of C{from twisted.web.template
    import tags; tags.a(href="linked-page.html")}, where 'a' can be basically
    any HTML tag.

    The class is not exposed publicly because you only ever need one of these,
    and we already made it for you.

    @see: L{tags}
    )tagNamer.cCs8|dkrtdS|d}|tkr0td|t|S)Nrr_zunknown tag )r#riVALID_HTML_TAG_NAMESAttributeError)r=rVr)r)r*__getattr__s
z_TagFactory.__getattr__N)rDrErFrGrMr#rZr)r)r)r*rUs
rUr)r-elementdoctype_failElementr.cs|dk	r|ddkr(tt|j}tttddfdd}dtttddd	}|||	|t
S)
a
    Render an element or other L{IRenderable}.

    @param request: The L{IRequest} being rendered to.
    @param element: An L{IRenderable} which will be rendered.
    @param doctype: A L{bytes} which will be written as the first line of
        the request, or L{None} to disable writing of a doctype.  The argument
        should not include a trailing newline and will default to the HTML5
        doctype C{''}.

    @returns: NOT_DONE_YET

    @since: 12.1
    N
)rr.csXtjd|dtdd}|dk	rF|jrFdk	s4tt|jSddSdS)Nz/An error occurred while rendering the response.)rsitesr
An error occurred while rendering the response.
)
_moduleLogrrZdisplayTracebacksrrwrite)rr`r^r-r)r*eb%szrenderElement..eb)r-)rr-r.cSs||Sr:)finish)rr-r)r)r*re6szrenderElement..finish)rbrrrrrrr&rTrrR)r-r\r]r^rQrdrer)rcr*
renderElements



rf)r[N)XrGrrgrcollectionsrrrtypingrrrrr	r
rrr
rrZxml.saxrrZxml.sax.xmlreaderrrZzope.interfacerZtwisted.internet.deferrZtwisted.loggerrZtwisted.pythonrZtwisted.python.failurerZtwisted.python.filepathrZtwisted.python.reflectrZtwisted.webrZtwisted.web._elementrrZtwisted.web._flattenrrr Ztwisted.web._stanr!r"r#r$Ztwisted.web.iwebr%r&r'r+r1r7rPr8rJrOrXrarprsryrContentHandlerEntityResolverrrMrrrrrRrarnrrXrUtagsrrfr)r)r)r*s`4
)..%y t8|