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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: table-renderer
-Version: 0.2.0
+Version: 0.3.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
@@ -174,6 +174,9 @@ Fine-tune your output image quality and margins.
 # High-res JPG with custom 20px padding
 table.to_image("output.jpg", dpi=300, padding=20)
 
+# PNG with a solid white background (instead of the default transparent)
+table.to_image("output_white.png", background_color="white")
+
 # Lightweight WebP with tight margins
 table.to_image("output.webp", dpi=72, padding=0)
 ```

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

@@ -151,6 +151,9 @@ Fine-tune your output image quality and margins.
 # High-res JPG with custom 20px padding
 table.to_image("output.jpg", dpi=300, padding=20)
 
+# PNG with a solid white background (instead of the default transparent)
+table.to_image("output_white.png", background_color="white")
+
 # Lightweight WebP with tight margins
 table.to_image("output.webp", dpi=72, padding=0)
 ```

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

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "table-renderer"
-version = "0.2.0"
+version = "0.3.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 → table_renderer-0.3.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.2.0"
+    __version__ = "0.3.0"
 
 __all__ = ["Cell", "Column", "Row", "Style", "StyledObject", "Table", "__version__"]

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

@@ -25,7 +25,7 @@ class Table(StyledObject):
         self._cells = [[Cell() for _ in range(cols)] for _ in range(rows)]
         self._row_objects = [Row(i) for i in range(rows)]
         self._col_objects = [Column(i) for i in range(cols)]
-        self.width: int | str = "100%"
+        self.width: int | str = "auto"
         self.font_files: list[str] = []
 
     def cell(self, row_index: int, col_index: int) -> Cell:
@@ -112,7 +112,14 @@ 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,
+        background_color: str = "transparent",
+    ) -> None:
         """
         Render the table to an image file.
 
@@ -120,17 +127,27 @@ class Table(StyledObject):
             output_path: Path to the output file (e.g., 'table.png', 'table.webp').
             dpi: Resolution of the output image.
             padding: Padding around the table in pixels.
+            background_color: Background color of the image.
         """
-        render_to_image(self, output_path, dpi=dpi, padding=padding)
+        render_to_image(
+            self,
+            output_path,
+            dpi=dpi,
+            padding=padding,
+            background_color=background_color,
+        )
 
-    def to_html(self, output_path: str) -> None:
+    def to_html(
+        self, output_path: str, *, background_color: str = "transparent"
+    ) -> None:
         """
         Export the table to an HTML file.
 
         Args:
             output_path: Path to the output HTML file.
+            background_color: Background color of the HTML body.
         """
-        save_html(self, output_path)
+        save_html(self, output_path, background_color=background_color)
 
     def _prepare_render(self) -> None:
         """Handle merging logic and cascading styles before rendering."""

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

@@ -19,7 +19,7 @@ HTML_TEMPLATE = """
 body {
     margin: 0;
     padding: 20px;
-    background-color: transparent;
+    background-color: {{ background_color }};
 }
 {% for font in font_faces %}
 @font-face {
@@ -37,7 +37,14 @@ table {
 td {
     padding: 8px;
     box-sizing: border-box;
+    {{ table_style }}
+}
+
+{% for row in rows %}
+.row-{{ row.index }} {
+    {{ row.style }}
 }
+{% endfor %}
 
 {% for col in columns %}
 .col-{{ col.index }} {
@@ -45,12 +52,6 @@ td {
     {{ col.style }}
 }
 {% endfor %}
-
-{% for row in rows %}
-.row-{{ row.index }} {
-    {{ row.style }}
-}
-{% endfor %}
 </style>
 </head>
 <body>
@@ -60,10 +61,10 @@ td {
             {% for c_idx in range(cells[r_idx]|length) %}
                 {% set cell = cells[r_idx][c_idx] %}
                 {% if not cell.is_merged %}
-                <td class="col-{{ c_idx }}"
+                <td class="row-{{ r_idx }} col-{{ c_idx }}"
                     rowspan="{{ cell.row_span }}"
                     colspan="{{ cell.col_span }}"
-                    style="{{ cell.final_style }}">
+                    style="{{ cell.style.to_css() }}">
                     {% if cell.image_url %}
                     <img src="{{ cell.image_url }}"
                          style="{% if cell.image_width %}width: {{ cell.image_width }}px;{% endif %}
@@ -82,12 +83,13 @@ td {
 """
 
 
