athena-python-pptx 0.16.0__tar.gz → 0.16.1__tar.gz

{athena_python_pptx-0.16.0 → athena_python_pptx-0.16.1}/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to `athena-python-pptx` are documented in this file.
 
+## 0.16.1 — `Presentation.upload()` and `create(pptx=...)` report the deck they create
+
+- `Presentation.upload()` emits the `CreatePresentation` tool-call event with
+  the new deck's id, as `Presentation.create()` and the docx and xlsx uploads
+  do. It emitted nothing, so a deck uploaded from sandbox code, including one
+  seeded from a brand template with `Presentation.create(pptx=...)`, showed no
+  creation card and never joined the Athena session's created assets.
+
 ## 0.16.0 — `Presentation.create()` makes 13.333" × 7.5" decks; `create(name=, title=)` titles the deck
 
 - **Behaviour change:** `Presentation.create()` makes a deck at PowerPoint's

{athena_python_pptx-0.16.0 → athena_python_pptx-0.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: athena-python-pptx
-Version: 0.16.0
+Version: 0.16.1
 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.16.0 → athena_python_pptx-0.16.1}/pptx/__init__.py

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

{athena_python_pptx-0.16.0 → athena_python_pptx-0.16.1}/pptx/client.py

@@ -138,6 +138,17 @@ def _poll_delays(poll_interval: float, max_attempts: int) -> Iterator[float]:
         delay = min(delay * 1.5, poll_interval)
 
 
+def _upload_deck_name(*, file_path: str, name: Optional[str]) -> str:
+    """The name an upload gives its deck: ``name``, else the file's name
+    without a ``.pptx`` / ``.potx`` extension."""
+    if name is not None:
+        return name
+    base = os.path.basename(file_path)
+    if base.endswith(".pptx") or base.endswith(".potx"):
+        return base[:-5]
+    return base
+
+
 def _is_read_timeout(exc: BaseException) -> bool:
     """A response that did not arrive in time. With retries configured,
     requests reports a read timeout as a ConnectionError wrapping urllib3's
@@ -926,12 +937,7 @@ class Client:
         if not os.path.exists(file_path):
             raise FileNotFoundError(f"File not found: {file_path}")
 
-        # Use filename as name if not provided
-        if name is None:
-            name = os.path.basename(file_path)
-            # Remove extension
-            if name.endswith(".pptx") or name.endswith(".potx"):
-                name = name[:-5]
+        name = _upload_deck_name(file_path=file_path, name=name)
 
         # Step 1: Create deck to get presigned URL
         deck_info = self.create_deck(name)
@@ -1007,11 +1013,7 @@ class Client:
         if not os.path.exists(file_path):
             raise FileNotFoundError(f"File not found: {file_path}")
 
-        # Use filename as name if not provided
-        if name is None:
-            name = os.path.basename(file_path)
-            if name.endswith(".pptx") or name.endswith(".potx"):
-                name = name[:-5]
+        name = _upload_deck_name(file_path=file_path, name=name)
 
         # Step 1: Create deck to get presigned URL
         deck_info = self.create_deck(name)

{athena_python_pptx-0.16.0 → athena_python_pptx-0.16.1}/pptx/presentation.py

@@ -17,7 +17,7 @@ import warnings
 
 from ._athena_extension import athena_extension
 from .batching import CommandBuffer, batch_context
-from .client import Client, _hand_session_to_next_client
+from .client import Client, _hand_session_to_next_client, _upload_deck_name
 from .commands import SetCoreProperties, SetPresentationSize, CopySlideFromDeck
 from .errors import AuthenticationError, RemoteError, UnsupportedFeatureError
 from .slides import SlideLayouts, SlideMasters, Slides
@@ -894,23 +894,51 @@ class Presentation:
             # Save changes
             prs.save("modified.pptx")
         """
+        from pptx import _ptc
+
         client = Client(base_url=base_url, api_key=api_key, prefer_user_key=True)
 
         # The presentation's client takes over this connection (closed here
         # when the upload or the open fails first).
         with _hand_session_to_next_client(client):
-            if wait:
-                kwargs: dict[str, Any] = {}
-                if max_wait_seconds is not None:
-                    # Match the client's poll_interval default (0.5s) so callers
-                    # can think in seconds without remembering attempt math.
-                    from .client import DEFAULT_POLL_INTERVAL
-
-                    kwargs["max_attempts"] = max(1, int(max_wait_seconds / DEFAULT_POLL_INTERVAL))
-                deck_id = client.upload_file(str(path), name=name, **kwargs)
-            else:
-                # Upload without waiting
-                deck_id = client.upload_file_async(str(path), name=name)
+            # PTC: the upload creates a deck asset, so it wears the same card
+            # as ``create()`` and the docx/xlsx uploads. Agora adds a deck to
+            # the session's created assets only from this event. Scoped to the
+            # upload as in ``create()``: the open below emits its own
+            # ``OpenPresentation``.
+            call_id = _ptc.emit_begin(
+                "CreatePresentation",
+                {"name": _upload_deck_name(file_path=str(path), name=name)},
+            )
+            try:
+                if wait:
+                    kwargs: dict[str, Any] = {}
+                    if max_wait_seconds is not None:
+                        # Match the client's poll_interval default (0.5s) so callers
+                        # can think in seconds without remembering attempt math.
+                        from .client import DEFAULT_POLL_INTERVAL
+
+                        kwargs["max_attempts"] = max(
+                            1, int(max_wait_seconds / DEFAULT_POLL_INTERVAL)
+                        )
+                    deck_id = client.upload_file(str(path), name=name, **kwargs)
+                else:
+                    # Upload without waiting
+                    deck_id = client.upload_file_async(str(path), name=name)
+            except Exception as exc:
+                _ptc.emit_end(
+                    call_id=call_id,
+                    tool_name="CreatePresentation",
+                    result={"ok": False, "error": str(exc)},
+                    is_error=True,
+                )
+                raise
+            _ptc.emit_end(
+                call_id=call_id,
+                tool_name="CreatePresentation",
+                result={"ok": True, "assetId": deck_id},
+                is_error=False,
+            )
 
             prs = cls(deck_id=deck_id, base_url=base_url, api_key=api_key, auto_refresh=wait)
         _release_opened_slides(prs)

{athena_python_pptx-0.16.0 → athena_python_pptx-0.16.1}/pyproject.toml

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