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

Aspose.Note FOSS for Python

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

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

Documentação GitHub

Biblioteca Python de código aberto para arquivos do OneNote

FOSS para Python é uma biblioteca 100% gratuita, licenciada pelo MIT que permite ler arquivos do Microsoft OneNote (.one) inteiramente a partir de Python, sem o Office da Microsoft, nenhuma automação COM e nenhum tempo de execução proprietário necessário. Ele expõe uma API pública limpa (aspose.note.*) modelada na familiar Aspose.Note para interface .NET, apoiado por um parser binário MS-ONE / OneStore embuído escrito em Python puro.

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

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

Leia e passeie documentos do OneNote

  • ** Carregar .um arquivo:** Abrir qualquer secção do OneNote a partir de um caminho ou fluxo binário através Document.
  • Viagem completa DOM: Navega Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • ** Extração de texto rico:** Leia o texto bruto através do RichText.Text ou inspecione os segmentos TextRun para obter metadados negros, itálicos, fonte, cor e hiperlink.
  • ** Análise de tabela:** Irradas transversais Table → TableRow → TableCell; ler largura das colunas via TableColumn.Width.
  • ** Inspeção de etiquetas:** Ler os metadados NoteTag (forma, rótulo, cor, estado de conclusão) sobre texto, imagem e nós da tabela.

Onde Aspose.Note FOSS pode ser usado

  • Indexação de conteúdo: Extrair e indexar todo o texto dos arquivos do OneNote para os canais de pesquisa.
  • Migração de documentos: Exportar secções do OneNote para PDF, texto simples ou dados estruturados.
  • ** Ferramentas de arquivo:** Salvar imagens e anexos incorporados no disco a partir dos ficheiros .one.
  • ** Fluxos de trabalho CI/CD:** Validar ou processar o conteúdo do OneNote dentro dos containers Docker.
  • Pipelines de base de conhecimentos: Extrair conteúdo estruturado dos notebooks da equipe OneNote.

Exportação, Imagens e Anexos

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

Experiência de 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]".

O API é modelado com base no familiar Aspose.Note para a interface .NET: 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 do OneNote e extrair todo o texto

Instalar com pip, em seguida passar um caminho de arquivo para Document() para analisar o formato binário do OneNote. GetChildNodes(RichText) realiza uma pesquisa recursiva profunda e retorna cada nó de texto no documento, que é útil para indexação de todo o texto ou tubulações 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 anexadas

A exportação 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 os nós Image 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 pelo MIT para leitura de arquivos Microsoft OneNote (.one) sem exigir o Microsoft Office, a automação COM ou qualquer tempo de execução proprietário.

Quais as variantes de formato do OneNote suportadas?

OneNote 2010, OneNOte Online e variantes de formato do OneNot 2007. Qualquer ficheiro válido .one pode ser carregado.

Como é que o instalo?

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

Posso exportar arquivos do OneNote para o PDF?

Sim. Chama Document.Save(path, SaveFormat.Pdf). A exportação PDF requer a dependência opcional ReportLab instalada através do extra [pdf] .

Posso carregar ficheiros .one 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 escrever no disco .

Que versão do Python é necessária?

É necessário Python 3.10 ou posterior.

Posso escrever ou modificar um arquivo .one?

Não. A edição atual é somente leitura. Pode abrir e analisar qualquer ficheiro de secções .one válido, mas não suporta a escrita para o formato binário do OneNote.

Os documentos do OneNote criptografados são suportados?

Não. Carregar um ficheiro .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 é licenciada pelo MIT e hospedada no GitHub. Os relatórios de bugs e solicitações de extração são bem-vindos.

  

Recursos de Suporte e Aprendizado

 Português