tabulate-html 0.1.1

A robust HTML table parser for Python with full rowspan/colspan and multi-header support

tabulate-html

A robust, professional-grade HTML table parser for Python, designed specifically for complex real-world web tables. It fully supports rowspan, colspan, multi-row hierarchical headers, merged cells, and concatenation of fragmented HTML snippets.

While many lightweight table parsers fail on merged cells, tabulate-html uses a precise 2D matrix mapping to handle them perfectly — making it an ideal choice for web scraping, data extraction, and structured crawling.

中文文档

Features

• Accurate handling of arbitrary rowspan and colspan (outperforms pandas.read_html and most other libraries on complex tables)
• Support for multi-row hierarchical headers (automatically merged as Level1_Level2_Level3)
• Concatenation of multiple table fragments (perfect for paginated or dynamically loaded tables)
• Configurable extraction strategies:
  • TEXT_AND_LINKS: plain text + appended links/images
  • RAW_HTML: preserve original cell HTML
  • STRIP_TAGS: pure text only
• Comprehensive logging and production-ready error handling
• Full type hints and clean, maintainable code

Installation

pip install tabulate-html

## Quick Start

```python
from tabulate_html import parse_html_tables

html = """
<table>
  <tr><th>Name</th><th colspan="2">Contact</th></tr>
  <tr><th>Age</th><th>Phone</th><th>Email</th></tr>
  <tr><td rowspan="2">John Doe</td><td>30</td><td>138...</td><td>[e-mail]</td></tr>
  <tr><td>31</td><td>139...</td><td>[e-mail]</td></tr>
</table>
"""

data = parse_html_tables(html, header_rows=[0, 1])
print(data)

Output:

[
  {
    "Name_Age": "John Doe",
    "Contact_Phone": "138...",
    "Contact_Email": "[e-mail]"
  },
  {
    "Name_Age": "John Doe",
    "Contact_Phone": "139...",
    "Contact_Email": "[e-mail]"
  }
]

Advanced Usage

from tabulate_html import TableParser, ParseStrategy

parser = TableParser(
    strategy=ParseStrategy.TEXT_AND_LINKS,  # Extract text and append links/images
    key_separator="-",                      # Use hyphen for header keys
    tag_separator=" "                       # Join multi-text segments with space
)

result = parser.parse(html_snippets, header_rows=[0, 1, 2])  # Support 3-level headers
json_output = parser.to_json(result)