xml.dom.minidom.md
1> **Источник:** https://python-all.ru/3.15/library/xml.dom.minidom.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `xml.dom.minidom` – Минимальная реализация DOM89**Исходный код:** [Lib/xml/dom/minidom.py](https://python-all.ru/src/3.15/Lib/xml/dom/minidom.py)1011---1213`xml.dom.minidom` – это минимальная реализация интерфейса Document Object Model с API, похожим на API в других языках. Она призвана быть проще, чем полный DOM, и значительно меньше. Пользователям, которые ещё недостаточно знакомы с DOM, стоит рассмотреть использование модуля [`xml.etree.ElementTree`](https://python-all.ru/3.15/library/xml.etree.elementtree.html#module-xml.etree.ElementTree) для обработки XML.1415> **Примечание**16>17> Если требуется разобрать непроверенные или неаутентифицированные данные, см. [Безопасность XML](https://python-all.ru/3.15/library/xml.html#xml-security).1819Приложения, работающие с DOM, обычно начинают с разбора XML в DOM. С `xml.dom.minidom` это делается с помощью функций parse:2021```python22from xml.dom.minidom import parse, parseString2324dom1 = parse('c:\\temp\\mydata.xml') # разобрать XML-файл по имени2526datasource = open('c:\\temp\\mydata.xml')27dom2 = parse(datasource) # разобрать открытый файл2829dom3 = parseString('<myxml>Some data<empty/> some more data</myxml>')30```3132Функция [`parse()`](https://python-all.ru/3.15/library/xml.dom.minidom.html#xml.dom.minidom.parse) может принимать имя файла или открытый файловый объект.3334#### `xml.dom.minidom.parse(filename_or_file, parser=None, bufsize=None)`3536Возвращает `Document` из переданных входных данных. *filename\_or\_file* может быть либо именем файла, либо объектом, похожим на файл. *parser*, если указан, должен быть объектом парсера SAX2. Эта функция изменит обработчик документа парсера и включит поддержку пространств имён; остальные настройки парсера (например, установка обработчика сущностей) должны быть выполнены заранее.3738Если XML находится в строке, можно использовать функцию [`parseString()`](https://python-all.ru/3.15/library/xml.dom.minidom.html#xml.dom.minidom.parseString) вместо этого:3940#### `xml.dom.minidom.parseString(string, parser=None)`4142Возвращает `Document`, представляющий *строку*. Этот метод создаёт объект [`io.StringIO`](https://python-all.ru/3.15/library/io.html#io.StringIO) для строки и передаёт его в [`parse()`](https://python-all.ru/3.15/library/xml.dom.minidom.html#xml.dom.minidom.parse).4344Обе функции возвращают объект `Document`, представляющий содержимое документа.4546Функции [`parse()`](https://python-all.ru/3.15/library/xml.dom.minidom.html#xml.dom.minidom.parse) и [`parseString()`](https://python-all.ru/3.15/library/xml.dom.minidom.html#xml.dom.minidom.parseString) подключают XML-парсер к «построителю DOM», который может принимать события разбора от любого SAX-парсера и преобразовывать их в DOM-дерево. Названия функций могут вводить в заблуждение, но их легко понять при изучении интерфейсов. Разбор документа завершается до того, как эти функции вернутся; просто сами эти функции не предоставляют реализацию парсера.4748Можно также создать `Document`, вызвав метод объекта «DOM Implementation» (реализация DOM). Получить этот объект можно либо вызовом функции `getDOMImplementation()` в пакете [`xml.dom`](https://python-all.ru/3.15/library/xml.dom.html#module-xml.dom), либо в модуле `xml.dom.minidom`. Получив `Document`, можно добавлять в него дочерние узлы, чтобы заполнить DOM:4950```python51from xml.dom.minidom import getDOMImplementation5253impl = getDOMImplementation()5455newdoc = impl.createDocument(None, "some_tag", None)56top_element = newdoc.documentElement57text = newdoc.createTextNode('Some textual content.')58top_element.appendChild(text)59```6061Получив объект DOM-документа, можно обращаться к частям XML-документа через его свойства и методы. Эти свойства определены в спецификации DOM. Основное свойство объекта документа – это свойство `documentElement`. Оно даёт доступ к корневому элементу XML-документа: тому, который содержит все остальные. Вот пример программы:6263```python64dom3 = parseString("<myxml>Some data</myxml>")65assert dom3.documentElement.tagName == "myxml"66```6768Когда работа с DOM-деревом завершена, можно по желанию вызвать метод `unlink()`, чтобы стимулировать раннюю очистку ставших ненужными объектов. `unlink()` – это специфичное для `xml.dom.minidom` расширение DOM API, которое делает узел и его потомков по сути бесполезными. В противном случае сборщик мусора Python со временем позаботится об объектах в дереве.6970> **См. также**71>72> **[Спецификация объектной модели документа (DOM) уровня 1](https://python-all.ru/3.15/library/xml.dom.minidom.html)**73>74> Рекомендация W3C для DOM, поддерживаемая `xml.dom.minidom`.7576## Объекты DOM7778Определение DOM API для Python даётся как часть документации модуля [`xml.dom`](https://python-all.ru/3.15/library/xml.dom.html#module-xml.dom). В этом разделе перечислены отличия между API и `xml.dom.minidom`.7980#### `Node.unlink()`8182Разрывает внутренние ссылки внутри DOM, чтобы он мог быть собран сборщиком мусора на версиях Python без циклического GC. Даже если циклический GC доступен, использование этого метода может освободить большие объёмы памяти раньше, поэтому вызов его для DOM-объектов, как только они больше не нужны, является хорошей практикой. Этот метод нужно вызывать только для объекта `Document`, но его можно вызывать и для дочерних узлов, чтобы удалить потомков этого узла.8384Можно избежать явного вызова этого метода, используя оператор [`with`](https://python-all.ru/3.15/reference/compound_stmts.html#with). Следующий код автоматически вызовет unlink для *dom* при выходе из блока `with`:8586```python87with xml.dom.minidom.parse(datasource) as dom:88 ... # Работать с DOM.89```9091#### `Node.writexml(writer, indent='', addindent='', newl='', encoding=None, standalone=None)`9293Записывает XML в объект writer. Writer принимает на вход тексты, а не байты; у него должен быть метод `write()`, соответствующий интерфейсу файлового объекта. Параметр *indent* задаёт отступ текущего узла. Параметр *addindent* задаёт дополнительный отступ для подузлов текущего узла. Параметр *newl* указывает строку, используемую для завершения строк.9495Для узла `Document` можно использовать дополнительный именованный аргумент *encoding* для указания поля кодировки в заголовке XML.9697Аналогично, явное указание аргумента *standalone* приводит к добавлению объявления standalone в пролог XML-документа. Если значение установлено в `True`, добавляется `standalone="yes"`, иначе устанавливается в ``. Если аргумент не указан, объявление не включается в документ.9899Изменено в версии 3.8: Метод `writexml()` теперь сохраняет порядок атрибутов, заданный пользователем.100101Изменено в версии 3.9: Добавлен параметр *standalone*.102103#### `Node.toxml(encoding=None, standalone=None)`104105Возвращает строку или байтовую строку, содержащую XML, представленный узлом DOM.106107При явном указании аргумента *encoding* [\[1\]](https://python-all.ru/3.15/library/xml.dom.minidom.html#id3) результат представляет собой байтовую строку в указанной кодировке. Если аргумент *encoding* не указан, результатом является строка Unicode, и XML-объявление в результирующей строке не указывает кодировку. Кодирование этой строки в кодировку, отличную от UTF-8, скорее всего, некорректно, поскольку UTF-8 является кодировкой XML по умолчанию.108109Аргумент *standalone* ведёт себя точно так же, как в [`writexml()`](https://python-all.ru/3.15/library/xml.dom.minidom.html#xml.dom.minidom.Node.writexml).110111Изменено в версии 3.8: Метод `toxml()` теперь сохраняет порядок атрибутов, заданный пользователем.112113Изменено в версии 3.9: Добавлен параметр *standalone*.114115#### `Node.toprettyxml(indent='\t', newl='\n', encoding=None, standalone=None)`116117Возвращает версию документа с красивым форматированием. *indent* задаёт строку отступа, по умолчанию – символ табуляции; *newl* задаёт строку, добавляемую в конце каждой строки, по умолчанию `\n`.118119Аргумент *encoding* ведёт себя как соответствующий аргумент [`toxml()`](https://python-all.ru/3.15/library/xml.dom.minidom.html#xml.dom.minidom.Node.toxml).120121Аргумент *standalone* ведёт себя точно так же, как в [`writexml()`](https://python-all.ru/3.15/library/xml.dom.minidom.html#xml.dom.minidom.Node.writexml).122123Изменено в версии 3.8: Метод `toprettyxml()` теперь сохраняет порядок атрибутов, заданный пользователем.124125Изменено в версии 3.9: Добавлен параметр *standalone*.126127## Пример DOM128129Эта примерная программа – довольно реалистичный пример простой программы. В данном конкретном случае мы не используем гибкость DOM в полной мере.130131```python132import xml.dom.minidom133134document = """\135<slideshow>136<title>Demo slideshow</title>137<slide><title>Slide title</title>138<point>This is a demo</point>139<point>Of a program for processing slides</point>140</slide>141142<slide><title>Another demo slide</title>143<point>It is important</point>144<point>To have more than</point>145<point>one slide</point>146</slide>147</slideshow>148"""149150dom = xml.dom.minidom.parseString(document)151152def getText(nodelist):153 rc = []154 for node in nodelist:155 if node.nodeType == node.TEXT_NODE:156 rc.append(node.data)157 return ''.join(rc)158159def handleSlideshow(slideshow):160 print("<html>")161 handleSlideshowTitle(slideshow.getElementsByTagName("title")[0])162 slides = slideshow.getElementsByTagName("slide")163 handleToc(slides)164 handleSlides(slides)165 print("</html>")166167def handleSlides(slides):168 for slide in slides:169 handleSlide(slide)170171def handleSlide(slide):172 handleSlideTitle(slide.getElementsByTagName("title")[0])173 handlePoints(slide.getElementsByTagName("point"))174175def handleSlideshowTitle(title):176 print(f"<title>{getText(title.childNodes)}</title>")177178def handleSlideTitle(title):179 print(f"<h2>{getText(title.childNodes)}</h2>")180181def handlePoints(points):182 print("<ul>")183 for point in points:184 handlePoint(point)185 print("</ul>")186187def handlePoint(point):188 print(f"<li>{getText(point.childNodes)}</li>")189190def handleToc(slides):191 for slide in slides:192 title = slide.getElementsByTagName("title")[0]193 print(f"<p>{getText(title.childNodes)}</p>")194195handleSlideshow(dom)196```197198## minidom и стандарт DOM199200Модуль `xml.dom.minidom` по сути является DOM, совместимым с DOM 1.0, с некоторыми возможностями DOM 2 (в первую очередь, поддержкой пространств имён).201202Использование интерфейса DOM в Python интуитивно понятно. Применяются следующие правила отображения:203204- Интерфейсы доступны через объекты экземпляров. Приложения не должны создавать экземпляры классов напрямую – для этого следует использовать функции-создатели, доступные на объекте `Document`. Производные интерфейсы поддерживают все операции (и атрибуты) базовых интерфейсов, а также любые новые операции.205- Операции используются как методы. Поскольку DOM использует только параметры [`in`](https://python-all.ru/3.15/reference/expressions.html#in), аргументы передаются в обычном порядке (слева направо). Необязательных аргументов нет. Операции `void` возвращают `None`.206- Атрибуты IDL отображаются в атрибуты экземпляра. Для совместимости с отображением языка OMG IDL для Python, атрибут `foo` также может быть доступен через методы доступа `_get_foo()` и `_set_foo()`. `readonly` атрибуты не должны изменяться; во время выполнения это не контролируется.207- Типы `short int`, `unsigned int`, `unsigned long long` и `boolean` все отображаются на целочисленные объекты Python.208- Тип `DOMString` отображается на строки Python. `xml.dom.minidom` поддерживает как байты, так и строки, но обычно возвращает строки. Значения типа `DOMString` также могут быть `None`, если по спецификации DOM от W3C допускается значение IDL `null`.209- Объявления `const` отображаются на переменные в соответствующей области видимости (например, `xml.dom.minidom.Node.PROCESSING_INSTRUCTION_NODE`); они не должны изменяться.210- `DOMException` в настоящее время не поддерживается в `xml.dom.minidom`. Вместо этого `xml.dom.minidom` использует стандартные исключения Python, такие как [`TypeError`](https://python-all.ru/3.15/library/exceptions.html#TypeError) и [`AttributeError`](https://python-all.ru/3.15/library/exceptions.html#AttributeError).211- Объекты `NodeList` реализованы с использованием встроенного типа list Python. Эти объекты предоставляют интерфейс, определённый в спецификации DOM, но в ранних версиях Python они не поддерживают официальный API. Однако они гораздо более «питоничны», чем интерфейс, определённый в рекомендациях W3C.212213Следующие интерфейсы не имеют реализации в `xml.dom.minidom`:214215- `DOMTimeStamp`216- `EntityReference`217218Большинство из них отражают информацию в XML-документе, которая не представляет общей ценности для большинства пользователей DOM.219220Сноски221222\[[1](https://python-all.ru/3.15/library/xml.dom.minidom.html#id1)\]223224Название кодировки в XML-выводе должно соответствовать соответствующим стандартам. Например, «UTF-8» допустимо, а «UTF8» недопустимо в объявлении XML-документа, хотя Python принимает её как название кодировки. См. [https://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl](https://python-all.ru/3.15/library/xml.dom.minidom.html) и [https://www.iana.org/assignments/character-sets/character-sets.xhtml](https://python-all.ru/3.15/library/xml.dom.minidom.html).225