Package genshi :: Module output :: Class XMLSerializer

Class XMLSerializer

object --+
         |
        XMLSerializer
Known Subclasses:

Produces XML text from an event stream.

>>> from genshi.builder import tag
>>> elem = tag.div(tag.a(href='foo'), tag.br, tag.hr(noshade=True))
>>> print(''.join(XMLSerializer()(elem.generate())))
<div><a href="foo"/><br/><hr noshade="True"/></div>
Instance Methods
 
__init__(self, doctype=None, strip_whitespace=True, namespace_prefixes=None, cache=True)
Initialize the XML serializer.
 
__call__(self, stream)

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Properties

Inherited from object: __class__

Method Details

__init__(self, doctype=None, strip_whitespace=True, namespace_prefixes=None, cache=True)
(Constructor)

 
Initialize the XML serializer.
Parameters:
  • doctype - a (name, pubid, sysid) tuple that represents the DOCTYPE declaration that should be included at the top of the generated output, or the name of a DOCTYPE as defined in DocType.get
  • strip_whitespace - whether extraneous whitespace should be stripped from the output
  • cache - whether to cache the text output per event, which improves performance for repetitive markup
Overrides: object.__init__
Notes:
  • Changed in 0.4.2: The doctype parameter can now be a string.
  • Changed in 0.6: The cache parameter was added