安装

安装 Aspose.Note FOSS for Python

Aspose.Note FOSS for Python 通过 PyPI 分发,包名为 aspose-note。安装需要 Python 3.10 或更高版本。


1. 标准安装(推荐)

使用 pip 安装核心库:

pip install aspose-note

这将安装 aspose.note 包,且不包含可选依赖项。它支持所有读取和遍历功能。PDF 导出 包含。


2. 安装带 PDF 导出支持

要启用 Document.Save(..., SaveFormat.Pdf),请使用 [pdf] 额外组件进行安装。这将添加 ReportLab 依赖 (reportlab>=3.6):

pip install "aspose-note[pdf]"

如果您已经安装了 core 包,请在一次命令中升级它并添加 extra:

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

Note: 尝试在未安装 ReportLab 的情况下使用 SaveFormat.Pdf 调用 Document.Save 将在运行时抛出 ImportError。在使用 PDF 功能之前,请先安装 [pdf] 扩展。


3. 虚拟环境(最佳实践)

使用虚拟环境将库与系统 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. 可编辑安装(供贡献者)

克隆仓库并以可编辑模式安装,以便开发或针对源代码运行测试:

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

依赖项

依赖项是否必需?用途
Python 3.10+始终最低语言版本
reportlab>=3.6可选(通过 [pdf] 额外)通过 Document.Save(..., SaveFormat.Pdf) 导出 PDF

核心库 零强制性第三方依赖。所有 MS-ONE/OneStore 二进制解析均在纯 Python 中实现,位于 aspose.note._internal 子包内。


包详情

属性
包名aspose-note
PyPI URLhttps://pypi.org/project/aspose-note/
导入路径from aspose.note import ...
版本(当前)26.3.2
Python 支持3.10, 3.11, 3.12
操作系统Windows, Linux, macOS (OS-independent)
许可证MIT (Aspose-Split)
源代码仓库https://github.com/aspose-note-foss/Aspose.Note-FOSS-for-Python

附加资源

 中文