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

Aspose.Slides FOSS for Python позволяет открыть любой файл .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) не поддерживаются.

У объектов Shape нет атрибута text_frame

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

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

Сохраняет ли загрузка весь оригинальный контент?

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

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

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

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

Получите доступ к коллекции изображений: prs.images возвращает 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