athena-python-pptx 0.1.59__tar.gz → 0.1.63__tar.gz

athena_python_pptx-0.1.63/CHANGELOG.md

@@ -0,0 +1,194 @@
+# Changelog
+
+All notable changes to `athena-python-pptx` are documented in this file.
+
+## 0.1.63
+
+Theme-hierarchy parity round (originally targeted 0.1.62, but PyPI's 0.1.62
+was claimed by an unrelated upload on 2026-05-06 — bumped to 0.1.63 to keep
+the SDK and PyPI sequence in step). — closes the remaining python-pptx surface gaps
+on `Presentation`, `SlideMaster`, `SlideLayout`, `Slides`, and `SlideShapes`
+that the parity test was allow-listing as KNOWN_MISSING.
+
+- **`Presentation.slide_master`** — shorthand for `slide_masters[0]`. Matches
+  python-pptx where most single-master decks reach for the canonical master
+  via this attribute. Raises `IndexError` if the snapshot has no masters.
+- **`SlideMaster.shapes`** / **`SlideMaster.placeholders`** — return empty
+  read-only collections instead of raising `AttributeError`. The REST snapshot
+  doesn't materialize master-level shapes as first-class elements (they are
+  projected onto each slide during ingestion), but code that probes these
+  collections for parity now gets a sensible empty result.
+- **`SlideLayout.shapes`** — same treatment as the master-level collection.
+- **`SlideLayout.slide_master`** — backreference to the parent
+  `SlideMaster`. `_build_slide_masters` now threads the master onto each
+  child layout when constructing the theme hierarchy, and the backreference
+  is `None` only on the legacy hardcoded fallback layouts (used when no
+  snapshot is available).
+- **`Slides.get(slide_id, default=None)`** — matches python-pptx's
+  dict-style lookup. Same backing store as `Slides.get_by_id`, with the
+  added optional default-return semantics.
+- **`SlideShapes.add_group_shape(shapes=())`** — alias that materializes any
+  iterable to a list and forwards to `group_shapes(...)`. Consistent with
+  python-pptx's signature; the SDK still requires at least 2 shapes per
+  group (one `GroupShapes` command per call).
+- **Parity test cleanup** — `tests/test_python_pptx_api_parity.py` no longer
+  allow-lists the items above under `KNOWN_MISSING`. Type mismatches for the
+  new `@property` accessors are documented in `KNOWN_TYPE_MISMATCHES`
+  (functionally identical to python-pptx's `lazyproperty`).
+
+## 0.1.61
+
+Parity round: structural module shims + python-pptx-aligned signatures.
+
+- **Module shims** so user code written against python-pptx imports unchanged:
+  `pptx.slide` (Slide / Slides / SlideLayout / SlideMaster / SlideMasters /
+  SlideBackground / SlideLayouts), `pptx.table` (Table / `_Cell`), and
+  `pptx.action` (Hyperlink, ActionSetting placeholder).
+- **`Presentation.save(file=...)`** — renamed kwarg from `path=` to match
+  python-pptx exactly. Positional callers (`prs.save("out.pptx")`) keep
+  working; keyword callers using `path=` must update.
+- **`Slides.add_slide(slide_layout=...)`** — renamed kwarg from `layout=` to
+  match python-pptx. `add_blank_slide()` updated internally.
+- **`Table.cell(row_idx, col_idx)`** and the `GraphicFrame.cell` shortcut —
+  renamed parameters from `(row, col)` to match python-pptx.
+- **`SlideShapes.add_chart(x, y, cx, cy, ...)`** — renamed positional
+  parameters from `(left, top, width, height)` to match python-pptx (EMU
+  semantics unchanged).
+- **`pptx.SlideMaster`** — added top-level export (was only available via
+  `pptx.slides.SlideMaster` previously).
+- **Parity test coverage doubled** — `tests/test_python_pptx_api_parity.py`
+  now compares 17 user-facing classes against stock python-pptx, up from 8.
+  Newly covered: Presentation, Slide, Slides, SlideLayout, SlideMaster,
+  SlideShapes, Table, `_Cell`. All deviations documented as either
+  REST-internal omissions (`element` / `part`) or SDK-extension extras.
+
+## 0.1.60
+
+Round 5 fidelity push — close diffs the parity harness surfaces against
+`lowes_template_v1.pptx` for `add_shape` / `add_textbox` / `add_picture` /
+`add_connector` / `add_table`. End-to-end: SDK → command → applier → Y.Doc →
+export-worker → OOXML.
+
+- **python-pptx-style auto-naming for new shapes:**
+  `slide.shapes.add_shape(MSO_SHAPE.OVAL, …)` now writes
+  `<p:cNvPr name="Oval 2"/>` instead of `name="Shape qR6BLH"`. Mirrors
+  python-pptx's deterministic `"<basename> <count_after_add>"` contract so
+  AI agents can find shapes by predictable names. Same scheme for
+  `add_textbox` (`"TextBox 2"`), `add_picture` (`"Picture 2"`),
+  `add_table` (`"Table 2"`), and `add_connector`
+  (`"Straight Connector 5"` / `"Elbow Connector …"` / `"Curved Connector …"`).
+  New `MSO_SHAPE → basename` map covers all 156 standard auto-shape
+  display names (`"Right Triangle"`, `"Rounded Rectangle"`,
+  `"Left-Right Arrow"`, etc.). `name` field added to `AddShape` /
+  `AddTextBox` / `AddPicture` / `AddConnector` / `AddTable` commands and
+  schemas; the applier stores it on the Y.Doc element and the
+  export-worker plumbs it through `CreateElement.shapeName`.
+- **Default `<p:txBody>` on `add_shape`:** SDK auto-shapes without text
+  now emit python-pptx's standard placeholder body
+  (`<a:bodyPr rtlCol="0" anchor="ctr"/><a:lstStyle/><a:p><a:pPr algn="ctr"/></a:p>`)
+  so PowerPoint's "click to type text" affordance survives an export.
+  Previously athena dropped `<p:txBody>` entirely when no text was set,
+  which made downstream PowerPoint editing harder.
+- **Default `<a:bodyPr>` on `add_textbox`:** new SDK textboxes now write
+  `<a:bodyPr wrap="none"><a:spAutoFit/></a:bodyPr>` (python-pptx's
+  default — auto-shrink to text). Previously athena wrote `wrap="square"`
+  which kept the box at its declared size and wrapped instead. Override
+  via `text_frame.word_wrap = True` to restore square-wrap behaviour.
+
+## 0.1.59
+
+Multi-round fidelity push (PR #19786). All items below are end-to-end:
+SDK setter → command → applier → Y.Doc → export-worker → OOXML.
+
+- **Picture crop end-to-end (`Shape.crop_left/top/right/bottom`):**
+  exported `<p:pic>` now emits `<a:srcRect l/t/r/b="..."/>` inside
+  `<a:blipFill>` for both `slide.shapes.add_picture(...)` and
+  `placeholder.insert_picture(...)`. Crop fractions clamp to [0,1]
+  and convert to OOXML's 1000ths-of-percent.
+- **Server-side `<c:title>` for SDK-authored charts (Gap 16
+  follow-up):** `chart.has_title = True; chart.chart_title.text_frame.text = '...'`
+  on a freshly-added chart now lands in the rendered chart XML. New
+  helper folds queued `ChartPatch` ops into the `ChartSpec` before
+  authoring (handles `SetChartTitle`, `SetLegendVisible`,
+  `UpdateSeriesValue/Name`, `UpdateCategoryLabel`, `SetSeriesColor`).
+- **Scatter / bubble `replace_data` (Gap 18 follow-up):**
+  `chart.replace_data(XyChartData)` and `chart.replace_data(BubbleChartData)`
+  now mutate the rendered chart's `<c:xVal>` / `<c:yVal>` /
+  `<c:bubbleSize>` via two new patch ops (`UpdateSeriesXValue`,
+  `UpdateBubbleSize`).
+- **Run strike + sub/superscript export:** `Run.font.strike = True`,
+  `Run.font.subscript = True`, `Run.font.superscript = True` now emit
+  `<a:rPr strike="sngStrike"/>` and `<a:rPr baseline="-25000|30000"/>`
+  on both SDK-authored runs and `SetTextRunStyle` patches. Schema also
+  accepts a raw `baseline: int|null` override.
+- **Connector elementType end-to-end:**
+  `slide.shapes.add_connector(MSO_CONNECTOR.STRAIGHT, ...)` now
+  renders on export as `<p:cxnSp prst="..."/>` with
+  `<a:headEnd>/<a:tailEnd>` arrow attributes when set. Previously
+  `add_connector` was silently dropped at export time.
+- **`add_slide(layout)` routes via snapshot-resolved `layoutPath`:**
+  closes the SDK→server layout-index mismatch that broke
+  `placeholder.insert_picture()` on Picture-with-Caption slides. The
+  SDK's `slide_layouts` ordering comes from the master's
+  `<p:sldLayoutIdLst>`, which generally does NOT match the
+  `slideLayout{i+1}.xml` filename numbering the server fell back to.
+  `add_slide` now forwards `layout._path` (and `layout.name` as
+  fallback); the applier prefers `layoutPath > layoutName > layoutIndex`.
+- **Theme/scheme color support for shape fill + line:**
+  `shape.fill.fore_color.theme_color = MSO_THEME_COLOR.ACCENT_1` and
+  `shape.line.color.theme_color = MSO_THEME_COLOR.HYPERLINK` round-trip
+  end-to-end as `<a:solidFill><a:schemeClr val="accent1"/></a:solidFill>`
+  in the exported OOXML. AI-driven brand templates can now keep
+  customers' theme colors instead of hard-coding sRGB. New
+  `SetShapeStyle` fields `fill_scheme_color` / `line_scheme_color`;
+  setting one clears the corresponding sRGB so each `<a:solidFill>`
+  slot has a single declaration.
+- **`Picture.crop_*` on `SubstitutePlaceholder(picture)`:** crop
+  fields now flow through the substitute-placeholder applier path so
+  cropped images filling layout placeholders honour the crop on
+  export.
+
+## 0.1.58
+
+- **Gap 18 (scatter / bubble chart authoring):** `slide.shapes.add_chart(XL_CHART_TYPE.XY_SCATTER, ..., XyChartData(...))` and `BUBBLE` with `BubbleChartData(...)` now author end-to-end. Server-side: chart-ooxml emits `<c:scatterChart>` / `<c:bubbleChart>` with `<c:xVal>` / `<c:yVal>` (and `<c:bubbleSize>` for bubble), pairs of value axes (no category axis), and an embedded workbook with x/y/(size) columns per series. SDK: `_split_chart_type` accepts all five `XY_SCATTER*` variants plus `BUBBLE`; `add_chart` and `insert_chart` validate the chart_data shape against the chart-type family. `replace_data` for XY/bubble is still gated (needs new patch ops; see GAP_REPORT.md Gap 18).
+- **Gap 9 (notesMaster export):** export-worker now bootstraps a `ppt/notesMasters/notesMaster1.xml` + companion `ppt/theme/themeN.xml` whenever speaker notes are added to a deck without a notesMaster. Generators are extracted into `apps/export-worker/src/notes-master.ts`. Bootstrap path also registers the `notesMaster` relationship in `presentation.xml.rels` and adds content-type overrides for the new parts. Matches python-pptx's behavior for the same flow.
+
+## 0.1.57
+
+- **Gap 13 (line.dash_style export):** SDK shapes / textboxes with `line.dash_style = MSO_LINE_DASH_STYLE.DASH` (or any preset) now emit `<a:prstDash val=...>` inside `<a:ln>` on export. Schema, ooxml-patch shape-creator, and export-worker plumbing all updated.
+- **Gap 14 (table column widths / row heights):** `table.columns[i].width` and `table.rows[i].height` on SDK-created tables now emit explicit `<a:gridCol w=...>` and `<a:tr h=...>` instead of dividing evenly.
+- **Gap 15 (cell.merge export):** `cell.merge(other)` on SDK-created tables now emits `gridSpan="..."` / `rowSpan="..."` on the merge origin and `hMerge="1"` / `vMerge="1"` on consumed cells.
+- **Gap 11 (run.hyperlink export):** `run.hyperlink.address = "https://..."` on SDK-created textboxes now writes `<a:hlinkClick r:id="rId..."/>` plus a corresponding External hyperlink relationship in the slide's `.rels`. Hyperlinked runs auto-underline to match python-pptx visual default.
+- **Gap 10 (group_shapes/.ungroup id mapping):** In immediate (non-batched) mode `slide.shapes.group_shapes(...)` now flushes the buffer and stamps the real server-assigned id onto the returned `Shape`, so `group.ungroup()` works in the same statement chain.
+- **Presentation.slide_width / slide_height setters:** `prs.slide_width = Inches(13.333)` and `prs.slide_height = Inches(7.5)` now work for python-pptx parity (route through `set_slide_size`).
+- **Font.strike / Font.subscript / Font.superscript:** new properties on `Run.font` for python-pptx parity. Persist via the existing run-style emission pipeline.
+- **Picture crop (`Shape.crop_top` / `crop_bottom` / `crop_left` / `crop_right`):** image shapes now expose python-pptx-compatible crop fractions (0.0–1.0). Setters emit a new `SetPictureCrop` command that writes to the Y.Doc element via `updateElementCrop`.
+- **Connector geometry (`Shape.begin_x` / `begin_y` / `end_x` / `end_y`):** connector shapes expose the python-pptx endpoint API. Setters update the bounding box + `flipH/flipV` accordingly.
+- **GroupShape.shapes children traversal:** for `is_group` shapes, `shape.shapes` returns the slide-level Shape objects whose ids match the group's `childIds`, mirroring `python-pptx GroupShape.shapes`.
+- New `SetPictureCrop` command on the SDK→server protocol; applier wired through `updateElementCrop`.
+
+## 0.1.56
+
+- **Charts: end-to-end author + edit support** for column / bar / line / area / pie / doughnut (including all stacked variants).
+  - `slide.shapes.add_chart(chart_type, left, top, width, height, chart_data)` now authors a fresh chart from scratch — previously raised `UnsupportedFeatureError`. Returns a `GraphicFrame` whose `.chart` property exposes the resulting `Chart` object. Supported types: `XL_CHART_TYPE.COLUMN_CLUSTERED`, `COLUMN_STACKED`, `COLUMN_STACKED_100`, `BAR_CLUSTERED`, `BAR_STACKED`, `BAR_STACKED_100`, `LINE`, `LINE_MARKERS`, `LINE_STACKED`, `LINE_STACKED_100`, `AREA`, `AREA_STACKED`, `AREA_STACKED_100`, `PIE`, `DOUGHNUT`. 3-D / scatter / bubble / radar / stock / surface / combo still raise `UnsupportedFeatureError` with a clearer message listing the supported set.
+  - `placeholder.insert_chart(chart_type, chart_data)` now wires up the same path — previously raised `NotImplementedError`.
+  - `Chart.replace_data(chart_data)` now emits `UpdateChartData` patches against an existing chart (ingested or just-authored) — previously raised `UnsupportedFeatureError`. Rewrites series values, series names, and category labels in place; embedded `.xlsx` workbook stays in sync.
+  - New `Chart.chart_title` setter and `Chart.has_legend` setter emit `SetChartTitle` and `SetLegendVisible` patches respectively.
+  - `CategoryChartData.add_series()` and `XyChartData` / `BubbleChartData` now capture data client-side instead of raising eagerly. (Authoring scatter / bubble charts still raises at `add_chart()` time.)
+  - `GraphicFrame` extended to host a `Chart` (in addition to `Table`), so `gf.chart` and `gf.has_chart` work.
+
+## 0.1.55
+
+- Internal: bumped version coordinated with the `Presentation.create()` server-side fix (#19270). No SDK API change.
+
+## 0.1.54
+
+- `RemoteError.__str__` now includes the HTTP status code (e.g., `[HTTP 400] Invalid request body: ...`) so the status is visible in tracebacks without unpacking `exc.status_code`.
+
+## 0.1.39
+
+- Added SDK support for `slide.shapes.add_table(...)` and table creation command wiring.
+- Added `slide.notes_slide.notes_text_frame.text` compatibility adapter for python-pptx style notes access.
+- Added support for auto-shape text frame access (`shape.text_frame`) to match python-pptx behavior.
+- Added smoke/integration tests for table creation/cell updates, notes slide adapter, and shape text-frame regression.
+- Updated README examples for notes slide adapter and auto-shape text support.

{athena_python_pptx-0.1.59 → athena_python_pptx-0.1.63}/CLAUDE.md

@@ -23,13 +23,19 @@ Before adding or modifying any API surface:
 3. Confirm the method/property/parameter exists with the same name and signature
 4. If it doesn't exist in python-pptx, **do not add it** without explicit user approval
 
-### Current status (v0.1.52)
+### Current status (v0.1.60)
 
 **Core classes are at 1:1 parity** with python-pptx: FillFormat, LineFormat, RGBColor, ColorFormat, Font. All legacy convenience methods on these classes have been removed.
 
+**Module path shims** mirror stock python-pptx layout: `pptx.slide`, `pptx.table`, `pptx.action`. User code written for python-pptx (`from pptx.table import _Cell`, `from pptx.slide import Slide`) imports unchanged.
+
+**Structural classes** (Presentation, Slide, Slides, SlideLayout, SlideMaster, SlideShapes, Table, `_Cell`) are parity-tested with deviations documented:
+- Stock-only members like `element` / `part` are intentionally absent (REST SDK has no XML/OPC parts).
+- SDK-specific extras (e.g., `Table.add_row()`, `Slide.title_text`, `Presentation.from_url()`) are listed in the test allowlist.
+
 **TextFrame, Paragraph, and Run** still have non-standard convenience extras (e.g., `to_dict()`, `word_count`, `capitalize()`, string helpers). These are candidates for removal in a future cleanup pass.
 
-Run `python -m pytest tests/test_python_pptx_api_parity.py -v -s` to verify parity across 8 classes.
+Run `python -m pytest tests/test_python_pptx_api_parity.py -v -s` to verify parity across 17 classes.
 
 ### Intentionally omitted (REST SDK limitations)
 

{athena_python_pptx-0.1.59 → athena_python_pptx-0.1.63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: athena-python-pptx
-Version: 0.1.59
+Version: 0.1.63
 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.59 → athena_python_pptx-0.1.63}/pptx/__init__.py

@@ -37,7 +37,7 @@ a clear message explaining what's not supported.
 from .presentation import Presentation
 
 # Slide classes
-from .slides import Slide, Slides, SlideLayout, SlideLayouts, SlideMasters, SlideBackground
+from .slides import Slide, Slides, SlideLayout, SlideLayouts, SlideMaster, SlideMasters, SlideBackground
 
 # Shape classes
 from .shapes import (
@@ -127,7 +127,7 @@ def flush_all() -> None:
     _active_buffers[:] = alive
 
 
-__version__ = "0.1.59"
+__version__ = "0.1.63"
 
 __all__ = [
     # Main entry point
@@ -137,6 +137,7 @@ __all__ = [
     "Slides",
     "SlideLayout",
     "SlideLayouts",
+    "SlideMaster",
     "SlideMasters",
     "SlideBackground",
     # Shape classes

athena_python_pptx-0.1.63/pptx/action.py

@@ -0,0 +1,34 @@
+"""Stock python-pptx exposes hyperlink/action classes via ``pptx.action``.
+
+Mirror that module path so user code written for python-pptx
+(``from pptx.action import Hyperlink, ActionSetting``) keeps working.
+
+``ActionSetting`` and the ``PP_ACTION`` enum are not yet implemented in this
+REST SDK — only ``Hyperlink`` is functional. The placeholders are provided so
+that imports succeed and ``isinstance``-style checks behave predictably; they
+will raise ``UnsupportedFeatureError`` if instantiated.
+"""
+
+from __future__ import annotations
+
+from .errors import UnsupportedFeatureError
+from .text import Hyperlink
+
+
+class ActionSetting:
+    """Placeholder for python-pptx's ``ActionSetting``.
+
+    Click-action support is not yet implemented in athena-python-pptx. The
+    class exists so that ``from pptx.action import ActionSetting`` succeeds;
+    instantiation raises :class:`pptx.errors.UnsupportedFeatureError`.
+    """
+
+    def __init__(self, *_args: object, **_kwargs: object) -> None:
+        raise UnsupportedFeatureError(
+            "ActionSetting is not implemented in athena-python-pptx. "
+            "Use Run.hyperlink for URL hyperlinks; click-actions to slides "
+            "are not yet supported.",
+        )
+
+
+__all__ = ["ActionSetting", "Hyperlink"]

{athena_python_pptx-0.1.59 → athena_python_pptx-0.1.63}/pptx/chart/__init__.py

@@ -4,9 +4,12 @@ Chart module for python-pptx compatibility.
 Provides chart-related classes (currently stubs for unimplemented features).
 """
 
+from .category import Categories, Category
 from .data import CategoryChartData, ChartData, XyChartData, BubbleChartData
 
 __all__ = [
+    "Categories",
+    "Category",
     "CategoryChartData",
     "ChartData",
     "XyChartData",

athena_python_pptx-0.1.63/pptx/chart/category.py

@@ -0,0 +1,17 @@
+"""Category sequence classes for python-pptx compatibility."""
+
+from __future__ import annotations
+
+from collections.abc import Iterable
+from typing import Any
+
+
+class Category(str):
+    """Single chart category label."""
+
+
+class Categories(tuple[Category, ...]):
+    """Read-only chart category label sequence."""
+
+    def __new__(cls, values: Iterable[Any] = ()) -> "Categories":
+        return super().__new__(cls, (Category(str(value)) for value in values))

{athena_python_pptx-0.1.59 → athena_python_pptx-0.1.63}/pptx/commands.py

@@ -71,6 +71,7 @@ class AddTextBox(Command):
     font_size_pt: Optional[float] = None
     bold: Optional[bool] = None
     italic: Optional[bool] = None
+    name: Optional[str] = None
 
     @property
     def command_type(self) -> str:
@@ -325,6 +326,7 @@ class AddShape(Command):
     line_color_hex: Optional[str] = None
     line_width_emu: Optional[int] = None
     text: Optional[str] = None
+    name: Optional[str] = None
 
     @property
     def command_type(self) -> str:
@@ -403,6 +405,7 @@ class AddPicture(Command):
     w_emu: Optional[int] = None
     h_emu: Optional[int] = None
     client_id: Optional[str] = None
+    name: Optional[str] = None
 
     @property
     def command_type(self) -> str:
@@ -443,6 +446,7 @@ class AddTable(Command):
     w_emu: int
     h_emu: int
     client_id: Optional[str] = None
+    name: Optional[str] = None
 
     @property
     def command_type(self) -> str:
@@ -1024,6 +1028,7 @@ class AddConnector(Command):
     begin_arrow: Optional[str] = None
     end_arrow: Optional[str] = None
     client_id: Optional[str] = None
+    name: Optional[str] = None
 
     @property
     def command_type(self) -> str:

{athena_python_pptx-0.1.59 → athena_python_pptx-0.1.63}/pptx/enum/shapes.py

@@ -576,3 +576,199 @@ class PP_PLACEHOLDER(IntEnum):
 
 # Alias for compatibility
 PP_PLACEHOLDER_TYPE = PP_PLACEHOLDER
+
+
+# ---------------------------------------------------------------------------
+# MSO_SHAPE → display "basename" used by python-pptx for default shape names.
+# python-pptx names new auto-shapes as "<basename> <slide_shape_count_after>".
+# We mirror that contract so AI agents can find shapes by predictable names.
+# ---------------------------------------------------------------------------
+_MSO_SHAPE_BASENAME = {
+    1: 'Rectangle',
+    2: 'Parallelogram',
+    3: 'Trapezoid',
+    4: 'Diamond',
+    5: 'Rounded Rectangle',
+    6: 'Octagon',
+    7: 'Isosceles Triangle',
+    8: 'Right Triangle',
+    9: 'Oval',
+    10: 'Hexagon',
+    11: 'Cross',
+    12: 'Regular Pentagon',
+    13: 'Can',
+    14: 'Cube',
+    15: 'Bevel',
+    16: 'Folded Corner',
+    17: 'Smiley Face',
+    18: 'Donut',
+    19: '"No" Symbol',
+    20: 'Block Arc',
+    21: 'Heart',
+    22: 'Lightning Bolt',
+    23: 'Sun',
+    24: 'Moon',
+    25: 'Arc',
+    26: 'Double Bracket',
+    27: 'Double Brace',
+    28: 'Plaque',
+    29: 'Left Bracket',
+    30: 'Right Bracket',
+    31: 'Left Brace',
+    32: 'Right Brace',
+    33: 'Right Arrow',
+    34: 'Left Arrow',
+    35: 'Up Arrow',
+    36: 'Down Arrow',
+    37: 'Left-Right Arrow',
+    38: 'Up-Down Arrow',
+    39: 'Quad Arrow',
+    40: 'Left-Right-Up Arrow',
+    41: 'Bent Arrow',
+    42: 'U-Turn Arrow',
+    43: 'Left-Up Arrow',
+    44: 'Bent-Up Arrow',
+    45: 'Curved Right Arrow',
+    46: 'Curved Left Arrow',
+    47: 'Curved Up Arrow',
+    48: 'Curved Down Arrow',
+    49: 'Striped Right Arrow',
+    50: 'Notched Right Arrow',
+    51: 'Pentagon',
+    52: 'Chevron',
+    53: 'Right Arrow Callout',
+    54: 'Left Arrow Callout',
+    55: 'Up Arrow Callout',
+    56: 'Down Arrow Callout',
+    57: 'Left-Right Arrow Callout',
+    58: 'Up-Down Arrow Callout',
+    59: 'Quad Arrow Callout',
+    60: 'Circular Arrow',
+    61: 'Process',
+    62: 'Alternate Process',
+    63: 'Decision',
+    64: 'Data',
+    65: 'Predefined Process',
+    66: 'Internal Storage',
+    67: 'Document',
+    68: 'Multidocument',
+    69: 'Terminator',
+    70: 'Preparation',
+    71: 'Manual Input',
+    72: 'Manual Operation',
+    73: 'Connector',
+    74: 'Off-page Connector',
+    75: 'Card',
+    76: 'Punched Tape',
+    77: 'Summing Junction',
+    78: 'Or',
+    79: 'Collate',
+    80: 'Sort',
+    81: 'Extract',
+    82: 'Merge',
+    83: 'Stored Data',
+    84: 'Delay',
+    85: 'Sequential Access Storage',
+    86: 'Magnetic Disk',
+    87: 'Direct Access Storage',
+    88: 'Display',
+    92: 'Explosion 1',
+    93: 'Explosion 2',
+    94: '4-Point Star',
+    95: '5-Point Star',
+    96: '8-Point Star',
+    97: '16-Point Star',
+    98: '24-Point Star',
+    99: '32-Point Star',
+    100: 'Up Ribbon',
+    101: 'Down Ribbon',
+    102: 'Curved Up Ribbon',
+    103: 'Curved Down Ribbon',
+    104: 'Vertical Scroll',
+    105: 'Horizontal Scroll',
+    106: 'Wave',
+    107: 'Double Wave',
+    108: 'Rectangular Callout',
+    109: 'Rounded Rectangular Callout',
+    110: 'Oval Callout',
+    111: 'Cloud Callout',
+    112: 'Line Callout 1',
+    113: 'Line Callout 2',
+    114: 'Line Callout 3',
+    115: 'Line Callout 4',
+    116: 'Line Callout 1 (Accent Bar)',
+    117: 'Line Callout 2 (Accent Bar)',
+    118: 'Line Callout 3 (Accent Bar)',
+    119: 'Line Callout 4 (Accent Bar)',
+    120: 'Line Callout 1 (No Border)',
+    121: 'Line Callout 2 (No Border)',
+    122: 'Line Callout 3 (No Border)',
+    123: 'Line Callout 4 (No Border)',
+    124: 'Line Callout 1 (Border and Accent Bar)',
+    125: 'Line Callout 2 (Border and Accent Bar)',
+    126: 'Line Callout 3 (Border and Accent Bar)',
+    127: 'Line Callout 4 (Border and Accent Bar)',
+    128: 'Action Button: Custom',
+    129: 'Action Button: Back or Previous',
+    130: 'Action Button: Forward or Next',
+    131: 'Action Button: Beginning',
+    132: 'Action Button: End',
+    133: 'Action Button: Home',
+    134: 'Action Button: Information',
+    135: 'Action Button: Return',
+    136: 'Action Button: Movie',
+    137: 'Action Button: Document',
+    138: 'Action Button: Sound',
+    139: 'Action Button: Help',
+    140: 'Bevel',
+    156: 'Frame',
+}
+
+
+def mso_shape_basename(shape) -> str:
+    """Return python-pptx-compatible display basename for an MSO_SHAPE.
+
+    Used by ``Shapes.add_shape()`` to mirror python-pptx's default naming
+    scheme: ``f"{basename} {slide_shape_count_after_add}"``.
+    """
+    if isinstance(shape, str):
+        # Backend string ('rectangle', 'oval', etc.) — title-case fallback.
+        return shape.replace('_', ' ').title()
+    try:
+        value = int(shape)
+    except (TypeError, ValueError):
+        return 'Shape'
+    if value in _MSO_SHAPE_BASENAME:
+        return _MSO_SHAPE_BASENAME[value]
+    name = getattr(shape, 'name', None)
+    if name:
+        return name.replace('_', ' ').title()
+    return 'Shape'
+
+
+_MSO_CONNECTOR_BASENAME = {
+    1: 'Straight Connector',
+    2: 'Elbow Connector',
+    3: 'Curved Connector',
+}
+
+
+def mso_connector_basename(connector) -> str:
+    """python-pptx names new connectors as ``f"{basename} {slide_count_after}"``.
+
+    Mirrors python-pptx — ``MSO_CONNECTOR.STRAIGHT`` → ``"Straight Connector"``.
+    """
+    if isinstance(connector, str):
+        normalized = connector.lower()
+        if normalized in {'straight', 'line'}:
+            return 'Straight Connector'
+        if normalized == 'elbow':
+            return 'Elbow Connector'
+        if normalized == 'curve':
+            return 'Curved Connector'
+        return connector.replace('_', ' ').title()
+    try:
+        value = int(connector)
+    except (TypeError, ValueError):
+        return 'Connector'
+    return _MSO_CONNECTOR_BASENAME.get(value, 'Connector')

{athena_python_pptx-0.1.59 → athena_python_pptx-0.1.63}/pptx/presentation.py

@@ -513,6 +513,16 @@ class Presentation:
         from .slides import _build_slide_masters
         return _build_slide_masters(self)
 
+    @property
+    def slide_master(self):
+        """The first :class:`SlideMaster` (python-pptx parity).
+
+        Stock python-pptx exposes ``Presentation.slide_master`` as a shortcut
+        for ``slide_masters[0]``. Raises ``IndexError`` if the deck has no
+        masters in its snapshot.
+        """
+        return self.slide_masters[0]
+
     def reorder_slides(self, new_order: list[int]) -> None:
         """
         Reorder slides in the presentation.
@@ -1230,12 +1240,13 @@ class Presentation:
                 snapshot=self._snapshot,
             )
 
-    def save(self, path: Union[str, Path]) -> None:
+    def save(self, file: Union[str, Path]) -> None:
         """
         Export the presentation and download to a local file.
 
         Args:
-            path: Path where the PPTX file should be saved
+            file: Path where the PPTX file should be saved.
+                Matches python-pptx's ``Presentation.save(file)`` signature.
         """
         # Flush any pending commands first
         self._buffer.flush()
@@ -1244,7 +1255,7 @@ class Presentation:
         pptx_bytes = self._client.export_and_download(self._deck_id)
 
         # Write to file
-        path = Path(path)
+        path = Path(file)
         path.write_bytes(pptx_bytes)
 
     def save_to_bytes(self) -> bytes: