table-to-image 0.1.0__py3-none-any.whl

table_to_image/__init__.py

@@ -0,0 +1,3 @@
+from .core import DataFrameToImage, render
+
+__all__ = ["DataFrameToImage", "render"]

table_to_image/cli.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+import typer
+import pandas as pd
+from .core import render
+
+app = typer.Typer()
+
+
+@app.command()
+def convert(
+    input_file: Path = typer.Argument(..., help="Input CSV, Excel, or markdown table file"),
+    output_file: Path = typer.Argument(..., help="Output PNG image file"),
+    font_size: int = typer.Option(14, "-s", "--size", help="Font size"),
+):
+    """Convert CSV/Excel/markdown table file to PNG image."""
+    # Detect file type and read accordingly
+    if input_file.suffix.lower() in ['.xlsx', '.xls']:
+        df = pd.read_excel(input_file)
+    elif input_file.suffix.lower() == '.md':
+        # Read markdown table using pandas
+        df = pd.read_csv(input_file, sep='|', skipinitialspace=True)
+    else:
+        df = pd.read_csv(input_file)
+
+    render(df, output_file, font_size=font_size)
+    typer.echo(f"Image saved to {output_file}")
+
+
+if __name__ == "__main__":
+    app()

table_to_image/core.py

@@ -0,0 +1,43 @@
+from pathlib import Path
+from typing import Union
+import pandas as pd
+from .render import render
+
+
+class DataFrameToImage:
+    """Convert pandas DataFrame to PNG image."""
+
+    def __init__(
+        self,
+        font_size: int = 14,
+        header_bg_color: tuple = (70, 130, 180),  # Steel blue
+        header_text_color: tuple = (255, 255, 255),
+        cell_bg_color: tuple = (255, 255, 255),
+        cell_text_color: tuple = (0, 0, 0),
+        margin: int = 10,
+    ):
+        self.font_size = font_size
+        self.header_bg_color = header_bg_color
+        self.header_text_color = header_text_color
+        self.cell_bg_color = cell_bg_color
+        self.cell_text_color = cell_text_color
+        self.margin = margin
+
+    def convert(
+        self,
+        df: pd.DataFrame,
+        output_path: Union[str, Path],
+        **kwargs
+    ):
+        """Convert DataFrame to image and save."""
+        render(
+            df,
+            output_path,
+            font_size=self.font_size,
+            header_bg_color=self.header_bg_color,
+            header_text_color=self.header_text_color,
+            cell_bg_color=self.cell_bg_color,
+            cell_text_color=self.cell_text_color,
+            margin=self.margin,
+            **kwargs
+        )

table_to_image/render.py

@@ -0,0 +1,102 @@
+from pathlib import Path
+from typing import Union
+import pandas as pd
+from PIL import Image, ImageDraw, ImageFont
+
+
+def render(
+    df: pd.DataFrame,
+    output_path: Union[str, Path],
+    font_size: int = 14,
+    header_bg_color: tuple = (70, 130, 180),
+    header_text_color: tuple = (255, 255, 255),
+    cell_bg_color: tuple = (255, 255, 255),
+    cell_text_color: tuple = (0, 0, 0),
+    margin: int = 10,
+):
+    """Render a pandas DataFrame as a PNG image."""
+    # Calculate dimensions
+    num_rows, num_cols = df.shape
+
+    # Get column widths based on content
+    col_widths = []
+    for col in df.columns:
+        max_width = len(str(col))
+        for val in df[col]:
+            max_width = max(max_width, len(str(val)))
+        col_widths.append(max_width)
+
+    # Get row height
+    row_height = font_size + 10
+
+    # Calculate image dimensions
+    cell_padding = 10
+    header_height = row_height
+    total_width = sum(col_widths) + (num_cols + 1) * cell_padding
+    total_height = (num_rows + 1) * row_height + (num_rows + 2) * margin
+
+    # Create image
+    img = Image.new('RGB', (total_width, total_height), color=(255, 255, 255))
+    draw = ImageDraw.Draw(img)
+
+    # Try to load a font, fall back to default if not available
+    try:
+        font = ImageFont.truetype("/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf", font_size)
+    except IOError:
+        font = ImageFont.load_default()
+
+    # Draw headers
+    x_offset = margin + cell_padding
+    y_offset = margin
+
+    for i, col in enumerate(df.columns):
+        # Draw header background
+        header_left = x_offset + sum(col_widths[:i])
+        header_top = y_offset
+        header_right = header_left + col_widths[i]
+        header_bottom = header_top + header_height
+        draw.rectangle(
+            [header_left, header_top, header_right, header_bottom],
+            fill=header_bg_color
+        )
+
+        # Draw header text
+        text_x = header_left + cell_padding // 2
+        text_y = header_top + (header_height - font_size) // 2
+        draw.text((text_x, text_y), str(col), fill=header_text_color, font=font)
+
+    # Draw cells
+    for row_idx, (_, row) in enumerate(df.iterrows()):
+        y_offset += row_height
+        for col_idx, value in enumerate(row):
+            cell_left = margin + cell_padding + sum(col_widths[:col_idx])
+            cell_top = y_offset
+            cell_right = cell_left + col_widths[col_idx]
+            cell_bottom = cell_top + row_height
+
+            # Draw cell background (alternating colors for readability)
+            if row_idx % 2 == 0:
+                cell_color = cell_bg_color
+            else:
+                cell_color = (245, 245, 245)
+            draw.rectangle(
+                [cell_left, cell_top, cell_right, cell_bottom],
+                fill=cell_color
+            )
+
+            # Draw cell border
+            draw.rectangle(
+                [cell_left, cell_top, cell_right, cell_bottom],
+                outline=(200, 200, 200),
+                width=1
+            )
+
+            # Draw cell text
+            text_x = cell_left + cell_padding // 2
+            text_y = cell_top + (row_height - font_size) // 2
+            draw.text((text_x, text_y), str(value), fill=cell_text_color, font=font)
+
+    # Save image
+    output_path = Path(output_path)
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    img.save(output_path, 'PNG')

