+ DfjwLRt^RIt^RIt^RIt^RIHt^RIHt^RIH t H t H t H t H t HtHtHtHtHtHt^RIHtHt^RIHtHt^RIHt^RIHt^R IHt^R I H!t!^R I"H#t#^R I$H%t%^R I&H't'^RI(H)t)^RI*H+t+H,t,^RI-H.t.H/t/H0t0^RI1H2t2H3t3H4t4H5t5^RI6H7t7H8t8H9t9Rt:RRlt;!RR])Px4t=!RR])Px4t>!RR])Px4t?!RR]+4t@!RR]+4tA!R R!]+4tB!R"R#]+4tC!R$R%4tDR&tE!R'R(]P]P4tHR)R*ltI]!]94!R+R,44tJ!R-R.]+4tKR/tL^tM]!4tN]!]94!R0R144tO]!]94!R2R344tP0R4kR5kR6kR7kR8kR9kR:kR;kRkR?kR@kRAkRBkRCkRDkREkRFkRGkRHkRIkRJkRKkRLkRMkRNkROkRPkRQkRRkRSkRTkRUkRVkRWkRXkRYkRZkR[kR\kR]kR^kR_kR`kRakRbkRckRdkRekRfkRgkRhkRikRjkRkkRlkRmkRnkRokRpkRqkRrkRskRtkRukRvkRwkRxkRykRzkR{kR|kR}kR~kRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRktQ!RR4tR]R!4tSRRRlltTR#)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) IRenderableIRequestITemplateLoaderc R\V4 R2#)a/ 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&} 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)
isinstancer2	TypeError	setHeaderredirectrdecodeencode)r/r0contents&& r*
redirectTor>;st(c5!!+,,o'BCS		szz'*+227;GNr,cRaa]tRt^dtoRtRtV3RlV3RlltRtRtRt	Vt
V;t#)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}
Tc <V^8dQhRS[/#)r.url)r2)r3
__classdict__s"r*r4Redirect.__annotate__nsEr,c0<\SV`4WnR#N)super__init__rB)selfrB	__class__s&&r*rHRedirect.__init__ns
r,c.\VPV4#rF)r>rB)rIr0s&&r*renderRedirect.renderrs$((G,,r,cV#rFrInamer0s&&&r*getChildRedirect.getChildur,)rB)__name__
__module____qualname____firstlineno____doc__isLeafrHrMrS__static_attributes____classdictcell__
__classcell__)rJrCs@@r*r@r@ds*F-r,r@c:a]tRt^ytoRt^tV3RlRltRtVtR#)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.
c&<V^8dQhRS[RS[/#)r.r0r1)r&r2)r3rCs"r*r4ParentRedirect.__annotate__s))h)5)r,c\\PPV4P	44PR4p\
W!4#)z>
Respond to all requests by redirecting to nearest directory.
ascii)strrURLPathfromRequestherer<r>)rIr0rhs&& r*rMParentRedirect.renders<7??..w7<<>?FFwO$((r,rPN)	rVrWrXrYrZr[rMr\r]rCs@r*r`r`ys$F))r,r`cFa]tRt^toRt^tRtRtRtRt	Rt
RtVtR#)	DeferredResourcezH
I wrap up a Deferred that will eventually result in a Resource
object.
cP\PPV4WnR#rF)rResourcerHd)rIros&&r*rHDeferredResource.__init__s""4(r,cV#rFrPrQs&&&r*rSDeferredResource.getChildrUr,cVPPVPV4PVPV4^RIHpV#))NOT_DONE_YET)roaddCallback_cbChild
addErrback_ebChildtwisted.web.serverru)rIr0rus&& r*rMDeferredResource.renders44=='2==dmmWU3r,cPVP\P!W44R#rF)rMrgetChildForRequest)rIchildr0s&&&r*rwDeferredResource._cbChildsx225BCr,c(VPV4R#rF)processingFailed)rIreasonr0s&&&r*ryDeferredResource._ebChilds  (r,)roN)
rVrWrXrYrZr[rHrSrMrwryr\r]rjs@r*rlrls0
FD))r,rlcJa]tRt^toRtRt]R4t]R4tRt	Vt
R#)_SourceLineElementz
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.
cJ\P!W4W nW0nR#rF)rrHnumbersource)rIloaderrrs&&&&r*rH_SourceLineElement.__init__s&r,cFV!VPPRR44#)z1
Render the line of source as a child of C{tag}.
z  u  )rreplacerIr0tags&&&r*
sourceLine_SourceLineElement.sourceLines!
4;;&&t-BCDDr,c8V!\VP44#)z.
Render the line number as a child of C{tag}.
)rerrs&&&r*
lineNumber_SourceLineElement.lineNumbers
3t{{#$$r,)rrN)rVrWrXrYrZrHrrrr\r]rjs@r*rrs9
EE%%r,rc@a]tRt^toRtRtRt]R4tRt	Vt
R#)_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>\P!W4W nR#rFrrHframerIrrs&&&r*rH_SourceFragmentElement.__init__&
r,c#"VP^,pVP^,p\V^,
V^,4F+pV\P!W4P	43xK-	R#5i)z
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.
N)rrange	linecachegetlinerstrip)rIfilenamersnipLineNumbers&   r*_getSourceLines&_SourceFragmentElement._getSourceLinessZ::a=ZZ]
#JNJNCN!9#4#4X#N#U#U#WXXDsA2A4c	#"VP4FRwr4VP4pW0P^,8XdRpMRp\V!R/RV/B4p\	WsV4xKT	R#5i)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"}.
snippetHighlightLinesnippetLineclassNrP)rcloner	TagLoaderr)rIr0rrrnewTagcssClassrs&&&     r*sourceLines"_SourceFragmentElement.sourceLinessd'+&:&:&<"JYY[FZZ]*1(v<((;<=F$VDD'=sA)A+rN)rVrWrXrYrZrHrrrr\r]rjs@r*rrs+YEEr,rcja]tRt^toRtRt]R4t]R4t]R4t	]R4t
RtVtR#)	
_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>\P!W4W nR#rFrrs&&&r*rH_FrameElement.__init__	rr,c4V!VP^,4#)zI
Render the name of the file this frame references as a child of C{tag}.
rrs&&&r*r_FrameElement.filename

4::a=!!r,cFV!\VP^,44#)zK
Render the source line number this frame references as a child of
C{tag}.
)rerrs&&&r*r_FrameElement.lineNumbers3tzz!}%&&r,c4V!VP^,4#)zF
Render the function name this frame references as a child of C{tag}.
rrs&&&r*function_FrameElement.functionrr,c@\\V4VP4#)zV
Render the source code surrounding the line this frame references,
replacing C{tag}.
)rrrrs&&&r*r_FrameElement.source#s&indjjAAr,rN)
rVrWrXrYrZrHrrrrrr\r]rjs@r*rrsa""''""BBr,rc:a]tRtRtoRtRt]R4tRtVt	R#)
_StackElementi,zO
L{_StackElement} renders an L{IRenderable} which can render a list of frames.
c>\P!W4W nR#rF)rrHstackFrames)rIrrs&&&r*rH_StackElement.__init__1s&&r,c	VPUu.uF&p\\VP44V4NK(	up#uupi)zG
Render the list of frames in this L{_StackElement}, replacing C{tag}.
)rrrr)rIr0rrs&&& r*frames_StackElement.frames5s@GKFVFV
FVUM)CIIK0%8FV
	

s,>)rN)
rVrWrXrYrZrHrrr\r]rjs@r*rr,s#'

r,rcta]tRtRtoRtR
V3RlRlltR
V3RlRlltV3RlR	ltV3R
lRltRt	Vt
R#)
_NSContexti?zD
A mapping from XML namespaces onto their prefixes in the document.
Nc.<V^8dQhRS[R,/#)r.parentr)r)r3rCs"r*r4_NSContext.__annotate__Ds	G	Gx5	Gr,cdWnVe\VP4VnR#RR/VnR#)zM
Pull out the parent's namespaces, if there's no parent then default to
XML.
Nz$http://www.w3.org/XML/1998/namespacexml)rrnss)rIrs&&r*rH_NSContext.__init__Ds+
;Fvzz;RDH>FDHr,c\<V^8dQhRS[S[,RS[S[,RS[S[,/#)r.kror1rre)r3rCs"r*r4rOs.""Xc]"x}"
"r,c8VPPW4#)zD
Get a prefix for a namespace.

@param d: The default prefix value.
)rget)rIrros&&&r*r_NSContext.getOsxx||A!!r,cJ<V^8dQhRS[S[,RS[S[,RR/#)r.rvr1Nr)r3rCs"r*r4rWs*##Xc]#x}##r,c<VPPW4R#)z8
Proxy through to setting the prefix for the namespace.
N)r__setitem__)rIrrs&&&r*r_NSContext.__setitem__Ws	
Q"r,cF<V^8dQhRS[S[,RS[S[,/#)r.rr1r)r3rCs"r*r4r]s#''Xc]'x}'r,c8VPPV4#)z8
Proxy through to getting the prefix for the namespace.
)r__getitem__)rIrs&&r*r_NSContext.__getitem__]sxx##A&&r,)rrrF)rVrWrXrYrZrHrrrr\r]rjs@r*rr?s4	G	G""##''r,rz4http://twistedmatrix.com/ns/twisted.web.template/0.1c2a]tRtRtoRtV3RlRltV3RlRltV3RlRltV3R	lR
ltV3RlRlt	V3R
lRlt
V3RlRltV3RlRltV3RlRlt
V3RlRltV3RlRltV3RlRltV3RlRltV3RlRltV3RlR ltR!tVtR"#)#_ToStanigzX
A SAX parser which converts an XML document to the Twisted STAN
Document Object Model.
c0<V^8dQhRS[S[,/#)r.sourceFilenamer)r3rCs"r*r4_ToStan.__annotate__msx}r,c>Wn\4VnRVnR#)z@
@param sourceFilename: the filename the XML was loaded out of.
FN)rr	prefixMapinCDATA)rIrs&&r*rH_ToStan.__init__ms-#r,c$<V^8dQhRS[RR/#)r.locatorr1N)r)r3rCs"r*r4rus'dr,cWnR#)zI
Set the document locator, which knows about line and character numbers.
N)r)rIrs&&r*setDocumentLocator_ToStan.setDocumentLocatorus	r,c<V^8dQhRR/#r.r1NrP)r3rCs"r*r4r{s
4
4t
4r,cR.VnVPVn.Vn.VnR#)z
Initialise the document.
N)documentcurrentstack
xmlnsAttrsrIs&r*
startDocument_ToStan.startDocument{s$$&
}} "
13r,c<V^8dQhRR/#rrP)r3rCs"r*r4rsTr,cR#)z
Document ended.
NrPrs&r*endDocument_ToStan.endDocumentr,c*<V^8dQhRS[RS[RR/#)r.targetdatar1Nre)r3rCs"r*r4rs"Cstr,cR#)z&
Processing instructions are ignored.
NrP)rIrrs&&&r*processingInstruction_ToStan.processingInstructionrr,c:<V^8dQhRS[S[,RS[RR/#)r.prefixurir1Nr)r3rCs"r*r4rs&??#?S?T?r,c\VP4VnWPV&V\8XdR#Vf VPP	RV34R#VPP	RV,V34R#)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)rIrrs&&&r*startPrefixMapping_ToStan.startPrefixMappingsg$DNN3$s$$>OO""GS>2OO""J$7#=>r,c4<V^8dQhRS[S[,RR/#)r.rr1Nr)r3rCs"r*r4rs  x}  r,cTVPPpVfQR4hW nR#)zJ
"Pops the stack" on the prefix mapping.

Gets called after endElementNS.
Nz$More prefix mapping ends than starts)rr)rIrrs&& r*endPrefixMapping_ToStan.endPrefixMappings*&&!I#II!r,cV<V^8dQhRS[S[S[3,RS[S[,RS[RR/#)r.namespaceAndNameqnameattrsr1N)r
rerr)r3rCs"r*r4rsEv#v#S/v#}v# 	v#

v#r,cVPpVPP4pVPP4pVwrxV\8Xd|VR8XdRpMqVR8XdkVR,p	\
VR,V	VVVR7p
VPPV
4VPPV
4V
PVn	R#Rp\V4p\VP44F$wrV
wppV\8wdKVR8XgK TpWK&	\4pVP4F7wwpppVPPV4pVfTpMVRV2pVVV&K9	V\8XdVR	8XdVP'g\!R
\R24hRV9d\!R
\R24h\#RVVVVR
7pVVPR,P$VR,&VPPV4VPVn	R#VP&'d,VP)\VP&44.VnV\8wd4Ve0VPV,pVeVPV,RV2p\#V\\+\,\.\0\23,\23,V44VVVVR7pVPPV4VPPV4VPVn	R# \
dRp	ELi;i)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$NrR)defaultrrcolumnNumberrM:attrz<{z}attr> as top-level elementz }attr> requires a name attribute)rMrrr)
attributesrMrrr)Nr)NrR)rr
getLineNumbergetColumnNumberrKeyErrorr$rrrchildrenrlistitemsrrAssertionErrorr#rrupdaterrrr2re)rIrrrrrrnsrRrslrMorderedrrattrNSjustTheNamenonTemplateAttrsattrNsattrNamensPrefixattrKeyelrs&&&&                    r*startElementNS_ToStan.startElementNSs &&\\//1
||335#
##}$##$56G
.)#%)!-

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

"B{{s ##G#s"	L22
MMc$<V^8dQhRS[RR/#)r.chr1Nr)r3rCs"r*r4r)s  S T r,cVP'd%VPR,PV4R#VPPV4R#)zU
Called when we receive some characters.  CDATA characters get passed
through as is.
Nr)rrrr)rIr2s&&r*
characters_ToStan.characters)s8
<<<JJrN!!"%Br,cP<V^8dQhRS[S[S[3,RS[S[,RR/#)r.rRrr1N)r
rer)r3rCs"r*r4r3s.	)	)sCx	)#	)4	)r,cVPP4VP'd%VPR,PVnR#VPVnR#)zz
A namespace tag is closed.  Pop the stack, if there's anything left in
it, otherwise return to the document's namespace.
Nr)rpoprrr)rIrRrs&&&r*endElementNS_ToStan.endElementNS3s;
	

:::::b>22DL==DLr,c0<V^8dQhRS[RS[RS[RR/#)r.rRpublicIdsystemIdr1Nr)r3rCs"r*r4r>s)SC34r,cR#z
DTDs are ignored.
NrP)rIrRr<r=s&&&&r*startDTD_ToStan.startDTD>rr,c$<V^8dQhRS[RR/#)r.argsr1N)object)r3rCs"r*r4rCsFtr,cR#r?rP)rIrCs&*r*endDTD_ToStan.endDTDCrr,c<V^8dQhRR/#rrP)r3rCs"r*r4rHsDr,cJRVnVPP.4R#)z?
We're starting to be in a CDATA element, make a note of this.
TN)rrrrs&r*
startCDATA_ToStan.startCDATAHs

"r,c<V^8dQhRR/#rrP)r3rCs"r*r4rOs,,$,r,cRVnRPVPP44pVPP\
V44R#)zq
We're no longer in a CDATA element.  Collect up the characters we've
parsed and put them in a new CDATA object.
FrN)rjoinrr8rrr!)rIcomments& r*endCDATA_ToStan.endCDATAOs:
''$**..*+E'N+r,c$<V^8dQhRS[RR/#)r.r=r1Nr)r3rCs"r*r4rXs..s.t.r,cNVPP\V44R#)z-
Add an XML comment which we've encountered.
N)rrr")rIr=s&&r*rO_ToStan.commentXs	
GG,-r,)rrrrrrrrN)rVrWrXrYrZrHrrrrr	r
r/r4r9r@rFrJrPrOr\r]rjs@r*rrgs

4
4

??,  v#v#p  	)	)

,,..r,rcvV^8dQhR\\\,\3,R\R,/#)r.flr1r)rrrrer
)r3s"r*r4r4_s,eBvJO,m1Dr,c\4pVP\P^4VP\P^4VP\P
^4VP\P^4\\VRR44pVPV4VPV4VP\PV4VPV4VP#)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.
rRN)r
setFeaturerfeature_validationfeature_namespacesfeature_external_gesfeature_external_pesrgetattrsetContentHandlersetEntityResolversetPropertyproperty_lexical_handlerparser)rVparserss&  r*
_flatsaxParsere_s]F
g00!4
g00!4
g22A6
g22A6FD)*A
Q
Q
w77;
LL::r,cHa]tRtRtoRtV3RlRltV3RlRltRtVtR#)		XMLStringiwz@
An L{ITemplateLoader} that loads and parses XML from a string.
c6<V^8dQhRS[S[S[3,/#)r.rd)rrer2)r3rCs"r*r4XMLString.__annotate__}s##%U
+#r,c\V\4'gVPR4p\\P
!V44VnR#)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)r7rer;reioStringIO_loadedTemplate)rIrds&&r*rHXMLString.__init__}s7!S!! A4A"++a.4Q"r,c.<V^8dQhRS[R,/#r.r1rr
)r3rCs"r*r4ris$$d=)$r,cVP#)z5
Return the document.

@return: the loaded document.
rnrs&r*loadXMLString.loads###r,rtN	rVrWrXrYrZrHrur\r]rjs@r*rgrgws##$$r,rgcna]tRtRtoRt]!R4tR
Rlt]R4t	]R4t
]R4tR	tVt
R#)FailureElementiz
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>\P!W4WnR#rF)rrHfailure)rIr{rs&&&r*rHFailureElement.__init__s&r,cLV!\VPP44#)z1
Render the exception type as a child of C{tag}.
)rr{typers&&&r*r~FailureElement.types
%dll&7&7899r,cjV!\VPP4PR44#)z2
Render the exception value as a child of C{tag}.
rk)rer{valuer<rs&&&r*rFailureElement.values)
3t||))*11&9::r,cT\\V4VPP4#)zv
Render all the frames in the wrapped
L{Failure}'s traceback stack, replacing
C{tag}.
)rrr{rrs&&&r*	tracebackFailureElement.tracebacksYs^T\\-@-@AAr,r{rF)rVrWrXrYrZrgrrHrr~rrr\r]rjs@r*ryrysaI	KFZ::;;BBr,ryc.p\R\V44PVP4\	V^,\
4'd)V^,P
R4PRR4#V^,P4R#)z
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.
Nr6rdxmlcharrefreplace)	r ryaddBothrr7r2r;r<raiseException)	myFailureresults& r*
formatFailurersmF$y12::6==I&)U##ay(//9LMM
1Ir,cHa]tRtRtoRtV3RlRltV3RlRltRtVtR#)	ri'zB
An L{ITemplateLoader} that loads an existing flattenable object.
c<V^8dQhRR/#)r.rrrP)r3rCs"r*r4TagLoader.__annotate__-s//M/r,cWnR#)z.
@param tag: The object which will be loaded.
Nr)rIrs&&r*rHTagLoader.__init__-s
#&.r,c.<V^8dQhRS[R,/#rqrr)r3rCs"r*r4r5sd=)r,cVP.#rFrrs&r*ruTagLoader.load5szr,rNrwrjs@r*rr's//r,rcla]tRtRtoRtV3RlRltV3RlRltV3RlRltV3R	lR
ltRt	Vt
R#)
XMLFilei9z>
An L{ITemplateLoader} that loads and parses XML from a file.
c0<V^8dQhRS[S[,/#)r.path)rr)r3rCs"r*r4XMLFile.__annotate__?s22Xc]2r,c\V\4'g\P!R\^R7RVnWnR#)zN
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.)category
stacklevelN)r7rwarningswarnDeprecationWarningrn_path)rIrs&&r*rHXMLFile.__init__?s?$))MM@+	
?C=$(
1r,c.<V^8dQhRS[R,/#rqrr)r3rCs"r*r4rSs
(
($}-
(r,c\VP\4'g\VP4#VPP	R4;_uu_4p\V4uuRRR4# +'giR#;i)z8
Read and parse the XML.

@return: the loaded document.
rN)r7rrreopen)rIfs& r*_loadDocXMLFile._loadDocSsP$**h// ,,%%$Q'&%%%sA//B	c <V^8dQhRS[/#)r.r1r)r3rCs"r*r4r_s..#.r,c$RVP:R2#)z)rrs&r*__repr__XMLFile.__repr___sdjj^1--r,c.<V^8dQhRS[R,/#rqrr)r3rCs"r*r4rbs$$d=)$r,c`VPfVP4VnVP#)zT
Return the document, first loading it if necessary.

