athena-python-pptx 0.1.75__tar.gz → 0.1.76__tar.gz

{athena_python_pptx-0.1.75 → athena_python_pptx-0.1.76}/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to `athena-python-pptx` are documented in this file.
 
+## 0.1.76
+
+**Table cell paragraph alignment now round-trips to OOXML (baseline-parity Gap A2).**
+
+`cell.text_frame.paragraphs[0].alignment = PP_ALIGN.X` previously stored
+the value locally for python-pptx parity but never reached the server.
+The setter now translates `PP_PARAGRAPH_ALIGNMENT` enum members (and the
+python-pptx lowercase string aliases) to the OOXML short form
+(`l` / `ctr` / `r` / `just` / `dist` / `thaiDist` / `justLow`) and emits
+a `SetTableCell` command carrying `paragraphAlignment`. The applier
+writes it to every paragraph in the cell's text body; the export worker
+emits a `SetTableCellText` intent whose paragraph alignment lands on
+`<a:pPr algn="…">` in the exported PPTX.
+
+Closes ~52 baseline-parity XML diffs against the 33 fixtures in
+`pptx-studio/tests/baseline-parity/`.
+
 ## 0.1.75
 
 **Critical bug fix — invisible text from `font.size = Pt(X)`.**

{athena_python_pptx-0.1.75 → athena_python_pptx-0.1.76}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: athena-python-pptx
-Version: 0.1.75
+Version: 0.1.76
 Summary: Drop-in replacement for python-pptx that connects to PPTX Studio for real-time collaboration
 Project-URL: Homepage, https://github.com/pptx-studio/python-sdk
 Project-URL: Documentation, https://docs.pptx-studio.com/sdk/python

{athena_python_pptx-0.1.75 → athena_python_pptx-0.1.76}/pptx/__init__.py

@@ -127,7 +127,7 @@ def flush_all() -> None:
     _active_buffers[:] = alive
 
 
