Aspose.Slides FOSS
Python
Premiers pas
Installation

Installation

Installation de Aspose.Slides FOSS pour Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, qui s’installe automatiquement avec pip : aucune extension native à compiler, aucune bibliothèque système à installer, et aucun Microsoft Office ou autre environnement d’exécution propriétaire requis.

Prérequis

ExigenceDétail
Python version3.10 or later
Gestionnaire de paquetspip (fourni avec CPython)
Système d’exploitationWindows, macOS, Linux (toute plateforme exécutant CPython)
Compilateur / outils de constructionAucun requis
Dépendance automatiquelxml (installé automatiquement par pip)

1. Install via pip (Recommended)

La façon la plus simple d’installer Aspose.Slides FOSS est directement depuis PyPI :

pip install aspose-slides-foss

pip télécharge et installe le paquet ainsi que le lxml dépendance. Aucune configuration post‑installation n’est nécessaire.

Pour installer une version figée afin d’obtenir des builds reproductibles :

pip install aspose-slides-foss==26.3.0

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

Utiliser un environnement virtuel maintient la bibliothèque isolée des autres projets Python et évite les conflits de version.

Créez et activez un environnement virtuel :

##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

Installez la bibliothèque dans l’environnement activé :

pip install aspose-slides-foss

Enregistrez les dépendances pour la reproductibilité :

pip freeze > requirements.txt

Pour recréer l’environnement sur une autre machine :

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

3. Verify the Installation

Après l’installation, vérifiez que la bibliothèque s’importe correctement et qu’un Presentation peut être créé :

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)}")

Sortie attendue :

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

Vous pouvez également vérifier la version installée avec pip :

pip show aspose-slides-foss

Cela affiche la version, l’auteur et la licence (MIT).

Démarrage rapide : créer une présentation avec une forme

Le script suivant crée une nouvelle présentation, ajoute un rectangle avec du texte, et l’enregistre en tant que .pptx fichier :

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")

Important : Utilisez toujours Presentation en tant que gestionnaire de contexte (with déclaration). Cela garantit le nettoyage approprié des ressources internes lorsque le bloc se termine.

Notes de la plateforme

Windows, macOS, Linux : La bibliothèque est identique sur toutes les plateformes. Il n’existe aucun chemin de code spécifique à une plateforme ni d’extensions binaires au-delà de lxml.

Docker / serverless : La bibliothèque fonctionne à l’intérieur d’images Docker allégées (comme python:3.12-slim) avec pip install aspose-slides-foss. Aucun paquet apt ou yum supplémentaire n’est requis sauf si lxml doit être compilé à partir du source (la roue PyPI couvre les architectures courantes).

CI/CD: Ajoutez pip install aspose-slides-foss à l’étape de dépendance de votre pipeline CI. Aucun paramétrage supplémentaire n’est requis.

Conda : Si votre projet utilise Conda, installez la bibliothèque depuis PyPI dans un environnement Conda :

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

Ressources supplémentaires

 Français