From 63e5b59c06fc99f95d274e7f181296e094cc3ee7 Mon Sep 17 00:00:00 2001 From: Alex Itkes <38556752+alexitkes@users.noreply.github.com> Date: Sun, 12 Apr 2020 17:21:58 +0300 Subject: bpo-13743: Add some documentation strings to xml.dom.minidom (GH-16355) --- Lib/xml/dom/minidom.py | 23 ++++++++++++++++++++++ .../2019-09-25-23-20-55.bpo-13743.5ToLDy.rst | 1 + 2 files changed, 24 insertions(+) create mode 100644 Misc/NEWS.d/next/Documentation/2019-09-25-23-20-55.bpo-13743.5ToLDy.rst diff --git a/Lib/xml/dom/minidom.py b/Lib/xml/dom/minidom.py index 1083b48..d09ef5e 100644 --- a/Lib/xml/dom/minidom.py +++ b/Lib/xml/dom/minidom.py @@ -719,6 +719,14 @@ class Element(Node): Node.unlink(self) def getAttribute(self, attname): + """Returns the value of the specified attribute. + + Returns the value of the element's attribute named attname as + a string. An empty string is returned if the element does not + have such an attribute. Note that an empty string may also be + returned as an explicitly given attribute value, use the + hasAttribute method to distinguish these two cases. + """ if self._attrs is None: return "" try: @@ -829,6 +837,11 @@ class Element(Node): removeAttributeNodeNS = removeAttributeNode def hasAttribute(self, name): + """Checks whether the element has an attribute with the specified name. + + Returns True if the element has an attribute with the specified name. + Otherwise, returns False. + """ if self._attrs is None: return False return name in self._attrs @@ -839,6 +852,11 @@ class Element(Node): return (namespaceURI, localName) in self._attrsNS def getElementsByTagName(self, name): + """Returns all descendant elements with the given tag name. + + Returns the list of all descendant elements (not direct children + only) with the specified tag name. + """ return _get_elements_by_tagName_helper(self, name, NodeList()) def getElementsByTagNameNS(self, namespaceURI, localName): @@ -849,6 +867,11 @@ class Element(Node): return "" % (self.tagName, id(self)) def writexml(self, writer, indent="", addindent="", newl=""): + """Write an XML element to a file-like object + + Write the element to the writer object that must provide + a write method (e.g. a file or StringIO object). + """ # indent = current indentation # addindent = indentation to add to higher levels # newl = newline string diff --git a/Misc/NEWS.d/next/Documentation/2019-09-25-23-20-55.bpo-13743.5ToLDy.rst b/Misc/NEWS.d/next/Documentation/2019-09-25-23-20-55.bpo-13743.5ToLDy.rst new file mode 100644 index 0000000..02dc433 --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2019-09-25-23-20-55.bpo-13743.5ToLDy.rst @@ -0,0 +1 @@ +Some methods within xml.dom.minidom.Element class are now better documented. -- cgit v0.12