table_to_image-0.1.0.dist-info/METADATA

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: table-to-image
+Version: 0.1.0
+Summary: Convert markdown tables to PNG images
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: typer>=0.9.0
+Dynamic: license-file
+
+# table-to-image
+
+Convert pandas DataFrame tables to PNG images.
+
+## Installation
+
+```bash
+pip install table-to-image
+```
+
+## Usage
+
+### As a Python Library
+
+```python
+import pandas as pd
+from table_to_image import render
+
+# Create a DataFrame
+df = pd.DataFrame({
+    'Name': ['Alice', 'Bob', 'Charlie'],
+    'Age': [25, 30, 35],
+    'City': ['NYC', 'LA', 'Chicago']
+})
+
+# Convert to image
+render(df, 'output.png')
+
+# With custom options
+render(df, 'output.png', font_size=16, header_bg_color=(255, 0, 0))
+```
+
+### Using the Class
+
+```python
+import pandas as pd
+from table_to_image import DataFrameToImage
+
+df = pd.DataFrame({'A': [1, 2], 'B': ['x', 'y']})
+
+converter = DataFrameToImage(font_size=18, header_bg_color=(0, 128, 0))
+converter.convert(df, 'table.png')
+```
+
+### CLI
+
+```bash
+# Convert CSV to PNG
+table-to-image input.csv output.png
+
+# Convert with custom font size
+table-to-image input.csv output.png --size 20
+
+# Convert Excel file
+table-to-image data.xlsx output.png
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `font_size` | Font size for text | 14 |
+| `header_bg_color` | Header background color (RGB tuple) | (70, 130, 180) |
+| `header_text_color` | Header text color (RGB tuple) | (255, 255, 255) |
+| `cell_bg_color` | Cell background color (RGB tuple) | (255, 255, 255) |
+| `cell_text_color` | Cell text color (RGB tuple) | (0, 0, 0) |
+| `margin` | Margin around the table | 10 |
+
+## License
+
+MIT

table_to_image-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+table_to_image/__init__.py,sha256=vNB38SklMQFWYr5LavNHY6Fv8vYkWTKe3x0fseer0cQ,85
+table_to_image/cli.py,sha256=PEmZF6w7xwUZOXgfx5AbMYVTU0RR_HXzfZd1oXcqsTk,919
+table_to_image/core.py,sha256=VWsh-xSeYRwgpGP5DqBQzOhSUa77XXeCsRYxeHAEvxY,1256
+table_to_image/render.py,sha256=1CZk0O6DW5NNN8faifC0qfFaueOo0I7BraoSbuqtm7Q,3389
+table_to_image-0.1.0.dist-info/licenses/LICENSE,sha256=dUhuoK-TCRQMpuLEAdfme-qPSJI0TlcH9jlNxeg9_EQ,1056
+table_to_image-0.1.0.dist-info/METADATA,sha256=flieqROV2eQ95sUMLcO892ux21b8r7fwN6I1nB-kqsk,1760
+table_to_image-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+table_to_image-0.1.0.dist-info/entry_points.txt,sha256=C8d88K_QUOqPLdyMLz5W-tWWk9mYiWHbw6YKUABFKq0,58
+table_to_image-0.1.0.dist-info/top_level.txt,sha256=--s1Nx9pOjssxfrHJnkxHfOv2u1LFPawFkT6QBj3QdQ,15
+table_to_image-0.1.0.dist-info/RECORD,,

table_to_image-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

table_to_image-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+table-to-image = table_to_image.cli:app

table_to_image-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

table_to_image-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+table_to_image