dataframe2image 0.2.0

Convert pandas DataFrame to beautiful table images with automatic Chinese font support

dataframe2image

Convert pandas DataFrame to beautiful table images.

Features

• Convert pandas DataFrame to high-quality table images
• Beautiful, customizable styling with CSS
• Support for various image formats (PNG, JPEG, WebP)
• Responsive table design
• Easy to use API

Installation

pip install dataframe2image

After installation, you need to install Playwright browsers:

playwright install chromium

Quick Start

import pandas as pd
from dataframe2image import df_to_image

# Create a sample DataFrame
df = pd.DataFrame({
    'Name': ['Alice', 'Bob', 'Charlie', 'Diana'],
    'Age': [25, 30, 35, 28],
    'City': ['New York', 'London', 'Tokyo', 'Paris'],
    'Salary': [50000, 60000, 70000, 55000]
})

# Convert to image
df_to_image(df, output_path='table.png')

Advanced Usage

from dataframe2image import df_to_image, TableStyle

# Custom styling
style = TableStyle(
    theme='dark',
    font_family='Arial',
    font_size=14,
    border_color='#333',
    header_bg_color='#4CAF50',
    row_bg_colors=['#f9f9f9', '#ffffff']
)

df_to_image(
    df, 
    output_path='styled_table.png',
    style=style,
    width=800,
    height=600
)

API Reference

df_to_image(df, output_path, style=None, width=None, height=None, format='png')

Convert a pandas DataFrame to an image.

Parameters:

• df (pandas.DataFrame): The DataFrame to convert
• output_path (str): Path where the image will be saved
• style (TableStyle, optional): Custom styling options
• width (int, optional): Image width in pixels
• height (int, optional): Image height in pixels (auto if not specified)
• format (str): Image format ('png', 'jpeg', 'webp')

TableStyle

Customization options for table appearance.

Parameters:

• theme (str): Theme name ('light', 'dark', 'minimal')
• font_family (str): Font family name
• font_size (int): Font size in pixels
• border_color (str): Border color (CSS color)
• header_bg_color (str): Header background color
• row_bg_colors (list): Alternating row background colors

License

MIT License