tesorotools-python 0.0.39__tar.gz → 0.0.40__tar.gz

{tesorotools_python-0.0.39 → tesorotools_python-0.0.40}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tesorotools-python
-Version: 0.0.39
+Version: 0.0.40
 Requires-Python: >=3.13
 Requires-Dist: babel>=2.17
 Requires-Dist: matplotlib>=3.10

{tesorotools_python-0.0.39 → tesorotools_python-0.0.40}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "tesorotools-python"
 requires-python = ">=3.13"
-version = "0.0.39"
+version = "0.0.40"
 dependencies = [
     # database and ORM
     "psycopg[binary]>=3.1",

{tesorotools_python-0.0.39 → tesorotools_python-0.0.40}/src/tesorotools/render/content/table.py

@@ -15,6 +15,7 @@ from docx.oxml.ns import nsdecls, qn
 from docx.shared import Inches, Pt, RGBColor
 from docx.table import Table as TableDocx
 from docx.table import _Cell as TableCell
+from docx.table import _Row as TableRow
 from yaml import MappingNode
 
 from tesorotools.utils.config import read_config
@@ -49,46 +50,6 @@ TEXTO_TABLAS: int = 9
 CENTER = WD_ALIGN_PARAGRAPH.CENTER
 
 
-def _set_cell_border(cell: TableCell, **kwargs: Any) -> None:
-    """
-    Set cell`s border
-    Usage:
-
-    set_cell_border(
-        cell,
-        top={"sz": 12, "val": "single", "color": "#FF0000", "space": "0"},
-        bottom={"sz": 12, "color": "#00FF00", "val": "single"},
-        start={"sz": 24, "val": "dashed", "shadow": "true"},
-        end={"sz": 12, "val": "dashed"},
-    )
-    """
-    tc = cell._tc
-    tcPr = tc.get_or_add_tcPr()
-
-    # check for tag existence, if none found, create one
-    tcBorders: Any = tcPr.first_child_found_in("w:tcBorders")  # type: ignore[reportUnknownMemberType]
-    if tcBorders is None:
-        tcBorders = OxmlElement("w:tcBorders")  # type: ignore[reportUnknownVariableType]
-        tcPr.append(tcBorders)  # type: ignore[reportUnknownMemberType]
-
-    # list over all available tags
-    for edge in ("start", "top", "end", "bottom", "insideH", "insideV"):
-        edge_data: Any = kwargs.get(edge)
-        if edge_data:
-            tag = "w:{}".format(edge)
-
-            # check for tag existence, if none found, then create one
-            element: Any = tcBorders.find(qn(tag))  # type: ignore[reportUnknownMemberType]
-            if element is None:
-                element = OxmlElement(tag)  # type: ignore[reportUnknownVariableType]
-                tcBorders.append(element)  # type: ignore[reportUnknownMemberType]
-
-            # looks like order of attributes is important
-            for key in ["sz", "val", "color", "space", "shadow"]:
-                if key in edge_data:
-                    element.set(qn("w:{}".format(key)), str(edge_data[key]))  # type: ignore[reportUnknownMemberType]
-
-
 def _style_horizontal_blocks_header(cell: TableCell) -> None:
     cell.paragraphs[0].alignment = WD_ALIGN_PARAGRAPH.CENTER
     cell.paragraphs[0].runs[0].font.size = Pt(12)
@@ -192,25 +153,47 @@ def _separate_blocks(
             "got a flat Index. Set block_sep=False or wrap rows in a "
             "MultiIndex with the block name as level 0."
         )
+    _disable_implicit_last_row(table_docx)
     blocks: list[str] = list(index.get_level_values(level=0).unique())
     previous_rows: int = 0
     for block in blocks[:-1]:
         block_size: int = len(index[index.get_level_values(level=0) == block])
-        for cell in table_docx.rows[block_size + previous_rows].cells:
-            _separate_cell(cell)
+        _separate_row(table_docx.rows[block_size + previous_rows])
         previous_rows += block_size
 
 
-def _separate_cell(cell: TableCell) -> None:
-    _set_cell_border(
-        cell,
-        bottom={
-            "sz": 1,
-            "val": "double",
-            "color": "#000000",
-            "space": 2,
-        },
-    )
+def _separate_row(row: TableRow) -> None:
+    """Mark *row* as ``lastRow`` via conditional-formatting reference.
+
+    The visible separator border belongs to the active table style
+    (``<w:tblStylePr w:type="lastRow">`` in ``styles.xml``). Emitting
+    only ``<w:cnfStyle>`` on ``<w:trPr>`` keeps direct formatting out of
+    ``<w:tcPr>``, which is the construct Word's co-authoring merge
+    engine corrupts in shared OneDrive/SharePoint documents. The
+    consumer's ``template.docx`` must define the ``lastRow`` conditional
+    formatting on the table style referenced by ``plots.yaml``.
+    """
+    trPr: Any = row._tr.get_or_add_trPr()  # type: ignore[reportUnknownMemberType]
+    cnfStyle: Any = OxmlElement("w:cnfStyle")  # type: ignore[reportUnknownVariableType]
+    # 12-bit mask, ECMA-376 §17.4.7. Bit 1 (zero-indexed) = lastRow.
+    cnfStyle.set(qn("w:val"), "010000000000")  # type: ignore[reportUnknownMemberType]
+    trPr.append(cnfStyle)  # type: ignore[reportUnknownMemberType]
+
+
+def _disable_implicit_last_row(table_docx: TableDocx) -> None:
+    """Force ``<w:tblLook w:lastRow="0"/>`` so the real last row stays plain.
+
+    With block_sep we mark *interior* rows as ``lastRow`` via
+    ``cnfStyle``. The table's own last row must not pick up the same
+    conditional formatting automatically, so we disable the implicit
+    ``lastRow`` flag at the ``<w:tblLook>`` level.
+    """
+    tblPr: Any = table_docx._element.tblPr  # type: ignore[reportUnknownMemberType]
+    tblLook: Any = tblPr.find(qn("w:tblLook"))  # type: ignore[reportUnknownMemberType]
+    if tblLook is None:
+        tblLook = OxmlElement("w:tblLook")  # type: ignore[reportUnknownVariableType]
+        tblPr.append(tblLook)  # type: ignore[reportUnknownMemberType]
+    tblLook.set(qn("w:lastRow"), "0")  # type: ignore[reportUnknownMemberType]
 
 
 def _is_bright(hex_color: str) -> bool: