Vhw dZddlZddlZddlZddlmZddlmZddlm 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/m0Z0ddl1m2Z2m3Z3m4Z4m5Z5ddl6m7Z7m8Z8m9Z9dZ:de;de8de;fdZ<Gdde)jzZ>Gdde)jzZ?Gdde)jzZ@Gdd e+ZAGd!d"e+ZBGd#d$e+ZCGd%d&e+ZDGd'd(ZEd)ZFGd*d+ejejZId,ee e eJfded-fd.ZKee9Gd/d0ZLGd1d2e+ZMd3ZNd4ZOeZPee9Gd5d6ZQee9Gd7d8ZRhd9ZSGd:d;ZTeTZU dAde8dee e#gd?fdeVf d@ZWy)BzG 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) IRenderableIRequestITemplateLoaderc dt|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)texts J/home/dcms/DCMS/lib/python3.12/site-packages/twisted/web/_template_util.py_PREr,,s6$<.''URLrequestreturnct|tstd|jdd|j	|ddt|j
djdiz}|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	TypeError	setHeaderredirectrdecodeencode)r.r/contents   r+
redirectTor;;sq(c5!+,,o'BCS		szz'*+227;GNr-c8eZdZdZdZdeffdZdZdZxZ	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}
    Turlc0t|||_yN)super__init__r>)selfr>	__class__s  r+rBzRedirect.__init__ns
r-c.t|j|Sr@)r;r>)rCr/s  r+renderzRedirect.renderrs$((G,,r-c|Sr@rCnamer/s   r+getChildzRedirect.getChildur-)
__name__
__module____qualname____doc__isLeafr4rBrFrK
__classcell__)rDs@r+r=r=ds%FE-r-r=c$eZdZdZdZdedefdZy)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/r0cttjj|j	jd}t
||S)zN
        Respond to all requests by redirecting to nearest directory.
        ascii)strrURLPathfromRequestherer9r;)rCr/r[s   r+rFzParentRedirect.renders>7??..w7<<>?FFwO$((r-N)rMrNrOrPrQr'r4rFrHr-r+rTrTys!$F)h)5)r-rTc2eZdZdZdZdZdZdZdZdZ	y)	DeferredResourcezT
    I wrap up a Deferred that will eventually result in a Resource
    object.
    rUcPtjj|||_yr@)rResourcerBd)rCr`s  r+rBzDeferredResource.__init__s""4(r-c|Sr@rHrIs   r+rKzDeferredResource.getChildrLr-c|jj|j|j|j|ddlm}|S)Nr)NOT_DONE_YET)r`addCallback_cbChild
addErrback_ebChildtwisted.web.serverrc)rCr/rcs   r+rFzDeferredResource.renders44=='2==dmmWU3r-cN|jtj||yr@)rFrgetChildForRequest)rCchildr/s   r+rezDeferredResource._cbChildsx225'BCr-c&|j|yr@)processingFailed)rCreasonr/s   r+rgzDeferredResource._ebChilds  (r-N)
rMrNrOrPrQrBrKrFrergrHr-r+r]r]s(
FD)r-r]c6eZdZdZdZedZedZy)_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.
    cLtj||||_||_yr@)rrBnumbersource)rCloaderrrrss    r+rBz_SourceLineElement.__init__s v&r-cF||jjddS)zA
        Render the line of source as a child of C{tag}.
        z  u  )rsreplacerCr/tags   r+
sourceLinez_SourceLineElement.sourceLines!
4;;&&t-BCDDr-c8|t|jS)z>
        Render the line number as a child of C{tag}.
        )rXrrrws   r+
