MarkupSafe 0.18

Meta

• License: BSD License (BSD)
• Author: Armin Ronacher

Classifiers

• Development Status
  • 5 - Production/Stable
• Environment
  • Web Environment
• Intended Audience
  • Developers
• License
  • OSI Approved :: BSD License
• Operating System
  • OS Independent
• Programming Language
  • Python
  • Python :: 3
• Topic
  • Internet :: WWW/HTTP :: Dynamic Content
  • Software Development :: Libraries :: Python Modules
  • Text Processing :: Markup :: HTML

Implements a unicode subclass that supports HTML strings:

>>> from markupsafe import Markup, escape
>>> escape("<script>alert(document.cookie);</script>")
Markup(u'&lt;script&gt;alert(document.cookie);&lt;/script&gt;')
>>> tmpl = Markup("<em>%s</em>")
>>> tmpl % "Peter > Lustig"
Markup(u'<em>Peter &gt; Lustig</em>')

If you want to make an object unicode that is not yet unicode but don’t want to lose the taint information, you can use the soft_unicode function. (On Python 3 you can also use soft_str which is a different name for the same function).

>>> from markupsafe import soft_unicode
>>> soft_unicode(42)
u'42'
>>> soft_unicode(Markup('foo'))
Markup(u'foo')

Objects can customize their HTML markup equivalent by overriding the __html__ function:

>>> class Foo(object):
... def __html__(self):
... return '<strong>Nice</strong>'
...
>>> escape(Foo())
Markup(u'<strong>Nice</strong>')
>>> Markup(Foo())
Markup(u'<strong>Nice</strong>')

Since MarkupSafe 0.10 there is now also a separate escape function called escape_silent that returns an empty string for None for consistency with other systems that return empty strings for None when escaping (for instance Pylons’ webhelpers).

If you also want to use this for the escape method of the Markup object, you can create your own subclass that does that:

from markupsafe import Markup, escape_silent as escape

class SilentMarkup(Markup):
 __slots__ = ()

 @classmethod
 def escape(cls, s):
 return cls(escape(s))

Verified details

These details have been verified by PyPI

Owner

• Pallets Projects

Unverified details

These details have not been verified by PyPI

Project links

• Homepage

• Download URL: MarkupSafe-0.18.tar.gz
• Upload date: May 22, 2013
• Size: 11.7 kB
• Tags: Source
• Uploaded using Trusted Publishing? No

Hashes for MarkupSafe-0.18.tar.gz

Algorithm	Hash digest
SHA256	b7d5d688bdd345bfa897777d297756688cf02e1b3742c56885e2e5c2b996ff82
MD5	f8d252fd05371e51dec2fe9a36890687
BLAKE2b-256	98cf197c3b0f73224b84eb419a967f87565bcc0b0c1147012397e6bd2d45e253

See more details on using hashes here.