How scanny/python-pptx works
python-pptx is a Python library for creating, reading, updating, and analyzing PowerPoint presentations without requiring PowerPoint itself. A typical workflow starts with application data and the public Presentation API, then edits presentation and slide content—shapes, text, charts, and images—and saves or reads a .pptx package. The graph also shows the XML object model and OPC packaging layer that support those features. Edges reflect README statements or dependencies visible in the supplied excerpts and SOURCE INDEX; unsampled internals are not treated as inspected call flows.
Main entry points: shapetree.py Shape collections · slide.py Slide parts · package.py OPC package I/O · presentation.py Presentation model
Components 26
Public API
- Presentation API
src/pptx/api.py - Presentation model
src/pptx/presentation.py
Presentation Content
- Slide model
src/pptx/slide.py - Shape collections
src/pptx/shapes/shapetree.py - Shape objects
src/pptx/shapes/autoshape.py - Text and fonts
src/pptx/text/text.py - Chart data
src/pptx/chart/data.py - Chart model
src/pptx/chart/chart.py - Chart XML writer
src/pptx/chart/xmlwriter.py - Image parts
src/pptx/parts/image.py - Media handling
src/pptx/media.py - Color and fills
src/pptx/dml/color.py
Document Format
- OPC package I/O
src/pptx/opc/package.py - Slide parts
src/pptx/parts/slide.py - XML element model
src/pptx/oxml/xmlchemy.py - Text XML
src/pptx/oxml/text.py - Slide XML
src/pptx/oxml/slide.py - XML namespaces
src/pptx/oxml/ns.py - XML simple types
src/pptx/oxml/simpletypes.py
Shared Support
- Chart enums
src/pptx/enum/chart.py - Drawing enums
src/pptx/enum/dml.py - Shape enums
src/pptx/enum/shapes.py - Shared utilities
src/pptx/shared.py
Other components
- Application data
- PPTX file
- Presentation analyst
Connections 26
- Application data → Presentation API: provides content
- Presentation API → Presentation model: creates or opens
- Presentation model → OPC package I/O: loads and saves
src/pptx/opc/package.py - OPC package I/O → Slide parts: resolves parts
src/pptx/opc/package.py - Slide parts → Slide model: provides slide part
src/pptx/parts/slide.py - Slide model → Shape collections: exposes shapes
src/pptx/slide.py - Shape collections → Shape objects: constructs shapes
src/pptx/shapes/shapetree.py - Shape objects → Text and fonts: exposes text
src/pptx/text/text.py - Shape collections → Chart data: accepts chart data
src/pptx/shapes/shapetree.py - Chart model → Chart data: uses chart data
src/pptx/chart/chart.py - Chart data → Chart XML writer: composes chart XML
src/pptx/chart/data.py - Shape collections → Image parts: adds pictures
src/pptx/shapes/shapetree.py - Image parts → OPC package I/O: uses package parts
src/pptx/parts/image.py - Slide model → Slide parts: uses slide parts
src/pptx/slide.py - Shape collections → Shape enums: uses shape types
src/pptx/shapes/shapetree.py - Chart XML writer → Chart enums: uses chart types
src/pptx/chart/xmlwriter.py - Text and fonts → Text XML: edits text XML
src/pptx/text/text.py - Text XML → XML simple types: uses XML types
src/pptx/oxml/text.py - XML element model → XML namespaces: uses namespaces
src/pptx/oxml/xmlchemy.py - Chart XML writer → XML namespaces: uses namespaces
src/pptx/chart/xmlwriter.py - Slide parts → Slide XML: uses slide XML
src/pptx/parts/slide.py - Color and fills → Drawing enums: uses drawing enums
src/pptx/dml/color.py - Chart model → Shared utilities: uses shared helpers
src/pptx/chart/chart.py - Media handling → OPC package I/O: uses package constants
src/pptx/media.py - Presentation model → PPTX file: saves presentation
- PPTX file → Presentation analyst: supports analysis