安装
安装 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 URL | https://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 |