Como salvar arquivos anexados do OneNote em Python

Arquivos OneNote .one podem conter anexos de arquivos incorporados: qualquer tipo de arquivo que foi inserido em uma página usando Inserir → Anexo de Arquivo no OneNote. O Aspose.Note FOSS para Python expõe esses através da classe AttachedFile, que fornece o nome original do arquivo e os bytes brutos do arquivo incorporado.

Pré-requisitos

pip install aspose-note

Etapa 1: Carregar o Documento

from aspose.note import Document

doc = Document("MyNotes.one")

Passo 2: Encontrar Todos os Arquivos Anexados

Use GetChildNodes(AttachedFile) para coletar recursivamente todos os anexos no documento, independentemente da página ou do contorno em que eles aparecem:

from aspose.note import Document, AttachedFile

doc = Document("MyNotes.one")
attachments = doc.GetChildNodes(AttachedFile)
print(f"Found {len(attachments)} attachment(s)")

Etapa 3: Salvar cada anexo no disco

Acesse af.Bytes para o conteúdo bruto do arquivo e af.FileName para o nome original. Sempre proteja contra um nome de arquivo None: a biblioteca retorna None quando os metadados do nome do arquivo não foram armazenados no arquivo:

from aspose.note import Document, AttachedFile

doc = Document("MyNotes.one")

for i, af in enumerate(doc.GetChildNodes(AttachedFile), start=1):
    name = af.FileName or f"attachment_{i}.bin"
    with open(name, "wb") as f:
        f.write(af.Bytes)
    print(f"Saved: {name} ({len(af.Bytes):,} bytes)")

Exemplo completo

Este script extrai todos os anexos de um arquivo .one e os salva em um diretório de saída dedicado:

from pathlib import Path
from aspose.note import Document, AttachedFile

def save_all_attachments(one_path: str, out_dir: str = "attachments") -> None:
    doc = Document(one_path)
    out = Path(out_dir)
    out.mkdir(exist_ok=True)

    attachments = doc.GetChildNodes(AttachedFile)
    if not attachments:
        print("No attachments found.")
        return

    for i, af in enumerate(attachments, start=1):
        name = af.FileName or f"attachment_{i}.bin"
        dest = out / name
        dest.write_bytes(af.Bytes)
        print(f"  [{i}] {name}  ({len(af.Bytes):,} bytes)")

    print(f"\nSaved {len(attachments)} file(s) to '{out_dir}/'")

save_all_attachments("MyNotes.one")

Notas

af.Bytes retorna b"" (bytes vazios) quando os dados do anexo não puderam ser analisados a partir do arquivo binário. Verifique len(af.Bytes) > 0 antes de salvar se quiser ignorar anexos vazios.
af.Tags é uma lista de objetos NoteTag se o anexo tiver alguma tag do OneNote aplicada a ele.
Aspose.Note FOSS for Python lê arquivos .one mas não grava de volta em .one. Você não pode criar ou modificar anexos.