lxml.etree.TreeBuilder

Package lxml :: Module etree :: Class TreeBuilder |
[hide private]
[frames] | no frames]

# Class TreeBuilder

          object --+
                   |
    _SaxParserTarget --+
                       |
                      TreeBuilder

TreeBuilder(self, element_factory=None, parser=None,
  comment_factory=None, pi_factory=None, insert_comments=True, insert_pis=True)

Parser target that builds a tree from parse event callbacks.

The factory arguments can be used to influence the creation of elements, comments and processing instructions.

By default, comments and processing instructions are inserted into the tree, but they can be ignored by passing the respective flags.

The final tree is returned by the `close()` method.

Instance Methods | [hide private]
__init__(self, element_factory=None, parser=None, comment_factory=None, pi_factory=None, insert_comments=True, insert_pis=True) x.__init__(...) initializes x; see help(type(x)) for signature |
a new object with type S, a subtype of T |
__new__(T, S, ...) |
close(self) Flushes the builder buffers, and returns the toplevel document element. |
comment(self, comment) Creates a comment using the factory, appends it (unless disabled) and returns it. |
data(self, data) Adds text to the current element. The value should be either an 8-bit string containing ASCII text, or a Unicode string. |
end(self, tag) Closes the current element. |
pi(self, target, data=None) Creates a processing instruction using the factory, appends it (unless disabled) and returns it. |
start(self, tag, attrs, nsmap=None) Opens a new element. |
Inherited from `object`: `__delattr__`, `__format__`, `__getattribute__`, `__hash__`, `__reduce__`, `__reduce_ex__`, `__repr__`, `__setattr__`, `__sizeof__`, `__str__`, `__subclasshook__`

Properties | [hide private]
Inherited from `object`: `__class__`

Method Details | [hide private]

### __init__(self, element_factory=None, parser=None, comment_factory=None, pi_factory=None, insert_comments=True, insert_pis=True) (Constructor) |
x.__init__(...) initializes x; see help(type(x)) for signature Overrides: object.__init__

### __new__(T, S, ...) |
Returns: a new object with type S, a subtype of T Overrides: object.__new__