Aspose.Slides FOSS
Python
Começando
Instalação

Instalação

Instalação do 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 o pip instala automaticamente: sem extensões nativas para compilar, sem bibliotecas de sistema para instalar, e sem necessidade de Microsoft Office ou outro runtime proprietário.

Pré-requisitos

RequisitoDetalhe
Python versão3.10 or later
Gerenciador de pacotespip (incluído com CPython)
Sistema operacionalWindows, macOS, Linux (qualquer plataforma que execute CPython)
Compilador / ferramentas de construçãoNenhum necessário
Dependência automáticalxml (instalado automaticamente pelo pip)

1. Install via pip (Recommended)

A maneira mais simples de instalar Aspose.Slides FOSS é diretamente do PyPI:

pip install aspose-slides-foss

pip baixa e instala o pacote junto com o lxml dependência. Nenhuma configuração pós-instalação é necessária.

Para instalar uma versão fixa para builds reproduzíveis:

pip install aspose-slides-foss==26.3.0

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

Usar um ambiente virtual mantém a biblioteca isolada de outros projetos Python e evita conflitos de versão.

Crie e ative um ambiente 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

Instale a biblioteca dentro do ambiente ativado:

pip install aspose-slides-foss

Registre as dependências para reproducibilidade:

pip freeze > requirements.txt

Para recriar o ambiente em outra máquina:

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

3. Verify the Installation

Após a instalação, verifique se a biblioteca é importada corretamente e um Presentation pode ser criado:

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

Saída esperada:

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

Você também pode verificar a versão instalada com pip:

pip show aspose-slides-foss

Isso imprime a versão, o autor e a licença (MIT).

Início Rápido: Criar uma Apresentação com uma Forma

O script a seguir cria uma nova apresentação, adiciona um retângulo com texto e a salva como um .pptx arquivo:

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: Sempre use Presentation como um gerenciador de contexto (with declaração). Isso garante a limpeza adequada dos recursos internos quando o bloco é encerrado.

Notas da Plataforma

Windows, macOS, Linux: A biblioteca é idêntica em todas as plataformas. Não há caminhos de código específicos de plataforma ou extensões binárias além de lxml.

Docker / serverless: A biblioteca funciona dentro de imagens Docker slim (como python:3.12-slim) com pip install aspose-slides-foss. Nenhum pacote adicional apt ou yum é necessário, a menos que lxml precisa compilar a partir do código-fonte (a roda PyPI cobre arquiteturas comuns).

CI/CD: Adicione pip install aspose-slides-foss ao passo de dependências do seu pipeline CI. Nenhuma configuração adicional é necessária.

Conda: Se o seu projeto usa Conda, instale a biblioteca a partir do PyPI dentro de um ambiente Conda:

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

Recursos Adicionais

 Português