a hU @sddlmZddlZddlZddlmZddlmZddlmZe dZ ddgdgdgd Z e d Z d d d eeddeddeddDZededejZdZGdddeZGdddZddZGdddejZdS))chainN)unescape) html5lib_shim) parse_shim) aabbracronymbZ blockquotecodeZemiZliolstrongZulhreftitle)rrr)httphttpsmailtocCsg|] }t|qS)chr).0crrK/wd/webapps/venvs/v2025_4um/lib/python3.9/site-packages/bleach/sanitizer.py *r  []?c@s eZdZdS)NoCssSanitizerWarningN)__name__ __module__ __qualname__rrrrr#5sr#c@s0eZdZdZeeeddddfddZddZdS) CleaneraCleaner for cleaning HTML fragments of malicious content This cleaner is a security-focused function whose sole purpose is to remove malicious content from a string such that it can be displayed as content in a web page. To use:: from bleach.sanitizer import Cleaner cleaner = Cleaner() for text in all_the_yucky_things: sanitized = cleaner.clean(text) .. Note:: This cleaner is not designed to use to transform content to be used in non-web-page contexts. .. Warning:: This cleaner is not thread-safe--the html parser has internal state. Create a separate cleaner per thread! FTNc Cs||_||_||_||_||_|p$g|_||_tj|j|jddd|_ t d|_ tj ddddddd|_ |durg}t|tr|}n4t|trg}|D]} t| ttfr|| qd|vrtjd td dS) a:Initializes a Cleaner :arg set tags: set of allowed tags; defaults to ``bleach.sanitizer.ALLOWED_TAGS`` :arg dict attributes: allowed attributes; can be a callable, list or dict; defaults to ``bleach.sanitizer.ALLOWED_ATTRIBUTES`` :arg list protocols: allowed list of protocols for links; defaults to ``bleach.sanitizer.ALLOWED_PROTOCOLS`` :arg bool strip: whether or not to strip disallowed elements :arg bool strip_comments: whether or not to strip HTML comments :arg list filters: list of html5lib Filter classes to pass streamed content through .. seealso:: http://html5lib.readthedocs.io/en/latest/movingparts.html#filters .. Warning:: Using filters changes the output of ``bleach.Cleaner.clean``. Make sure the way the filters change the output are secure. :arg CSSSanitizer css_sanitizer: instance with a "sanitize_css" method for sanitizing style attribute values and style text; defaults to None F)tagsstripZconsume_entitiesZnamespaceHTMLElementsetreealwaysT)Zquote_attr_valuesZomit_optional_tagsZescape_lt_in_attrsZresolve_entitiessanitizeZalphabetical_attributesNstylez7'style' attribute specified, but css_sanitizer not set.)category)r( attributes protocolsr)strip_commentsfilters css_sanitizerrZBleachHTMLParserparserZ getTreeWalkerwalkerZBleachHTMLSerializer serializer isinstancelistdictvaluestupleextendwarningswarnr#) selfr(r/r0r)r1r2r3Zattributes_valuesr:rrr__init__VsH&       zCleaner.__init__c Cst|ts&d|jjdd}t||s.dS|j|}t|||j |j |j |j |j |jd}|jD]}||d}qh|j|S)zCleans text and returns sanitized result as unicode :arg str text: text to be cleaned :returns: sanitized text as unicode :raises TypeError: if ``text`` is not a text type zargument cannot be of z type, zmust be of text typer)source allowed_tagsr/strip_disallowed_tagsstrip_html_commentsr3allowed_protocols)rA)r7str __class__r$ TypeErrorr4Z parseFragmentBleachSanitizerFilterr5r(r/r)r1r3r0r2r6render)r?textmessagedomfilteredZ filter_classrrrcleans*    z Cleaner.clean) r$r%r&__doc__ ALLOWED_TAGSALLOWED_ATTRIBUTESALLOWED_PROTOCOLSr@rOrrrrr'9s Ur'csLtr Sttr&fdd}|Sttr@fdd}|StddS)a0Generates attribute filter function for the given attributes value The attributes value can take one of several shapes. This returns a filter function appropriate to the attributes value. One nice thing about this is that there's less if/then shenanigans in the ``allow_token`` method. cs`|vr0|}t|r$||||S||vr0dSdvr\d}t|rT||||S||vSdS)NT*F)callable)tagattrvalueZattr_valr/rr _attr_filters  z.attribute_filter_factory.._attr_filtercs|vSNr)rVrWrXrYrrrZsz3attributes needs to be a callable, a list or a dictN)rUr7r9r8 ValueError)r/rZrrYrattribute_filter_factorys    r]c @sreZdZdZeeeejej ej dddf ddZ ddZ d d Z d d Zd dZddZddZddZddZdS)rIzmhtml5lib Filter that sanitizes text This filter can be used anywhere html5lib filters can be used. FTNc CsTtj||t||_t||_t||_||_| |_ ||_ ||_ | |_ ||_ dS)a_Creates a BleachSanitizerFilter instance :arg source: html5lib TreeWalker stream as an html5lib TreeWalker :arg set allowed_tags: set of allowed tags; defaults to ``bleach.sanitizer.ALLOWED_TAGS`` :arg dict attributes: allowed attributes; can be a callable, list or dict; defaults to ``bleach.sanitizer.ALLOWED_ATTRIBUTES`` :arg list allowed_protocols: allowed list of protocols for links; defaults to ``bleach.sanitizer.ALLOWED_PROTOCOLS`` :arg attr_val_is_uri: set of attributes that have URI values :arg svg_attr_val_allows_ref: set of SVG attributes that can have references :arg svg_allow_local_href: set of SVG elements that can have local hrefs :arg bool strip_disallowed_tags: whether or not to strip disallowed tags :arg bool strip_html_comments: whether or not to strip HTML comments :arg CSSSanitizer css_sanitizer: instance with a "sanitize_css" method for sanitizing style attribute values and style text; defaults to None N)rFilterr@ frozensetrBrEr] attr_filterrCrDattr_val_is_urisvg_attr_val_allows_refr3svg_allow_local_href) r?rArBr/rErarbrcrCrDr3rrrr@s0   zBleachSanitizerFilter.__init__ccs:|D]0}||}|sqt|tr.|EdHq|VqdSr[)sanitize_tokenr7r8)r?token_iteratortokenretrrrsanitize_streamAs   z%BleachSanitizerFilter.sanitize_streamccsg}|D]f}|rP|ddkr*||qqhddd|Ddd}g}|Vn|ddkrh||q|Vqddd|Ddd}|VdS) z/Merge consecutive Characters tokens in a streamtype CharactersrcSsg|] }|dqSdatarrZ char_tokenrrrr[rz:BleachSanitizerFilter.merge_characters..)rlricSsg|] }|dqSrkrrmrrrrirN)appendjoin)r?reZcharacters_bufferrfZ new_tokenrrrmerge_charactersMs*     z&BleachSanitizerFilter.merge_characterscCs||tj|Sr[)rprhrr^__iter__)r?rrrrqnszBleachSanitizerFilter.__iter__cCs|d}|dvr>|d|jvr(||S|jr2dS||SnJ|dkrr|jsltj|dddd d |d<|SdSn|d kr||S|SdS) aSanitize a token either by HTML-encoding or dropping. Unlike sanitizer.Filter, allowed_attributes can be a dict of {'tag': ['attribute', 'pairs'], 'tag': callable}. Here callable is a function with two arguments of attribute name and value. It should return true of false. Also gives the option to strip tags instead of encoding. :arg dict token: token to sanitize :returns: token or list of tokens ri)StartTagEndTagEmptyTagnameNCommentrlz"z')"')entitiesrj)rB allow_tokenrCdisallowed_tokenrDrescapesanitize_characters)r?rf token_typerrrrdss"    z$BleachSanitizerFilter.sanitize_tokencCs|dd}|s|Stt|}||d<d|vr4|Sg}t|D]}|sLqB|drt|}|dur|dkr|dddn|d|d |t |d d}|rB|d|dqB|d|dqB|S) aHandles Characters tokens Our overridden tokenizer doesn't do anything with entities. However, that means that the serializer will convert all ``&`` in Characters tokens to ``&``. Since we don't want that, we extract entities here and convert them to Entity tokens so the serializer will let them be. :arg token: the Characters token to work on :returns: a list of tokens rlr&Namprj)rirlEntity)riru) getINVISIBLE_CHARACTERS_REsubINVISIBLE_REPLACEMENT_CHARrZnext_possible_entity startswithZ match_entityrnlen)r?rfrlZ new_tokenspartentity remainderrrrr}s.    z)BleachSanitizerFilter.sanitize_characterscCst|}tdd|}|dd}|}zt|}WntyNYdS0|j rf|j |vr|Sn@| drt|Sd|vr| dd|vr|Sd|vsd |vr|SdS) zChecks a uri value to see if it's allowed :arg value: the uri value to sanitize :arg allowed_protocols: list of allowed protocols :returns: allowed value or None z[`\000-\040\177-\240\s]+ru�N#:rrr) rZconvert_entitiesrerreplacelowerrurlparser\schemersplit)r?rXrEZnormalized_uriparsedrrrsanitize_uri_values*     z(BleachSanitizerFilter.sanitize_uri_valuec Csd|vri}|dD]\}}|\}}||d||s     z!BleachSanitizerFilter.allow_tokencCs|d}|dkr&d|dd|d<n|dr|dvs:Jg}|dD]b\\}}}|rh|sh||}}|dusz|tjvr|}ntj|d|}|d |d |d qJd |dd |d|d<nd |dd|d<|dr|dddd|d<d|d<|d=|S)Nrirszrl)rrrtrrz="rwrj)rrprefixesrnror)r?rfr~rnsruvrrrrr{Zs(    z&BleachSanitizerFilter.disallowed_token)r$r%r&rPrQrRrSrrarbrcr@rhrprqrdr}rrzr{rrrrrIs&  > !+=:ErI) itertoolsrrr=Zxml.sax.saxutilsrZbleachrrr_rQrRrSrorangeZINVISIBLE_CHARACTERScompileUNICODErr UserWarningr#r'r]ZSanitizerFilterrIrrrrs.    &+