xml stubtest exceptions (#5161)

* Explaining xml stubtest exceptions

* Fix 3.6/3.7 ExternalEntityParserCreate

* Fix typos and formatting

* Missing return type

* Reverting ExternalEntityParserCreate change to see error

* Remove unused sys import

* Readd ExternalEntityParserCreate with explanations

tests/stubtest_whitelists/py36.txt

@@ -36,7 +36,7 @@ multiprocessing.shared_memory
 nntplib._NNTPBase.starttls
 os.utime
 plistlib.Dict.__init__
-pyexpat.XMLParserType.ExternalEntityParserCreate
+pyexpat.XMLParserType.ExternalEntityParserCreate  # C signature is wrong - function gets only positional args
 random.Random.randrange  # missing undocumented arg _int
 random.randrange  # missing undocumented arg _int
 secrets.SystemRandom.getstate
@@ -72,7 +72,7 @@ uuid.UUID.int
 webbrowser.Opera.raise_opts
 xml.etree.ElementTree.TreeBuilder.start  # Discrepancy between Python and C modules, fixed in bpo-39495
 xml.etree.cElementTree.TreeBuilder.start  # bpo-39495
-xml.parsers.expat.XMLParserType.ExternalEntityParserCreate
+xml.parsers.expat.XMLParserType.ExternalEntityParserCreate  # C signature is wrong - function gets only positional args
 # These enums derive from (int, IntEnum) or (str, Enum). See comment in py3_common.txt
 enum.IntFlag.__new__
 re.RegexFlag.__new__

tests/stubtest_whitelists/py37.txt

@@ -45,7 +45,7 @@ macurl2path  # removed in 3.7
 multiprocessing.shared_memory
 nntplib._NNTPBase.starttls
 os.utime
-pyexpat.XMLParserType.ExternalEntityParserCreate
+pyexpat.XMLParserType.ExternalEntityParserCreate  # C signature is wrong - function gets only positional args
 queue.SimpleQueue.__init__
 random.Random.randrange  # missing undocumented arg _int
 random.randrange  # missing undocumented arg _int
@@ -72,7 +72,7 @@ uuid.getnode  # undocumented, unused parameter getters that was later removed
 webbrowser.Opera.raise_opts
 xml.etree.ElementTree.TreeBuilder.start  # Discrepancy between Python and C modules, fixed in bpo-39495
 xml.etree.cElementTree.TreeBuilder.start  # bpo-39495
-xml.parsers.expat.XMLParserType.ExternalEntityParserCreate
+xml.parsers.expat.XMLParserType.ExternalEntityParserCreate  # C signature is wrong - function gets only positional args
 # These enums derive from (int, IntEnum) or (str, Enum). See comment in py3_common.txt
 enum.IntFlag.__new__
 pstats.SortKey.__new__

tests/stubtest_whitelists/py38.txt

@@ -99,9 +99,9 @@ uuid.getnode  # undocumented, unused parameter getters that was later removed
 weakref.WeakValueDictionary.update
 webbrowser.Opera.raise_opts
 xml.etree.ElementTree.TreeBuilder.start  # Discrepancy between Python and C modules, fixed in bpo-39495
-xml.etree.ElementTree.XMLParser.__init__
+xml.etree.ElementTree.XMLParser.__init__  # Defined in C so has general signature
 xml.etree.cElementTree.TreeBuilder.start  # bpo-39495
-xml.etree.cElementTree.XMLParser.__init__
+xml.etree.cElementTree.XMLParser.__init__  # Defined in C so has general signature
 zipfile.Path.open
 # These enums derive from (int, IntEnum) or (str, Enum). See comment in py3_common.txt
 enum.IntFlag.__new__

tests/stubtest_whitelists/py39.txt

@@ -130,8 +130,8 @@ typing._TypedDict.values
 unittest.doModuleCleanups
 weakref.WeakValueDictionary.update
 webbrowser.Opera.raise_opts
-xml.etree.ElementTree.XMLParser.__init__
-xml.etree.cElementTree.XMLParser.__init__
+xml.etree.ElementTree.XMLParser.__init__  # Defined in C so has general signature
+xml.etree.cElementTree.XMLParser.__init__  # Defined in C so has general signature
 
 # positional-only complaints
 builtins.bytearray.pop

tests/stubtest_whitelists/py3_common.txt

@@ -413,8 +413,6 @@ webbrowser.UnixBrowser.remote_action
 webbrowser.UnixBrowser.remote_action_newtab
 webbrowser.UnixBrowser.remote_action_newwin
 wsgiref.types  # Doesn't exist, see comments in file
-xml.etree.ElementPath._SelectorContext.parent_map
-xml.sax.xmlreader.AttributesImpl.has_key
 zipfile.ZipExtFile.read
 zipfile.ZipExtFile.readline
 zlib.compressobj