Add stub for xml.dom.expatbuilder (#6517)

Co-authored-by: Akuli <akuviljanen17@gmail.com>

stdlib/xml/dom/expatbuilder.pyi

@@ -1,3 +1,99 @@
-from typing import Any
+from typing import Any, NoReturn
+from xml.dom.minidom import Document, DOMImplementation, Node, TypeInfo
+from xml.dom.xmlbuilder import DOMBuilderFilter, Options
 
-def __getattr__(name: str) -> Any: ...  # incomplete
+TEXT_NODE = Node.TEXT_NODE
+CDATA_SECTION_NODE = Node.CDATA_SECTION_NODE
+DOCUMENT_NODE = Node.DOCUMENT_NODE
+FILTER_ACCEPT = DOMBuilderFilter.FILTER_ACCEPT
+FILTER_REJECT = DOMBuilderFilter.FILTER_REJECT
+FILTER_SKIP = DOMBuilderFilter.FILTER_SKIP
+FILTER_INTERRUPT = DOMBuilderFilter.FILTER_INTERRUPT
+theDOMImplementation: DOMImplementation | None
+
+class ElementInfo:
+    tagName: Any
+    def __init__(self, tagName, model: Any | None = ...) -> None: ...
+    def getAttributeType(self, aname) -> TypeInfo: ...
+    def getAttributeTypeNS(self, namespaceURI, localName) -> TypeInfo: ...
+    def isElementContent(self) -> bool: ...
+    def isEmpty(self) -> bool: ...
+    def isId(self, aname) -> bool: ...
+    def isIdNS(self, euri, ename, auri, aname) -> bool: ...
+
+class ExpatBuilder:
+    document: Document  # Created in self.reset()
+    curNode: Any  # Created in self.reset()
+    def __init__(self, options: Options | None = ...) -> None: ...
+    def createParser(self): ...
+    def getParser(self): ...
+    def reset(self) -> None: ...
+    def install(self, parser) -> None: ...
+    def parseFile(self, file) -> Document: ...
+    def parseString(self, string: str) -> Document: ...
+    def start_doctype_decl_handler(self, doctypeName, systemId, publicId, has_internal_subset) -> None: ...
+    def end_doctype_decl_handler(self) -> None: ...
+    def pi_handler(self, target, data) -> None: ...
+    def character_data_handler_cdata(self, data) -> None: ...
+    def character_data_handler(self, data) -> None: ...
+    def start_cdata_section_handler(self) -> None: ...
+    def end_cdata_section_handler(self) -> None: ...
+    def entity_decl_handler(self, entityName, is_parameter_entity, value, base, systemId, publicId, notationName) -> None: ...
+    def notation_decl_handler(self, notationName, base, systemId, publicId) -> None: ...
+    def comment_handler(self, data) -> None: ...
+    def external_entity_ref_handler(self, context, base, systemId, publicId) -> int: ...
+    def first_element_handler(self, name, attributes) -> None: ...
+    def start_element_handler(self, name, attributes) -> None: ...
+    def end_element_handler(self, name) -> None: ...
+    def element_decl_handler(self, name, model) -> None: ...
+    def attlist_decl_handler(self, elem, name, type, default, required) -> None: ...
+    def xml_decl_handler(self, version, encoding, standalone) -> None: ...
+
+class FilterVisibilityController:
+    filter: DOMBuilderFilter
+    def __init__(self, filter: DOMBuilderFilter) -> None: ...
+    def startContainer(self, node: Node) -> int: ...
+    def acceptNode(self, node: Node) -> int: ...
+
+class FilterCrutch:
+    def __init__(self, builder) -> None: ...
+
+class Rejecter(FilterCrutch):
+    def start_element_handler(self, *args: Any) -> None: ...
+    def end_element_handler(self, *args: Any) -> None: ...
+
+class Skipper(FilterCrutch):
+    def start_element_handler(self, *args: Any) -> None: ...
+    def end_element_handler(self, *args: Any) -> None: ...
+
+class FragmentBuilder(ExpatBuilder):
+    fragment: Any | None
+    originalDocument: Any
+    context: Any
+    def __init__(self, context, options: Options | None = ...) -> None: ...
+
+class Namespaces:
+    def createParser(self): ...
+    def install(self, parser) -> None: ...
+    def start_namespace_decl_handler(self, prefix, uri) -> None: ...
+    def start_element_handler(self, name, attributes) -> None: ...
+    def end_element_handler(self, name) -> None: ...
+
+class ExpatBuilderNS(Namespaces, ExpatBuilder): ...
+class FragmentBuilderNS(Namespaces, FragmentBuilder): ...
+class ParseEscape(Exception): ...
+
+class InternalSubsetExtractor(ExpatBuilder):
+    subset: Any | None
+    def getSubset(self) -> Any | None: ...
+    def parseFile(self, file) -> None: ...  # type: ignore[override]
+    def parseString(self, string: str) -> None: ...  # type: ignore[override]
+    def start_doctype_decl_handler(self, name, publicId, systemId, has_internal_subset) -> None: ...  # type: ignore[override]
+    def end_doctype_decl_handler(self) -> NoReturn: ...
+    def start_element_handler(self, name, attrs) -> NoReturn: ...
+
+def parse(file, namespaces: bool = ...): ...
+def parseString(string: str, namespaces: bool = ...): ...
+def parseFragment(file, context, namespaces: bool = ...): ...
+def parseFragmentString(string: str, context, namespaces: bool = ...): ...
+def makeBuilder(options: Options) -> ExpatBuilderNS | ExpatBuilder: ...

tests/stubtest_allowlists/py3_common.txt

@@ -228,8 +228,6 @@ webbrowser.UnixBrowser.remote_action  # always overridden in inheriting class
 webbrowser.UnixBrowser.remote_action_newtab  # always overridden in inheriting class
 webbrowser.UnixBrowser.remote_action_newwin  # always overridden in inheriting class
 wsgiref.types  # Doesn't exist, see comments in file
-xml.dom.xmlbuilder.ExpatBuilder  # mypy bug w.r.t. module __getattr__, see python/mypy#11411
-xml.dom.xmlbuilder.ExpatBuilderNS  # mypy bug w.r.t. module __getattr__, see python/mypy#11411
 
 # ==========
 # Allowlist entries that cannot or should not be fixed
@@ -686,23 +684,6 @@ wsgiref.handlers.BaseHandler.result
 wsgiref.handlers.BaseHandler.status
 xml.dom
 xml.dom.InvalidCharacterErr
-xml.dom.expatbuilder.ElementInfo
-xml.dom.expatbuilder.ExpatBuilder
-xml.dom.expatbuilder.ExpatBuilderNS
-xml.dom.expatbuilder.FilterCrutch
-xml.dom.expatbuilder.FilterVisibilityController
-xml.dom.expatbuilder.FragmentBuilder
-xml.dom.expatbuilder.FragmentBuilderNS
-xml.dom.expatbuilder.InternalSubsetExtractor
-xml.dom.expatbuilder.Namespaces
-xml.dom.expatbuilder.ParseEscape
-xml.dom.expatbuilder.Rejecter
-xml.dom.expatbuilder.Skipper
-xml.dom.expatbuilder.makeBuilder
-xml.dom.expatbuilder.parse
-xml.dom.expatbuilder.parseFragment
-xml.dom.expatbuilder.parseFragmentString
-xml.dom.expatbuilder.parseString
 xml.dom.minidom.Attr.isId
 xml.dom.minidom.Attr.schemaType
 xml.dom.minidom.CharacterData.length