lineNumberz_SourceLineElement.lineNumbers
3t{{#$$r-N)rMrNrOrPrBrryr{rHr-r+rprps6
EE%%r-rpc,eZdZdZdZdZedZy)_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.
    c>tj||||_yr@rrBframerCrtrs   r+rBz_SourceFragmentElement.__init__v&
r-c#K|jd}|jd}t|dz
|dzD]*}|tj||j	f,yw)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.
        rUN)rrange	linecachegetlinerstrip)rCfilenamer{snipLineNumbers    r+_getSourceLinesz&_SourceFragmentElement._getSourceLinessc::a=ZZ]
#JNJNC	YN!9#4#4X~#N#U#U#WXX	YsAA!c	#K|jD]N\}}|j}||jdk(rd}nd}t|did|i}t	|||Pyw)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"}.
        rsnippetHighlightLinesnippetLineclassNrH)rcloner	TagLoaderrp)rCr/rxr{rynewTagcssClassrts        r+sourceLinesz"_SourceFragmentElement.sourceLinessr'+&:&:&<	E"J
YY[FTZZ]*1(v<((;<=F$VZDD	EsA#A%N)rMrNrOrPrBrrrrHr-r+r}r}s(YEEr-r}cVeZdZdZdZedZedZedZedZ	y)
_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.
    c>tj||||_yr@rrs   r+rBz_FrameElement.__init__	rr-c,||jdS)zY
        Render the name of the file this frame references as a child of C{tag}.
        rUrrws   r+rz_FrameElement.filename

4::a=!!r-c>|t|jdS)zc
        Render the source line number this frame references as a child of
        C{tag}.
        r)rXrrws   r+r{z_FrameElement.lineNumbers3tzz!}%&&r-c,||jdS)zV
        Render the function name this frame references as a child of C{tag}.
        rrrws   r+functionz_FrameElement.functionrr-c@tt||jS)zn
        Render the source code surrounding the line this frame references,
        replacing C{tag}.
        )r}rrrws   r+rsz_FrameElement.source#s&indjjAAr-N)
rMrNrOrPrBrrr{rrsrHr-r+rrs^""''""BBr-rc&eZdZdZdZedZy)
_StackElementzW
    L{_StackElement} renders an L{IRenderable} which can render a list of frames.
    c>tj||||_yr@)rrBstackFrames)rCrtrs   r+rBz_StackElement.__init__1sv&&r-c	|jDcgc]%}tt|j|'c}Scc}w)zW
        Render the list of frames in this L{_StackElement}, replacing C{tag}.
        )rrrr)rCr/rxrs    r+framesz_StackElement.frames5s;GKFVFV
=BM)CIIK0%8
	

s*<N)rMrNrOrPrBrrrHr-r+rr,s '

r-rceZdZdZddedfdZddeedeedeefdZdeed	eeddfd
ZdeedeefdZ	y)
_NSContextzL
    A mapping from XML namespaces onto their prefixes in the document.
    Nparentc^||_|t|j|_yddi|_y)ze
        Pull out the parent's namespaces, if there's no parent then default to
        XML.
        Nz$http://www.w3.org/XML/1998/namespacexml)rrnss)rCrs  r+rBz_NSContext.__init__Ds-
;Fvzz;RDH>FDHr-kr`r0c:|jj||S)z\
        Get a prefix for a namespace.

        @param d: The default prefix value.
        )rget)rCrr`s   r+rz_NSContext.getOsxx||Aq!!r-vc<|jj||y)zH
        Proxy through to setting the prefix for the namespace.
        N)r__setitem__)rCrrs   r+rz_NSContext.__setitem__Ws	
Q"r-c8|jj|S)zH
        Proxy through to getting the prefix for the namespace.
        )r__getitem__)rCrs  r+rz_NSContext.__getitem__]sxx##A&&r-r@)
