Method _build_doc

pandas/io/html.py:764–810

Raises ------ ValueError * If a URL that lxml cannot parse is passed. Exception * Any other ``Exception`` thrown. For example, trying to parse a URL that is syntactically correct on a machine with no internet conne

(self)

        return obj.tag == tag

    def _build_doc(self):
        """
        Raises
        ------
        ValueError
            * If a URL that lxml cannot parse is passed.

        Exception
            * Any other ``Exception`` thrown. For example, trying to parse a
              URL that is syntactically correct on a machine with no internet
              connection will fail.

        See Also
        --------
        pandas.io.html._HtmlFrameParser._build_doc
        """
        from lxml.etree import XMLSyntaxError
        from lxml.html import (
            HTMLParser,
            parse,
        )

        parser = HTMLParser(recover=True, encoding=self.encoding)

        if is_url(self.io):
            with get_handle(self.io, "r", storage_options=self.storage_options) as f:
                r = parse(f.handle, parser=parser)
        else:
            # try to parse the input in the simplest way
            try:
                r = parse(self.io, parser=parser)
            except OSError as err:
                raise FileNotFoundError(
                    f"[Errno {errno.ENOENT}] {os.strerror(errno.ENOENT)}: {self.io}"
                ) from err
        try:
            r = r.getroot()
        except AttributeError:
            pass
        else:
            if not hasattr(r, "text_content"):
                raise XMLSyntaxError("no text parsed from document", 0, 0, 0)

        for br in r.xpath("*//br"):
            br.tail = "\n" + (br.tail or "")

        return r

    def _parse_thead_tr(self, table):
        rows = []