U
‚xà[´' ã @ s< d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd lm Z dd
lm
Z
d Z d d
ddgZ e
d¡Ze
d¡ZG dd „ d e ƒZG dd„ deƒZee dƒrÈG dd„ dejƒZdd„ ZG dd„ deƒZzdd lmZmZmZ W n* e k
r" dd l mZmZmZ Y nX es8eZ e d ¡ dS ) uß
markupsafe
~~~~~~~~~~
Implements an escape function and a Markup string to replace HTML
special characters with safe representations.
:copyright: © 2010 by the Pallets team.
:license: BSD, see LICENSE for more details.
é Né )Ú int_types)Ú iteritems)ÚMapping)ÚPY2)Ú string_types)Ú text_type)Úunichrz1.1.0ÚMarkupÚ soft_unicodeÚescapeÚ
escape_silentz(|<[^>]*>)z &([^& ;]+);c s e Zd ZdZdZd.dd„Zdd „ Z‡ fd
d „Zd d
„ Zdd„ Z e Z
dd„ Z dd„ Z dd„ Z
ej
je
_dd„ Zejje_dd„ Zejje_dd„ Zejje_d d „ Zd d „ Zed d!„ ƒZd"d#„ Zd$D ]Zeeƒeƒ e< qÂd%d&„ Zd'd(„ Zd)d*„ Zd+d,„ Z e ed-ƒr
ed-ƒZ [[‡ Z S )/r
aö A string that is ready to be safely inserted into an HTML or XML
document, either because it was escaped or because it was marked
safe.
Passing an object to the constructor converts it to text and wraps
it to mark it safe without escaping. To escape the text, use the
:meth:`escape` class method instead.
>>> Markup('Hello, World!')
Markup('Hello, World!')
>>> Markup(42)
Markup('42')
>>> Markup.escape('Hello, World!')
Markup('Hello <em>World</em>!')
This implements the ``__html__()`` interface that some frameworks
use. Passing an object that implements ``__html__()`` will wrap the
output of that method, marking it safe.
>>> class Foo:
... def __html__(self):
... return 'foo'
...
>>> Markup(Foo())
Markup('foo')
This is a subclass of the text type (``str`` in Python 3,
``unicode`` in Python 2). It has the same methods as that type, but
all methods escape their arguments and return a ``Markup`` instance.
>>> Markup('%s') % 'foo & bar'
Markup('foo & bar')
>>> Markup('Hello ') + ''
Markup('Hello <foo>')
© Ú NÚstrictc C s6 t |dƒr| ¡ }|d kr&t | |¡S t | |||¡S ©NÚ__html__)Úhasattrr r Ú__new__)ÚclsÚbaseÚencodingÚerrorsr r ú5/usr/lib/python3/dist-packages/markupsafe/__init__.pyr F s
zMarkup.__new__c C s | S ©Nr ©Úselfr r r r M s zMarkup.__html__c s4 t |tƒst|dƒr0| tt| ƒ | |¡¡¡S tS r ) Ú
isinstancer r Ú __class__Úsuperr
Ú__add__r ÚNotImplemented©r Úother©r r r r P s zMarkup.__add__c C s( t |dƒst|tƒr$| |¡ | ¡S tS r )r r r r r r! r" r r r Ú__radd__U s zMarkup.__radd__c C s t |tƒr | t | |¡¡S tS r )r r r r Ú__mul__r! )r Znumr r r r& Z s
zMarkup.__mul__c s@ t |tƒr"t‡ fdd„|D ƒƒ}n t|ˆ jƒ}ˆ t ˆ |¡¡S )Nc 3 s | ]}t |ˆ jƒV qd S r )Ú_MarkupEscapeHelperr )Ú.0Úxr r r Ú c s z!Markup.__mod__..)r Útupler' r r r Ú__mod__)r Úargr r r r, a s
zMarkup.__mod__c C s d| j jt | ¡f S )Nz%s(%s))r Ú__name__r Ú__repr__r r r r r/ h s zMarkup.__repr__c C s | t | t| j|ƒ¡¡S r )r r ÚjoinÚmapr )r Úseqr r r r0 k s z Markup.joinc O s t t| jtj| f|ž|ŽƒƒS r )Úlistr1 r r Úsplit©r ÚargsÚkwargsr r r r4 p s z Markup.splitc O s t t| jtj| f|ž|ŽƒƒS r )r3 r1 r r Úrsplitr5 r r r r8 u s z
Markup.rsplitc O s t t| jtj| f|ž|ŽƒƒS r )r3 r1 r r Ú
splitlinesr5 r r r r9 z s zMarkup.splitlinesc s( ddl m‰ ‡ fdd„}t |t| ƒ¡S )uß Convert escaped markup back into a text string. This replaces
HTML entities with the characters they represent.
>>> Markup('Main » About').unescape()
'Main » About'
r ©Ú
HTML_ENTITIESc sˆ | d¡}|ˆ kr tˆ | ƒS zL|d d… dkrHtt|dd … dƒƒW S | d¡rhtt|dd … ƒƒW S W n tk
r~ Y nX | ¡ S )Nr é )z#xz#Xé ú#)Úgroupr ÚintÚ
startswithÚ
ValueError)ÚmÚnamer: r r Ú handle_matchˆ s
z%Markup.unescape..handle_match)Z
_constantsr; Ú
_entity_reÚsubr )r rE r r: r Úunescape s zMarkup.unescapec C s" d t d| ¡ ¡ ¡}t|ƒ ¡ S )u¼ :meth:`unescape` the markup, remove tags, and normalize
whitespace to single spaces.
>>> Markup('Main » About').striptags()
'Main » About'
ú r )r0 Ú
_striptags_rerG r4 r
rH )r Ústrippedr r r Ú striptags˜ s zMarkup.striptagsc C s t |ƒ}|j| k r| |ƒS |S )ztEscape a string. Calls :func:`escape` and ensures that for
subclasses the correct type is returned.
)r r )r ÚsÚrvr r r r ¢ s
z
Markup.escapec s* t t| ƒ‰ ‡ fdd„}ˆ j|_ˆ j|_|S )Nc s> t t|ƒt|ƒ| jƒ}t |t|ƒ| jƒ | ˆ | f|ž|Ž¡S r )Ú_escape_argspecr3 Ú enumerater r r r5 ©Zorigr r Úfunc¯ s z1Markup.make_simple_escaping_wrapper..func)Úgetattrr r. Ú__doc__)rD rR r rQ r Ú make_simple_escaping_wrapper¬ s
z#Markup.make_simple_escaping_wrapper)Ú __getitem__Ú
capitalizeÚtitleÚlowerÚupperÚreplaceÚljustÚrjustÚlstripÚrstripÚcenterÚstripÚ translateÚ
expandtabsÚswapcaseÚzfillc C s t t| jt | | |¡¡ƒƒS r )r+ r1 r r Ú partitionr ©r Úsepr r r rf Ì s zMarkup.partitionc C s t t| jt | | |¡¡ƒƒS r )r+ r1 r r Ú
rpartitionr rg r r r ri Ï s zMarkup.rpartitionc O s( t | jƒ}t||ƒ}| | | ||¡¡S r )ÚEscapeFormatterr Ú_MagicFormatMappingr Zvformat)r r6 r7 Z formatterr r r ÚformatÒ s
z
Markup.formatc C s |r t dƒ‚| S )Nz,Unsupported format specification for Markup.)rB )r Ú format_specr r r Ú__html_format__× s zMarkup.__html_format__Ú __getslice__)r Nr ) r. Ú
__module__Ú __qualname__rT Ú __slots__r r r r% r& Ú__rmul__r, r/ r0 r r4 r8 r9 rH rL Ú classmethodr rU ÚmethodÚlocalsrf ri rl rn r ro Ú
__classcell__r r r$ r r
s@ $
c @ s0 e Zd ZdZdd„ Zdd„ Zdd„ Zdd „ Zd
S ) rk zÍThis class implements a dummy wrapper to fix a bug in the Python
standard library for string formatting.
See http://bugs.python.org/issue13598 for information about why
this is necessary.
c C s || _ || _d| _d S )Nr )Ú_argsÚ_kwargsÚ _last_indexr5 r r r Ú__init__ë s z _MagicFormatMapping.__init__c C sP |dkrF| j }| j d7 _ z | j| W S tk
r< Y nX t|ƒ}| j| S )Nr r )rz rx Ú LookupErrorÚstrry )r ÚkeyÚidxr r r rV ð s z _MagicFormatMapping.__getitem__c C s
t | jƒS r )Úiterry r r r r Ú__iter__û s z _MagicFormatMapping.__iter__c C s
t | jƒS r )Úlenry r r r r Ú__len__þ s z_MagicFormatMapping.__len__N)r. rp rq rT r{ rV r rƒ r r r r rk ã s
rk rl c @ s e Zd Zdd„ Zdd„ ZdS )rj c C s
|| _ d S r )r )r r r r r r{ s zEscapeFormatter.__init__c C sd t |dƒr| |¡}n@t |dƒrB|r8td |t|ƒ¡ƒ‚| ¡ }ntj | |t |ƒ¡}t |
|¡ƒS )Nrn r zžFormat specifier {0} given, but {1} does not define __html_format__. A class that defines __html__ must define __html_format__ to work with format specifiers.) r rn rB rl Útyper ÚstringÚ FormatterÚ format_fieldr r )r Úvaluerm rN r r r r‡ s
ýÿ
z EscapeFormatter.format_fieldN)r. rp rq r{ r‡ r r r r rj s rj c C s2 |D ](\}}t |dƒs t|tƒr||ƒ| |< q| S )z,Helper for various string-wrapped functions.r )r r r )ÚobjÚiterabler r~ rˆ r r r rO s rO c @ sD e Zd ZdZdd„ Zdd„ Zdd„ ZeZdd „ Zd
d „ Z d d
„ Z
dS )r' zHelper for Markup.__mod__c C s || _ || _d S r )r‰ r )r r‰ r r r r r{ ( s z _MarkupEscapeHelper.__init__c C s t | j| | jƒS r )r' r‰ r )r Úitemr r r rV , s z _MarkupEscapeHelper.__getitem__c C s t | | j¡ƒS r )r r r‰ r r r r Ú__str__/ s z_MarkupEscapeHelper.__str__c C s t | t| jƒ¡ƒS r )r} r Úreprr‰ r r r r r/ 4 s z _MarkupEscapeHelper.__repr__c C s
t | jƒS r )r@ r‰ r r r r Ú__int__7 s z_MarkupEscapeHelper.__int__c C s
t | jƒS r )Úfloatr‰ r r r r Ú __float__: s z _MarkupEscapeHelper.__float__N) r. rp rq rT r{ rV rŒ Z __unicode__r/ rŽ r r r r r r' % s r' )r r
r Úsoft_str) rT Úrer… Z_compatr r r r r r r Ú __version__Ú__all__ÚcompilerJ rF r
rk r r† rj rO Úobjectr' Z _speedupsr r
r Ú ImportErrorZ_nativer‘ Úappendr r r r Ú s6
E