Aspose.Slides FOSS
Python
Comenzando
Instalación

Instalación

Instalación de Aspose.Slides FOSS para Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, que pip instala automáticamente: sin extensiones nativas que compilar, sin bibliotecas del sistema que instalar, y sin Microsoft Office u otro tiempo de ejecución propietario requerido.

Requisitos previos

RequisitoDetalle
Python versión3.10 or later
Gestor de paquetespip (incluido con CPython)
Sistema operativoWindows, macOS, Linux (cualquier plataforma que ejecute CPython)
Compilador / herramientas de compilaciónNo se requiere ninguno
Dependencia automáticalxml (instalado por pip automáticamente)

1. Install via pip (Recommended)

La forma más sencilla de instalar Aspose.Slides FOSS es directamente desde PyPI:

pip install aspose-slides-foss

pip descarga e instala el paquete junto con el lxml dependencia. No se necesita configuración posterior a la instalación.

Para instalar una versión fijada para compilaciones reproducibles:

pip install aspose-slides-foss==26.3.0

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

Usar un entorno virtual mantiene la biblioteca aislada de otros proyectos Python y evita conflictos de versiones.

Crea y activa un entorno virtual:

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

Instala la biblioteca dentro del entorno activado:

pip install aspose-slides-foss

Registra las dependencias para reproducibilidad:

pip freeze > requirements.txt

Para recrear el entorno en otra máquina:

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

3. Verify the Installation

Después de la instalación, verifica que la biblioteca se importe correctamente y un Presentation puede crearse:

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

Salida esperada:

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

También puedes comprobar la versión instalada con pip:

pip show aspose-slides-foss

Esto imprime la versión, el autor y la licencia (MIT).

Inicio rápido: Crear una presentación con una forma

El siguiente script crea una nueva presentación, agrega un rectángulo con texto y lo guarda como un .pptx archivo:

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

Importante: Siempre use Presentation como un gestor de contexto (with declaración). Esto asegura una limpieza adecuada de los recursos internos cuando el bloque finaliza.

Notas de la plataforma

Windows, macOS, Linux: La biblioteca es idéntica en todas las plataformas. No hay rutas de código específicas de la plataforma ni extensiones binarias más allá de lxml.

Docker / serverless: La biblioteca funciona dentro de imágenes Docker ligeras (como python:3.12-slim) con pip install aspose-slides-foss. No se requieren paquetes adicionales de apt o yum a menos que lxml necesite compilar desde el código fuente (la rueda de PyPI cubre arquitecturas comunes).

CI/CD: Añade pip install aspose-slides-foss a la etapa de dependencias de tu canal CI. No se requiere configuración adicional.

Conda: Si su proyecto usa Conda, instale la biblioteca desde PyPI dentro de un entorno Conda:

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

Recursos adicionales

 Español