1. Produits
  2.   Aspose.Note
  3.   Aspose.Note FOSS for Python

Aspose.Note FOSS pour Python

Lisez, parcourez et exportez les fichiers Microsoft OneNote (.one) depuis Python — gratuit et open source, aucun Microsoft Office requis.

Aspose.Note FOSS for Python Aspose.Note FOSS
for Python

Documentation GitHub

Bibliothèque Python open-source pour les fichiers OneNote

Aspose.Note FOSS pour Python est une bibliothèque 100 % gratuite, sous licence MIT, qui vous permet de lire les fichiers Microsoft OneNote (.one) entièrement depuis Python, sans Microsoft Office, sans automatisation COM et sans aucun runtime propriétaire requis. Elle expose une API publique propre (aspose.note.*) modélisée sur l’interface familière Aspose.Note pour .NET, soutenue par un analyseur binaire MS-ONE/OneStore intégré écrit en pur Python.

Installez depuis PyPI avec pip install aspose-note (ou pip install "aspose-note[pdf]" pour activer l’exportation PDF). Nécessite Python 3.10 ou version ultérieure.

La bibliothèque convient aux scripts d’automatisation de documents, aux pipelines d’indexation de contenu, aux outils d’archivage et à tout flux de travail côté serveur qui doit consommer le contenu OneNote sans dépendance à Microsoft Office. Pour la gamme de produits d’entreprise, voir Aspose.Note — Enterprise Product Family.

Lire et parcourir les documents OneNote

  • Charger les fichiers .one: Ouvrez n’importe quelle section OneNote à partir d’un chemin de fichier ou d’un flux binaire via Document.
  • Parcours complet du DOM: Naviguer Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Extraction de texte enrichi: Lire le texte brut via RichText.Text ou inspecter les segments TextRun pour les métadonnées de gras, italique, police, couleur et hyperlien.
  • Analyse de tableau : Parcourir les hiérarchies Table → TableRow → TableCell ; lire les largeurs de colonnes via TableColumn.Width.
  • Inspection des balises : Lire les métadonnées NoteTag (forme, étiquette, couleur, état d’achèvement) sur les nœuds de texte, d’image et de tableau.

Où Aspose.Note FOSS peut être utilisé

  • Indexation du contenu: Extraire et indexer tout le texte des archives OneNote pour les pipelines de recherche.
  • Migration de documents : Exporter les sections OneNote au format PDF, texte brut ou données structurées.
  • Outils d’archivage : Enregistrez les images intégrées et les pièces jointes sur le disque à partir des fichiers .one.
  • Flux de travail CI/CD: Valider ou traiter le contenu OneNote à l’intérieur de conteneurs Docker.
  • Pipelines de base de connaissances : Extraire le contenu structuré des blocs-notes OneNote d’équipe.

Exportation, images et pièces jointes

  • Export PDF : Enregistrez tout Document chargé au format PDF en utilisant Document.Save(path, SaveFormat.Pdf). L’édition FOSS utilise un rendu par défaut ; les options PDF avancées par page ne sont pas disponibles dans cette version.
  • Exportation d’image : Parcourez les nœuds Image pour récupérer les octets bruts (Bytes), le nom de fichier (FileName) et les dimensions (OriginalWidth, OriginalHeight).
  • Enregistrement des pièces jointes : Parcourez les nœuds AttachedFile pour enregistrer les pièces jointes de fichiers intégrés sur le disque.
  • Chargement basé sur le flux: Ouvrez les fichiers .one à partir d’un flux binaire (par ex., io.BytesIO) sans écrire sur le disque.

Expérience développeur

Aspose.Note FOSS s’installe avec une seule commande pip install aspose-note. Le paquet de base n’a aucune dépendance optionnelle ; l’export PDF nécessite ReportLab, installé via pip install "aspose-note[pdf]".

L’API est modélisée sur l’interface familière Aspose.Note pour .NET : Document, Page, Outline, RichText, Image, Table, AttachedFile. La bibliothèque est sous licence MIT, open-source, et accepte les rapports de bugs et les contributions sur GitHub.

Charger un fichier OneNote et extraire tout le texte

Installez avec pip, puis passez un chemin de fichier à Document() pour analyser le format binaire OneNote. GetChildNodes(RichText) effectue une recherche récursive profonde et renvoie chaque nœud de texte du document, ce qui est utile pour l’indexation en texte intégral ou les pipelines de migration.

pip install aspose-note

from aspose.note import Document, RichText
doc = Document("notebook.one")
print(f"Pages: {len(list(doc))}")
# Extract all text across the entire document
texts = [rt.Text for rt in doc.GetChildNodes(RichText) if rt.Text]
for text in texts:
   print(text)

Exporter en PDF et enregistrer les images jointes

L’exportation PDF nécessite la dépendance optionnelle ReportLab. Installez-le avec pip install "aspose-note[pdf]". Le même objet Document peut également être itéré pour les nœuds Image afin d’extraire et d’enregistrer toutes les images intégrées sur le disque en une seule passe.

from aspose.note import Document, SaveFormat, Image
import pathlib

doc = Document("notebook.one")

# Export the document to PDF (requires aspose-note[pdf])
doc.Save("output.pdf", SaveFormat.Pdf)

# Save all embedded images to disk
out_dir = pathlib.Path("images")
out_dir.mkdir(exist_ok=True)
for i, img in enumerate(doc.GetChildNodes(Image)):
   name = img.FileName or f"image_{i}.bin"
   (out_dir / name).write_bytes(img.Bytes)

Foire aux questions

Qu’est‑ce que Aspose.Note FOSS pour Python ?

C’est une bibliothèque Python gratuite, sous licence MIT, permettant de lire les fichiers Microsoft OneNote (.one) sans nécessiter Microsoft Office, l’automatisation COM ou tout environnement d’exécution propriétaire.

Quelles variantes de format OneNote sont prises en charge ?

OneNote 2010, OneNote Online et les variantes de format OneNote 2007. Tout fichier de section .one valide peut être chargé.

Comment l’installer ?

Exécutez pip install aspose-note pour la bibliothèque de base, ou pip install "aspose-note[pdf]" pour inclure la dépendance optionnelle ReportLab pour l’exportation PDF.

Puis-je exporter des fichiers OneNote en PDF ?

Oui. Appelez Document.Save(path, SaveFormat.Pdf). L’exportation PDF nécessite la dépendance optionnelle ReportLab installée via l’extra [pdf].

Puis-je charger des fichiers .one depuis un flux ?

Oui. La classe Document accepte un flux binaire (par ex., io.BytesIO ou un corps de réponse HTTP) afin que vous puissiez traiter les fichiers sans les écrire sur le disque.

Quelle version de Python est requise ?

Python 3.10 ou version ultérieure est requis.

Puis-je écrire ou modifier un fichier .one ?

Non. L’édition actuelle est en lecture seule. Elle peut ouvrir et analyser tout fichier de section .one valide, mais l’écriture du format binaire OneNote n’est pas prise en charge.

Les documents OneNote chiffrés sont-ils pris en charge ?

Non. Le chargement d’un fichier .one protégé par mot de passe déclenche une IncorrectPasswordException. Les documents chiffrés ne sont pas pris en charge dans l’édition actuelle.

Où puis‑je trouver le code source ?

La bibliothèque est sous licence MIT et hébergée sur GitHub. Les rapports de bugs et les pull requests sont les bienvenus.

  

Ressources de support et d'apprentissage

 Français