athena-python-pptx 0.14.2__tar.gz → 0.14.3__tar.gz

{athena_python_pptx-0.14.2 → athena_python_pptx-0.14.3}/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to `athena-python-pptx` are documented in this file.
 
+## 0.14.3 — waterfall `connector_lines`
+
+- New Athena extension `chart.plots[0].connector_lines = False` on a
+  `WaterfallPlot` hides the lines joining each bar to the next (Excel's
+  "Show connector lines"; `True` by default). Emits a
+  `SetWaterfallConnectorLines` chart patch; an SDK-authored waterfall then
+  exports one category per bar with its `gap_width`, and an uploaded Office
+  2016 waterfall writes `connectorLines` into its own part. Reads back from
+  either.
+- Studio-side (no SDK change, any SDK version): SDK-authored bar / column
+  series export `<c:invertIfNegative val="0"/>` by default, so negative bars
+  keep the series colour instead of rendering white in PowerPoint; an explicit
+  `series.invert_if_negative = True` still wins. `chart.replace_data()` on an
+  uploaded bar chart rebuilds its series the same way.
+
 ## 0.14.2 — `chart.value_axis` / `chart.category_axis` edit the axis python-pptx returns
 
 Axis edits (`axis_title`, `visible`, `minimum_scale` / `maximum_scale` /

{athena_python_pptx-0.14.2 → athena_python_pptx-0.14.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: athena-python-pptx
-Version: 0.14.2
+Version: 0.14.3
 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.14.2 → athena_python_pptx-0.14.3}/docs/API_PARITY_EXCEPTIONS.md

@@ -1443,6 +1443,7 @@ cd.categories = ["FY24", "Price", "Volume", "FX", "FY25"]
 cd.add_series("EBIT", (120, 18, -9, -4, None))   # one series of deltas
 chart = slide.shapes.add_chart(XL_CHART_TYPE.WATERFALL, x, y, cx, cy, cd).chart
 chart.plots[0].subtotals = [0, 4]                # Athena extension
+chart.plots[0].connector_lines = False           # Athena extension (default True)
 ```
 
 | Surface | Kind | Wire |
@@ -1450,6 +1451,7 @@ chart.plots[0].subtotals = [0, 4]                # Athena extension
 | `chart.plots[0]` on a waterfall | `WaterfallPlot` (a `BarPlot`: `data_labels`, `has_data_labels` work; `gap_width` is kept but not drawn, see below) | — |
 | `WaterfallPlot.subtotals` (get / set) | Athena extension | `SetWaterfallSubtotals` chart patch |
 | `WaterfallPlot.set_subtotals(indices)` | Athena extension (same as the setter) | `SetWaterfallSubtotals` |
+| `WaterfallPlot.connector_lines` (get / set, `bool`) | Athena extension | `SetWaterfallConnectorLines` chart patch |
 | `chart.chart_type` | reads back `XL_CHART_TYPE.WATERFALL` | — |
 
 Semantics follow Excel's "Set as total": a subtotal point is drawn from zero
@@ -1493,6 +1495,13 @@ as on and paint the parts below zero white. Keynote ignores deleted legend
 entries and point labels, so its legend also lists the base and connector
 series, and a bar split at zero shows a label on each part.
 
+Connector lines are on unless `chart.plots[0].connector_lines = False`
+(Excel's "Show connector lines"; python-pptx has no waterfall type, so this
+is an Athena extension like `subtotals`). Off, an SDK-authored waterfall
+exports without the "Connector" series and its blank-labelled categories:
+one category per bar, and `gap_width` is drawn. The setting survives
+`chart.replace_data(...)`, and a reopened deck reads it back.
+
 What that construction cannot carry, the studio does not draw either, so the
 preview matches the deck: labels centred in the bars (a stacked chart has no
 outside-end position), and no label on a floating bar that crosses zero. With
@@ -1503,8 +1512,10 @@ waterfall type.
 **Waterfalls in uploaded decks.** A waterfall PowerPoint 2016+ saved (an
 Office-2016 chartEx part) is a `WaterfallPlot` with its `subtotals` too. It
 exports as its original part: `chart.replace_data(...)` (one series), point
-values, category labels, the series name, `subtotals` and the chart title are
-written back into that part and its embedded workbook. Its type, legend, data
+values, category labels, the series name, `subtotals`, `connector_lines`
+(`cx:visibility/@connectorLines`; a part that never set it reads `True`) and
+the chart title are written back into that part and its embedded workbook. Its
+type, legend, data
 labels, colours, axes and other formatting keep the uploaded design: a write to
 them fails the command with an error naming the edit, rather than being
 accepted and lost on export. The other chartEx charts (treemap, sunburst,
@@ -2563,6 +2574,7 @@ python-pptx. Generated from `pptx._athena_extension.iter_athena_extensions()`.
 | `pptx.shapes.Table.delete_column` | method | 0.1.81 | python-pptx#895 | Table.delete_column — alias for remove_column. |
 | `pptx.shapes.Table.delete_row` | method | 0.1.81 | python-pptx#837 | Table.delete_row — alias for remove_row, the verb used in python-pptx#837. |
 | `pptx.shapes.Table.remove_column` | method | 0.1.81 | python-pptx#895 | Table.remove_column — column-axis counterpart to remove_row. |
+| `pptx.shapes.WaterfallPlot.connector_lines` | property | 0.14.3 | Athena-Intel/demo-app-monorepo#37496 | WaterfallPlot.connector_lines — whether lines join each bar to the next. |
 | `pptx.shapes.WaterfallPlot.set_subtotals` | method | 0.14.0 | python-pptx#651 | WaterfallPlot.set_subtotals — mark the total points of a waterfall. |
 | `pptx.shapes.WaterfallPlot.subtotals` | property | 0.14.0 | python-pptx#651 | WaterfallPlot.subtotals — point indices drawn from zero as totals. |
 | `pptx.shapes._ChartTitle.height` | property | 0.1.81 | python-pptx#1030 | ChartTitle.height — fractional height of the title layout box. |

{athena_python_pptx-0.14.2 → athena_python_pptx-0.14.3}/pptx/__init__.py

@@ -326,7 +326,7 @@ def validate_all_touched() -> dict[int, list[str]]:
     return results
 
 
-__version__ = "0.14.2"
+__version__ = "0.14.3"
 
 __all__ = [
     # Main entry point

{athena_python_pptx-0.14.2 → athena_python_pptx-0.14.3}/pptx/shapes/__init__.py

@@ -3296,8 +3296,9 @@ class WaterfallPlot(BarPlot):
     python-pptx has no waterfall; this plot is an Athena extension. The
     series carries the deltas, and :attr:`subtotals` marks the points drawn
     from zero as totals (Excel's "Set as total"). A total whose value is
-    ``None`` shows the running total. ``gap_width`` and ``data_labels`` work
-    as on a bar plot.
+    ``None`` shows the running total. :attr:`connector_lines` shows or hides
+    the lines joining each bar to the next (Excel's "Show connector lines",
+    on by default). ``gap_width`` and ``data_labels`` work as on a bar plot.
     """
 
     @property
@@ -3344,6 +3345,37 @@ class WaterfallPlot(BarPlot):
             "subtotalIndices": values,
         }])
 
+    @property
+    @athena_extension(
+        issue="Athena-Intel/demo-app-monorepo#37496",
+        since="0.14.3",
+        description="WaterfallPlot.connector_lines — whether lines join each bar to the next.",
+    )
+    def connector_lines(self) -> bool:
+        """Whether connector lines join each bar's end to the next bar.
+
+        ``True`` unless turned off (Excel's default), including for an
+        uploaded Office 2016 waterfall that never set it.
+        """
+        waterfall = self._data.get("waterfall") or {}
+        return waterfall.get("connectorLines") is not False
+
+    @connector_lines.setter
+    @athena_extension(issue="Athena-Intel/demo-app-monorepo#37496", since="0.14.3", description="WaterfallPlot.connector_lines setter.")
+    def connector_lines(self, value: bool) -> None:
+        """Show (``True``) or hide (``False``) the connector lines.
+
+        Emits a ``SetWaterfallConnectorLines`` chart patch.
+        """
+        shown = bool(value)
+        self._data["waterfall"] = {**(self._data.get("waterfall") or {}), "connectorLines": shown}
+        _emit_chart_patches(self._chart._shape, [{
+            "op": "SetWaterfallConnectorLines",
+            "chartId": self._chart._shape.shape_id,
+            "plotId": self._plot_id,
+            "connectorLines": shown,
+        }])
+
 
 def _plot_class_for_type(chart_type: Optional[str]) -> type:
     """Pick the right :class:`_ChartPlot` subclass for a chart type.

{athena_python_pptx-0.14.2 → athena_python_pptx-0.14.3}/pyproject.toml

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