class_docstr: Base class for parsers that parse HTML into DataFrames.
  
  Parameters
  ----------
  io : str or file-like
      This can be either a string of raw HTML, a valid URL using the HTTP,
      FTP, or FILE protocols or a file-like object.
  
  match : str or regex
      The text to match in the document.
  
  attrs : dict
      List of HTML <table> element attributes to match.
  
  encoding : str
      Encoding to be used by parser
  
  displayed_only : bool
      Whether or not items with "display:none" should be ignored
  
  extract_links : {None, "all", "header", "body", "footer"}
      Table elements in the specified section(s) with <a> tags will have their
      href extracted.
  
      .. versionadded:: 1.5.0
  
  Attributes
  ----------
  io : str or file-like
      raw HTML, URL, or file-like object
  
  match : regex
      The text to match in the raw HTML
  
  attrs : dict-like
      A dictionary of valid table attributes to use to search for table
      elements.
  
  encoding : str
      Encoding to be used by parser
  
  displayed_only : bool
      Whether or not items with "display:none" should be ignored
  
  extract_links : {None, "all", "header", "body", "footer"}
      Table elements in the specified section(s) with <a> tags will have their
      href extracted.
  
      .. versionadded:: 1.5.0
  
  Notes
  -----
  To subclass this class effectively you must override the following methods:
      * :func:`_build_doc`
      * :func:`_attr_getter`
      * :func:`_href_getter`
      * :func:`_text_getter`
      * :func:`_parse_td`
      * :func:`_parse_thead_tr`
      * :func:`_parse_tbody_tr`
      * :func:`_parse_tfoot_tr`
      * :func:`_parse_tables`
      * :func:`_equals_tag`
  See each method's respective documentation for details on their
  functionality.
class_docstr_tok: ["Base","class","for","parsers","that","parse","HTML","into","DataFrames",".","Parameters","--","--","--","--","--","io",":","str","or","file-like","This","can","be","either","a","string","of","raw","HTML",",","a","valid","URL","using","the","HTTP",",","FTP",",","or","FILE","protocols","or","a","file-like","object",".","match",":","str","or","regex","The","text","to","match","in","the","document",".","attrs",":","dict","List","of","HTML","<","table",">","element","attributes","to","match",".","encoding",":","str","Encoding","to","be","used","by","parser","displayed_only",":","bool","Whether","or","not","items","with","``","display",":","none","''","should","be","ignored","extract_links",":","{","None",",","``","all","''",",","``","header","''",",","``","body","''",",","``","footer","''","}","Table","elements","in","the","specified","section","(","s",")","with","<","a",">","tags","will","have","their","href","extracted",".","..","versionadded",":",":","1.5.0","Attributes","--","--","--","--","--","io",":","str","or","file-like","raw","HTML",",","URL",",","or","file-like","object","match",":","regex","The","text","to","match","in","the","raw","HTML","attrs",":","dict-like","A","dictionary","of","valid","table","attributes","to","use","to","search","for","table","elements",".","encoding",":","str","Encoding","to","be","used","by","parser","displayed_only",":","bool","Whether","or","not","items","with","``","display",":","none","''","should","be","ignored","extract_links",":","{","None",",","``","all","''",",","``","header","''",",","``","body","''",",","``","footer","''","}","Table","elements","in","the","specified","section","(","s",")","with","<","a",">","tags","will","have","their","href","extracted",".","..","versionadded",":",":","1.5.0","Notes","--","--","-","To","subclass","this","class","effectively","you","must","override","the","following","methods",":","*",":","func",":","`","_build_doc","`","*",":","func",":","`","_attr_getter","`","*",":","func",":","`","_href_getter","`","*",":","func",":","`","_text_getter","`","*",":","func",":","`","_parse_td","`","*",":","func",":","`","_parse_thead_tr","`","*",":","func",":","`","_parse_tbody_tr","`","*",":","func",":","`","_parse_tfoot_tr","`","*",":","func",":","`","_parse_tables","`","*",":","func",":","`","_equals_tag","`","See","each","method","'s","respective","documentation","for","details","on","their","functionality","."]
code: def __init__(
      self,
      io: FilePath | ReadBuffer[str] | ReadBuffer[bytes],
      match: str | Pattern,
      attrs: dict[str, str] | None,
      encoding: str,
      displayed_only: bool,
      extract_links: Literal[None, "header", "footer", "body", "all"],
  ) -> None:
      self.io = io
      self.match = match
      self.attrs = attrs
      self.encoding = encoding
      self.displayed_only = displayed_only
      self.extract_links = extract_links
  
imports: from __future__ import annotations
  from collections import abc
  import numbers
  import re
  from typing import TYPE_CHECKING, Iterable, Literal, Pattern, Sequence, cast
  from pandas._libs import lib
  from pandas._typing import BaseBuffer, DtypeBackend, FilePath, ReadBuffer
  from pandas.compat._optional import import_optional_dependency
  from pandas.errors import AbstractMethodError, EmptyDataError
  from pandas.util._validators import check_dtype_backend
  from pandas.core.dtypes.common import is_list_like
  from pandas import isna
  from pandas.core.indexes.base import Index
  from pandas.core.indexes.multi import MultiIndex
  from pandas.core.series import Series
  from pandas.io.common import file_exists, get_handle, is_url, stringify_path, urlopen, validate_header_arg
  from pandas.io.formats.printing import pprint_thing
  from pandas.io.parsers import TextParser
label_desc: Use image node_id 1 to create a new _HtmlFrameParser object  with example: obj = _HtmlFrameParser(io, match, attrs, encoding, displayed_only, extract_links)