table-renderer 0.1.0__tar.gz → 0.2.0__tar.gz

{table_renderer-0.1.0 → table_renderer-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: table-renderer
-Version: 0.1.0
+Version: 0.2.0
 Summary: A Python library for rendering structured tables as high-quality images or HTML.
 Keywords: table,renderer,rendering,image,html,weasyprint,pdfium,report
 Author: pTaunium
@@ -29,9 +29,10 @@ Description-Content-Type: text/markdown
 
 <!-- README-I18N:END -->
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Python Version](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue)](pyproject.toml)
 [![CI](https://github.com/pTaunium/table-renderer/actions/workflows/ci.yml/badge.svg)](https://github.com/pTaunium/table-renderer/actions)
+[![codecov](https://codecov.io/gh/pTaunium/table-renderer/graph/badge.svg)](https://codecov.io/gh/pTaunium/table-renderer)
 
 `table-renderer` is a powerful and lightweight Python library designed to convert structured tables into high-quality images (PNG, JPG, WebP) or HTML. By combining the layout power of CSS with an intuitive Python API, it's perfect for automated reporting, Kubernetes CronJobs, or any data visualization task.
 
@@ -41,6 +42,7 @@ Description-Content-Type: text/markdown
 - **Business Friendly**: Uses `pypdfium2` (Apache-2.0) and `WeasyPrint` for a 100% MIT-compatible dependency chain.
 - **High-Quality Rendering**: Powered by WeasyPrint (CSS engine), supporting complex text wrapping, alignment, and cell merging.
 - **Auto-Crop**: Automatically crops images to the actual table area using visual detection, eliminating unnecessary white space.
+- **Continuous Long Tables**: Automatically stitches multiple PDF pages into a single continuous long image, preventing content from being cut off.
 - **Object-Oriented API**: Clean `Table` -> `Row/Column` -> `Cell` hierarchy with fluent interface support.
 - **Cascading Styles**: Manage visual styles effortlessly with "Global Defaults + Local Overrides."
 - **Multi-language Font Support**: Support for font stacks (e.g., different fonts for English and Chinese).
@@ -81,7 +83,7 @@ from table_renderer import Table
 # 1. Initialize a 3x3 table
 table = Table(3, 3)
 table.set_width(600)
-table.set_border(1, "black", "solid")
+table.set_border(width=1, color="black", style="solid")
 
 # 2. Set header style (Row 0)
 header = table.get_row(0)
@@ -135,12 +137,14 @@ table.set_font(family="Roboto-Regular, NotoSansTC-Medium")
 
 ### 3. Embedding Images in Cells
 
-You can easily embed local images into any cell.
+You can embed both local images and remote URLs into any cell.
 
 ```python
-# Set an image with optional width/height constraints
+# Set a local image
 table.cell(1, 0).set_image("path/to/logo.png", width=50)
-table.cell(1, 0).set_text("Company Logo") # Text appears below the image
+
+# Set a remote image URL
+table.cell(1, 1).set_image("https://example.com/image.jpg", width=100)
 ```
 
 ### 4. Layout & Sizing
@@ -153,6 +157,15 @@ table.get_column(0).set_width(200)    # Fixed 200px
 table.get_column(1).set_width("auto") # Distribute remaining space
 ```
 
+**Handling Extremely Wide Tables:**
+The library dynamically estimates canvas width to prevent clipping. However, if your table contains unbreakable strings (like long URLs) and relies purely on auto-layout, you can manually override the canvas width. The auto-crop feature will automatically trim any excess white space.
+
+```python
+# Force a massive canvas width; auto-crop will cleanly trim the excess
+table.set_width(15000)
+table.to_image("wide_table.png")
+```
+
 ### 5. DPI, Formats & Padding
 
 Fine-tune your output image quality and margins.
@@ -177,9 +190,8 @@ FROM python:3.12-slim
 # Install system dependencies for WeasyPrint rendering and fonts
 RUN apt-get update && apt-get install -y --no-install-recommends \
     libpango-1.0-0 \
-    libharfbuzz0b \
     libpangoft2-1.0-0 \
-    libpangocairo-1.0-0 \
+    libharfbuzz-subset0 \
     fonts-noto-cjk \
     && rm -rf /var/lib/apt/lists/*
 

{table_renderer-0.1.0 → table_renderer-0.2.0}/README.md

@@ -6,9 +6,10 @@
 
 <!-- README-I18N:END -->
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Python Version](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue)](pyproject.toml)
 [![CI](https://github.com/pTaunium/table-renderer/actions/workflows/ci.yml/badge.svg)](https://github.com/pTaunium/table-renderer/actions)
+[![codecov](https://codecov.io/gh/pTaunium/table-renderer/graph/badge.svg)](https://codecov.io/gh/pTaunium/table-renderer)
 
 `table-renderer` is a powerful and lightweight Python library designed to convert structured tables into high-quality images (PNG, JPG, WebP) or HTML. By combining the layout power of CSS with an intuitive Python API, it's perfect for automated reporting, Kubernetes CronJobs, or any data visualization task.
 
@@ -18,6 +19,7 @@
 - **Business Friendly**: Uses `pypdfium2` (Apache-2.0) and `WeasyPrint` for a 100% MIT-compatible dependency chain.
 - **High-Quality Rendering**: Powered by WeasyPrint (CSS engine), supporting complex text wrapping, alignment, and cell merging.
 - **Auto-Crop**: Automatically crops images to the actual table area using visual detection, eliminating unnecessary white space.
+- **Continuous Long Tables**: Automatically stitches multiple PDF pages into a single continuous long image, preventing content from being cut off.
 - **Object-Oriented API**: Clean `Table` -> `Row/Column` -> `Cell` hierarchy with fluent interface support.
 - **Cascading Styles**: Manage visual styles effortlessly with "Global Defaults + Local Overrides."
 - **Multi-language Font Support**: Support for font stacks (e.g., different fonts for English and Chinese).
@@ -58,7 +60,7 @@ from table_renderer import Table
 # 1. Initialize a 3x3 table
 table = Table(3, 3)
 table.set_width(600)
-table.set_border(1, "black", "solid")
+table.set_border(width=1, color="black", style="solid")
 
 # 2. Set header style (Row 0)
 header = table.get_row(0)
@@ -112,12 +114,14 @@ table.set_font(family="Roboto-Regular, NotoSansTC-Medium")
 
 ### 3. Embedding Images in Cells
 
-You can easily embed local images into any cell.
+You can embed both local images and remote URLs into any cell.
 
 ```python
-# Set an image with optional width/height constraints
+# Set a local image
 table.cell(1, 0).set_image("path/to/logo.png", width=50)
-table.cell(1, 0).set_text("Company Logo") # Text appears below the image
+
+# Set a remote image URL
+table.cell(1, 1).set_image("https://example.com/image.jpg", width=100)
 ```
 
 ### 4. Layout & Sizing
@@ -130,6 +134,15 @@ table.get_column(0).set_width(200)    # Fixed 200px
 table.get_column(1).set_width("auto") # Distribute remaining space
 ```
 
+**Handling Extremely Wide Tables:**
+The library dynamically estimates canvas width to prevent clipping. However, if your table contains unbreakable strings (like long URLs) and relies purely on auto-layout, you can manually override the canvas width. The auto-crop feature will automatically trim any excess white space.
+
+```python
+# Force a massive canvas width; auto-crop will cleanly trim the excess
+table.set_width(15000)
+table.to_image("wide_table.png")
+```
+
 ### 5. DPI, Formats & Padding
 
 Fine-tune your output image quality and margins.
@@ -154,9 +167,8 @@ FROM python:3.12-slim
 # Install system dependencies for WeasyPrint rendering and fonts
 RUN apt-get update && apt-get install -y --no-install-recommends \
     libpango-1.0-0 \
-    libharfbuzz0b \
     libpangoft2-1.0-0 \
-    libpangocairo-1.0-0 \
+    libharfbuzz-subset0 \
     fonts-noto-cjk \
     && rm -rf /var/lib/apt/lists/*
 

{table_renderer-0.1.0 → table_renderer-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "table-renderer"
-version = "0.1.0"
+version = "0.2.0"
 description = "A Python library for rendering structured tables as high-quality images or HTML."
 readme = "README.md"
 license = "MIT"

table_renderer-0.2.0/src/table_renderer/__init__.py

@@ -0,0 +1,11 @@
+import importlib.metadata
+
+from .models import Cell, Column, Row, Style, StyledObject, Table
+
+try:
+    __version__ = importlib.metadata.version("table-renderer")
+except importlib.metadata.PackageNotFoundError:
+    # Package is not installed (e.g. during local development without pip install -e .)
+    __version__ = "0.2.0"
+
+__all__ = ["Cell", "Column", "Row", "Style", "StyledObject", "Table", "__version__"]

{table_renderer-0.1.0 → table_renderer-0.2.0}/src/table_renderer/models/base.py

@@ -12,6 +12,7 @@ class StyledObject:
 
     def set_font(
         self,
+        *,
         size: int | None = None,
         color: str | None = None,
         family: str | None = None,
@@ -50,6 +51,7 @@ class StyledObject:
 
     def set_align(
         self,
+        *,
         horizontal: Literal["left", "center", "right"] | None = None,
         vertical: Literal["top", "middle", "bottom"] | None = None,
     ) -> Self:
@@ -69,6 +71,7 @@ class StyledObject:
 
     def set_border(
         self,
+        *,
         width: int | None = None,
         color: str | None = None,
         style: Literal["solid", "dashed", "dotted"] | None = None,

{table_renderer-0.1.0 → table_renderer-0.2.0}/src/table_renderer/models/cell.py

@@ -38,7 +38,7 @@ class Cell(StyledObject):
         return self
 
     def set_image(
-        self, path: str, width: int | None = None, height: int | None = None
+        self, path: str, *, width: int | None = None, height: int | None = None
     ) -> Self:
         """
         Set an image to be displayed in the cell.
@@ -56,7 +56,7 @@ class Cell(StyledObject):
         self.image_height = height
         return self
 
-    def span(self, rows: int = 1, cols: int = 1) -> Self:
+    def span(self, *, rows: int = 1, cols: int = 1) -> Self:
         """
         Set the row and column span for merging.
 

{table_renderer-0.1.0 → table_renderer-0.2.0}/src/table_renderer/models/table.py

@@ -112,7 +112,7 @@ class Table(StyledObject):
         self.font_files.append(font_path)
         return self
 
-    def to_image(self, output_path: str, dpi: int = 144, padding: int = 10) -> None:
+    def to_image(self, output_path: str, *, dpi: int = 144, padding: int = 10) -> None:
         """
         Render the table to an image file.
 

{table_renderer-0.1.0 → table_renderer-0.2.0}/src/table_renderer/renderer.py

@@ -13,6 +13,7 @@ HTML_TEMPLATE = """
 <head>
 <style>
 @page {
+    size: {{ page_width }}px {{ page_height }}px; /* Dynamically estimated size */
     margin: 0;
 }
 body {
@@ -116,16 +117,40 @@ def render_to_html(table: "Table") -> str:
             # Handle Image URL resolution
             cell.image_url = ""
             if cell.image_path:
-                abs_img_path = os.path.abspath(cell.image_path)
-                cell.image_url = f"file://{abs_img_path}"
+                if cell.image_path.startswith(("http://", "https://")):
+                    cell.image_url = cell.image_path
+                else:
+                    abs_img_path = os.path.abspath(cell.image_path)
+                    cell.image_url = f"file://{abs_img_path}"
 
             # Attach final style string for template
             cell.final_style = final_style.to_css()
             row_data.append(cell)
         cells_data.append(row_data)
 
+    # Estimate safe canvas width to prevent clipping
+    # Base it on the number of columns if explicit widths aren't provided (assume ~100px min per column)
+    col_count = len(table._cells[0]) if table._cells else 0
+    estimated_width = max(2000, col_count * 100)
+
+    if isinstance(table.width, int):
+        estimated_width = max(estimated_width, table.width + 100)
+
+    col_width_sum = 0
+    for c in table._col_objects:
+        if isinstance(c.width, int):
+            col_width_sum += c.width
+    estimated_width = max(estimated_width, col_width_sum + 100)
+
+    # Estimate safe canvas height to optimize rendering speed for small tables, capped at 5000px
+    # Assume a generous average of 40px per row plus 100px padding
+    estimated_height = len(table._cells) * 40 + 100
+    estimated_height = min(max(estimated_height, 500), 5000)
+
     template = Template(HTML_TEMPLATE)
     return template.render(
+        page_width=estimated_width,
+        page_height=estimated_height,
         table_width=f"{table.width}px" if isinstance(table.width, int) else table.width,
         table_style=table.style.to_css(),
         font_faces=font_faces,
@@ -147,6 +172,7 @@ def render_to_html(table: "Table") -> str:
 def render_to_image(
     table: "Table",
     output_path: str,
+    *,
     dpi: int = 144,
     padding: int = 10,
 ) -> None:
@@ -168,16 +194,30 @@ def render_to_image(
 
     # Load the PDF from bytes
     with pdfium.PdfDocument(pdf_bytes) as pdf:
-        page = pdf[0]
-
-        # Render page to a bitmap
-        # scale_factor: 72 is the default PDF DPI
+        page_images = []
         scale_factor = dpi / 72
-        bitmap = page.render(scale=scale_factor)
 
-        # Convert pdfium bitmap to Pillow Image
-        pil_image = bitmap.to_pil()
-        bitmap.close()
+        # Render each page to a PIL Image
+        for page in pdf:
+            # fill_color=(255, 255, 255, 0) ensures the background is transparent
+            bitmap = page.render(scale=scale_factor, fill_color=(255, 255, 255, 0))
+            pil_page = bitmap.to_pil()
+            page_images.append(pil_page)
+            bitmap.close()
+
+        if not page_images:
+            return
+
+        # Stitch all pages vertically into one long image
+        total_width = max(img.width for img in page_images)
+        total_height = sum(img.height for img in page_images)
+
+        # Create a large canvas
+        pil_image = Image.new("RGBA", (total_width, total_height), (255, 255, 255, 0))
+        y_offset = 0
+        for img in page_images:
+            pil_image.paste(img, (0, y_offset))
+            y_offset += img.height
 
     # Visual Auto-Crop: Find the bounding box of non-white pixels
     # 1. Convert to RGB to ensure we have a standard background to check
@@ -203,6 +243,12 @@ def render_to_image(
         pil_image = pil_image.crop((left, top, right, bottom))
 
     # Save to the requested format (Pillow handles most formats)
+    if output_path.lower().endswith((".jpg", ".jpeg")) and pil_image.mode == "RGBA":
+        # Create a white background image and paste the RGBA image on it to flatten it
+        rgb_image = Image.new("RGB", pil_image.size, (255, 255, 255))
+        rgb_image.paste(pil_image, mask=pil_image.split()[3])
+        pil_image = rgb_image
+
     pil_image.save(output_path)
 
 

table_renderer-0.1.0/src/table_renderer/__init__.py

@@ -1,3 +0,0 @@
-from .models import Cell, Column, Row, Style, StyledObject, Table
-
-__all__ = ["Cell", "Column", "Row", "Style", "StyledObject", "Table"]