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 чи інше пропрієтарне середовище виконання.

Передумови

ВимогаДеталь
версія Python3.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

Додаткові ресурси

 Українська