hF.SrSSKJr SSKJr SSKJr SSKJr SSK J r SSK J r SSK JrJrJrJrJrJrJrJrJrJrJrJr SS KJrJr SS KJr SS KJ r SS K!J"r"J#r#J$r$J%r%J&r&J'r' SS K(J)r)J*r*J+r+ SSK,J-r-J.r. \"S5r/\r0\\1\2\&\"\$\%\\0S4\\0\\0SS4\#\\0\\\0\3\04\-4 r4Sr5SSjr6SSjr7SSjr8SSjr9SSjr:S S!Sjjr;S"Sjr<S#Sjr=S$Sjr>S%Sjr?S&Sjr@g)'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.Nic[U[5(aURS5nURSS5RSS5RSS5nU$)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> isinstancestrencodereplacedatas [/root/1688_scrapy/alibaba-scraper/venv/lib/python3.13/site-packages/twisted/web/_flatten.pyescapeForContentr2GsN${{7# <<h ' / /g > F FtW UD KcR[U[5(aURS5$U$)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. r&)r+r,r-r/s r1attributeEscapingDoneOutsider5Zs%${{7## Kr3c^SU4SjjnU$)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. cH>T"[U5RSS55 g)N"s")r2r.)r0writes r1_write*writeWithAttributeEscaping.._writes t$,,T9=>r3)r0bytesreturnNone)r9r:s` r1writeWithAttributeEscapingr@msR? Mr3cr[U[5(aURS5nURSS5$)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. r&]]>s]]]]>r*r/s r1 escapedCDATArCs1${{7# << 2 33r3c[U[5(aURS5nURSS5nU(aUSSS:XaUS- nU$)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. r&-->s-->N- r*r/s r1escapedCommentrIsM${{7# << *D RS T!   Kr3cf[U5HnUcMX;dMX0s $ UbU$[U5e)zC Find the value of the named slot in the given stack of slot data. )reversedr )nameslotDatadefault slotFrames r1 _getSlotValuerPs>h'  T%6? "(  N4  r3cj^^[U4Sj5mSU4SjjnSU4SjjnTRX5 T$)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$>TR5$N)cancel)_ds r1_fork..s r3c*>TRU5 U$rS)callback)resultd2s r1rZ_fork..callbacks F r3c*>TRU5 U$rS)errback)failurer\s r1r__fork..errbacks 7r3)r[r$r=r$)r`rr=r)r addCallbacks)rVrZr_r\s` @r1_forkrcs- 34BNN8% Ir3c #f^^^# UUU4SUU4SjjjmSU4Sjjn[U[[45(aU"U"U55 g[U[5(a,[ UR TUR 5nT"U5v g[U[5(a,U"S5 U"[UR55 U"S5 g[U[5(a,U"S5 U"[UR55 U"S5 g[U[5(GaTRUR5 URnUb_Uc[!SUS 35eUR#S 5n SU lUR%U5n U "TU 5n T"U 5v TR'5 gUR((dT"UR*5v gU"S 5 [UR([5(aUR(R-S 5n O UR(n U"U 5 UR.R15HXup[U [5(aU R-S 5n U"S U -S-5 T"U[2[5U5S9v U"S5 MZ UR*(d[7U 5[8;a0U"S5 T"UR*[:5v U"SU -S-5 gU"S5 g[U[<[>[@45(aUH nT"U5v M g[U[B5(a(SURD4-nU"UR-S 55 g[U[F5(aU"[IU55v g[KU5(aFU"[FRL"[O[P[F[R[T[R4U555v g[VRX"U5(aURT5n T"XS9v g[[U5e7f)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 >[TXTX!5$rS)_flattenElement)newRoot dataEscaper renderFactoryr9requestrMs r1 keepGoing"_flattenElement..keepGoings  WX}  r3c&>URT5$rS) addCallback)r[rks r1keepGoingAsync'_flattenElement..keepGoingAsyncs!!),,r3s z&#%d;)ri) rg Flattenablerh$Callable[[Union[bytes, str]], bytes]riOptional[IRenderable]r9Callable[[bytes], object]r=z@Generator[Union[Flattenable, Deferred[Flattenable]], None, None])r[Deferred[Flattenable]r=rv).r+r<r,rrPrLrNrrCr0rrIrappendrMrender ValueErrorclonelookupRenderMethodpoptagNamechildrenr- attributesitemsr5r@rrr2tuplelistrrordinalrrcr fromCoroutinerr rrobjectr" providedByr!)rjrootr9rMrirhro slotValue rendererName rootClone renderMethodr[r}kvelementescapedrks` ` @r1rfrfsb=H/<+0   9 - )  J   -$ %% 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##sP,P1c h^^ ^ ^ # /m Sm SU U U 4SjjnS U U U4Sjjm [XU/S[5/nU(aO[US5n[U[5(aT "5 UIShvN nUR U5 U(aMOT "5 gN&![ a UR5 N/[awn/nUH:nURcMUR URRS5 M< UR5 [Xg[[5S55eSnAff=f7f) 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}. rch>TRU5 T[U5- mT[:aT"5 ggrS)rwlen BUFFER_SIZE)bsbufbufSize flushBuffers r1 bufferedWrite#_flattenTree..bufferedWrites. 23r7 k ! M "r3cP>TS:aT"SRT55 TSS2 Smgg)Nrr3)join)rrr9sr1r!_flattenTree..flushBuffers+ Q; #((3- AG r3NrFr)rr<r=r>)r=r>)rfr2nextr+rrw StopIterationr| Exceptiongi_framef_localsrrr) rjrr9rstackreroots generatorrrrs ` @@@r1 _flattenTreerss( CG }b$@PQ-E  "59oG'8,, '- LL !% %*M(  IIK FE" %%1LL!3!3!}, 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)rjrr9s r1flattenrs2 ,we< ==r3c^[5m[XTR5nURU4Sj5 [ [ [ U5$)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$>TR5$rS)getvalue)rUios r1rWflattenString..s BKKMr3)rrr9rnrrr<)rjrrVrs @r1 flattenStringrs: Brxx(AMM)*  ##r3)r0zUnion[bytes, str]r=r<)r9rur=zCallable[[bytes], None]rS)rLr,rMz-Sequence[Optional[Mapping[str, Flattenable]]]rNzOptional[Flattenable]r=rr)rV Deferred[T]r=r)rjOptional[IRequest]rrrr9rurMz)List[Optional[Mapping[str, Flattenable]]]rirtrhrsr=zMGenerator[Union[Generator[Any, Any, Any], Deferred[Flattenable]], None, None])rjrrrrr9rur=r>)rjrrrrr9rur=zDeferred[None])rjrrrrr=zDeferred[bytes])A__doc__ __future__rinspectrrrsysr tracebackrtypesrtypingr r r r r rrrrrrrtwisted.internet.deferrrtwisted.python.compatrtwisted.python.failurertwisted.web._stanrrrrrrtwisted.web.errorrr r!twisted.web.iwebr"r#r$FlattenableRecursiver<r,rrrrr2r5r@rCrIrPrcrfrrrr?r3r1rs #     <.*NNKK2 CL      #$  "D$./  !" h+,f6JJK    &&, $,,^ 4.&*! !;!#! !"&N$ N$ N$ %N$8 N$ ) N$ 6 N$SN$bE E'2E;TE EP> >'2>;T>>8$r3