Two enhancements to make python-pptx more useful for LLM-driven presentation generation: structured serialization of presentation content, and programmatic animation of shapes.

Serialization (to_dict() / __repr__())

• Added to_dict() returning JSON-serializable dicts on Presentation, Slide, BaseShape, TextFrame, _Paragraph, _Run, Font
• Added descriptive __repr__() on the same objects (defensive against incomplete/mock state in Slide)
• Font.to_dict() only includes explicitly-set properties to avoid inherited noise
• 26 tests in tests/test_llm_friendly.py

Animation (Slide.add_animation())

• src/pptx/enum/animation.py — PP_ANIMATION_TYPE enum: 14 entrance effects (APPEAR, FADE, FLY_IN×4, WIPE×4, SPLIT×2, WHEEL, DISSOLVE)
• src/pptx/oxml/slide.py — CT_Slide.add_animation() + XML builders (_build_animation_timing_xml, _build_animation_click_par_xml) generating valid OOXML timing trees. Supports first-animation (full scaffold) and subsequent-animation (appended to existing mainSeq) paths. _ANIMATION_FILTER_MAP maps enum xml_values → OOXML filter/transition attrs.
• src/pptx/slide.py — Slide.add_animation(shape, animation_type, duration=500) public API with input validation
• 21 tests in tests/test_animation.py

Usage

from pptx import Presentation
from pptx.enum.animation import PP_ANIMATION_TYPE
import json

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[1])
title = slide.placeholders[0]
title.text = "Hello"

slide.add_animation(title, PP_ANIMATION_TYPE.FADE, duration=1000)
slide.add_animation(slide.placeholders[1], PP_ANIMATION_TYPE.WIPE_FROM_LEFT, 800)

# Inspect entire presentation as structured data
print(json.dumps(prs.to_dict(), indent=2))

prs.save("output.pptx")

All 2747 tests pass (2700 existing + 47 new).

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.