webtable2json v1.0.0 - Initial Release
π Initial Release
A powerful Python library for extracting HTML tables from webpages and converting them to structured JSON format.
β¨ Features
Universal Table Extraction: Extract tables from any URL or HTML content
Smart Data Cleaning: Automatically cleans and normalizes table data
Complex Table Support: Handles thead, tbody, colspan, rowspan, and nested structures
Link Preservation: Maintains links and metadata from table cells
Flexible Output: Get all tables or target specific ones by index
Type Safety: Full type hints for better development experience
Error Handling: Comprehensive error handling with meaningful messages
π Key Functions
convert_url_to_json() - Extract tables directly from URLs
convert_html_to_json() - Process HTML content
get_main_table() - Get the largest/main table automatically
get_clean_ranking_data() - Specialized function for ranking websites
WebTableToJSON class - Full control with custom headers and options
π Perfect For
Web scraping projects
Data extraction from ranking websites (NIRF, university rankings, etc.)
Converting tabular web data to structured formats
Research and data analysis
API development requiring table data
π Requirements
Python 3.7+
requests >= 2.25.0
beautifulsoup4 >= 4.9.0
π¦ Installation
pip install webtable2json
π§ Quick Start
from webtable2json import convert_url_to_json
Extract all tables from a webpage
tables = convert_url_to_json("https://example.com/data")
print(f"Found {len(tables)} tables")
This initial release provides a solid foundation for HTML table extraction with clean, intuitive APIs and robust error handling.