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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: table-renderer
-Version: 0.3.0
+Version: 0.4.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
@@ -44,7 +44,7 @@ Description-Content-Type: text/markdown
 - **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."
+- **Cascading Styles**: Manage visual styles effortlessly with logical precedence: `Cell` > `Row` > `Column` > `Table`.
 - **Multi-language Font Support**: Support for font stacks (e.g., different fonts for English and Chinese).
 - **Customizable Resolution**: Adjustable DPI for high-resolution output (e.g., 300 DPI for print).
 - **Lightweight Deployment**: No heavy browser dependencies (like Chromium), making it ideal for Docker/K8s.
@@ -82,7 +82,6 @@ from table_renderer import Table
 
 # 1. Initialize a 3x3 table
 table = Table(3, 3)
-table.set_width(600)
 table.set_border(width=1, color="black", style="solid")
 
 # 2. Set header style (Row 0)
@@ -105,8 +104,8 @@ table.cell(2, 2).set_text("$79")
 # 4. Global column styling (align prices to the right)
 table.get_column(2).set_align(horizontal="right").set_width(100)
 
-# 5. Export to image with custom DPI and padding
-table.to_image("report.png", dpi=300, padding=20)
+# 5. Export to image with custom DPI, padding, and background color
+table.to_image("report.png", dpi=300, padding=20, background_color="white")
 ```
 
 ---

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

@@ -21,7 +21,7 @@
 - **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."
+- **Cascading Styles**: Manage visual styles effortlessly with logical precedence: `Cell` > `Row` > `Column` > `Table`.
 - **Multi-language Font Support**: Support for font stacks (e.g., different fonts for English and Chinese).
 - **Customizable Resolution**: Adjustable DPI for high-resolution output (e.g., 300 DPI for print).
 - **Lightweight Deployment**: No heavy browser dependencies (like Chromium), making it ideal for Docker/K8s.
@@ -59,7 +59,6 @@ from table_renderer import Table
 
 # 1. Initialize a 3x3 table
 table = Table(3, 3)
-table.set_width(600)
 table.set_border(width=1, color="black", style="solid")
 
 # 2. Set header style (Row 0)
@@ -82,8 +81,8 @@ table.cell(2, 2).set_text("$79")
 # 4. Global column styling (align prices to the right)
 table.get_column(2).set_align(horizontal="right").set_width(100)
 
-# 5. Export to image with custom DPI and padding
-table.to_image("report.png", dpi=300, padding=20)
+# 5. Export to image with custom DPI, padding, and background color
+table.to_image("report.png", dpi=300, padding=20, background_color="white")
 ```
 
 ---

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

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

