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

Aspose.Note FOSS for Python

Lire, parcourir et exporter les fichiers Microsoft OneNote (.one) depuis Python — gratuit et open‑source, sans Microsoft Office requis.

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

Documentation GitHub

Bibliothèque Python à code source ouvert pour les fichiers OneNote

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

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

La bibliothèque convient aux scripts d’automatisation de documents, aux pipelines d"indexation du contenu, à tous les flux de travail côté serveur qui doivent consommer le contenus OneNote sans dépendance Microsoft Office. Pour la famille de produits pour entreprises, 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 : Naviguez Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Extraction de texte enrichi : Lisez le texte brut via RichText.Text ou inspectez les segments TextRun pour les métadonnées de gras, italique, police, couleur et hyperlien.
  • Analyse des tableaux : Parcourez les hiérarchies Table → TableRow → TableCell ; lisez les largeurs de colonnes via TableColumn.Width.
  • Inspection des balises : Lisez les métadonnées NoteTag (forme, libellé, couleur, état d’achèvement) sur les nœuds de texte, d’image et de tableau.

Où Aspose.Note FOSS peut être utilisé

  • ** Indexer le contenu:** Extrait et indexez tout le texte des archives OneNote pour les pipelines de recherche.
  • Migration de document: Exporter des sections OneNote en PDF, texte brut ou données structurées.
  • Outils d’archivage: Enregistrer les images et pièces jointes intégrées sur le disque à partir des fichiers .one.
  • ** Flux de travail CI/CD:** Valider ou traiter le contenu OneNote dans les conteneurs Docker.
  • Pipelines de base de connaissances: Extrait du contenu structuré des carnets d’équipe OneNote.

Exporter, images et pièces jointes

  • Exportation 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ées 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 de 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’exportation PDF nécessite ReportLab, installé via pip install "aspose-note[pdf]".

Le API est basé sur le Aspose.Note familier pour l’interface .NET : Document, Page, Outline, RichText, Image, Table, AttachedFile. La bibliothèque est sous licence MIT, open source, et accepte les rapports de bugs ainsi que 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 approfondie et renvoie chaque nœud textuel du document, ce qui est utile pour l’indexation ou la migration des pipelines en texte complet.

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 vers PDF et enregistrer les images jointes

L’exportation PDF nécessite la dépendance ReportLab optionnelle. Installez-la 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 de sauvegarder 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 ?

Il s’agit d’une bibliothèque Python gratuite sous licence MIT pour lire des fichiers Microsoft OneNote (.one) sans nécessiter l’automatisation de Microsoft Office, COM ou tout temps d ’exécution propriétaire.

Quelles variantes de formats OneNote sont prises en charge ?

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]" afin d’inclure le rapport optionnel ReportLab dépendance pour l’exportation PDF.

Puis-je exporter des fichiers OneNote en PDF?

Oui. Appeler Document.Save(path, SaveFormat.Pdf). L’exportation PDF nécessite la dépendance de ReportLab optionnelle installée par l’intermédiaire du supplément [pdf] .

Je peux télécharger .one fichiers à partir d’un flux?

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

Quelle version de Python est nécessaire ?

Python 3.10 ou version ultérieure est requise.

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

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

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

Non. Le chargement d’un fichier protégé par mot de passe .one génère un IncorrectPasswordException. Les documents crypté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 demandes d’extraction sont bienvenus.

  

Ressources de support et d'apprentissage

 Français