Aspose.Cells FOSS
Python
Guia do Desenvolvedor
Features

Exportação de Formato de Planilha para Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() a chamada lida com todo o pipeline de saída — XLSX, CSV, TSV, Markdown ou JSON — preservando valores de células e fórmulas sem exigir o Microsoft Office.

Instalação e Configuração 

pip install aspose-cells-foss

Importe as classes principais:

from aspose.cells_foss import Workbook, SaveFormat, Cell
from aspose.cells_foss import MarkdownHandler, MarkdownSaveOptions
from aspose.cells_foss import CSVSaveOptions

Formatos de Saída Suportados

FormatoConstante SaveFormatObservações
XLSXSaveFormat.XLSXFormato padrão; preserva estilos, fórmulas, gráficos
CSVSaveFormat.CSVSeparado por vírgulas; apenas a primeira planilha por padrão
TSVSaveFormat.TSVValores separados por tabulação
MarkdownSaveFormat.MARKDOWNGera tabelas Markdown padrão
JSONSaveFormat.JSONRepresentação JSON estruturada dos dados da planilha

Importante: Aspose.Cells FOSS faz não suporta exportação para PDF, HTML, PNG, TIFF, DOCX ou PPTX. Estes estão disponíveis apenas no pacote comercial aspose-cells-python apenas.

Exemplos de Uso

Salvar como XLSX

O formato padrão ao salvar com um .xlsx extensão:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750

workbook.save("report.xlsx")

Salvar como CSV 

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save("data.csv", SaveFormat.CSV)

Salvar como Markdown

Exporte dados tabulares como tabelas Markdown — útil para documentação e geração de README:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "First name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save_as_markdown("data.md")

A saída é uma tabela Markdown padrão:

| First name | Age |
|---|---|
| Alice | 30 |
| Bob | 25 |

Markdown com Opções

Use MarkdownSaveOptions para controle granular:

from aspose.cells_foss import Workbook, Cell, MarkdownSaveOptions

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "City"
ws.cells["B1"].value = "Population"
ws.cells["A2"].value = "London"
ws.cells["B2"].value = 9000000

options = MarkdownSaveOptions()

workbook.save_as_markdown("cities.md", options)

Markdown para String (em memória)

Gere uma string Markdown sem gravar no disco:

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Key"
ws.cells["B1"].value = "Value"
ws.cells["A2"].value = "version"
ws.cells["B2"].value = "26.3.0"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)

Salvar em JSON

Exportar dados da pasta de trabalho como JSON estruturado para pipelines de API:

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95.5
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88.0

workbook.save("data.json", SaveFormat.JSON)

Carregar um CSV e salvar como XLSX 

from aspose.cells_foss import Workbook, SaveFormat

workbook = Workbook()
workbook.load_csv("input.csv")
workbook.save("output.xlsx", SaveFormat.XLSX)

Dicas e Melhores Práticas

Exportação Markdown

  • Use MarkdownHandler.save_markdown_to_string(wb) para casos de uso em memória, como respostas de API.

Exportação CSV

  • A exportação CSV grava a primeira planilha por padrão.
  • Caracteres especiais (vírgulas, quebras de linha) nos valores das células são automaticamente colocados entre aspas.

Exportação JSON

  • A exportação JSON usa endereços de células como chaves. Adequada para intercâmbio de dados; fórmulas complexas são armazenadas como suas expressões em string.

Problemas Comuns e Resoluções

ProblemaResolução
ModuleNotFoundError: No module named 'aspose.cells_foss'Executar pip install aspose-cells-foss e confirme se o ambiente virtual está ativo
AttributeError em SaveFormat.PDFA exportação de PDF não está na biblioteca FOSS; use SaveFormat.MARKDOWN ou SaveFormat.XLSX em vez disso
Saída Markdown vaziaCertifique‑se de que ao menos uma célula na planilha tenha um valor antes de salvar
Problemas de codificação no MarkdownUse MarkdownHandler.save_markdown_to_string() para saída de string em memória com controle total de codificação

Perguntas Frequentes

Quais formatos de saída o Aspose.Cells FOSS suporta? XLSX, CSV, TSV, Markdown e JSON.

Posso converter para PDF? Não. A exportação para PDF requer o comercial aspose-cells-python pacote. Aspose.Cells FOSS exporta apenas para XLSX, CSV, TSV, Markdown e JSON.

Posso carregar um XLSX existente e salvá-lo novamente como Markdown? Sim. Workbook("existing.xlsx") carrega o arquivo e workbook.save_as_markdown("output.md") exporta-o.

A saída de Markdown baseada em stream é suportada? Sim. Use MarkdownHandler.save_markdown_to_string(workbook) para obter o Markdown como uma string Python sem qualquer I/O de arquivo.

Quais versões do Python são suportadas? Python 3.7 e posteriores.

Veja Também

 Português