@return: the loaded document.
)rnrrs&r*ruXMLFile.loadbs*'#'==?D ###r,)rnrN)rVrWrXrYrZrHrrrur\r]rjs@r*rr9s222(
(
(..$$r,raabbracronymaddressappletareaarticleasideaudiobbasebasefontbdibdobig
blockquotebodybrbuttoncanvascaptioncentercitecodecolcolgroupcommanddatalistdddeldetailsdfndirdivdldtemembedfieldset
figcaptionfigurefontfooterformrframeseth1h2h3h4h5h6headheaderhgrouphrhtmliiframeimginputinsisindexkeygenkbdlabellegendlilinkmapmarkmenumetameternavnoframesnoscriptrDoloptgroupoptionoutputpparampreprogressqrprtrubyrdsampscriptsectionselectsmallrspanstrikestrongstylesubsummarysuptabletbodytdtextareatfootththeadtimetitletrttuulvarvideowbrc6a]tRtRtoRtV3RlRltRtVtR#)_TagFactoryiaf
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}
c&<V^8dQhRS[RS[/#)r.tagNamer1)rer#)r3rCs"r*r4_TagFactory.__annotate__s33r,cVR8Xd\R4#VPR4pV\9d\RV:24h\V4#)rr_zunknown tag )r#rVALID_HTML_TAG_NAMESAttributeError)rIr*s&&r*__getattr___TagFactory.__getattr__sFm#r7N..%.. <{!;<<7|r,rPN)rVrWrXrYrZr0r\r]rjs@r*r(r(sr,r(cV^8dQhR\R\R\\,R\\\
.R3,,R\/#)r.r0elementdoctype_failElementrr1)r&r%rr2rrrD)r3s"r*r4r4sO44
4
4e_48WIy$89:	4
4r,caaVe#SPV4SPR4Sf\o\SVSP4pRVV3RllpRS/RRllpVPV4VP	V4\
#)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

cTV^8dQhR\R\\R,,/#)r.r{r1N)rrr)r3s"r*r4#renderElement..__annotate__%s#G$ 8r,c<\PRVR7\SRR4pVe6VP'd$SfQh\	SS!V4SP
4#SPR4R#)z/An error occurred while rendering the response.rsiteNsr
An error occurred while rendering the response.
)
_moduleLogr{r]displayTracebacksrwrite)r{r;r5r0s& r*ebrenderElement..eb%sw=w		
w- 6 6 6+++7L$97==IIMMK
r,r0c<V^8dQhR\R\R\/#)r.rr0r1)rDr&)r3s"r*r4r96s!v8&r,c&VP4V#rF)finish)rr0s&$r*rCrenderElement..finish6s
r,)r>ryrrxrru)r0r3r4r5ror?rCsf&&f   r*
renderElementrEsv(

g

e%'--0A"gLLIIfr,)sN)UrZrlrrcollectionsrrrtypingrrrrr	r
rrr
rrxml.saxrrxml.sax.xmlreaderrrzope.interfacertwisted.internet.deferrtwisted.loggerrtwisted.pythonrtwisted.python.failurertwisted.python.filepathrtwisted.python.reflectrtwisted.webrtwisted.web._elementrrtwisted.web._flattenrrr twisted.web._stanr!r"r#r$twisted.web.iwebr%r&r'r+r>rnr@r`rlrrrrrrContentHandlerEntityResolverrrergryrrur<rrr.r(tagsrErPr,r*rYs
#)7&+!"*,5 2DD77CC(&Rx  *)X&&):)x(()8%%<+EW+E\+BG+B\
G
&"'"'JLu.g$$g&<&<u.p0
_$$$6qBWqBh8
X

_"
_0$0$0$nyy
yy	y

y
yyyyyyy
y
y
y !y"#y$	%y&
'y(
)y*+y,
-y./y01y2
3y45y67y89y:	;y<
=y>?y@
AyB
CyD
EyF	GyH	IyJ	KyLMyNOyPQyR
SyTUyV
WyXYyZ[y\]y^	_y`	ayb	cyd	eyf	gyh	iyjkyl
myn
oyp	qyrsytuyv
wyx
yyz{y|
}y~y@
AyB
CyDEyF
GyH	IyJKyL
MyNOyPQyRSyTUyV
WyXYyZ[y\
]y^	_y`ayb
cyd
eyfgyhiyj
kylmynoyp	qyr	sytuyvwyxyyz
{y|}y~
y@AyB
CyDEyF
GyH
IyJKyL
MyNOyP
QyRSyTUyV	WyXYyZ[y\	]y^_y`aybcyd	eyf	gyhiyj	kyl
mynoyp
qyx0}44r,