mirror of
https://github.com/correl/SleekXMPP.git
synced 2024-11-28 03:00:16 +00:00
bd9bf3f1c7
Will now always show top-level namespace, unless it is the same as the stream's default namespace. Also added the XMPP stream namespace to the namespace map as 'stream'.
120 lines
4 KiB
Python
120 lines
4 KiB
Python
"""
|
|
SleekXMPP: The Sleek XMPP Library
|
|
Copyright (C) 2010 Nathanael C. Fritz
|
|
This file is part of SleekXMPP.
|
|
|
|
See the file LICENSE for copying permission.
|
|
"""
|
|
|
|
from __future__ import unicode_literals
|
|
import types
|
|
|
|
|
|
def tostring(xml=None, xmlns='', stanza_ns='', stream=None,
|
|
outbuffer='', top_level=False):
|
|
"""
|
|
Serialize an XML object to a Unicode string.
|
|
|
|
If namespaces are provided using xmlns or stanza_ns, then elements
|
|
that use those namespaces will not include the xmlns attribute in
|
|
the output.
|
|
|
|
Arguments:
|
|
xml -- The XML object to serialize. If the value is None,
|
|
then the XML object contained in this stanza
|
|
object will be used.
|
|
xmlns -- Optional namespace of an element wrapping the XML
|
|
object.
|
|
stanza_ns -- The namespace of the stanza object that contains
|
|
the XML object.
|
|
stream -- The XML stream that generated the XML object.
|
|
outbuffer -- Optional buffer for storing serializations during
|
|
recursive calls.
|
|
top_level -- Indicates that the element is the outermost
|
|
element.
|
|
"""
|
|
# Add previous results to the start of the output.
|
|
output = [outbuffer]
|
|
|
|
# Extract the element's tag name.
|
|
tag_name = xml.tag.split('}', 1)[-1]
|
|
|
|
# Extract the element's namespace if it is defined.
|
|
if '}' in xml.tag:
|
|
tag_xmlns = xml.tag.split('}', 1)[0][1:]
|
|
else:
|
|
tag_xmlns = u''
|
|
|
|
default_ns = ''
|
|
stream_ns = ''
|
|
if stream:
|
|
default_ns = stream.default_ns
|
|
stream_ns = stream.stream_ns
|
|
|
|
# Output the tag name and derived namespace of the element.
|
|
namespace = u''
|
|
if top_level and tag_xmlns not in ['', default_ns, stream_ns] or \
|
|
tag_xmlns not in ['', xmlns, stanza_ns, stream_ns]:
|
|
namespace = u' xmlns="%s"' % tag_xmlns
|
|
if stream and tag_xmlns in stream.namespace_map:
|
|
mapped_namespace = stream.namespace_map[tag_xmlns]
|
|
if mapped_namespace:
|
|
tag_name = u"%s:%s" % (mapped_namespace, tag_name)
|
|
output.append(u"<%s" % tag_name)
|
|
output.append(namespace)
|
|
|
|
# Output escaped attribute values.
|
|
for attrib, value in xml.attrib.items():
|
|
value = xml_escape(value)
|
|
if '}' not in attrib:
|
|
output.append(' %s="%s"' % (attrib, value))
|
|
else:
|
|
attrib_ns = attrib.split('}')[0][1:]
|
|
attrib = attrib.split('}')[1]
|
|
if stream and attrib_ns in stream.namespace_map:
|
|
mapped_ns = stream.namespace_map[attrib_ns]
|
|
if mapped_ns:
|
|
output.append(' %s:%s="%s"' % (mapped_ns,
|
|
attrib,
|
|
value))
|
|
|
|
if len(xml) or xml.text:
|
|
# If there are additional child elements to serialize.
|
|
output.append(u">")
|
|
if xml.text:
|
|
output.append(xml_escape(xml.text))
|
|
if len(xml):
|
|
for child in xml.getchildren():
|
|
output.append(tostring(child, tag_xmlns, stanza_ns, stream))
|
|
output.append(u"</%s>" % tag_name)
|
|
elif xml.text:
|
|
# If we only have text content.
|
|
output.append(u">%s</%s>" % (xml_escape(xml.text), tag_name))
|
|
else:
|
|
# Empty element.
|
|
output.append(u" />")
|
|
if xml.tail:
|
|
# If there is additional text after the element.
|
|
output.append(xml_escape(xml.tail))
|
|
return u''.join(output)
|
|
|
|
|
|
def xml_escape(text):
|
|
"""
|
|
Convert special characters in XML to escape sequences.
|
|
|
|
Arguments:
|
|
text -- The XML text to convert.
|
|
"""
|
|
if type(text) != types.UnicodeType:
|
|
text = list(unicode(text, 'utf-8', 'ignore'))
|
|
else:
|
|
text = list(text)
|
|
escapes = {u'&': u'&',
|
|
u'<': u'<',
|
|
u'>': u'>',
|
|
u"'": u''',
|
|
u'"': u'"'}
|
|
for i, c in enumerate(text):
|
|
text[i] = escapes.get(c, c)
|
|
return u''.join(text)
|