{table_renderer-0.3.0 → table_renderer-0.4.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.3.0"
+    __version__ = "0.4.0"
 
 __all__ = ["Cell", "Column", "Row", "Style", "StyledObject", "Table", "__version__"]

{table_renderer-0.3.0 → table_renderer-0.4.0}/src/table_renderer/models/__init__.py

@@ -1,8 +1,7 @@
-from .base import StyledObject
 from .cell import Cell
 from .column import Column
 from .row import Row
-from .style import Style
+from .style import Style, StyledObject
 from .table import Table
 
 __all__ = ["Cell", "Column", "Row", "Style", "StyledObject", "Table"]

{table_renderer-0.3.0 → table_renderer-0.4.0}/src/table_renderer/models/cell.py

@@ -1,6 +1,6 @@
 from typing import Self
 
-from .base import StyledObject
+from .style import StyledObject
 
 
 class Cell(StyledObject):

{table_renderer-0.3.0 → table_renderer-0.4.0}/src/table_renderer/models/column.py

@@ -1,6 +1,6 @@
 from typing import Self
 
-from .base import StyledObject
+from .style import StyledObject
 
 
 class Column(StyledObject):

{table_renderer-0.3.0 → table_renderer-0.4.0}/src/table_renderer/models/row.py

@@ -1,4 +1,4 @@
-from .base import StyledObject
+from .style import StyledObject
 
 
 class Row(StyledObject):

{table_renderer-0.3.0 → table_renderer-0.4.0}/src/table_renderer/models/style.py

@@ -1,5 +1,5 @@
 from dataclasses import dataclass
-from typing import Literal
+from typing import Literal, Self
 
 
 @dataclass
@@ -105,3 +105,93 @@ class Style:
             if style:
                 css.append(f"border-{side}-style: {style};")
         return css
+
+
+class StyledObject:
+    """Base class for objects that can be styled."""
+
+    def __init__(self) -> None:
+        """Initialize with a default Style."""
+        self.style = Style()
+
+    def set_font(
+        self,
+        *,
+        size: int | None = None,
+        color: str | None = None,
+        family: str | None = None,
+        weight: Literal["normal", "bold"] | None = None,
+    ) -> Self:
+        """
+        Set font related styles.
+
+        Args:
+            size: Font size in pixels.
+            color: Text color (e.g., 'red', '#ff0000').
+            family: Font family or font stack.
+            weight: 'normal' or 'bold'.
+
+        Returns:
+            The object itself for chaining.
+        """
+        self.style.font_size = size or self.style.font_size
+        self.style.font_color = color or self.style.font_color
+        self.style.font_family = family or self.style.font_family
+        self.style.font_weight = weight or self.style.font_weight
+        return self
+
+    def set_background(self, color: str) -> Self:
+        """
+        Set the background color.
+
+        Args:
+            color: Background color.
+
+        Returns:
+            The object itself for chaining.
+        """
+        self.style.bg_color = color
+        return self
+
+    def set_align(
+        self,
+        *,
+        horizontal: Literal["left", "center", "right"] | None = None,
+        vertical: Literal["top", "middle", "bottom"] | None = None,
+    ) -> Self:
+        """
+        Set text alignment.
+
+        Args:
+            horizontal: Horizontal alignment.
+            vertical: Vertical alignment.
+
+        Returns:
+            The object itself for chaining.
+        """
+        self.style.text_align = horizontal or self.style.text_align
+        self.style.vertical_align = vertical or self.style.vertical_align
+        return self
+
+    def set_border(
+        self,
+        *,
+        width: int | None = None,
+        color: str | None = None,
+        style: Literal["solid", "dashed", "dotted"] | None = None,
+    ) -> Self:
+        """
+        Set border styles.
+
+        Args:
+            width: Border width in pixels.
+            color: Border color.
+            style: Border style.
+
+        Returns:
+            The object itself for chaining.
+        """
+        self.style.border_width = width or self.style.border_width
+        self.style.border_color = color or self.style.border_color
+        self.style.border_style = style or self.style.border_style
+        return self

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

@@ -2,10 +2,10 @@ from typing import Self
 
 from table_renderer.renderer import render_to_image, save_html
 
-from .base import StyledObject
 from .cell import Cell
 from .column import Column
 from .row import Row
+from .style import StyledObject
 
 
 class Table(StyledObject):

table_renderer-0.3.0/src/table_renderer/models/base.py

@@ -1,93 +0,0 @@
-from typing import Literal, Self
-
-from .style import Style
-
-
-class StyledObject:
-    """Base class for objects that can be styled."""
-
-    def __init__(self) -> None:
-        """Initialize with a default Style."""
-        self.style = Style()
-
-    def set_font(
-        self,
-        *,
-        size: int | None = None,
-        color: str | None = None,
-        family: str | None = None,
-        weight: Literal["normal", "bold"] | None = None,
-    ) -> Self:
-        """
-        Set font related styles.
-
-        Args:
-            size: Font size in pixels.
-            color: Text color (e.g., 'red', '#ff0000').
-            family: Font family or font stack.
-            weight: 'normal' or 'bold'.
-
-        Returns:
-            The object itself for chaining.
-        """
-        self.style.font_size = size or self.style.font_size
-        self.style.font_color = color or self.style.font_color
-        self.style.font_family = family or self.style.font_family
-        self.style.font_weight = weight or self.style.font_weight
-        return self
-
-    def set_background(self, color: str) -> Self:
-        """
-        Set the background color.
-
-        Args:
-            color: Background color.
-
-        Returns:
-            The object itself for chaining.
-        """
-        self.style.bg_color = color
-        return self
-
-    def set_align(
-        self,
-        *,
-        horizontal: Literal["left", "center", "right"] | None = None,
-        vertical: Literal["top", "middle", "bottom"] | None = None,
-    ) -> Self:
-        """
-        Set text alignment.
-
-        Args:
-            horizontal: Horizontal alignment.
-            vertical: Vertical alignment.
-
-        Returns:
-            The object itself for chaining.
-        """
-        self.style.text_align = horizontal or self.style.text_align
-        self.style.vertical_align = vertical or self.style.vertical_align
-        return self
-
-    def set_border(
-        self,
-        *,
-        width: int | None = None,
-        color: str | None = None,
-        style: Literal["solid", "dashed", "dotted"] | None = None,
-    ) -> Self:
-        """
-        Set border styles.
-
-        Args:
-            width: Border width in pixels.
-            color: Border color.
-            style: Border style.
-
-        Returns:
-            The object itself for chaining.
-        """
-        self.style.border_width = width or self.style.border_width
-        self.style.border_color = color or self.style.border_color
-        self.style.border_style = style or self.style.border_style
-        return self

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

@@ -40,18 +40,18 @@ td {
     {{ table_style }}
 }
 
-{% for row in rows %}
-.row-{{ row.index }} {
-    {{ row.style }}
-}
-{% endfor %}
-
 {% for col in columns %}
 .col-{{ col.index }} {
     width: {{ col.width }};
     {{ col.style }}
 }
 {% endfor %}
+
+{% for row in rows %}
+.row-{{ row.index }} {
+    {{ row.style }}
+}
+{% endfor %}
 </style>
 </head>
 <body>