xml.dom.pulldom — Поддержка построения частичных DOM-деревьев

Исходный код: Lib/xml/dom/pulldom.py

Модуль xml.dom.pulldom предоставляет «pull-парсер», который также может быть запрошен для создания фрагментов документа, доступных через DOM, при необходимости. Основная концепция заключается в извлечении «событий» из потока входящего XML и обработке их. В отличие от SAX, который также использует модель обработки событий с обратными вызовами, пользователь pull-парсера отвечает за явное извлечение событий из потока, циклически перебирая эти события до тех пор, пока обработка не будет завершена или не возникнет ошибка.

from xml.dom.pulldom import parse
from xml.sax import make_parser
from xml.sax.handler import feature_external_ges

parser = make_parser()
parser.setFeature(feature_external_ges, True)
parse(filename, parser=parser)

Пример:

from xml.dom import pulldom

doc = pulldom.parse('sales_items.xml')
for event, node in doc:
    if event == pulldom.START_ELEMENT and node.tagName == 'item':
        if int(node.getAttribute('price')) > 50:
            doc.expandNode(node)
            print(node.toxml())

event является константой и может быть одной из:

• START_ELEMENT
• END_ELEMENT
• COMMENT
• START_DOCUMENT
• END_DOCUMENT
• CHARACTERS
• PROCESSING_INSTRUCTION
• IGNORABLE_WHITESPACE

node — это объект типа xml.dom.minidom.Document, xml.dom.minidom.Element или xml.dom.minidom.Text.

Поскольку документ обрабатывается как «плоский» поток событий, дерево документа неявно просматривается, и нужные элементы находятся независимо от их глубины в дереве. Другими словами, нет необходимости учитывать иерархические проблемы, такие как рекурсивный поиск узлов документа, хотя если контекст элементов был важен, то нужно либо поддерживать состояние, связанное с контекстом (например, запоминать, где вы находитесь в документе в любой момент), либо использовать метод DOMEventStream.expandNode() и переключиться на обработку, связанную с DOM.

class xml.dom.pulldom.PullDom(documentFactory=None)

Подкласс xml.sax.handler.ContentHandler.

class xml.dom.pulldom.SAX2DOM(documentFactory=None)

Подкласс xml.sax.handler.ContentHandler.

xml.dom.pulldom.parse(stream_or_string, parser=None, bufsize=None)

Возвращает DOMEventStream из заданного входного значения. stream_or_string может быть именем файла или объектом, подобным файлу. parser, если задан, должен быть объектом XMLReader. Эта функция изменит обработчик документа парсера и активирует поддержку пространства имен; другие настройки парсера (например, установка разрешителя сущностей) должны быть выполнены заранее.

Если у вас есть XML в строке, вы можете использовать функцию parseString() вместо этого:

xml.dom.pulldom.parseString(string, parser=None)

Возвращает DOMEventStream, который представляет собой (Unicode) строку.

xml.dom.pulldom.default_bufsize

Значение по умолчанию для параметра bufsize для parse().

Значение этой переменной может быть изменено перед вызовом parse(), и новое значение вступит в силу.