-__version__ = "0.1.75"
+__version__ = "0.1.76"
 
 __all__ = [
     # Main entry point

{athena_python_pptx-0.1.75 → athena_python_pptx-0.1.76}/pptx/commands.py

@@ -476,6 +476,12 @@ class SetTableCell(Command):
         col: Column index (0-based)
         text: Cell text content
         fill_color_hex: Cell background color
+        paragraph_alignment: Horizontal alignment of the cell's text body.
+            Mirrors python-pptx ``cell.text_frame.paragraphs[0].alignment``.
+            Accepts the OOXML short forms ``l``, ``ctr``, ``r``, ``just``,
+            ``dist``, ``thaiDist``. Translated from ``PP_ALIGN`` /
+            ``PP_PARAGRAPH_ALIGNMENT`` by the SDK before emit. Closes
+            baseline-parity Gap A2 (~52 diffs across table fixtures).
     """
 
     shape_id: ShapeId
@@ -486,6 +492,7 @@ class SetTableCell(Command):
     font_size_centipoints: Optional[int] = None
     bold: Optional[bool] = None
     font_color_hex: Optional[str] = None
+    paragraph_alignment: Optional[str] = None
 
     @property
     def command_type(self) -> str:

{athena_python_pptx-0.1.75 → athena_python_pptx-0.1.76}/pptx/shapes/__init__.py

@@ -56,6 +56,57 @@ _ELEMENT_TYPE_TO_MSO_SHAPE_TYPE: dict[str, MSO_SHAPE_TYPE] = {
 }
 
 
+# Map PP_PARAGRAPH_ALIGNMENT enum members and python-pptx string aliases
+# to OOXML <a:pPr algn="..."> short forms. Accepts the IntEnum int values
+# directly so callers can pass ``PP_ALIGN.CENTER`` without importing the
+# enum class. ``None`` clears the attribute.
+_PP_ALIGN_INT_TO_OOXML: dict[int, str] = {
+    1: "l",
+    2: "ctr",
+    3: "r",
+    4: "just",
+    5: "dist",
+    6: "thaiDist",
+    7: "justLow",
+}
+_PP_ALIGN_NAME_TO_OOXML: dict[str, str] = {
+    "left": "l",
+    "center": "ctr",
+    "right": "r",
+    "justify": "just",
+    "distribute": "dist",
+    "thai_distribute": "thaiDist",
+    "justify_low": "justLow",
+    # Already-short forms pass through.
+    "l": "l", "ctr": "ctr", "r": "r",
+    "just": "just", "dist": "dist", "thaiDist": "thaiDist", "justLow": "justLow",
+}
+
+
+def _normalize_pp_align(value: Any) -> Optional[str]:
+    """Translate a PP_ALIGN value to the OOXML short form used by SetTableCell.
+
+    Accepts ``PP_PARAGRAPH_ALIGNMENT`` (or any ``int``) and the lowercased
+    python-pptx string aliases used by ``pptx.text.PP_ALIGN``. Returns
+    ``None`` for ``None`` input so the setter can clear the attribute.
+    """
+    if value is None:
+        return None
+    if isinstance(value, int) and not isinstance(value, bool):
+        try:
+            return _PP_ALIGN_INT_TO_OOXML[int(value)]
+        except KeyError:
+            raise ValueError(f"Unsupported paragraph alignment value: {value!r}")
+    if isinstance(value, str):
+        try:
+            return _PP_ALIGN_NAME_TO_OOXML[value]
+        except KeyError:
+            raise ValueError(f"Unsupported paragraph alignment value: {value!r}")
+    raise TypeError(
+        f"alignment must be a PP_ALIGN enum, int, or string; got {type(value).__name__}"
+    )
+
+
 # Map XL_CHART_TYPE → (server chart_type, grouping). Only the chart types
 # author.ts supports today are listed here; anything else raises
 # UnsupportedFeatureError. Surface area mirrors python-pptx's accepted enum
@@ -5814,15 +5865,13 @@ class _TableCellParagraph:
     For API parity with python-pptx, ``add_run()`` and ``clear()`` are
     supported but operate on the single underlying run — multiple
     ``add_run()`` calls return the *same* ``_TableCellRun`` object, and
-    only the last text/style assignment wins. ``alignment`` is accepted
-    for compatibility but doesn't yet round-trip to OOXML (no per-cell
-    paragraph-alignment command on the applier).
+    only the last text/style assignment wins. ``alignment`` round-trips
+    to ``<a:pPr algn="...">`` on the cell's text body via SetTableCell.
     """
 
     def __init__(self, cell: "TableCell"):
         self._cell = cell
         self._runs = [_TableCellRun(cell)]
-        self._alignment: Optional[Any] = None
 
     @property
     def runs(self) -> list[_TableCellRun]:
@@ -5838,12 +5887,22 @@ class _TableCellParagraph:
 
     @property
     def alignment(self) -> Optional[Any]:
-        return self._alignment
+        """Return the cell's paragraph alignment as the original input value.
+
+        Stored on the parent cell so that text-body re-creation (which
+        rebuilds the paragraph wrapper) doesn't lose the assignment.
+        """
+        return self._cell._paragraph_alignment_input
 
     @alignment.setter
     def alignment(self, value: Any) -> None:
-        # Accepted for python-pptx parity; not yet round-tripped to OOXML.
-        self._alignment = value
+        # Translate PP_ALIGN enum / string to OOXML short form. Stored on
+        # the cell so we can re-emit it inside SetTableCell. Keep the
+        # original input around for the getter to return per python-pptx
+        # semantics (callers expect the same value type back).
+        self._cell._paragraph_alignment_input = value
+        self._cell._paragraph_alignment = _normalize_pp_align(value)
+        self._cell._emit_cell_change()
 
     def add_run(self) -> _TableCellRun:
         """Return the single underlying run.
@@ -5943,6 +6002,10 @@ class TableCell:
         self._margin_top = margin_top
         self._margin_bottom = margin_bottom
         self._vertical_anchor = vertical_anchor
+        # OOXML short form (``l``/``ctr``/``r``/...) sent over the wire and
+        # the caller's original input retained for the python-pptx getter.
+        self._paragraph_alignment: Optional[str] = None
+        self._paragraph_alignment_input: Any = None
 
     @property
     def text(self) -> str:
@@ -6318,6 +6381,7 @@ class TableCell:
                 font_size_centipoints=int(self._font_size_pt * 100) if self._font_size_pt is not None else None,
                 bold=self._bold,
                 font_color_hex=self._font_color_hex,
+                paragraph_alignment=self._paragraph_alignment,
             )
             self._table._buffer.add(cmd)
 

{athena_python_pptx-0.1.75 → athena_python_pptx-0.1.76}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "athena-python-pptx"
-version = "0.1.75"
+version = "0.1.76"
 description = "Drop-in replacement for python-pptx that connects to PPTX Studio for real-time collaboration"
 readme = "README.md"
 license = "MIT"