22

✏️ Editing: xml.dom.pulldom.rst.txt

:mod:`xml.dom.pulldom` --- Support for building partial DOM trees
=================================================================

.. module:: xml.dom.pulldom
   :synopsis: Support for building partial DOM trees from SAX events.
.. moduleauthor:: Paul Prescod <paul@prescod.net>

.. versionadded:: 2.0

**Source code:** :source:`Lib/xml/dom/pulldom.py`

--------------

:mod:`xml.dom.pulldom` allows building only selected portions of a Document
Object Model representation of a document from SAX events.

.. warning::

The :mod:`xml.dom.pulldom` module is not secure against
   maliciously constructed data.  If you need to parse untrusted or
   unauthenticated data see :ref:`xml-vulnerabilities`.

.. class:: PullDOM([documentFactory])

:class:`xml.sax.handler.ContentHandler` implementation that ...

.. class:: DOMEventStream(stream, parser, bufsize)

...

.. class:: SAX2DOM([documentFactory])

:class:`xml.sax.handler.ContentHandler` implementation that ...

.. function:: parse(stream_or_string[, parser[, bufsize]])

...

.. function:: parseString(string[, parser])

...

.. data:: default_bufsize

Default value for the *bufsize* parameter to :func:`parse`.

.. versionchanged:: 2.1
      The value of this variable can be changed before calling :func:`parse` and the
      new value will take effect.

.. _domeventstream-objects:

DOMEventStream Objects
----------------------

.. method:: DOMEventStream.getEvent()

...

.. method:: DOMEventStream.expandNode(node)

...

.. method:: DOMEventStream.reset()

...

MR SKB