Source code:Lib/xml/dom/minidom.py
xml.dom.minidom is a minimal implementation of the Document ObjectModel interface, with an API similar to that in other languages. It is intendedto be simpler than the full DOM and also significantly smaller. Users who arenot already proficient with the DOM should consider using thexml.etree.ElementTree module for their XML processing instead
Warning
Thexml.dom.minidom module is not secure againstmaliciously constructed data. If you need to parse untrusted orunauthenticated data seeXML vulnerabilities.
DOM applications typically start by parsing some XML into a DOM. Withxml.dom.minidom, this is done through the parse functions:
fromxml.dom.minidomimportparse,parseStringdom1=parse('c:\\temp\\mydata.xml')# parse an XML file by namedatasource=open('c:\\temp\\mydata.xml')dom2=parse(datasource)# parse an open filedom3=parseString('<myxml>Some data<empty/> some more data</myxml>')
Theparse() function can take either a filename or an open file object.
Return aDocument from the given input.filename_or_file may beeither a file name, or a file-like object.parser, if given, must be a SAX2parser object. This function will change the document handler of the parser andactivate namespace support; other parser configuration (like setting an entityresolver) must have been done in advance.
If you have XML in a string, you can use theparseString() functioninstead:
Return aDocument that represents thestring. This method creates aio.StringIO object for the string and passes that on toparse().
Both functions return aDocument object representing the content of thedocument.
What theparse() andparseString() functions do is connect an XMLparser with a “DOM builder” that can accept parse events from any SAX parser andconvert them into a DOM tree. The name of the functions are perhaps misleading,but are easy to grasp when learning the interfaces. The parsing of the documentwill be completed before these functions return; it’s simply that thesefunctions do not provide a parser implementation themselves.
You can also create aDocument by calling a method on a “DOMImplementation” object. You can get this object either by calling thegetDOMImplementation() function in thexml.dom package or thexml.dom.minidom module. Once you have aDocument, youcan add child nodes to it to populate the DOM:
fromxml.dom.minidomimportgetDOMImplementationimpl=getDOMImplementation()newdoc=impl.createDocument(None,"some_tag",None)top_element=newdoc.documentElementtext=newdoc.createTextNode('Some textual content.')top_element.appendChild(text)
Once you have a DOM document object, you can access the parts of your XMLdocument through its properties and methods. These properties are defined inthe DOM specification. The main property of the document object is thedocumentElement property. It gives you the main element in the XMLdocument: the one that holds all others. Here is an example program:
dom3=parseString("<myxml>Some data</myxml>")assertdom3.documentElement.tagName=="myxml"
When you are finished with a DOM tree, you may optionally call theunlink() method to encourage early cleanup of the now-unneededobjects.unlink() is axml.dom.minidom-specificextension to the DOM API that renders the node and its descendants areessentially useless. Otherwise, Python’s garbage collector willeventually take care of the objects in the tree.
See also
The definition of the DOM API for Python is given as part of thexml.dommodule documentation. This section lists the differences between the API andxml.dom.minidom.
Break internal references within the DOM so that it will be garbage collected onversions of Python without cyclic GC. Even when cyclic GC is available, usingthis can make large amounts of memory available sooner, so calling this on DOMobjects as soon as they are no longer needed is good practice. This only needsto be called on theDocument object, but may be called on child nodesto discard children of that node.
You can avoid calling this method explicitly by using thewithstatement. The following code will automatically unlinkdom when thewith block is exited:
withxml.dom.minidom.parse(datasource)asdom:...# Work with dom.
Write XML to the writer object. The writer should have awrite() methodwhich matches that of the file object interface. Theindent parameter is theindentation of the current node. Theaddindent parameter is the incrementalindentation to use for subnodes of the current one. Thenewl parameterspecifies the string to use to terminate newlines.
For theDocument node, an additional keyword argumentencoding canbe used to specify the encoding field of the XML header.
Return a string or byte string containing the XML represented bythe DOM node.
With an explicitencoding[1] argument, the result is a bytestring in the specified encoding.With noencoding argument, the result is a Unicode string, and theXML declaration in the resulting string does not specify anencoding. Encoding this string in an encoding other than UTF-8 islikely incorrect, since UTF-8 is the default encoding of XML.
Return a pretty-printed version of the document.indent specifies theindentation string and defaults to a tabulator;newl specifies the stringemitted at the end of each line and defaults to\n.
Theencoding argument behaves like the corresponding argument oftoxml().
This example program is a fairly realistic example of a simple program. In thisparticular case, we do not take much advantage of the flexibility of the DOM.
importxml.dom.minidomdocument="""\<slideshow><title>Demo slideshow</title><slide><title>Slide title</title><point>This is a demo</point><point>Of a program for processing slides</point></slide><slide><title>Another demo slide</title><point>It is important</point><point>To have more than</point><point>one slide</point></slide></slideshow>"""dom=xml.dom.minidom.parseString(document)defgetText(nodelist):rc=[]fornodeinnodelist:ifnode.nodeType==node.TEXT_NODE:rc.append(node.data)return''.join(rc)defhandleSlideshow(slideshow):print("<html>")handleSlideshowTitle(slideshow.getElementsByTagName("title")[0])slides=slideshow.getElementsByTagName("slide")handleToc(slides)handleSlides(slides)print("</html>")defhandleSlides(slides):forslideinslides:handleSlide(slide)defhandleSlide(slide):handleSlideTitle(slide.getElementsByTagName("title")[0])handlePoints(slide.getElementsByTagName("point"))defhandleSlideshowTitle(title):print("<title>%s</title>"%getText(title.childNodes))defhandleSlideTitle(title):print("<h2>%s</h2>"%getText(title.childNodes))defhandlePoints(points):print("<ul>")forpointinpoints:handlePoint(point)print("</ul>")defhandlePoint(point):print("<li>%s</li>"%getText(point.childNodes))defhandleToc(slides):forslideinslides:title=slide.getElementsByTagName("title")[0]print("<p>%s</p>"%getText(title.childNodes))handleSlideshow(dom)
Thexml.dom.minidom module is essentially a DOM 1.0-compatible DOM withsome DOM 2 features (primarily namespace features).
Usage of the DOM interface in Python is straight-forward. The following mappingrules apply:
The following interfaces have no implementation inxml.dom.minidom:
Most of these reflect information in the XML document that is not of generalutility to most DOM users.
Footnotes
| [1] | The encoding name included in the XML output should conform tothe appropriate standards. For example, “UTF-8” is valid, but“UTF8” is not valid in an XML document’s declaration, even thoughPython accepts it as an encoding name.Seehttp://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDeclandhttp://www.iana.org/assignments/character-sets. |
20.6.xml.dom — The Document Object Model API
20.8.xml.dom.pulldom — Support for building partial DOM trees
Enter search terms or a module, class or function name.
