cpython/Doc/library/xml.dom.pulldom.rst

80 lines
1.5 KiB
ReStructuredText

: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()
...