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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: table-renderer
-Version: 0.1.1
+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
@@ -42,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).
@@ -82,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)
@@ -156,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.
@@ -180,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.1 → table_renderer-0.2.0}/README.md

@@ -19,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).
@@ -59,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)
@@ -133,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.
@@ -157,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.1 → table_renderer-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "table-renderer"
-version = "0.1.1"
+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.1.1 → table_renderer-0.2.0}/src/table_renderer/__init__.py

@@ -6,6 +6,6 @@ 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.1.1"
+    __version__ = "0.2.0"
 
 __all__ = ["Cell", "Column", "Row", "Style", "StyledObject", "Table", "__version__"]

{table_renderer-0.1.1 → 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.1 → 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.1 → 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.1 → 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 {
@@ -127,8 +128,29 @@ def render_to_html(table: "Table") -> str:
             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,
@@ -150,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:
@@ -171,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
@@ -206,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)