libearth.compat.etree — ElementTree compatibility layer

This proxy module offers a compatibility layer between several ElementTree implementations.

• If there’s installed lxml module, use lxml.etree.
• If xml.etree.cElementTree is available, use it.
• If IronPython, use xml.etree.ElementTree with libearth.compat.clrxmlreader.TreeBuilder.
• Otherwise, use xml.etree.ElementTree.

It provides the following two functions:

libearth.compat.etree.fromstring(string)

Parse the given XML string.

Parameters:string (str, bytes, basestring) – xml string to parse Returns:the element tree object

libearth.compat.etree.fromstringlist(iterable)

Parse the given chunks of XML string.

Parameters:iterable (collections.Iterable) – chunks of xml string to parse Returns:the element tree object

libearth.compat.etree.tostring(tree)

Generate an XML string from the given element tree.

Parameters:tree – an element tree object to serialize Returns:an xml string Return type:str, bytes