summaryrefslogtreecommitdiffstats
path: root/Doc/library/xml.etree.elementtree.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/library/xml.etree.elementtree.rst')
-rw-r--r--Doc/library/xml.etree.elementtree.rst9
1 files changed, 6 insertions, 3 deletions
diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst
index 876de29..f9290f5 100644
--- a/Doc/library/xml.etree.elementtree.rst
+++ b/Doc/library/xml.etree.elementtree.rst
@@ -1045,9 +1045,9 @@ Element Objects
:meth:`~object.__getitem__`, :meth:`~object.__setitem__`,
:meth:`~object.__len__`.
- Caution: Elements with no subelements will test as ``False``. This behavior
- will change in future versions. Use specific ``len(elem)`` or ``elem is
- None`` test instead. ::
+ Caution: Elements with no subelements will test as ``False``. Testing the
+ truth value of an Element is deprecated and will raise an exception in
+ Python 3.14. Use specific ``len(elem)`` or ``elem is None`` test instead.::
element = root.find('foo')
@@ -1057,6 +1057,9 @@ Element Objects
if element is None:
print("element not found")
+ .. versionchanged:: 3.12
+ Testing the truth value of an Element emits :exc:`DeprecationWarning`.
+
Prior to Python 3.8, the serialisation order of the XML attributes of
elements was artificially made predictable by sorting the attributes by
their name. Based on the now guaranteed ordering of dicts, this arbitrary