3 š(ƒhßã@sÜdZddlZddlmZddlmZddlmZmZGdd„de ƒZ Gdd „d e e ƒZ Gd d „d ej e ƒZejrveZne ZeZGd d „d e ƒZGdd„de eƒZGdd„dej eƒZejrÀeZneZeZdd„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. éN)Úsix)ÚRemovedInDjango20Warning)ÚPromiseÚcurryc@s eZdZdS)Ú EscapeDataN)Ú__name__Ú __module__Ú __qualname__©r r ú;/tmp/pip-install-q3hcpn_q/Django/django/utils/safestring.pyrsrc@seZdZdZdS)Ú EscapeBytesz@ A byte string that should be HTML-escaped when output. N)rrr Ú__doc__r r r r r sr c@seZdZdZdS)Ú EscapeTextzJ A unicode string object that should be HTML-escaped when output. N)rrr r r r r r rsrc@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)rrr rr r r r r'srcs6eZdZdZ‡fdd„Zdd„ZeeejdZ‡Z S)Ú SafeByteszƒ A bytes subclass that has been specifically marked as "safe" (requires no further escaping) for HTML output purposes. cs8tt|ƒj|ƒ}t|tƒr"t|ƒSt|tƒr4t|ƒ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 r6s   zSafeBytes.__add__cOs8|jdƒ}||f|ž|Ž}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_methodBs   zSafeBytes._proxy_method)r) rrr r rr rrÚdecodeÚ __classcell__r r )rr r1s  rcs8eZdZdZ‡fdd„Zdd„Zeeejj dZ ‡Z S)rz‚ A unicode (Python 2) / str (Python 3) subclass that has been specifically marked as "safe" for HTML output purposes. cs&tt|ƒj|ƒ}t|tƒr"t|ƒ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 rWs zSafeText.__add__cOs8|jdƒ}||f|ž|Ž}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 as   zSafeText._proxy_method)r) rrr r rr rrÚ text_typeÚencoder"r r )rr rRs  rcCsTt|dƒr|St|tƒs(t|tƒr0|jr0t|ƒSt|tjtfƒrHt|ƒ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_safexs r*cCsjtjdtƒt|dƒs t|tƒr$|St|tƒs>t|tƒrF|jrFt |ƒSt|t j tfƒr^t |ƒ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). z"mark_for_escaping() is deprecated.r)ÚwarningsÚwarnrr%rrrrr&r rr#rÚ EscapeStringr()r)r r r Úmark_for_escapingˆs r.)r r+Z django.utilsrZdjango.utils.deprecationrZdjango.utils.functionalrrÚobjectrrr r#rÚPY3r-Z EscapeUnicoderrrr'Z SafeUnicoder*r.r r r r Ús(   !