Aspose.Slides FOSS
Python
Начало работы
Установка

Установка

Установка Aspose.Slides FOSS для Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, который pip устанавливает автоматически: нет нативных расширений для компиляции, нет системных библиотек для установки и не требуется Microsoft Office или другой проприетарный runtime.

Требования

ТребованиеПодробность
Python версия3.10 or later
Менеджер пакетовpip (в комплекте с CPython)
Операционная системаWindows, macOS, Linux (любая платформа, на которой работает CPython)
Компилятор / инструменты сборкиНе требуется
Автоматическая зависимостьlxml (устанавливается pip автоматически)

1. Install via pip (Recommended)

Самый простой способ установить Aspose.Slides FOSS — напрямую из PyPI:

pip install aspose-slides-foss

pip загружает и устанавливает пакет вместе с lxml зависимостью. Дополнительная настройка после установки не требуется.

Чтобы установить фиксированную версию для воспроизводимых сборок:

pip install aspose-slides-foss==26.3.0

2. Set Up a Virtual Environment (Recommended for Projects)

Использование виртуального окружения изолирует библиотеку от других проектов Python и предотвращает конфликты версий.

Создайте и активируйте виртуальное окружение:

##Create the environment
python -m venv .venv

##Activate on Linux / macOS
source .venv/bin/activate

##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

Установите библиотеку внутри активированного окружения:

pip install aspose-slides-foss

Зафиксируйте зависимости для воспроизводимости:

pip freeze > requirements.txt

Чтобы воссоздать окружение на другой машине:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

После установки проверьте, что библиотека импортируется корректно и Presentation можно создать:

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

with slides.Presentation() as prs:
    print("Aspose.Slides FOSS installed successfully")
    print(f"Slides in empty presentation: {len(prs.slides)}")

Ожидаемый вывод:

Aspose.Slides FOSS installed successfully
Slides in empty presentation: 1

Вы также можете проверить установленную версию с помощью pip:

pip show aspose-slides-foss

Это выводит версию, автора и лицензию (MIT).

Быстрый старт: создание презентации с фигурой

Следующий скрипт создаёт новую презентацию, добавляет прямоугольник с текстом и сохраняет её как .pptx файл:

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

with slides.Presentation() as prs:
    slide = prs.slides[0]

    ##Add a rectangle shape and set its text
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 150)
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")

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

print("Saved hello.pptx")

Важно: Всегда используйте Presentation в качестве менеджера контекста (with оператор). Это обеспечивает правильную очистку внутренних ресурсов при выходе из блока.

Примечания к платформе

Windows, macOS, Linux: Библиотека идентична на всех платформах. Нет платформенно‑специфичных путей кода или бинарных расширений, кроме lxml.

Docker / безсерверные: Библиотека работает внутри облегчённых Docker‑образов (например, python:3.12-slim) с pip install aspose-slides-foss. Дополнительные пакеты apt или yum не требуются, если только lxml нуждается в компиляции из исходного кода (колесо PyPI покрывает распространённые архитектуры).

CI/CD: Добавьте pip install aspose-slides-foss в шаг зависимости вашего CI‑конвейера. Дополнительная настройка не требуется.

Conda: Если ваш проект использует Conda, установите библиотеку из PyPI внутри среды Conda:

conda create -n slides-env python=3.12
conda activate slides-env
pip install aspose-slides-foss

Дополнительные ресурсы

 Русский