+ jF*Rt^RIHt^RIHt^RIHt^RIHt^RI H t ^RI H t ^RI HtHtHtHtHtHtHtHtHtHtHtHt^RIHtHt^R IHt^R IH t ^R I!H"t"H#t#H$t$H%t%H&t&H't'^R I(H)t)H*t*H+t+^R I,H-t-H.t.]!R4t/]t0]]1]2]&]"]$]%]]0R3,]]0,]]0RR3,]#]]0,]]]0,]3]03,]-3 ,t4R't5RRlt6RRlt7RRlt8RRlt9RRlt:R(RRllt;RRltR#R$lt?R%R&lt@R#))zu Context-free flattener/serializer for rendering Python objects, possibly complex or arbitrarily nested, as strings. ) annotations) iscoroutine)BytesIO)exc_info) extract_tb) GeneratorType) AnyCallable Coroutine GeneratorListMappingOptionalSequenceTupleTypeVarUnioncast)DeferredensureDeferred) nativeString)Failure)CDATACharRefCommentTagslot voidElements)FlattenerError UnfilledSlotUnsupportedType) IRenderableIRequestT.Nc V^8dQhRRRR/#datazUnion[bytes, str]returnbytes)formats"6/usr/lib/python3/dist-packages/twisted/web/_flatten.py __annotate__r-Gs,c\V\4'dVPR4pVPRR4PRR4PRR4pV#)a{ Escape some character or UTF-8 byte data for inclusion in an HTML or XML document, by replacing metacharacters (C{&<>}) with their entity equivalents (C{&<>}). This is used as an input to L{_flattenElement}'s C{dataEscaper} parameter. @param data: The string to escape. @return: The quoted form of C{data}. If C{data} is L{str}, return a utf-8 encoded string. utf-8&s&s> isinstancestrencodereplacer's&r,escapeForContentr:GsN${{7# <<h ' / /g > F FtW UD Kr.c V^8dQhRRRR/#r%r*)r+s"r,r-r-Zs'8Ur.cT\V\4'dVPR4#V#)a Escape some character or UTF-8 byte data for inclusion in the top level of an attribute. L{attributeEscapingDoneOutside} actually passes the data through unchanged, because L{writeWithAttributeEscaping} handles the quoting of the text within attributes outside the generator returned by L{_flattenElement}; this is used as the C{dataEscaper} argument to that L{_flattenElement} call so that that generator does not redundantly escape its text output. @param data: The string to escape. @return: The string, unchanged, except for encoding. r0)r5r6r7r9s&r,attributeEscapingDoneOutsider=Zs%${{7## Kr.c V^8dQhRRRR/#)r&writeCallable[[bytes], object]r(zCallable[[bytes], None]r*)r+s"r,r-r-ms,, $,,r.caRV3RllpV#)a Decorate a C{write} callable so that all output written is properly quoted for inclusion within an XML attribute value. If a L{Tag } C{x} is flattened within the context of the contents of another L{Tag } C{y}, the metacharacters (C{<>&"}) delimiting C{x} should be passed through unchanged, but the textual content of C{x} should still be quoted, as usual. For example: C{&}. That is the default behavior of L{_flattenElement} when L{escapeForContent} is passed as the C{dataEscaper}. However, when a L{Tag } C{x} is flattened within the context of an I{attribute} of another L{Tag } C{y}, then the metacharacters delimiting C{x} should be quoted so that it can be parsed from the attribute's value. In the DOM itself, this is not a valid thing to do, but given that renderers and slots may be freely moved around in a L{twisted.web.template} template, it is a condition which may arise in a document and must be handled in a way which produces valid output. So, for example, you should be able to get C{}. This should also be true for other XML/HTML meta-constructs such as comments and CDATA, so if you were to serialize a L{comment } in an attribute you should get C{}. Therefore in order to capture these meta-characters, flattening is done with C{write} callable that is wrapped with L{writeWithAttributeEscaping}. The final case, and hopefully the much more common one as compared to serializing L{Tag } and arbitrary L{IRenderable} objects within an attribute, is to serialize a simple string, and those should be passed through for L{writeWithAttributeEscaping} to quote without applying a second, redundant level of quoting. @param write: A callable which will be invoked with the escaped L{bytes}. @return: A callable that writes data with escaping. c V^8dQhRRRR/#)r&r'r)r(Noner*)r+s"r,r-0writeWithAttributeEscaping..__annotate__s??U?t?r.cJ<S!\V4PRR44R#)"s"N)r:r8)r'r?s&r,_write*writeWithAttributeEscaping.._writes t$,,T9=>r.r*)r?rGsf r,writeWithAttributeEscapingrImsR?? Mr.c V^8dQhRRRR/#r%r*)r+s"r,r-r-s 4 4( 4U 4r.ct\V\4'dVPR4pVPRR4#)z Escape CDATA for inclusion in a document. @param data: The string to escape. @return: The quoted form of C{data}. If C{data} is unicode, return a utf-8 encoded string. r0]]>s]]]]>r4r9s&r, escapedCDATArMs1${{7# << 2 33r.c V^8dQhRRRR/#r%r*)r+s"r,r-r-s*ur.c\V\4'dVPR4pVPRR4pV'dVRRR8Xd VR, pV#)a Within comments the sequence C{-->} can be mistaken as the end of the comment. To ensure consistent parsing and valid output the sequence is replaced with C{-->}. Furthermore, whitespace is added when a comment ends in a dash. This is done to break the connection of the ending C{-} with the closing C{-->}. @param data: The string to escape. @return: The quoted form of C{data}. If C{data} is unicode, return a utf-8 encoded string. r0-->s-->N- r4r9s&r,escapedCommentrTsM${{7# << *D RS T!   Kr.c(V^8dQhRRRRRRRR/#) r&namer6slotDataz-Sequence[Optional[Mapping[str, Flattenable]]]defaultzOptional[Flattenable]r( Flattenabler*)r+s"r,r-r-s0!! !;!#! !r.ct\V4FpVfK W9gKW0,u# VeV#\V4h)zC Find the value of the named slot in the given stack of slot data. )reversedr)rVrWrX slotFrames&&& r, _getSlotValuer]s>h'  T%6? "(  N4  r.c V^8dQhRRRR/#)r&dz Deferred[T]r(r*)r+s"r,r-r-s[[r.cnaa\V3Rl4oRV3RllpRV3RllpSPW4S#)z Create a new L{Deferred} based on C{d} that will fire and fail with C{d}'s result or error, but will not modify C{d}'s callback type. c$<SP4#N)cancel)_r_s&r,_fork..s r.c V^8dQhRRRR/#)r&resultr#r(r*)r+s"r,r-_fork..__annotate__sqr.c*<SPV4V#rb)callback)rhd2s&r,rk_fork..callbacks F r.c V^8dQhRRRR/#)r&failurerr(r*)r+s"r,r-risWr.c*<SPV4V#rb)errback)rorls&r,rq_fork..errbacks 7r.)r addCallbacks)r_rkrqrlsf @r,_forkrts7 34BNN8% Ir.c4V^8dQhRRRRRRRRR R R R R R/#)r&requestOptional[IRequest]rootrYr?r@rWz)List[Optional[Mapping[str, Flattenable]]] renderFactoryOptional[IRenderable] dataEscaper$Callable[[Union[bytes, str]], bytes]r(zMGenerator[Union[Generator[Any, Any, Any], Deferred[Flattenable]], None, None]r*)r+s"r,r-r-sXN$N$ N$ N$ %N$8 N$ ) N$ 6 N$SN$r.c #aaa"VVV3RVV3RllloRV3Rllp\V\\34'dV!V!V44R #\V\4'd.\ VP SVP 4pS!V4xR #\V\4'd.V!R4V!\VP44V!R4R #\V\4'd.V!R4V!\VP44V!R4R #\V\4'EdSPVP4VPpVebVf\!R V R 24hVP#R 4p R V nVP%V4p V !SV 4p S!V 4xSP'4R #VP('gS!VP*4xR #V!R 4\VP(\4'dVP(P-R4p M VP(p V!V 4VP.P14Fdwr\V \4'dV P-R4p V!RV ,R,4S!V\2\5V4R7xV!R4Kf VP*'g\7V 4\89d:V!R4S!VP*\:4xV!RV ,R,4R #V!R4R #\V\<\>\@34'dVF pS!V4xK R #\V\B4'd.RVPD3,pV!VP-R44R #\V\F4'dV!\IV44xR #\KV4'dPV!\FPL!\O\P\F\R,\T\R3,V444xR #\VPX!V4'dVPS4p S!WR7xR #\[V4h5i)a Make C{root} slightly more flat by yielding all its immediate contents as strings, deferreds or generators that are recursive calls to itself. @param request: A request object which will be passed to L{IRenderable.render}. @param root: An object to be made flatter. This may be of type C{unicode}, L{str}, L{slot}, L{Tag }, L{tuple}, L{list}, L{types.GeneratorType}, L{Deferred}, or an object that implements L{IRenderable}. @param write: A callable which will be invoked with each L{bytes} produced by flattening C{root}. @param slotData: A L{list} of L{dict} mapping L{str} slot names to data with which those slots will be replaced. @param renderFactory: If not L{None}, an object that provides L{IRenderable}. @param dataEscaper: A 1-argument callable which takes L{bytes} or L{unicode} and returns L{bytes}, quoted as appropriate for the rendering context. This is really only one of two values: L{attributeEscapingDoneOutside} or L{escapeForContent}, depending on whether the rendering context is within an attribute or not. See the explanation in L{writeWithAttributeEscaping}. @return: An iterator that eventually writes L{bytes} to C{write}. It can yield other iterators or L{Deferred}s; if it yields another iterator, the caller will iterate it; if it yields a L{Deferred}, the result of that L{Deferred} will be another generator, in which case it is iterated. See L{_flattenTree} for the trampoline that consumes said values. c ,V^8dQhRRRRRRRRR R /#) r&newRootrYr{r|ryrzr?r@r(z@Generator[Union[Flattenable, Deferred[Flattenable]], None, None]r*)r+s"r,r-%_flattenElement..__annotate__s;   9 - )  J  r.c <\SWSW!4#rb)_flattenElement)rr{ryr?rvrWs&&&&r, keepGoing"_flattenElement..keepGoings  WX}  r.c V^8dQhRRRR/#)r&rhzDeferred[Flattenable]r(r*)r+s"r,r-rs--4-9N-r.c&<VPS4#rb) addCallback)rhrs&r,keepGoingAsync'_flattenElement..keepGoingAsyncs!!),,r.s z&#%d;)ry).r5r)r6rr]rVrXrrMr'rrTrappendrWrender ValueErrorclonelookupRenderMethodpoptagNamechildrenr7 attributesitemsr=rIrrr:tuplelistrrordinalrrtr fromCoroutinerr rYobjectr! providedByr )rvrxr?rWryr{r slotValue rendererName rootClone renderMethodrhrkvelementescapedrsf&&f&& @r,rrsbb=H/<+0   --$ %% k$ D$  !$))Xt||D  "" D%  l l499%& f D' " " g nTYY'( f D#   &{{  #$ :<.I>? 5)I#I (;;LIL!'95FF# # LLN |||DMM* *  d dllC ( (ll))'2GllG gOO))+DA!S!!HHW% $(U" #/7QRW7X  $K, ===L1E $KDMM+;< < %'/D( ) &M D5$ 6 7 7GG$ $ D' " "T\\O+ gnnW%& D( # #U4[)) T    " "Yx 4fkIJDQ      % %W%33d##sGQ*DQ* E6Q*)Q*c(V^8dQhRRRRRRRR/#) r&rvrwrxrYr?r@r(rCr*)r+s"r,r-r-ss2EE E'2E;TE Er.c aa a a ".o ^o RV V V 3RllpRV V V3Rllo \WV.R\4.pV'dN\VR,4p\V\4'dS !4VGRjxL pVP V4KUS !4R#L \ dTP4K~\dp.pTF?pTPfKTP TPPR,4KA TP4\Yg\\4^,44hRp?ii;i5i)aY Make C{root} into an iterable of L{bytes} and L{Deferred} by doing a depth first traversal of the tree. @param request: A request object which will be passed to L{IRenderable.render}. @param root: An object to be made flatter. This may be of type C{unicode}, L{bytes}, L{slot}, L{Tag }, L{tuple}, L{list}, L{types.GeneratorType}, L{Deferred}, or something providing L{IRenderable}. @param write: A callable which will be invoked with each L{bytes} produced by flattening C{root}. @return: A C{Deferred}-returning coroutine that resolves to C{None}. c V^8dQhRRRR/#)r&bsr)r(rCr*)r+s"r,r-"_flattenTree..__annotate__s%Dr.cv<SPV4S\V4, oS\8d S!4R#R#rb)rlen BUFFER_SIZE)rbufbufSize flushBuffers&r, bufferedWrite#_flattenTree..bufferedWrites. 23r7 k ! M "r.cV^8dQhRR/#)r&r(rCr*)r+s"r,r-rsr.cR<S^8dS!RPS44SR^oR#R#)r.:NNNN)join)rrr?sr,r!_flattenTree..flushBuffers+ Q; #((3- AG r.NrxrS)rr:nextr5rr StopIterationr Exceptiongi_framef_localsrrr) rvrxr?rstackreroots generatorrrrs &&f @@@r, _flattenTreerss ( CG }b$@PQ-E  "59oG'8,, '- LL !M(  IIK FE" %%1LL!3!3!> >'2>;T>>r.c,\\WV44#)a Incrementally write out a string representation of C{root} using C{write}. In order to create a string representation, C{root} will be decomposed into simpler objects which will themselves be decomposed and so on until strings or objects which can easily be converted to strings are encountered. @param request: A request object which will be passed to the C{render} method of any L{IRenderable} provider which is encountered. @param root: An object to be made flatter. This may be of type L{str}, L{bytes}, L{slot}, L{Tag }, L{tuple}, L{list}, L{types.GeneratorType}, L{Deferred}, or something that provides L{IRenderable}. @param write: A callable which will be invoked with each L{bytes} produced by flattening C{root}. @return: A L{Deferred} which will be called back with C{None} when C{root} has been completely flattened into C{write} or which will be errbacked if an unexpected exception occurs. )rr)rvrxr?s&&&r,flattenrs2 ,we< ==r.c$V^8dQhRRRRRR/#)r&rvrwrxrYr(zDeferred[bytes]r*)r+s"r,r-r-s"$$-$[$_$r.ca\4o\WSP4pVPV3Rl4\ \ \ ,V4#)a Collate a string representation of C{root} into a single string. This is basically gluing L{flatten} to an L{io.BytesIO} and returning the results. See L{flatten} for the exact meanings of C{request} and C{root}. @return: A L{Deferred} which will be called back with a single UTF-8 encoded string as its result when C{root} has been completely flattened or which will be errbacked if an unexpected exception occurs. c$<SP4#rb)getvalue)rdios&r,reflattenString..s BKKMr.)rrr?rrrr))rvrxr_rs&& @r, flattenStringrs: Brxx(AMM)*  ##r.irb)A__doc__ __future__rinspectrrrsysr tracebackrtypesrtypingrr r r r r rrrrrrtwisted.internet.deferrrtwisted.python.compatrtwisted.python.failurertwisted.web._stanrrrrrrtwisted.web.errorrrr twisted.web.iwebr!r"r#FlattenableRecursiver)r6rrYrr:r=rIrMrTr]rtrrrrr*r.r,rs #     <.*NNKK2 CL      #$  "D$./  !" h+,f6JJK    &&,^ 4(!"&N$bEP>8$r.