diff options
author | Armin Ronacher <armin.ronacher@active-4.com> | 2010-06-22 19:48:44 +0200 |
---|---|---|
committer | Armin Ronacher <armin.ronacher@active-4.com> | 2010-06-22 19:48:44 +0200 |
commit | 05b792ccb62dd28f323da2254166213767ee86c2 (patch) | |
tree | e3a3e8ed7ebae6aab41092d18e4189b4a8c35f5c | |
parent | 20706f20512c143c3bcb1fbdcd729e57f4a3a82f (diff) | |
download | markupsafe-05b792ccb62dd28f323da2254166213767ee86c2.tar.gz |
Updated 'documentation'0.9
-rw-r--r-- | README.rst | 22 |
1 files changed, 22 insertions, 0 deletions
@@ -9,3 +9,25 @@ Markup(u'<script>alert(document.cookie);</script>') >>> tmpl = Markup("<em>%s</em>") >>> tmpl % "Peter > Lustig" Markup(u'<em>Peter > 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: + +>>> 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>') |