Installazione

Installazione di Aspose.Note FOSS per Python

Aspose.Note FOSS for Python is distributed via PyPI sotto il nome del pacchetto aspose-note. L’installazione richiede Python 3.10 o versioni successive.

1. Standard Install (Recommended)

Installa la libreria core con pip:

pip install aspose-note

Questo installa il aspose.note pacchetto senza dipendenze opzionali. Supporta tutte le funzionalità di lettura e traversata. L’esportazione PDF è non inclusa.

2. Install with PDF Export Support

Per abilitare Document.Save(..., SaveFormat.Pdf), installa con il [pdf] extra. Questo aggiunge la ReportLab dipendenza (reportlab>=3.6):

pip install "aspose-note[pdf]"

Se hai già installato il pacchetto core, aggiornalo e aggiungi l’extra in un unico comando:

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

Nota: Tentare di chiamare Document.Save con SaveFormat.Pdf senza ReportLab installato genererà un ImportError a runtime. Installa il [pdf] extra prima di utilizzare la funzionalità PDF.

3. Virtual Environment (Best Practice)

Usa un ambiente virtuale per isolare la libreria dal tuo Python di 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)

Clona il repository e installa in modalità modificabile per sviluppare o eseguire test sul codice sorgente:

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

Dopo l’installazione, verifica che il pacchetto sia importabile:

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

Verifica la versione installata:

pip show aspose-note

Output previsto (la versione può differire):

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

Dipendenze

La libreria principale ha zero dipendenze obbligatorie di terze parti. Tutta l’analisi binaria MS-ONE/OneStore è implementata in puro Python all’interno del aspose.note._internal sottopacchetto.

Dettagli del pacchetto

Risorse aggiuntive

• Aspose.Note FOSS for Python: PyPI
• Repository sorgente
• Segnala problemi
• Guida per sviluppatori
• Riferimento API