Как загружать презентации в Python

Aspose.Slides FOSS for Python lets you open any .pptx файл, проверьте его содержимое и либо сохраните его обратно в PPTX, либо извлеките из него данные. Это руководство охватывает открытие файла, перебор слайдов, чтение текста фигур и сохранение с обратным проходом.

Пошаговое руководство

pip install aspose-slides-foss

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation("input.pptx") as prs:
    print(f"Slide count: {len(prs.slides)}")
    prs.save("output.pptx", SaveFormat.PPTX)

import aspose.slides_foss as slides

with slides.Presentation("deck.pptx") as prs:
    for i, slide in enumerate(prs.slides):
        shape_count = len(slide.shapes)
        print(f"Slide {i}: {shape_count} shapes")

import aspose.slides_foss as slides

with slides.Presentation("deck.pptx") as prs:
    for slide in prs.slides:
        for shape in slide.shapes:
            if hasattr(shape, "text_frame") and shape.text_frame is not None:
                text = shape.text_frame.text
                if text.strip():
                    print(f"  Shape text: {text!r}")

import aspose.slides_foss as slides

with slides.Presentation("deck.pptx") as prs:
    props = prs.document_properties
    print(f"Title:   {props.title}")
    print(f"Author:  {props.author}")
    print(f"Subject: {props.subject}")

prs.save("output.pptx", SaveFormat.PPTX)

Распространённые проблемы и их решения

FileNotFoundError

Проверьте, что путь к .pptx файлу корректен относительно рабочей директории. Используйте pathlib.Path для надёжного построения пути:

from pathlib import Path
path = Path(__file__).parent / "assets" / "deck.pptx"
with slides.Presentation(str(path)) as prs:
    ...

Exception: File format is not supported

Библиотека поддерживает .pptx (Office Open XML) только. Устаревшие .ppt (binary PowerPoint 97–2003) файлы не поддерживаются.

У фигур нет атрибута text_frame

Некоторые фигуры (Connectors, PictureFrames, GroupShapes) не имеют a text_frame. Защитите с помощью hasattr(shape, "text_frame") and shape.text_frame is not None перед доступом к тексту.

Часто задаваемые вопросы

Сохраняет ли загрузка всё оригинальное содержимое?

Да. Неизвестные XML‑части сохраняются дословно при обратном сохранении. Библиотека не удаляет XML‑содержимое, которое она ещё не понимает.

Можно ли загрузить PPTX, защищённый паролем?

Презентации, защищённые паролем (зашифрованные), не поддерживаются в этой версии.

Можно ли извлечь встроенные изображения?

Получите доступ к коллекции изображений: prs.images возвращает the ImageCollection. Каждое изображение имеет content_type и bytes свойство для чтения необработанных данных изображения.

Поддерживается ли загрузка из потока в памяти?

Загрузка напрямую из io.BytesIO не доступна в текущем API. Сначала запишите байты во временный файл:

import tempfile, os
import aspose.slides_foss as slides

with tempfile.NamedTemporaryFile(suffix=".pptx", delete=False) as tmp:
    tmp.write(pptx_bytes)
    tmp_path = tmp.name

try:
    with slides.Presentation(tmp_path) as prs:
        print(f"Slides: {len(prs.slides)}")
finally:
    os.unlink(tmp_path)

См. также

• Как создавать презентации в Python
• Как сохранять презентации в Python
• Обзор функций
• Справочник API