Move to the toplevel xml module.

Author: serhiy-storchaka

Doc/library/xml.rst

@@ -57,8 +57,6 @@ This module also defines utility functions.
    ..versionadded:: next
 
 
-   .. versionadded:: 3.2
-
 .. _xml-security:
 .. _xml-vulnerabilities:
 

Lib/test/test_sax.py

@@ -9,8 +9,8 @@
 except SAXReaderNotAvailable:
     # don't try to test this module if we cannot create a parser
     raise unittest.SkipTest("no XML parsers available")
-from xml.sax.saxutils import (XMLGenerator, escape, unescape, quoteattr,
-                              XMLFilterBase, prepare_input_source)
+from xml.sax.saxutils import XMLGenerator, escape, unescape, quoteattr, \
+                             XMLFilterBase, prepare_input_source
 from xml.sax.expatreader import create_parser
 from xml.sax.handler import (feature_namespaces, feature_external_ges,
                              LexicalHandler)

Lib/test/test_xml.py

@@ -0,0 +1,27 @@
+import xml
+import unittest
+
+
+class TestUtils(unittest.TestCase):
+
+    def test_is_valid_name(self):
+        is_valid_name = xml.is_valid_name
+        self.assertFalse(is_valid_name(''))
+        self.assertTrue(is_valid_name('name'))
+        self.assertTrue(is_valid_name('NAME'))
+        self.assertTrue(is_valid_name('name0:-._·'))
+        self.assertTrue(is_valid_name('_'))
+        self.assertTrue(is_valid_name(':'))
+        self.assertTrue(is_valid_name('Ñàḿĕ'))
+        self.assertTrue(is_valid_name('\U000EFFFF'))
+        self.assertFalse(is_valid_name('0'))
+        self.assertFalse(is_valid_name('-'))
+        self.assertFalse(is_valid_name('.'))
+        self.assertFalse(is_valid_name('·'))
+        self.assertFalse(is_valid_name('na me'))
+        for c in '<>/!?=\x00\x01\x7f\ud800\udfff\ufffe\uffff\U000F0000':
+            self.assertFalse(is_valid_name('name' + c))
+
+
+if __name__ == '__main__':
+    unittest.main()

Misc/NEWS.d/next/Library/2025-10-08-15-36-00.gh-issue-139489.W46tvn.rst

@@ -1,2 +1,2 @@
-Add the :func:`~xml.sax.saxutils.is_valid_name` function, which allows to check
+Add the :func:`xml.is_valid_name` function, which allows to check
 whether a string can be used as an element or attribute name in XML.