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

Aspose.Note FOSS para Python

Leia, percorra e exporte arquivos Microsoft OneNote (.one) a partir de Python — gratuito e de código aberto, sem necessidade de Microsoft Office.

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

Documentação GitHub

Biblioteca Python de código aberto para arquivos OneNote

Aspose.Note FOSS para Python é uma biblioteca 100% gratuita, licenciada sob MIT, que permite ler arquivos Microsoft OneNote (.one) totalmente a partir de Python, sem Microsoft Office, sem automação COM e sem necessidade de runtime proprietário. Ela expõe uma API pública limpa (aspose.note.*) modelada na familiar interface Aspose.Note para .NET, suportada por um analisador binário MS-ONE/OneStore embutido escrito em puro Python.

Instale a partir do PyPI com pip install aspose-note (ou pip install "aspose-note[pdf]" para habilitar a exportação de PDF). Requer Python 3.10 ou posterior.

A biblioteca é adequada para scripts de automação de documentos, pipelines de indexação de conteúdo, ferramentas de arquivamento e qualquer fluxo de trabalho do lado do servidor que precise consumir conteúdo do OneNote sem depender do Microsoft Office. Para a família de produtos empresariais, veja Aspose.Note — Enterprise Product Family.

Leia e percorra documentos OneNote

  • Carregar arquivos .one: Abra qualquer seção do OneNote a partir de um caminho de arquivo ou fluxo binário via Document.
  • Travessia completa do DOM: Navegue Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Extração de texto rico: Leia o texto bruto via RichText.Text ou inspecione segmentos TextRun para metadados de negrito, itálico, fonte, cor e hiperlink.
  • Análise de tabela: Percorrer hierarquias Table → TableRow → TableCell; ler larguras de coluna via TableColumn.Width.
  • Inspeção de tags: Leia os metadados NoteTag (forma, rótulo, cor, estado de conclusão) em nós de texto, imagem e tabela.

Onde Aspose.Note FOSS pode ser usado

  • Indexação de conteúdo: Extraia e indexe todo o texto de arquivos OneNote para pipelines de pesquisa.
  • Migração de documentos: Exportar seções do OneNote para PDF, texto simples ou dados estruturados.
  • Ferramentas de arquivamento: Salvar imagens incorporadas e anexos no disco a partir de arquivos .one.
  • CI/CD workflows: Validar ou processar conteúdo do OneNote dentro de contêineres Docker.
  • Pipelines de base de conhecimento: Extraia conteúdo estruturado dos blocos de anotações do OneNote da equipe.

Exportar, imagens e anexos

  • Exportação de PDF: Salve qualquer Document carregado em PDF usando Document.Save(path, SaveFormat.Pdf). A edição FOSS usa uma renderização padrão; opções avançadas de PDF por página não estão disponíveis nesta versão.
  • Exportação de imagem: Iterar nós Image para recuperar bytes brutos (Bytes), nome de arquivo (FileName) e dimensões (OriginalWidth, OriginalHeight).
  • Salvamento de anexos: Iterar nós AttachedFile para salvar anexos de arquivos incorporados no disco.
  • Carregamento baseado em fluxo: Abra arquivos .one a partir de um fluxo binário (por exemplo, io.BytesIO) sem gravar no disco.

Experiência do desenvolvedor

Aspose.Note FOSS instala com um único comando pip install aspose-note. O pacote base não tem dependências opcionais; a exportação de PDF requer ReportLab, instalado via pip install "aspose-note[pdf]".

A API é modelada na familiar Aspose.Note para .NET interface: Document, Page, Outline, RichText, Image, Table, AttachedFile. A biblioteca tem licença MIT, é de código aberto e aceita relatórios de bugs e contribuições no GitHub.

Carregar um arquivo OneNote e extrair todo o texto

Instale com pip, depois passe um caminho de arquivo para Document() para analisar o formato binário do OneNote. GetChildNodes(RichText) realiza uma busca recursiva profunda e retorna cada nó de texto no documento, o que é útil para indexação de texto completo ou pipelines de migração.

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)

Exportar para PDF e Salvar Imagens Anexas

A exportação de PDF requer a dependência opcional ReportLab. Instale-a com pip install "aspose-note[pdf]". O mesmo objeto Document também pode ser iterado para nós Image a fim de extrair e salvar todas as imagens incorporadas no disco em uma única passagem.

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)

Perguntas Frequentes

O que é Aspose.Note FOSS para Python?

É uma biblioteca Python gratuita, licenciada sob MIT, para ler arquivos Microsoft OneNote (.one) sem exigir Microsoft Office, automação COM ou qualquer runtime proprietário.

Quais variantes de formato do OneNote são suportadas?

OneNote 2010, OneNote Online e variantes de formato do OneNote 2007. Qualquer arquivo de seção .one válido pode ser carregado.

Como faço para instalá-lo?

Execute pip install aspose-note para a biblioteca base, ou pip install "aspose-note[pdf]" para incluir a dependência opcional ReportLab para exportação de PDF.

Posso exportar arquivos do OneNote para PDF?

Sim. Chame Document.Save(path, SaveFormat.Pdf). A exportação de PDF requer a dependência opcional ReportLab instalada via o extra [pdf].

Posso carregar arquivos .one a partir de um stream?

Sim. A classe Document aceita um fluxo binário (por exemplo, io.BytesIO ou um corpo de resposta HTTP) para que você possa processar arquivos sem gravá‑los no disco.

Qual versão do Python é necessária?

Python 3.10 ou posterior é necessário.

Posso escrever ou modificar um arquivo .one?

Não. A edição atual é somente leitura. Ela pode abrir e analisar qualquer arquivo de seção .one válido, mas gravar de volta no formato binário do OneNote não é suportado.

Documentos do OneNote criptografados são suportados?

Não. Carregar um arquivo .one protegido por senha gera um IncorrectPasswordException. Documentos criptografados não são suportados na edição atual.

Onde posso encontrar o código-fonte?

A biblioteca tem licença MIT e está hospedada no GitHub. Relatórios de bugs e pull requests são bem‑vindos.

  

Recursos de Suporte e Aprendizado

 Português