o iF@sdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZmZmZmZmZmZmZmZmZmZdd lmZmZdd lmZdd lm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)m*Z*m+Z+ddl,m-Z-m.Z.edZ/eZ0 ee1e2e&e"e$e%ee0dfee0ee0ddfe#ee0eee0e3e0fe-f Z4 dZ5dEddZ6dEddZ7dFddZ8dEd d!Z9dEd"d#Z: dGdHd+d,Z;dId/d0ZZ>dLd@dAZ?dMdCdDZ@dS)Nzu 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.NidataUnion[bytes, str]returnbytescCs4t|tr |d}|dddddd}|S) 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>N isinstancestrencodereplacer$r2ZC:\Users\psant\Downloads\PAF backend\school\venv\Lib\site-packages\twisted/web/_flatten.pyescapeForContentGs r4cCst|tr |dS|S)aG 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(N)r-r.r/r1r2r2r3attributeEscapingDoneOutsideZs  r5writeCallable[[bytes], object]Callable[[bytes], None]csdfdd }|S) aU 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. r$r'r&Nonecst|dddS)N"s")r4r0r1r6r2r3_writesz*writeWithAttributeEscaping.._writeN)r$r'r&r9r2)r6r<r2r;r3writeWithAttributeEscapingms)r=cCs t|tr |d}|ddS)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]]]]>Nr,r1r2r2r3 escapedCDATAs  r?cCs@t|tr |d}|dd}|r|dddkr|d7}|S)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,r1r2r2r3escapedComments  rDnamer.slotData-Sequence[Optional[Mapping[str, Flattenable]]]defaultOptional[Flattenable] FlattenablecCs>t|D]}|dur||vr||Sq|dur|St|)zK Find the value of the named slot in the given stack of slot data. N)reversedr)rErFrHZ slotFramer2r2r3 _getSlotValues  rLd Deferred[T]cs<tfddd fdd }dfd d }||S)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. cSN)cancel_)rMr2r3z_fork..resultr#r&c||SrP)callbackrVd2r2r3rX z_fork..callbackfailurercrWrP)errback)r]rZr2r3r^r\z_fork..errbackN)rVr#r&r#)r]rr&r)rZ addCallbacks)rMrXr^r2)rMr[r3_forks  r_requestOptional[IRequest]root)List[Optional[Mapping[str, Flattenable]]] renderFactoryOptional[IRenderable] dataEscaper$Callable[[Union[bytes, str]], bytes]MGenerator[Union[Generator[Any, Any, Any], Deferred[Flattenable]], None, None]c#s|||fd$fd d d%fdd }t|ttfr#|||dSt|tr7t|j|j}|VdSt|trM|d|t|j |ddSt|t rc|d|t |j |ddSt|t r |j|j}|dur|durtd|d|d} d| _||} | | } | VdS|js|jVdS|dt|jtr|jd} n|j} || |jD]$\} }t| tr| d} |d| d|tt|dV|dq|jst| tvr |d|jtV|d | ddS|d!dSt|ttt fr'|D]}|VqdSt|t!r}, 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. newRootrJrfrgrdrer6r7r&@Generator[Union[Flattenable, Deferred[Flattenable]], None, None]cst||||SrP)_flattenElement)rirfrdr6)r`rFr2r3 keepGoings z"_flattenElement..keepGoingrVDeferred[Flattenable]cs |SrP) addCallbackrY)rlr2r3keepGoingAsyncs z'_flattenElement..keepGoingAsyncs s