athena-python-docx 0.36.0__tar.gz → 0.37.0__tar.gz

{athena_python_docx-0.36.0 → athena_python_docx-0.37.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: athena-python-docx
-Version: 0.36.0
+Version: 0.37.0
 Summary: Drop-in replacement for python-docx that connects to Athena's DOCX Studio collaborative document stack
 Project-URL: Homepage, https://athenaintelligence.ai
 Author-email: Athena Intelligence <engineering@athenaintelligence.ai>

{athena_python_docx-0.36.0 → athena_python_docx-0.37.0}/docx/__init__.py

@@ -6,7 +6,7 @@ See CLAUDE.md for the API parity contract.
 
 from __future__ import annotations
 
-__version__ = "0.36.0"
+__version__ = "0.37.0"
 
 from docx.api import Document
 from docx._buffer import discard_all, flush_all

{athena_python_docx-0.36.0 → athena_python_docx-0.37.0}/docx/commands.py

@@ -565,10 +565,17 @@ class SetSectionLinkToPrevious(Command):
 
 @dataclass
 class TablesInsertRow(Command):
+    """``grid_row`` is python-docx's ``Table.add_row()``: the row goes after
+    the table's last one, with a cell for each grid column as wide as the
+    column, holding one empty paragraph, and nothing of the rows above.
+    Without it, the row is Word's Insert Row next to ``row_index``. A
+    docx-studio that predates the field ignores it."""
+
     node_id: str
     row_index: int
     position: str  # "above" | "below"
     count: int = 1
+    grid_row: bool | None = None
 
 
 @dataclass

{athena_python_docx-0.36.0 → athena_python_docx-0.37.0}/docx/table.py

@@ -1053,6 +1053,11 @@ class Table:
         }
         if source_index is not None:
             params["copyFormatFrom"] = source_index
+        else:
+            # python-docx's row: a cell for each grid column, as wide as the
+            # column, and nothing of the last row (its height, grid skips,
+            # header flag or cell formatting).
+            params["gridRow"] = True
         run_sync(self._session.doc.tables.insert_row(params))
         # Keep the bounds-check cache current so the next ``cell()``
         # access still hits the fast path.

{athena_python_docx-0.36.0 → athena_python_docx-0.37.0}/docx/text/run.py

@@ -1063,11 +1063,14 @@ class Run:
         # server keeps its own properties (``w:bCs``, an off toggle) for the
         # new text, as python-docx keeps the run's ``w:rPr``. A docx-studio
         # from before the field ignores it.
-        run_sync(
-            self._session.doc.replace(
-                {"target": self._text_range, "text": value, "wholeRun": True},
-            ),
-        )
+        command: dict = {"target": self._text_range, "text": value, "wholeRun": True}
+        later = later_runs_at_end(self)
+        if later and server_takes(self._session, "runIdentity"):
+            # A run after this one ends where it does (an empty run, a text
+            # box's or a SmartArt drawing's): docx-studio tells this run's
+            # record from its by the run's identity, and keeps both.
+            command["run"] = {"laterRuns": later}
+        run_sync(self._session.doc.replace(command))
         if not tracked:
             new_end: int = self._range[0] + len(value)
             self._range = (self._range[0], new_end)

{athena_python_docx-0.36.0 → athena_python_docx-0.37.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "athena-python-docx"
-version = "0.36.0"
+version = "0.37.0"
 description = "Drop-in replacement for python-docx that connects to Athena's DOCX Studio collaborative document stack"
 readme = "README.md"
 license = "MIT"

{athena_python_docx-0.36.0 → athena_python_docx-0.37.0}/tests/test_run_later_runs.py

@@ -578,3 +578,35 @@ def test_a_column_break_a_room_keeps_as_a_block_leaves_the_run_apart(mock_sessio
 
     assert _sent(fake_sd_methods, "format.apply") == []
     assert r._pending_inline == {"bold": True}
+
+
+@pytest.mark.parametrize(("capabilities", "named"), [(CAPABILITIES, {"laterRuns": 1}), (OLDER, None)])
+def test_a_runs_text_written_before_a_later_empty_run_names_the_run(
+    mock_session: Any, fake_sd_methods: Any, capabilities: dict[str, Any], named: dict[str, Any] | None
+) -> None:
+    # a = p.add_run('Left'); p.add_run(); a.text = 'Changed': the empty run ends where 'Left' does, as a
+    # text box's anchor run does, and docx-studio keeps its record only for an SDK that names 'Left'.
+    fake_sd_methods.scripted_returns["info"] = {"capabilities": capabilities}
+    p = _paragraph(mock_session)
+    a = p.add_run("Left")
+    p.add_run()
+    fake_sd_methods.calls.clear()
+    a.text = "Changed"
+
+    [sent] = _sent(fake_sd_methods, "replace")
+    assert sent.get("run") == named
+    assert sent["wholeRun"] is True
+
+
+def test_a_runs_text_written_with_no_later_run_at_its_end_sends_no_identity(
+    mock_session: Any, fake_sd_methods: Any
+) -> None:
+    fake_sd_methods.scripted_returns["info"] = {"capabilities": CAPABILITIES}
+    p = _paragraph(mock_session)
+    a = p.add_run("Left")
+    p.add_run("Right")
+    fake_sd_methods.calls.clear()
+    a.text = "Changed"
+
+    [sent] = _sent(fake_sd_methods, "replace")
+    assert "run" not in sent

athena_python_docx-0.37.0/tests/test_table_add_row_grid_row.py

@@ -0,0 +1,36 @@
+"""``Table.add_row()`` asks docx-studio for python-docx's row (``gridRow``):
+a ``w:tr`` after the table's last row with a ``w:tc`` for each grid column, as
+wide as the column, and nothing of the last row: python-docx 1.2.0's
+``add_row`` builds it from ``tblGrid`` alone. Without it, the row was Word's
+Insert Row below the last one, which keeps that row's grid skips
+(``w:gridAfter``), height and cell formatting.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from docx.commands import TablesInsertRow
+from docx.table import Table
+
+
+def test_add_row_sends_python_docx_row_after_the_last_row(
+    mock_session: Any, fake_sd_methods: Any
+) -> None:
+    table = Table(session=mock_session, node_id="t:0")
+
+    row = table.add_row()
+
+    inserts = [params for op, params in fake_sd_methods.calls if op == "tables.insert_row"]
+    assert inserts == [
+        {"nodeId": "t:0", "rowIndex": 1, "position": "below", "count": 1, "gridRow": True}
+    ]
+    assert row._index == 2
+
+
+def test_grid_row_goes_on_the_wire_only_when_set() -> None:
+    plain = TablesInsertRow(node_id="t:0", row_index=1, position="below")
+    grid = TablesInsertRow(node_id="t:0", row_index=1, position="below", grid_row=True)
+
+    assert "gridRow" not in plain.to_dict()
+    assert grid.to_dict()["gridRow"] is True

{athena_python_docx-0.36.0 → athena_python_docx-0.37.0}/uv.lock

@@ -8,7 +8,7 @@ resolution-markers = [
 
 [[package]]
 name = "athena-python-docx"
-version = "0.36.0"
+version = "0.37.0"
 source = { editable = "." }
 dependencies = [
     { name = "athena-references" },