rMrNrOrPr
rBrXrrrrHr-r+rr?s}	Gx5	G"Xc]"x}"
"#Xc]#x}##'Xc]'x}'r-rz4http://twistedmatrix.com/ns/twisted.web.template/0.1c*eZdZdZdeefdZdeddfdZd"dZ	d"d	Z
d
ededdfdZd
eededdfdZd
eeddfdZ
deeefdeededdfdZdeddfdZdeeefdeeddfdZdedededdfdZdeddfdZd"dZd"dZd eddfd!Zy)#_ToStanzd
    A SAX parser which converts an XML document to the Twisted STAN
    Document Object Model.
    sourceFilenamec>||_t|_d|_y)zP
        @param sourceFilename: the filename the XML was loaded out of.
        FN)rr	prefixMapinCDATA)rCrs  r+rBz_ToStan.__init__ms-#r-locatorr0Nc||_y)zY
        Set the document locator, which knows about line and character numbers.
        N)r)rCrs  r+setDocumentLocatorz_ToStan.setDocumentLocatorusr-cPg|_|j|_g|_g|_y)z*
        Initialise the document.
        N)documentcurrentstack
xmlnsAttrsrCs r+
startDocumentz_ToStan.startDocument{s$$&
}} "
13r-cy)z!
        Document ended.
        NrHrs r+endDocumentz_ToStan.endDocumentr-targetdatacy)z6
        Processing instructions are ignored.
        NrH)rCrrs   r+processingInstructionz_ToStan.processingInstructionrr-prefixurict|j|_||j|<|tk(ry||jj	d|fy|jj	d|z|fy)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)rrTEMPLATE_NAMESPACErappend)rCrrs   r+startPrefixMappingz_ToStan.startPrefixMappingsi$DNN3$s$$>OO""GS>2OO""J$7#=>r-cP|jj}|Jd||_y)zb
        "Pops the stack" on the prefix mapping.

        Gets called after endElementNS.
        Nz$More prefix mapping ends than starts)rr)rCrrs   r+endPrefixMappingz_ToStan.endPrefixMappings,&&!I#II!r-namespaceAndNameqnameattrsc|j}|jj}|jj}|\}}|tk(rn|dk(rd}nf|dk(ra	|d}	t
|d|	|||}
|jj|
|jj|
|
j|_	yd}t|}t|jD]\}
}|
\}}|tk7r|dk(s|}||
=!t}|jD]4\\}}}|jj|}||}n|d	|}|||<6|tk(r|d
k(r|jst!dtdd
|vrt!dtdt#d||||}||jdj$|d
<|jj||j|_	y|j&r+|j)t|j&g|_|tk7r'|%|j|}||j|d	|}t#|tt+t,t.t0t2ft2f|||||}|jj||jj||j|_	y#t
$rd}	YwxYw)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)NrJ)rrr{columnNumberrF:attrz<{z}attr> as top-level elementrJz }attr> requires a name attribute)rFrr{r)
attributesrFrr{r)rr
getLineNumbergetColumnNumberrKeyErrorr%rrrchildrenrlistitemsrrAssertionErrorr$rrupdaterrrr4rX)rCrrrrr{rnsrJrslrForderedrrattrNSjustTheNamenonTemplateAttrsattrNsattrNamensPrefixattrKeyelrs                        r+startElementNSz_ToStan.startElementNSs &&\\//1
||335#D
##}$##$56G
.)#%)!-

!!"%##B'!{{e$)	DAq"#FK++h&AJ
	'=%,]]_	*!VX~~))&1H"%Jaz2()W%
	*##::$,--IJ--$,--NO!%)BCEDJJrN%%&6v&>?JJb!;;DL??##K$@A DO##^^B'F!..,-Qtf5
"WU5#:.346FG!%	
	

"B{{s ##G#sK''K65K6chc|jr|jdj|y|jj|y)zm
        Called when we receive some characters.  CDATA characters get passed
        through as is.
        rN)rrrr)rCrs  r+
charactersz_ToStan.characters)s6
<<JJrN!!"%Br-rJc|jj|jr|jdj|_y|j|_y)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)rCrJrs   r+endElementNSz_ToStan.endElementNS3s9
	

