a
_q\' @ s6 d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd lm Z dd
lm
Z
d Z g d Z e
d
Ze
dZG dd de ZG dd deZee drG dd dejZdd ZG dd deZzddlmZmZmZ W n( e y ddl mZmZmZ Y n0 es2eZ e d dS ) z
markupsafe
~~~~~~~~~~
Implements an escape function and a Markup string to replace HTML
special characters with safe representations.
:copyright: 2010 Pallets
:license: BSD-3-Clause
N ) int_types) iteritems)Mapping)PY2) string_types) text_type)unichrz1.1.1)Markup soft_unicodeescape
escape_silentz(|<[^>]*>)z &([^& ;]+);c s e Zd ZdZdZd.ddZdd 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 ]Zeee e< qd%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>')
Nstrictc C s6 t |dr| }|d u r&t| |S t| |||S N__html__)hasattrr r __new__)clsbaseencodingerrorsr r 9/usr/lib64/python3.9/site-packages/markupsafe/__init__.pyr F s
zMarkup.__new__c C s | S Nr selfr r r r M s zMarkup.__html__c s4 t |tst|dr0| tt| | |S tS r )
isinstancer r __class__superr
__add__r NotImplementedr otherr r r r P s zMarkup.__add__c C s( t |dst|tr$| || S tS r )r r r r r r! r" r r r __radd__U s zMarkup.__radd__c C s t |tr | t| |S tS r )r r r r __mul__r! )r Znumr r r r& Z s
zMarkup.__mul__c s@ t |tr"t fdd|D }n t| j} t |S )Nc 3 s | ]}t | jV qd S r )_MarkupEscapeHelperr ).0xr r r c 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 r0 h s zMarkup.__repr__c C s | t| t| j|S r )r r joinmapr )r seqr r r r1 k s z Markup.joinc O s$ t t| jtj| g|R i |S r )listr2 r r splitr argskwargsr r r r5 p s z Markup.splitc O s$ t t| jtj| g|R i |S r )r4 r2 r r rsplitr6 r r r r9 u s z
Markup.rsplitc O s$ t t| jtj| g|R i |S r )r4 r2 r r
splitlinesr6 r r r r: 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}| v r t | S zL|d d dv rHtt|dd dW S |drhtt|dd W S W n ty| Y n0 | S )Nr )z#xz#X #)groupr int
startswith
ValueError)mnamer; r r handle_match s
z%Markup.unescape..handle_match)Z
_constantsr<
_entity_resubr )r rF r r; r unescape s zMarkup.unescapec C s" d td| }t| S )u :meth:`unescape` the markup, remove tags, and normalize
whitespace to single spaces.
>>> Markup('Main » About').striptags()
'Main » About'
r )r1
_striptags_rerH r5 r
rI )r strippedr r r striptags s zMarkup.striptagsc C s t |}|j| ur| |S |S )ztEscape a string. Calls :func:`escape` and ensures that for
subclasses the correct type is returned.
)r r )r srvr r r r s
z
Markup.escapec s* t t| fdd} j|_ j|_|S )Nc sD t t|t|| j}t |t|| j | | g|R i |S r )_escape_argspecr4 enumerater r r r6 Zorigr r func s z1Markup.make_simple_escaping_wrapper..func)getattrr r/ __doc__)rE rS r rR r make_simple_escaping_wrapper s
z#Markup.make_simple_escaping_wrapper) __getitem__
capitalizetitlelowerupperreplaceljustrjustlstriprstripcenterstrip translate
expandtabsswapcasezfillc C s t t| jt| | |S r )r, r2 r r partitionr r sepr r r rg s zMarkup.partitionc C s t t| jt| | |S r )r, r2 r r
rpartitionr rh r r r rj s zMarkup.rpartitionc O s( t | j}t||}| || ||S r )EscapeFormatterr _MagicFormatMappingr Zvformat)r r7 r8 formatterr r r format s
z
Markup.formatc C s |r t d| S )Nz,Unsupported format specification for Markup.)rC )r format_specr r r __html_format__ s zMarkup.__html_format__ __getslice__)r Nr ) r/
__module__ __qualname__rU __slots__r r r r% r& __rmul__r- r0 r1 r r5 r9 r: rI rM classmethodr rV methodlocalsrg rj rn rp r rq
__classcell__r r r$ r r
s@ $
r
c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
S ) rl zThis 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_indexr6 r r r __init__ s z _MagicFormatMapping.__init__c C sN |dkrD| j }| j d7 _ z | j| W S ty: Y n0 t|}| j| S )Nr r )r| rz LookupErrorstrr{ )r keyidxr r r rW s z _MagicFormatMapping.__getitem__c C s
t | jS r )iterr{ r r r r __iter__ s z _MagicFormatMapping.__iter__c C s
t | jS r )lenr{ r r r r __len__ s z_MagicFormatMapping.__len__N)r/ rr rs rU r} rW r r r r r r rl s
rl rn c @ s e Zd Zdd Zdd ZdS )rk c C s
|| _ d S r )r )r r r r r r} s zEscapeFormatter.__init__c C sd t |dr||}n@t |drB|r8td|t|| }ntj| |t |}t |
|S )Nrp r zFormat 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 rp rC rn typer string Formatter format_fieldr r )r valuero rO r r r r s
z EscapeFormatter.format_fieldN)r/ rr rs r} r r r r r rk s rk c C s2 |D ](\}}t |ds t|tr||| |< q| S )z,Helper for various string-wrapped functions.r )r r r )objiterabler r r r r r rP s rP 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| | jS r )r' r r )r itemr r r rW , s z _MarkupEscapeHelper.__getitem__c C s t | | jS r )r r r r r r r __str__/ s z_MarkupEscapeHelper.__str__c C s t | t| jS r )r r reprr r r r r r0 4 s z _MarkupEscapeHelper.__repr__c C s
t | jS r )rA r r r r r __int__7 s z_MarkupEscapeHelper.__int__c C s
t | jS r )floatr r r r r __float__: s z _MarkupEscapeHelper.__float__N) r/ rr rs rU r} rW r Z __unicode__r0 r r r r r r r' % s r' )r r
r soft_str) rU rer Z_compatr r r r r r r __version____all__compilerK rG r
rl r r rk rP objectr' Z _speedupsr r
r ImportErrorZ_nativer appendr r r r s6
E