Инсталация

Инсталиране на Aspose.Note FOSS за Python

Aspose.Note FOSS for Python is distributed via PyPI под името на пакета aspose-note. Инсталирането изисква Python 3.10 или по-нова.

1. Standard Install (Recommended)

Инсталирайте основната библиотека с pip:

pip install aspose-note

Това инсталира aspose.note пакет без никакви незадължителни зависимости. Той поддържа всички функции за четене и обхождане. PDF експортирането е не включено.

2. Install with PDF Export Support

За да активирате Document.Save(..., SaveFormat.Pdf), инсталирайте с the [pdf] extra. Това добавя ReportLab зависимост (reportlab>=3.6):

pip install "aspose-note[pdf]"

Ако вече сте инсталирали основния пакет, актуализирайте го и добавете допълнението с една команда:

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

Забележка: Опит за извикване Document.Save с SaveFormat.Pdf без инсталиран ReportLab ще предизвика ImportError по време на изпълнение. Инсталирайте [pdf] extra преди използване на PDF функционалност.

3. Virtual Environment (Best Practice)

Използвайте виртуална среда, за да изолирате библиотеката от вашата системна Python:

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

Клонирайте хранилището и инсталирайте в режим на редактиране, за да разработвате или изпълнявате тестове срещу изходния код:

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

Проверка

След инсталацията проверете дали пакетът може да се импортира:

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

Проверете инсталираната версия:

pip show aspose-note

Очакван изход (версията може да се различава):

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

Зависимости

Основната библиотека има нула задължителни зависимости от трети страни. Цялото парсиране на двоични файлове MS-ONE/OneStore е реализирано в чист Python в рамките на aspose.note._internal подпакет.

Подробности за пакета

Допълнителни ресурси

• Aspose.Note FOSS for Python: PyPI
• Хранилище на изходния код
• Докладване на проблеми
• Ръководство за разработчици
• API справка