Issue #5262: Improved fix.
[python.git] / Doc / library / xml.dom.pulldom.rst
blob80a91b8ec7fe3a32a44863643dac438b595196b1
2 :mod:`xml.dom.pulldom` --- Support for building partial DOM trees
3 =================================================================
5 .. module:: xml.dom.pulldom
6    :synopsis: Support for building partial DOM trees from SAX events.
7 .. moduleauthor:: Paul Prescod <paul@prescod.net>
10 .. versionadded:: 2.0
12 :mod:`xml.dom.pulldom` allows building only selected portions of a Document
13 Object Model representation of a document from SAX events.
16 .. class:: PullDOM([documentFactory])
18    :class:`xml.sax.handler.ContentHandler` implementation that ...
21 .. class:: DOMEventStream(stream, parser, bufsize)
23    ...
26 .. class:: SAX2DOM([documentFactory])
28    :class:`xml.sax.handler.ContentHandler` implementation that ...
31 .. function:: parse(stream_or_string[, parser[, bufsize]])
33    ...
36 .. function:: parseString(string[, parser])
38    ...
41 .. data:: default_bufsize
43    Default value for the *bufsize* parameter to :func:`parse`.
45    .. versionchanged:: 2.1
46       The value of this variable can be changed before calling :func:`parse` and the
47       new value will take effect.
50 .. _domeventstream-objects:
52 DOMEventStream Objects
53 ----------------------
56 .. method:: DOMEventStream.getEvent()
58    ...
61 .. method:: DOMEventStream.expandNode(node)
63    ...
66 .. method:: DOMEventStream.reset()
68    ...