Generic element structure builder. This builder converts a sequence
of start, data, and end method calls to a well-formed element structure.
You can use this class to build an element structure using a custom XML
parser, or a parser for some other XML-like format.
The element_factory is called to create new Element instances when
given.
close(
)
Flushes the parser buffers, and returns the toplevel documen
element.
Returns:
An Element instance.
data(
data)
Adds text to the current element.
data is a string. This should be either an 8-bit string
containing ASCII text, or a Unicode string.
end(
tag)
Closes the current element.
tag is the element name.
Returns:
The closed element.
start(
tag, attrs)
Opens a new element.
tag is the element name.
attrs is a dictionary containing element attributes.