::::b>22DL==DLr-publicIdsystemIdcyz#
        DTDs are ignored.
        NrH)rCrJrrs    r+startDTDz_ToStan.startDTD>rr-argscyrrH)rCrs  r+endDTDz_ToStan.endDTDCrr-cHd|_|jjgy)zO
        We're starting to be in a CDATA element, make a note of this.
        TN)rrrrs r+
startCDATAz_ToStan.startCDATAHs

"r-cd|_dj|jj}|jjt
|y)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")rCcomments  r+endCDATAz_ToStan.endCDATAOs:
''$**..*+E'N+r-r:cL|jjt|y)z=
        Add an XML comment which we've encountered.
        N)rrr#)rCr:s  r+rz_ToStan.commentXs	
GG,-r-)r0N)rMrNrOrPr
rXrBrrrrrrrrrrrrrobjectrrrrrHr-r+rrgsJ
x}'d
4
Cst
?#?S?T?, x}  v#S/v#}v# 	v#

v#p S T 	)sCx	)#	)4	)SC34
Ft
,.s.t.r-rflrct}|jtjd|jtjd|jtj
d|jtjdtt|dd}|j||j||jtj||j||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.
    rrUrJN)r
setFeaturerfeature_validationfeature_namespacesfeature_external_gesfeature_external_pesrgetattrsetContentHandlersetEntityResolversetPropertyproperty_lexical_handlerparser)r	parserss   r+
_flatsaxParser_s]F
g00!4
g00!4
g22A6
g22A6FD)*A
Q
Q
w77;
LL::r-c8eZdZdZdeeeffdZdedfdZ	y)	XMLStringzH
    An L{ITemplateLoader} that loads and parses XML from a string.
    rct|ts|jd}tt	j
||_y)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)r3rXr8rioStringIO_loadedTemplate)rCrs  r+rBzXMLString.__init__}s4!S! A4A"++a.4Q"r-r0rc|jS)zM
        Return the document.

        @return: the loaded document.
        )rrs r+loadzXMLString.loads###r-N)
rMrNrOrPrrXr4rBrr!rHr-r+rrws-#%U
+#$d=)$r-rcXeZdZdZedZddZedZedZ	edZ
y)	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
        
      

      

        

          
          
        

      

    

  

  

    : 
  



Nc>tj||||_yr@)rrBfailure)rCr%rts   r+rBzFailureElement.__init__sv&r-cL|t|jjS)zA
        Render the exception type as a child of C{tag}.
        )rr%typerws   r+r'zFailureElement.types
%dll&7&7899r-cj|t|jjjdS)zB
        Render the exception value as a child of C{tag}.
        r)rXr%valuer9rws   r+r)zFailureElement.values)
3t||))*11&9::r-cTtt||jjS)z
        Render all the frames in the wrapped
        L{Failure}'s traceback stack, replacing
        C{tag}.
        )rrr%rrws   r+	tracebackzFailureElement.tracebacksYs^T\\-@-@AAr-r@)rMrNrOrPrrtrBrr'r)r+rHr-r+r#r#s^I	KFZ::;;BBr-r#cg}tdt|j|jt	|dt
r$|dj
djddS|djy)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.
    Nrr2rWxmlcharrefreplace)	r!r#addBothrr3r4r8r9raiseException)	myFailureresults  r+
formatFailurer2sjF$y12::6==I&)U#ay(//9LMM
1Ir-rUc*eZdZdZddZdedfdZy)rzJ
    An L{ITemplateLoader} that loads an existing flattenable object.
    rc||_y)z>
        @param tag: The object which will be loaded.
        Nrx)rCrxs  r+rBzTagLoader.__init__-s
#&.r-r0c|jgSr@r5rs r+r!zTagLoader.load5szr-N)rxr)rMrNrOrPrBrr!rHr-r+rr's/d=)r-rcReZdZdZdeefdZdedfdZde	fdZ
dedfdZy	)
XMLFilezF
    An L{ITemplateLoader} that loads and parses XML from a file.
    pathczt|tstjdtdd|_	||_y)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.r)category
