Instalação

Instalação do Aspose.Note FOSS para Python

Aspose.Note FOSS for Python is distributed via PyPI sob o nome do pacote aspose-note. A instalação requer Python 3.10 ou posterior.

1. Standard Install (Recommended)

Instale a biblioteca principal com pip:

pip install aspose-note

Isso instala o aspose.note pacote sem dependências opcionais. Ele suporta todos os recursos de leitura e travessia. A exportação em PDF é não incluída.

2. Install with PDF Export Support

Para habilitar Document.Save(..., SaveFormat.Pdf), instale com o [pdf] extra. Isso adiciona o ReportLab dependência (reportlab>=3.6):

pip install "aspose-note[pdf]"

Se você já instalou o pacote principal, atualize-o e adicione o extra em um único comando:

pip install --upgrade "aspose-note[pdf]"

Nota:Tentando chamar Document.Save com SaveFormat.Pdf sem o ReportLab instalado gerará um ImportError em tempo de execução. Instale o [pdf] extra antes de usar a funcionalidade PDF.

3. Virtual Environment (Best Practice)

Use um ambiente virtual para isolar a biblioteca do seu Python do sistema:

##Create a virtual environment
python -m venv .venv

##Activate it
##Windows:
.venv\Scripts\activate
##Linux / macOS:
source .venv/bin/activate

##Install (with PDF support)
pip install "aspose-note[pdf]"

4. Editable Install (For Contributors)

Clone o repositório e instale em modo editável para desenvolver ou executar testes contra o código-fonte:

git clone https://github.com/aspose-note-foss/Aspose.Note-FOSS-for-Python.git
cd Aspose.Note-FOSS-for-Python

##Editable install with PDF support
pip install -e ".[pdf]"

##Run the test suite
python -m unittest discover -s tests -p "test_*.py" -v

Verificação

Após a instalação, verifique se o pacote pode ser importado:

from aspose.note import Document, SaveFormat, FileFormat
print("Aspose.Note FOSS for Python installed successfully.")

Verifique a versão instalada:

pip show aspose-note

Saída esperada (a versão pode ser diferente):

Name: aspose-note
Version: 26.3.2
Summary: Aspose.Note-compatible Python API for reading OneNote (.one) files
...

Dependências

A biblioteca central tem zero dependências obrigatórias de terceiros. Todo o parsing binário MS-ONE/OneStore é implementado em puro Python dentro do aspose.note._internal subpacote.

Detalhes do Pacote

Recursos Adicionais

• Aspose.Note FOSS for Python: PyPI
• Repositório de Código-Fonte
• Reportar Problemas
• Guia do Desenvolvedor
• Referência da API