-def render_to_html(table: "Table") -> str:
+def render_to_html(table: "Table", *, background_color: str = "transparent") -> str:
     """
     Generate the HTML representation of the table.
 
     Args:
         table: The Table object to render.
+        background_color: The background color of the body.
 
     Returns:
         A string containing the complete HTML document.
@@ -107,12 +109,6 @@ def render_to_html(table: "Table") -> str:
         row_data = []
         for col_index in range(len(table._cells[0])):
             cell = table._cells[row_index][col_index]
-            row = table.get_row(row_index)
-            col = table.get_column(col_index)
-
-            # Cascading: Table -> Row/Col -> Cell
-            base_style = table.style.merge(col.style).merge(row.style)
-            final_style = base_style.merge(cell.style)
 
             # Handle Image URL resolution
             cell.image_url = ""
@@ -123,8 +119,6 @@ def render_to_html(table: "Table") -> str:
                     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)
 
@@ -151,6 +145,7 @@ def render_to_html(table: "Table") -> str:
     return template.render(
         page_width=estimated_width,
         page_height=estimated_height,
+        background_color=background_color,
         table_width=f"{table.width}px" if isinstance(table.width, int) else table.width,
         table_style=table.style.to_css(),
         font_faces=font_faces,
@@ -175,6 +170,7 @@ def render_to_image(
     *,
     dpi: int = 144,
     padding: int = 10,
+    background_color: str = "transparent",
 ) -> None:
     """
     Render the table to an image file.
@@ -184,8 +180,9 @@ def render_to_image(
         output_path: Destination path for the image.
         dpi: Target resolution.
         padding: Margin around the table.
+        background_color: Background color of the image.
     """
-    html_content = render_to_html(table)
+    html_content = render_to_html(table, background_color=background_color)
     # WeasyPrint v53+ removed write_png, so we render to PDF then convert to PNG
     pdf_bytes = HTML(string=html_content).write_pdf()
 
@@ -220,17 +217,19 @@ def render_to_image(
             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
-    bg = Image.new("RGB", pil_image.size, (255, 255, 255))
+    # Use 'L' (grayscale) mode to reduce memory usage (1 byte per pixel vs 3)
     if pil_image.mode == "RGBA":
-        bg.paste(pil_image, mask=pil_image.split()[3])
+        # Flatten RGBA onto a white grayscale background
+        grayscale = Image.new("L", pil_image.size, 255)
+        grayscale.paste(pil_image.convert("L"), mask=pil_image.getchannel("A"))
     else:
-        bg.paste(pil_image)
+        # For RGB or other modes, just convert to grayscale
+        grayscale = pil_image.convert("L")
 
-    # 2. Invert and find bbox of "ink"
+    # Invert and find bbox of "ink" (non-white pixels)
     import PIL.ImageOps
 
-    inverted = PIL.ImageOps.invert(bg)
+    inverted = PIL.ImageOps.invert(grayscale)
     bbox = inverted.getbbox()
 
     if bbox:
@@ -252,14 +251,17 @@ def render_to_image(
     pil_image.save(output_path)
 
 
-def save_html(table: "Table", output_path: str) -> None:
+def save_html(
+    table: "Table", output_path: str, *, background_color: str = "transparent"
+) -> None:
     """
     Save the table's HTML representation to a file.
 
     Args:
         table: The Table object to export.
         output_path: Path to the destination HTML file.
+        background_color: Background color of the HTML body.
     """
-    html_content = render_to_html(table)
+    html_content = render_to_html(table, background_color=background_color)
     with open(output_path, "w", encoding="utf-8") as f:
         f.write(html_content)