stacklevelN)r3rwarningswarnDeprecationWarningr_path)rCr9s  r+rBzXMLFile.__init__?s>$)MM@+	
?C=$(
1r-r0rct|jtst|jS|jj	d5}t|cdddS#1swYyxYw)zP
        Read and parse the XML.

        @return: the loaded document.
        rN)r3r@rropen)rCfs  r+_loadDoczXMLFile._loadDocSsP$**h/ ,,%
($Q'
(
(
(sA  A)c"d|jdS)Nz)r@rs r+__repr__zXMLFile.__repr___sdjj^1--r-c\|j|j|_|jS)zl
        Return the document, first loading it if necessary.

        @return: the loaded document.
        )rrErs r+r!zXMLFile.loadbs*'#'==?D ###r-N)rMrNrOrPrrrBrrErXrHr!rHr-r+r8r89sE2Xc]2(
($}-
(.#.$d=)$r-r8>xabipqrubrdddldtemh1h2h3h4h5h6hrliolrprttdthtrttulbdibdobigcoldeldfndirdivimginskbdmapnavpresubsupvarwbrabbrareabasebodycitecodefontformheadhtmllinkmarkmenumetarubysampspantimeasideaudioembedrinputlabelmeterparamsmallstyletabletbodytfoottheadtitlevideoappletbuttoncanvascenterfigurefooterheaderhgroupiframekeygenlegendroptionoutputscriptselectrsstrikestrongacronymaddressarticlecaptioncommanddetailsisindexsectionsummarybasefontcolgroupdatalistfieldsetframesetnoframesnoscriptoptgroupprogresstextarea
blockquote
figcaptionc eZdZdZdedefdZy)_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}
    tagNamer0c|dk(rtdS|jd}|tvrtd|t|S)Nrr_zunknown tag )r$rVALID_HTML_TAG_NAMESAttributeError)rCrs  r+__getattr__z_TagFactory.__getattr__sFm#r7N..%.. <{!;<<7|r-N)rMrNrOrPrXr$rrHr-r+rrs33r-relementdoctype_failElementrcH|"j|jdtt|j}dtdtt
dffd}ddtdtdtfd	}|j||j|tS)
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
r%r0ctjd|tdd}|-|jr!Jt	|j
Sjdy)Nz/An error occurred while rendering the response.)r%sitesr
An error occurred while rendering the response.
)
_moduleLogr%rdisplayTracebacksr write)r%rrr/s  r+ebzrenderElement..eb%st=w		
w- 6 6+++7L$97==IIMMK
r-)r/r1r/c&|j|Sr@)finish)r1r/s  r+rzrenderElement..finish6s
r-)rr#r rr
rrr'rfr.rc)r/rrrr`rrs`  `   r+
renderElementrs(

g

e%'--0AG$ 8"7>v8&LLIIfr-)sN)XrPrrr=collectionsrrrtypingrrrr	r
rrr
rrrxml.saxrrxml.sax.xmlreaderrrzope.interfacertwisted.internet.deferrtwisted.loggerrtwisted.pythonrtwisted.python.failurertwisted.python.filepathrtwisted.python.reflectrtwisted.webrtwisted.web._elementrrtwisted.web._flattenrr r!twisted.web._stanr"r#r$r%twisted.web.iwebr&r'r(r,r4r;r_r=rTr]rpr}rrrrContentHandlerEntityResolverrrXrrr#r2rcrrr8rrtagsrrrHr-r+rs2
#)7&+!"*,5 2DD77CC(&E&H&&Rx  *)X&&):)x(()8%%<+EW+E\+BG+B\
G
&"'"'JLu.g$$g&<&<u.peBvJO,m1D0
_$$$6qBWqBh8
X

_"
_0$0$0$nyx0} 2=A	4
4
4e_48WIy$89:	4
4r-