table-to-image 0.1.0__tar.gz

table_to_image-0.1.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,71 @@
+# 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/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "table-to-image"
+version = "0.1.0"
+description = "Convert markdown tables to PNG images"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "pandas>=2.0.0",
+    "pillow>=10.0.0",
+    "typer>=0.9.0",
+]
+
+[project.scripts]
+table-to-image = "table_to_image.cli:app"

table_to_image-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

table_to_image-0.1.0/src/table_to_image/__init__.py

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

table_to_image-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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/src/table_to_image.egg-info/PKG-INFO

@@ -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/src/table_to_image.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/table_to_image/__init__.py
+src/table_to_image/cli.py
+src/table_to_image/core.py
+src/table_to_image/render.py
+src/table_to_image.egg-info/PKG-INFO
+src/table_to_image.egg-info/SOURCES.txt
+src/table_to_image.egg-info/dependency_links.txt
+src/table_to_image.egg-info/entry_points.txt
+src/table_to_image.egg-info/requires.txt
+src/table_to_image.egg-info/top_level.txt
+tests/test_core.py

table_to_image-0.1.0/src/table_to_image.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

table_to_image-0.1.0/src/table_to_image.egg-info/entry_points.txt

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

table_to_image-0.1.0/src/table_to_image.egg-info/requires.txt

@@ -0,0 +1,3 @@
+pandas>=2.0.0
+pillow>=10.0.0
+typer>=0.9.0

table_to_image-0.1.0/src/table_to_image.egg-info/top_level.txt

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

table_to_image-0.1.0/tests/test_core.py

@@ -0,0 +1,87 @@
+"""Tests for table_to_image core functionality."""
+import tempfile
+from pathlib import Path
+import pandas as pd
+from PIL import Image
+
+from table_to_image import DataFrameToImage, render
+
+
+def test_dataframe_to_image_init():
+    """Test DataFrameToImage initialization with default values."""
+    converter = DataFrameToImage()
+    assert converter.font_size == 14
+    assert converter.header_bg_color == (70, 130, 180)
+    assert converter.header_text_color == (255, 255, 255)
+    assert converter.cell_bg_color == (255, 255, 255)
+    assert converter.cell_text_color == (0, 0, 0)
+    assert converter.margin == 10
+
+
+def test_dataframe_to_image_custom_init():
+    """Test DataFrameToImage initialization with custom values."""
+    converter = DataFrameToImage(
+        font_size=20,
+        header_bg_color=(255, 0, 0),
+        cell_bg_color=(200, 200, 200),
+        margin=20
+    )
+    assert converter.font_size == 20
+    assert converter.header_bg_color == (255, 0, 0)
+    assert converter.margin == 20
+
+
+def test_render_dataframe():
+    """Test render function creates a valid image."""
+    df = pd.DataFrame({
+        'Name': ['Alice', 'Bob'],
+        'Age': [25, 30],
+        'City': ['NYC', 'LA']
+    })
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        output_path = Path(tmpdir) / "test.png"
+        render(df, output_path)
+
+        # Verify file was created
+        assert output_path.exists()
+
+        # Verify it's a valid image
+        img = Image.open(output_path)
+        assert img.format == 'PNG'
+        assert img.size[0] > 0
+        assert img.size[1] > 0
+
+
+def test_dataframe_to_image_convert():
+    """Test DataFrameToImage.convert method."""
+    df = pd.DataFrame({
+        'Column A': ['Value 1', 'Value 2'],
+        'Column B': [100, 200]
+    })
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        output_path = Path(tmpdir) / "convert_test.png"
+        converter = DataFrameToImage()
+        converter.convert(df, output_path)
+
+        assert output_path.exists()
+        img = Image.open(output_path)
+        assert img.format == 'PNG'
+
+
+def test_render_with_custom_colors():
+    """Test render function with custom colors."""
+    df = pd.DataFrame({'X': [1, 2], 'Y': [3, 4]})
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        output_path = Path(tmpdir) / "custom_colors.png"
+        render(
+            df,
+            output_path,
+            font_size=16,
+            header_bg_color=(0, 128, 0),
+            header_text_color=(255, 255, 0)
+        )
+
+        assert output_path.exists()