î _ÝV>ã@sdZddlmZddlmZmZGdd„deƒZGdd„deeƒZ Gdd „d ej eƒZ ej r‰e Z n e Z e ZGd d „d eƒZGd d „d eeƒZGdd„dej eƒZej ròeZn eZeZdd„Zdd„ZdS)a8 Functions for working with "safe strings": strings that can be displayed safely without further escaping in HTML. Marking something as a "safe string" means that the producer of the string has already turned characters that should not be interpreted by the HTML engine (e.g. '<') into the appropriate entities. é)Úsix)ÚPromiseÚcurryc@seZdZdS)Ú EscapeDataN)Ú__name__Ú __module__Ú __qualname__©r r ú9/tmp/pip-build-ghmbqnp_/Django/django/utils/safestring.pyr s rc@seZdZdZdS)Ú EscapeBytesz@ A byte string that should be HTML-escaped when output. N)rrrÚ__doc__r r r r r s r c@seZdZdZdS)Ú EscapeTextzJ A unicode string object that should be HTML-escaped when output. N)rrrr r r r r r s r c@seZdZdd„ZdS)ÚSafeDatacCs|S)z  Returns the html representation of a string for interoperability. This allows other template engines to understand Django's SafeData. r )Úselfr r r Ú__html__%szSafeData.__html__N)rrrrr r r r r$s rcsIeZdZdZ‡fdd†Zdd„ZeedejƒZ‡S)Ú SafeByteszƒ A bytes subclass that has been specifically marked as "safe" (requires no further escaping) for HTML output purposes. csNtt|ƒj|ƒ}t|tƒr1t|ƒSt|tƒrJt|ƒS|S)z¡ Concatenating a safe byte string with another safe byte string or safe unicode string is safe. Otherwise, the result is no longer safe. )ÚsuperrÚ__add__Ú isinstanceÚSafeText)rÚrhsÚt)Ú __class__r r r3s   zSafeBytes.__add__cOsH|jdƒ}||||Ž}t|tƒr:t|ƒSt|ƒSdS)z° Wrap a call to a normal unicode method up so that we return safe results. The method that is being wrapped is passed in the 'method' argument. ÚmethodN)ÚpoprÚbytesrr)rÚargsÚkwargsrÚdatar r r Ú _proxy_method?s  zSafeBytes._proxy_methodr) rrrr rrrrÚdecoder r )rr r.s  rcsLeZdZdZ‡fdd†Zdd„Zeedejj ƒZ ‡S)rz‚ A unicode (Python 2) / str (Python 3) subclass that has been specifically marked as "safe" for HTML output purposes. cs5tt|ƒj|ƒ}t|tƒr1t|ƒS|S)z¤ Concatenating a safe unicode string with another safe byte string or safe unicode string is safe. Otherwise, the result is no longer safe. )rrrrr)rrr)rr r rTs zSafeText.__add__cOsH|jdƒ}||||Ž}t|tƒr:t|ƒSt|ƒSdS)z° Wrap a call to a normal unicode method up so that we return safe results. The method that is being wrapped is passed in the 'method' argument. rN)rrrrr)rrrrrr r r r^s  zSafeText._proxy_methodr) rrrr rrrrÚ text_typeÚencoder r )rr rOs  rcCsvt|dƒr|St|tƒs:t|tƒrD|jrDt|ƒSt|tjtfƒrft|ƒSt t |ƒƒS)zÖ Explicitly mark a string as safe for (HTML) output purposes. The returned object can be used everywhere a string or unicode object is appropriate. Can be called multiple times on a single string. r) ÚhasattrrrrÚ_delegate_bytesrrr!rÚ SafeStringÚstr)Úsr r r Ú mark_safeus'  r(cCs…t|dƒst|tƒr"|St|tƒsIt|tƒrS|jrSt|ƒSt|tjtfƒrut |ƒSt t |ƒƒS)zÜ Explicitly mark a string as requiring HTML escaping upon output. Has no effect on SafeData subclasses. Can be called multiple times on a single string (the resulting escaping is only applied once). r) r#rrrrr$r rr!r Ú EscapeStringr&)r'r r r Úmark_for_escaping…s'  r*N)r Z django.utilsrZdjango.utils.functionalrrÚobjectrrr r!r ÚPY3r)Z EscapeUnicoderrrr%Z SafeUnicoder(r*r r r r Ús$   !