lxml 5.3.2__cp39-cp39-macosx_10_9_universal2.whl → 6.0.0__cp39-cp39-macosx_10_9_universal2.whl

lxml/__init__.py

@@ -1,6 +1,6 @@
 # this is a package
 
-__version__ = "5.3.2"
+__version__ = "6.0.0"
 
 
 def get_include():

lxml/_elementpath.py

@@ -1,4 +1,4 @@
-# cython: language_level=2
+# cython: language_level=3
 
 #
 # ElementTree
@@ -85,6 +85,8 @@ def xpath_tokenizer(pattern, namespaces=None, with_prefixes=True):
                     yield ttype, "{%s}%s" % (namespaces[prefix], uri)
                 except KeyError:
                     raise SyntaxError("prefix %r not found in prefix map" % prefix)
+            elif tag.isdecimal():
+                yield token  # index
             elif default_namespace and not parsing_attribute:
                 yield ttype, "{%s}%s" % (default_namespace, tag)
             else:

lxml/apihelpers.pxi

@@ -439,7 +439,7 @@ cdef int _removeUnusedNamespaceDeclarations(xmlNode* c_element, set prefixes_to_
                 c_nsdef = c_nsdef.next
             c_nsdef.next = c_nsdef.next.next
         tree.xmlFreeNs(c_ns_list[i].ns)
-    
+
     if c_ns_list is not NULL:
         python.lxml_free(c_ns_list)
     return 0
@@ -685,7 +685,7 @@ cdef unicode _collectText(xmlNode* c_node):
     """Collect all text nodes and return them as a unicode string.
 
     Start collecting at c_node.
-    
+
     If there was no text to collect, return None
     """
     cdef Py_ssize_t scount
@@ -845,7 +845,7 @@ cdef inline xmlNode* _findChild(xmlNode* c_node, Py_ssize_t index) noexcept:
         return _findChildBackwards(c_node, -index - 1)
     else:
         return _findChildForwards(c_node, index)
-    
+
 cdef inline xmlNode* _findChildForwards(xmlNode* c_node, Py_ssize_t index) noexcept:
     """Return child element of c_node with index, or return NULL if not found.
     """
@@ -876,7 +876,7 @@ cdef inline xmlNode* _findChildBackwards(xmlNode* c_node, Py_ssize_t index) noex
             c += 1
         c_child = c_child.prev
     return NULL
-    
+
 cdef inline xmlNode* _textNodeOrSkip(xmlNode* c_node) noexcept nogil:
     """Return the node if it's a text node.  Skip over ignorable nodes in a
     series of text nodes.  Return NULL if a non-ignorable node is found.
@@ -1031,23 +1031,31 @@ cdef Py_ssize_t _mapTagsToQnameMatchArray(xmlDoc* c_doc, list ns_tags,
     Note that each qname struct in the array owns its href byte string object
     if it is not NULL.
     """
-    cdef Py_ssize_t count = 0, i
+    cdef Py_ssize_t count = 0, i, c_tag_len
     cdef bytes ns, tag
+    cdef const_xmlChar* c_tag
+
     for ns, tag in ns_tags:
         if tag is None:
-            c_tag = <const_xmlChar*>NULL
-        elif force_into_dict:
-            c_tag = tree.xmlDictLookup(c_doc.dict, _xcstr(tag), len(tag))
-            if c_tag is NULL:
-                # clean up before raising the error
-                for i in xrange(count):
-                    cpython.ref.Py_XDECREF(c_ns_tags[i].href)
-                raise MemoryError()
+            c_tag = <const_xmlChar*> NULL
         else:
-            c_tag = tree.xmlDictExists(c_doc.dict, _xcstr(tag), len(tag))
-            if c_tag is NULL:
-                # not in the dict => not in the document
+            c_tag_len = len(tag)
+            if c_tag_len > limits.INT_MAX:
+                # too long, not in the dict => not in the document
                 continue
+            elif force_into_dict:
+                c_tag = tree.xmlDictLookup(c_doc.dict, _xcstr(tag), <int> c_tag_len)
+                if c_tag is NULL:
+                    # clean up before raising the error
+                    for i in xrange(count):
+                        cpython.ref.Py_XDECREF(c_ns_tags[i].href)
+                    raise MemoryError()
+            else:
+                c_tag = tree.xmlDictExists(c_doc.dict, _xcstr(tag), <int> c_tag_len)
+                if c_tag is NULL:
+                    # not in the dict => not in the document
+                    continue
+
         c_ns_tags[count].c_name = c_tag
         if ns is None:
             c_ns_tags[count].href = NULL
@@ -1095,7 +1103,7 @@ cdef int _removeSiblings(xmlNode* c_element, tree.xmlElementType node_type, bint
 
 cdef void _moveTail(xmlNode* c_tail, xmlNode* c_target) noexcept:
     cdef xmlNode* c_next
-    # tail support: look for any text nodes trailing this node and 
+    # tail support: look for any text nodes trailing this node and
     # move them too
     c_tail = _textNodeOrSkip(c_tail)
     while c_tail is not NULL:

lxml/builder.py

@@ -45,6 +45,13 @@ _QName = ET.QName
 
 from functools import partial
 
+try:
+    from types import GenericAlias as _GenericAlias
+except ImportError:
+    # Python 3.8 - we only need this as return value from "__class_getitem__"
+    def _GenericAlias(cls, item):
+        return f"{cls.__name__}[{item.__name__}]"
+
 try:
     basestring
 except NameError:
@@ -227,6 +234,10 @@ class ElementMaker:
     def __getattr__(self, tag):
         return partial(self, tag)
 
+    # Allow subscripting ElementMaker in type annotions (PEP 560)
+    def __class_getitem__(cls, item):
+        return _GenericAlias(cls, item)
+
 
 # create factory object
 E = ElementMaker()

lxml/debug.pxi

@@ -32,59 +32,5 @@ cdef class _MemDebug:
             raise MemoryError()
         return tree.xmlDictSize(c_dict)
 
-    def dump(self, output_file=None, byte_count=None):
-        """dump(self, output_file=None, byte_count=None)
-
-        Dumps the current memory blocks allocated by libxml2 to a file.
-
-        The optional parameter 'output_file' specifies the file path.  It defaults
-        to the file ".memorylist" in the current directory.
-
-        The optional parameter 'byte_count' limits the number of bytes in the dump.
-        Note that this parameter is ignored when lxml is compiled against a libxml2
-        version before 2.7.0.
-        """
-        cdef Py_ssize_t c_count
-        if output_file is None:
-            output_file = b'.memorylist'
-        elif isinstance(output_file, unicode):
-            output_file.encode(sys.getfilesystemencoding())
-
-        f = stdio.fopen(output_file, "w")
-        if f is NULL:
-            raise IOError(f"Failed to create file {output_file.decode(sys.getfilesystemencoding())}")
-        try:
-            if byte_count is None:
-                tree.xmlMemDisplay(f)
-            else:
-                c_count = byte_count
-                tree.xmlMemDisplayLast(f, c_count)
-        finally:
-            stdio.fclose(f)
-
-    def show(self, output_file=None, block_count=None):
-        """show(self, output_file=None, block_count=None)
-
-        Dumps the current memory blocks allocated by libxml2 to a file.
-        The output file format is suitable for line diffing.
-
-        The optional parameter 'output_file' specifies the file path.  It defaults
-        to the file ".memorydump" in the current directory.
-
-        The optional parameter 'block_count' limits the number of blocks
-        in the dump.
-        """
-        if output_file is None:
-            output_file = b'.memorydump'
-        elif isinstance(output_file, unicode):
-            output_file.encode(sys.getfilesystemencoding())
-
-        f = stdio.fopen(output_file, "w")
-        if f is NULL:
-            raise IOError(f"Failed to create file {output_file.decode(sys.getfilesystemencoding())}")
-        try:
-            tree.xmlMemShow(f, block_count if block_count is not None else tree.xmlMemBlocks())
-        finally:
-            stdio.fclose(f)
 
 memory_debugger = _MemDebug()

lxml/etree.h

@@ -1,4 +1,4 @@
-/* Generated by Cython 3.0.12 */
+/* Generated by Cython 3.1.2 */
 
 #ifndef __PYX_HAVE__lxml__etree
 #define __PYX_HAVE__lxml__etree
@@ -13,22 +13,22 @@ struct LxmlElementBase;
 struct LxmlElementClassLookup;
 struct LxmlFallbackElementClassLookup;
 
-/* "lxml/etree.pyx":355
+/* "lxml/etree.pyx":451
  * 
  * # type of a function that steps from node to node
  * ctypedef public xmlNode* (*_node_to_node_function)(xmlNode*)             # <<<<<<<<<<<<<<
  * 
  * 
- */
+*/
 typedef xmlNode *(*_node_to_node_function)(xmlNode *);
 
-/* "lxml/etree.pyx":371
- * @cython.final
- * @cython.freelist(8)
- * cdef public class _Document [ type LxmlDocumentType, object LxmlDocument ]:             # <<<<<<<<<<<<<<
- *     """Internal base class to reference a libxml document.
+/* "lxml/etree.pyx":465
+ * # Public Python API
  * 
- */
+ * @cython.final             # <<<<<<<<<<<<<<
+ * @cython.freelist(8)
+ * cdef public class _Document [ type LxmlDocumentType, object LxmlDocument ]:
+*/
 struct LxmlDocument {
   PyObject_HEAD
   struct __pyx_vtabstruct_4lxml_5etree__Document *__pyx_vtab;
@@ -38,13 +38,13 @@ struct LxmlDocument {
   struct __pyx_obj_4lxml_5etree__BaseParser *_parser;
 };
 
-/* "lxml/etree.pyx":720
+/* "lxml/etree.pyx":817
  * 
- * @cython.no_gc_clear
- * cdef public class _Element [ type LxmlElementType, object LxmlElement ]:             # <<<<<<<<<<<<<<
- *     """Element class.
  * 
- */
+ * @cython.no_gc_clear             # <<<<<<<<<<<<<<
+ * cdef public class _Element [ type LxmlElementType, object LxmlElement ]:
+ *     """Element class.
+*/
 struct LxmlElement {
   PyObject_HEAD
   struct LxmlDocument *_doc;
@@ -52,13 +52,13 @@ struct LxmlElement {
   PyObject *_tag;
 };
 
-/* "lxml/etree.pyx":1895
+/* "lxml/etree.pyx":1991
  * 
  * 
  * cdef public class _ElementTree [ type LxmlElementTreeType,             # <<<<<<<<<<<<<<
  *                                  object LxmlElementTree ]:
  *     cdef _Document _doc
- */
+*/
 struct LxmlElementTree {
   PyObject_HEAD
   struct __pyx_vtabstruct_4lxml_5etree__ElementTree *__pyx_vtab;
@@ -66,13 +66,13 @@ struct LxmlElementTree {
   struct LxmlElement *_context_node;
 };
 
-/* "lxml/etree.pyx":2669
+/* "lxml/etree.pyx":2765
  * 
  * 
  * cdef public class _ElementTagMatcher [ object LxmlElementTagMatcher,             # <<<<<<<<<<<<<<
  *                                        type LxmlElementTagMatcherType ]:
  *     """
- */
+*/
 struct LxmlElementTagMatcher {
   PyObject_HEAD
   struct __pyx_vtabstruct_4lxml_5etree__ElementTagMatcher *__pyx_vtab;
@@ -82,13 +82,13 @@ struct LxmlElementTagMatcher {
   char *_name;
 };
 
-/* "lxml/etree.pyx":2700
+/* "lxml/etree.pyx":2796
  *                 self._name = NULL
  * 
  * cdef public class _ElementIterator(_ElementTagMatcher) [             # <<<<<<<<<<<<<<
  *     object LxmlElementIterator, type LxmlElementIteratorType ]:
  *     """
- */
+*/
 struct LxmlElementIterator {
   struct LxmlElementTagMatcher __pyx_base;
   struct LxmlElement *_node;
@@ -101,7 +101,7 @@ struct LxmlElementIterator {
  * cdef public class ElementBase(_Element) [ type LxmlElementBaseType,             # <<<<<<<<<<<<<<
  *                                           object LxmlElementBase ]:
  *     """ElementBase(*children, attrib=None, nsmap=None, **_extra)
- */
+*/
 struct LxmlElementBase {
   struct LxmlElement __pyx_base;
 };
@@ -112,7 +112,7 @@ struct LxmlElementBase {
  * ctypedef public object (*_element_class_lookup_function)(object, _Document, xmlNode*)             # <<<<<<<<<<<<<<
  * 
  * # class to store element class lookup functions
- */
+*/
 typedef PyObject *(*_element_class_lookup_function)(PyObject *, struct LxmlDocument *, xmlNode *);
 
 /* "src/lxml/classlookup.pxi":213
@@ -121,7 +121,7 @@ typedef PyObject *(*_element_class_lookup_function)(PyObject *, struct LxmlDocum
  * cdef public class ElementClassLookup [ type LxmlElementClassLookupType,             # <<<<<<<<<<<<<<
  *                                        object LxmlElementClassLookup ]:
  *     """ElementClassLookup(self)
- */
+*/
 struct LxmlElementClassLookup {
   PyObject_HEAD
   _element_class_lookup_function _lookup_function;
@@ -133,7 +133,7 @@ struct LxmlElementClassLookup {
  * cdef public class FallbackElementClassLookup(ElementClassLookup) \             # <<<<<<<<<<<<<<
  *          [ type LxmlFallbackElementClassLookupType,
  *            object LxmlFallbackElementClassLookup ]:
- */
+*/
 struct LxmlFallbackElementClassLookup {
   struct LxmlElementClassLookup __pyx_base;
   struct __pyx_vtabstruct_4lxml_5etree_FallbackElementClassLookup *__pyx_vtab;
@@ -224,9 +224,6 @@ __PYX_EXTERN_C xmlNs *findOrBuildNodeNsPrefix(struct LxmlDocument *, xmlNode *,
 /* WARNING: the interface of the module init function changed in CPython 3.5. */
 /* It now returns a PyModuleDef instance instead of a PyModule instance. */
 
-#if PY_MAJOR_VERSION < 3
-PyMODINIT_FUNC initetree(void);
-#else
 /* WARNING: Use PyImport_AppendInittab("etree", PyInit_etree) instead of calling PyInit_etree directly from Python 3.5 */
 PyMODINIT_FUNC PyInit_etree(void);
 
@@ -243,6 +240,5 @@ static PyObject* __PYX_WARN_IF_PyInit_etree_INIT_CALLED(PyObject* res) {
 }
 #define PyInit_etree() __PYX_WARN_IF_PyInit_etree_INIT_CALLED(PyInit_etree())
 #endif
-#endif
 
 #endif /* !__PYX_HAVE__lxml__etree */

lxml/etree.pyx

@@ -19,6 +19,7 @@ __all__ = [
     'FallbackElementClassLookup', 'FunctionNamespace', 'HTML', 'HTMLParser',
     'ICONV_COMPILED_VERSION',
     'LIBXML_COMPILED_VERSION', 'LIBXML_VERSION',
+    'LIBXML_FEATURES',
     'LIBXSLT_COMPILED_VERSION', 'LIBXSLT_VERSION',
     'LXML_VERSION',
     'LxmlError', 'LxmlRegistryError', 'LxmlSyntaxError',
@@ -299,6 +300,101 @@ cdef extern from *:
 ICONV_COMPILED_VERSION = __unpackIntVersion(LIBICONV_HEX_VERSION, base=0x100)[:2]
 
 
+cdef extern from "libxml/xmlversion.h":
+    """
+    static const char* const _lxml_lib_features[] = {
+#ifdef LIBXML_HTML_ENABLED
+        "html",
+#endif
+#ifdef LIBXML_FTP_ENABLED
+        "ftp",
+#endif
+#ifdef LIBXML_HTTP_ENABLED
+        "http",
+#endif
+#ifdef LIBXML_CATALOG_ENABLED
+        "catalog",
+#endif
+#ifdef LIBXML_XPATH_ENABLED
+        "xpath",
+#endif
+#ifdef LIBXML_ICONV_ENABLED
+        "iconv",
+#endif
+#ifdef LIBXML_ICU_ENABLED
+        "icu",
+#endif
+#ifdef LIBXML_REGEXP_ENABLED
+        "regexp",
+#endif
+#ifdef LIBXML_SCHEMAS_ENABLED
+        "xmlschema",
+#endif
+#ifdef LIBXML_SCHEMATRON_ENABLED
+        "schematron",
+#endif
+#ifdef LIBXML_ZLIB_ENABLED
+        "zlib",
+#endif
+#ifdef LIBXML_LZMA_ENABLED
+        "lzma",
+#endif
+        0
+    };
+    """
+    const char* const* _LXML_LIB_FEATURES "_lxml_lib_features"
+
+
+cdef set _copy_lib_features():
+    features = set()
+    feature = _LXML_LIB_FEATURES
+    while feature[0]:
+        features.add(feature[0].decode('ASCII'))
+        feature += 1
+    return features
+
+LIBXML_COMPILED_FEATURES = _copy_lib_features()
+LIBXML_FEATURES = {
+    feature_name for feature_id, feature_name in [
+        #XML_WITH_THREAD = 1
+        #XML_WITH_TREE = 2
+        #XML_WITH_OUTPUT = 3
+        #XML_WITH_PUSH = 4
+        #XML_WITH_READER = 5
+        #XML_WITH_PATTERN = 6
+        #XML_WITH_WRITER = 7
+        #XML_WITH_SAX1 = 8
+        (xmlparser.XML_WITH_FTP, "ftp"),  # XML_WITH_FTP = 9
+        (xmlparser.XML_WITH_HTTP, "http"),  # XML_WITH_HTTP = 10
+        #XML_WITH_VALID = 11
+        (xmlparser.XML_WITH_HTML, "html"),  # XML_WITH_HTML = 12
+        #XML_WITH_LEGACY = 13
+        #XML_WITH_C14N = 14
+        (xmlparser.XML_WITH_CATALOG, "catalog"),  # XML_WITH_CATALOG = 15
+        (xmlparser.XML_WITH_XPATH, "xpath"),  # XML_WITH_XPATH = 16
+        #XML_WITH_XPTR = 17
+        #XML_WITH_XINCLUDE = 18
+        (xmlparser.XML_WITH_ICONV, "iconv"),  # XML_WITH_ICONV = 19
+        #XML_WITH_ISO8859X = 20
+        #XML_WITH_UNICODE = 21
+        (xmlparser.XML_WITH_REGEXP, "regexp"),  # XML_WITH_REGEXP = 22
+        #XML_WITH_AUTOMATA = 23
+        #XML_WITH_EXPR = 24
+        (xmlparser.XML_WITH_SCHEMAS, "xmlschema"),  # XML_WITH_SCHEMAS = 25
+        (xmlparser.XML_WITH_SCHEMATRON, "schematron"),  # XML_WITH_SCHEMATRON = 26
+        #XML_WITH_MODULES = 27
+        #XML_WITH_DEBUG = 28
+        #XML_WITH_DEBUG_MEM = 29
+        #XML_WITH_DEBUG_RUN = 30  # unused
+        (xmlparser.XML_WITH_ZLIB, "zlib"),  # XML_WITH_ZLIB = 31
+        (xmlparser.XML_WITH_ICU, "icu"),  # XML_WITH_ICU = 32
+        (xmlparser.XML_WITH_LZMA, "lzma"),  # XML_WITH_LZMA = 33
+    ] if xmlparser.xmlHasFeature(feature_id)
+}
+
+cdef bint HAS_ZLIB_COMPRESSION = xmlparser.xmlHasFeature(xmlparser.XML_WITH_ZLIB)
+
+
 # class for temporary storage of Python references,
 # used e.g. for XPath results
 @cython.final
@@ -519,13 +615,15 @@ cdef public class _Document [ type LxmlDocumentType, object LxmlDocument ]:
         c_ns = self._findOrBuildNodeNs(c_node, c_href, NULL, 0)
         tree.xmlSetNs(c_node, c_ns)
 
+
 cdef tuple __initPrefixCache():
     cdef int i
     return tuple([ python.PyBytes_FromFormat("ns%d", i)
-                   for i in range(30) ])
+                   for i in range(26) ])
 
 cdef tuple _PREFIX_CACHE = __initPrefixCache()
 
+
 cdef _Document _documentFactory(xmlDoc* c_doc, _BaseParser parser):
     cdef _Document result
     result = _Document.__new__(_Document)
@@ -1637,11 +1735,6 @@ cdef public class _Element [ type LxmlElementType, object LxmlElement ]:
         return CSSSelector(expr, translator=translator)(self)
 
 
-cdef extern from "includes/etree_defs.h":
-    # macro call to 't->tp_new()' for fast instantiation
-    cdef object NEW_ELEMENT "PY_NEW" (object t)
-
-
 @cython.linetrace(False)
 cdef _Element _elementFactory(_Document doc, xmlNode* c_node):
     cdef _Element result
@@ -1651,12 +1744,15 @@ cdef _Element _elementFactory(_Document doc, xmlNode* c_node):
     if c_node is NULL:
         return None
 
-    element_class = LOOKUP_ELEMENT_CLASS(
+    element_class = <type> LOOKUP_ELEMENT_CLASS(
         ELEMENT_CLASS_LOOKUP_STATE, doc, c_node)
+    if type(element_class) is not type:
+        if not isinstance(element_class, type):
+            raise TypeError(f"Element class is not a type, got {type(element_class)}")
     if hasProxy(c_node):
         # prevent re-entry race condition - we just called into Python
         return getProxy(c_node)
-    result = NEW_ELEMENT(element_class)
+    result = element_class.__new__(element_class)
     if hasProxy(c_node):
         # prevent re-entry race condition - we just called into Python
         result._c_node = NULL
@@ -3082,18 +3178,34 @@ cdef xmlNode* _createEntity(xmlDoc* c_doc, const_xmlChar* name) noexcept:
 
 # module-level API for ElementTree
 
-def Element(_tag, attrib=None, nsmap=None, **_extra):
+from abc import ABC
+
+class Element(ABC):
     """Element(_tag, attrib=None, nsmap=None, **_extra)
 
-    Element factory.  This function returns an object implementing the
+    Element factory, as a class.
+
+    An instance of this class is an object implementing the
     Element interface.
 
+    >>> element = Element("test")
+    >>> type(element)
+    <class 'lxml.etree._Element'>
+    >>> isinstance(element, Element)
+    True
+    >>> issubclass(_Element, Element)
+    True
+
     Also look at the `_Element.makeelement()` and
     `_BaseParser.makeelement()` methods, which provide a faster way to
     create an Element within a specific document or parser context.
     """
-    return _makeElement(_tag, NULL, None, None, None, None,
-                        attrib, nsmap, _extra)
+    def __new__(cls, _tag, attrib=None, nsmap=None, **_extra):
+          return _makeElement(_tag, NULL, None, None, None, None,
+                              attrib, nsmap, _extra)
+
+# Register _Element as a virtual subclass of Element
+Element.register(_Element)
 
 
 def Comment(text=None):
@@ -3205,32 +3317,41 @@ def SubElement(_Element _parent not None, _tag,
     """
     return _makeSubElement(_parent, _tag, None, None, attrib, nsmap, _extra)
 
+from typing import Generic, TypeVar
 
-def ElementTree(_Element element=None, *, file=None, _BaseParser parser=None):
-    """ElementTree(element=None, file=None, parser=None)
+T = TypeVar("T")
 
-    ElementTree wrapper class.
-    """
-    cdef xmlNode* c_next
-    cdef xmlNode* c_node
-    cdef xmlNode* c_node_copy
-    cdef xmlDoc*  c_doc
-    cdef _ElementTree etree
-    cdef _Document doc
+class ElementTree(ABC, Generic[T]):
+    def __new__(cls, _Element element=None, *, file=None, _BaseParser parser=None):
+        """ElementTree(element=None, file=None, parser=None)
 
-    if element is not None:
-        doc  = element._doc
-    elif file is not None:
-        try:
-            doc = _parseDocument(file, parser, None)
-        except _TargetParserResult as result_container:
-            return result_container.result
-    else:
-        c_doc = _newXMLDoc()
-        doc = _documentFactory(c_doc, parser)
+        ElementTree wrapper class.
+        """
+        cdef xmlNode* c_next
+        cdef xmlNode* c_node
+        cdef xmlNode* c_node_copy
+        cdef xmlDoc*  c_doc
+        cdef _ElementTree etree
+        cdef _Document doc
+
+        if element is not None:
+            doc  = element._doc
+        elif file is not None:
+            try:
+                doc = _parseDocument(file, parser, None)
+            except _TargetParserResult as result_container:
+                return result_container.result
+        else:
+            c_doc = _newXMLDoc()
+            doc = _documentFactory(c_doc, parser)
+
+        return _elementTreeFactory(doc, element)
 
-    return _elementTreeFactory(doc, element)
+# Register _ElementTree as a virtual subclass of ElementTree
+ElementTree.register(_ElementTree)
 
+# Remove "ABC" and typing helpers from module dict
+del ABC, Generic, TypeVar, T
 
 def HTML(text, _BaseParser parser=None, *, base_url=None):
     """HTML(text, parser=None, base_url=None)