xml.sax.saxutils — Утилиты SAX

Модуль xml.sax.saxutils содержит ряд классов и функций, которые часто полезны при создании приложений SAX, как в непосредственном использовании, так и в качестве базовых классов.

xml.sax.saxutils.escape(data[, entities])

Экранирует символы '&', '<', и '>' в строке данных.

Вы можете экранировать другие строки данных, передав словарь в качестве необязательного параметра entities. Ключи и значения должны быть строками; каждый ключ будет заменён соответствующим значением. Символы '&', '<' и '>' всегда экранируются, даже если задан параметр entities.

xml.sax.saxutils.unescape(data[, entities])

Деэкранирует символы '&', '<', и '>' в строке данных.

Вы можете деэкранировать другие строки данных, передав словарь в качестве необязательного параметра entities. Ключи и значения должны быть строками; каждый ключ будет заменён соответствующим значением. Символы '&amp', '<', и '>' всегда деэкранируются, даже если задан параметр entities.

Новая в версии 2.3.

xml.sax.saxutils.quoteattr(data[, entities])

Аналогично escape(), но также подготавливает data для использования в качестве значения атрибута. Возвращаемое значение — это строка с экранированными данными, содержащая все необходимые замены. quoteattr() выбирает символ кавычки на основе содержимого data, пытаясь избежать кодирования символов кавычек в строке. Если в data присутствуют как одинарные, так и двойные кавычки, то двойные кавычки будут закодированы, и data будет заключено в двойные кавычки. Результирующую строку можно использовать непосредственно в качестве значения атрибута:

>>> print "<element attr=%s>" % quoteattr("ab ' cd \" ef")
<element attr="ab ' cd &quot; ef">

Эта функция полезна при генерации значений атрибутов для HTML или любого SGML, используя справочный конкретный синтаксис.

Новая в версии 2.2.

class xml.sax.saxutils.XMLGenerator([out[, encoding]])

Этот класс реализует интерфейс ContentHandler, записывая события SAX обратно в XML-документ. Другими словами, использование XMLGenerator в качестве обработчика содержимого позволит воспроизвести исходный документ, который анализируется. out должен быть объектом, похожим на файл, по умолчанию — sys.stdout. encoding — кодировка выходного потока, по умолчанию — 'iso-8859-1'.

class xml.sax.saxutils.XMLFilterBase(base)

Этот класс предназначен для размещения между XMLReader и обработчиками событий приложения-клиента. По умолчанию он ничего не делает, кроме передачи запросов в чтец и событий обработчикам без изменений, но подклассы могут переопределять определённые методы для изменения потока событий или конфигурационных запросов по мере их прохождения.

xml.sax.saxutils.prepare_input_source(source[, base])

Эта функция принимает источник ввода и необязательный базовый URL и возвращает полностью разрешённый объект InputSource, готовый к чтению. Источник ввода может быть задан как строкой, объектом, похожим на файл, или объектом InputSource; парсеры будут использовать эту функцию для реализации полиморфного аргумента source в их методе parse().