Язык программирования Python [Г. Россум] (pdf) читать постранично, страница - 134

атрибут не имеет значения по
умолчанию). Вам следует переопределить этот атрибут в производном классе — в
исходной реализации он равен пустому словарю.
elements
Отображение имен элементов к кортежам из функций (или других объектов, поддерживающих вызов), предназначенных для обработки открывающего и закрывающего тега для этого элемента или None, если должен быть вызван метод
unknown_starttag() или unknown_endtag(). Вам следует переопределить
этот атрибут в производном классе — в исходной реализации он равен пустому
словарю.
entitydefs
Отображение имен сущностей к их значениям. В исходной реализации равен словарю, в котором есть записи с ключами ’lt’, ’gt’, ’amp’, ’quot’ и ’apos’
(обязательный набор для всех типов документов).
reset()
Возвращает экземпляр в исходное состояние. Все необработанные данные теряются. Этот метод неявно вызывается при инициализации.
setnomoretags()
Останавливает обработку тегов. Весь последующий текст воспринимается без обработки (CDATA).
setliteral()
Временно приостанавливает обработку тегов. Последующий текст воспринимается
без обработки (CDATA). Обработчик автоматически выходит из этого режима, как
только дойдет до закрывающего тега для последнего открытого.
feed(data)
Передает экземпляру размеченный текст data для обработки. Обрабатываются

406

Глава 29. Средства работы с языками структурной разметки
только завершенные данные, остальное остается в буфере до тех пор, пока не
будет передана следующая порция данных или не будет вызван метод close().

close()
Завершает обработку всех данных в буфере. Вы можете переопределить этот метод
в производном классе, добавив дополнительные действия. Переопределенный метод
всегда должен вызывать исходную версию метода.
translate_references(data)
Преобразует все ссылки на символы (‘&#ref;’) и сущности (‘&ref;’) в строке
data и возвращает полученный текст.
getnamespace()
Возвращает отображение аббревиатур для (активных в настоящий момент) пространств имен к их URI (Uniform Resource Identifier, универсальный идентификатор
ресурса).
handle_xml(encoding, standalone)
Вызывается для обработки тега ‘’. В качестве аргументов используются значения одноименных атрибутов тега (по умолчанию используются None и
строка ’no’ соответственно). Исходная реализация ничего не делает.
handle_doctype(tag, pubid, syslit, data)
Вызывается для обработки объявления типа документа. Аргумент tag является
строкой с именем корневого элемента, pubid — формальный публичный идентификатор (или None, если не задан), syslit — системный идентификатор и
data — необработанный текст встроенного в документ DTD (Document Type
Definition, определение типа документа) или None, если документ не содержит
DTD. Исходная реализация ничего не делает.
handle_starttag(tag, method, attributes)
Вызывается для обработки открывающих тегов, для которых задан обработчик в атрибуте elements. Аргумент tag является строкой с именем тега, method — функция (метод), предназначенная для обработки открывающего тега, и attributes — словарь, отображающий имена атрибутов, найденных внутри угловых скобок тега, к их значениям (после обработки ссылок
на символы и сущности). Например, для обработки открывающего тега ‘