Installation

Installation of Aspose.Note FOSS for Python

Aspose.Note FOSS for Python is distributed via PyPI under the package name aspose-note. Installation requires Python 3.10 or later.

1. Standard Install (Recommended)

Install the core library with pip:

pip install aspose-note

This installs the aspose.note package with no optional dependencies. It covers parsing and traversal features. PDF export requires an additional dependency and is not included in this base install.

2. Install with PDF Export Support

To enable Document.Save(..., SaveFormat.Pdf), install with the [pdf] extra. This adds the ReportLab dependency (reportlab>=3.6):

pip install aspose-note

If you have already installed the core package, re-run the install command above with the [pdf] extra added — pip will upgrade in place.

Note: Attempting to call Document.Save with SaveFormat.Pdf without ReportLab installed will raise a module-not-found error at runtime. Install the [pdf] extra before using PDF export functionality.

3. Virtual Environment (Best Practice)

Use a virtual environment to isolate the library from your system Python:

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

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

##Then install with the [pdf] extra, using the command shown in Step 2 above

4. Editable Install (For Contributors)

Clone the repository and install in editable mode to develop or run tests against the source:


The `License` API surface has changed in the current source model; review its reference page before relying on older member details.
git clone https://github.com/aspose-note-foss/Aspose.Note-FOSS-for-Python.git
cd Aspose.Note-FOSS-for-Python

##Editable, PDF-extra-enabled install from source (see the repository's CONTRIBUTING guide for the exact command)

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

Verification

After installation, verify that the package is importable:

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

Check the installed version:

pip show aspose-note

Expected output (version may differ):

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

Dependencies

Dependency	Required?	Purpose
Python 3.10+	Always	Minimum language version
`reportlab>=3.6`	Optional (via `[pdf]` extra)	PDF export via `Document.Save(..., SaveFormat.Pdf)`

The core library has zero mandatory third-party dependencies. All MS-ONE/OneStore binary parsing is implemented in pure Python within the aspose.note._internal subpackage.

Package Details

Attribute	Value
Package name	`aspose-note`
PyPI URL	https://pypi.org/project/aspose-note/
Import path	`from aspose.note import ...`
Version (current)	26.3.2
Python support	3.10, 3.11, 3.12 (install requires Python 3.10 or later)
Operating systems	Windows, Linux, macOS (OS-independent)
License	MIT (Aspose-Split)
Source repository	https://github.com/aspose-note-foss/Aspose.Note-FOSS-for-Python