Staging
v0.8.1
https://github.com/python/cpython
Raw File
Tip revision: d6e19c3513a24950f3d896f1031de17d8f090434 authored by Georg Brandl on 30 January 2011, 14:03:33 UTC
Bump version.
Tip revision: d6e19c3
__init__.py
"""
General functions for HTML manipulation.
"""


_escape_map = {ord('&'): '&amp;', ord('<'): '&lt;', ord('>'): '&gt;'}
_escape_map_full = {ord('&'): '&amp;', ord('<'): '&lt;', ord('>'): '&gt;',
                    ord('"'): '&quot;', ord('\''): '&#x27;'}

# NB: this is a candidate for a bytes/string polymorphic interface

def escape(s, quote=True):
    """
    Replace special characters "&", "<" and ">" to HTML-safe sequences.
    If the optional flag quote is true (the default), the quotation mark
    character (") is also translated.
    """
    if quote:
        return s.translate(_escape_map_full)
    return s.translate(_escape_map)
back to top