Guia do Desenvolvedor

Aspose.Cells FOSS for Python is a free, open-source library for programmatic spreadsheet processing. Whether you are building data pipelines, generating automated reports, exporting ML results to Excel, or converting workbooks to Markdown for documentation pipelines, Aspose.Cells FOSS provides a comprehensive API that covers every layer of spreadsheet manipulation without requiring Microsoft Office.

Principais Recursos

Operações de Pasta de Trabalho e Planilha

Crie novas pastas de trabalho do zero ou abra arquivos XLSX ou CSV existentes. Navegue na Workbook → Worksheets → Cells → Cell hierarquia com uma API limpa e Pythonic. Adicione, renomeie e remova planilhas usando workbook.add_worksheet(name) e workbook.remove_worksheet(index_or_name). Acesse células individuais pelo endereço (ws.cells["A1"]), defina valores diretamente e itere sobre intervalos preenchidos.

Estilização e Formatação de Células

Aplique formatação granular a células individuais. Controle a família da fonte, tamanho, cor, negrito, itálico, sublinhado e tachado via a Font classe. Defina preenchimentos de fundo usando cell.style.fill.set_solid_fill("FFRRGGBB"). As cores são expressas como strings hexadecimais de 8 caracteres AARRGGBB sem um # prefixo (por exemplo,., "FFFF0000" para vermelho opaco).

Criação e Visualização de Gráficos

Adicione gráficos de coluna, linha, barra e pizza às planilhas usando métodos dedicados como ws.charts.add_bar(top_row, left_col, bottom_row, right_col) e ws.charts.add_line(...). Defina o título do gráfico como uma string (chart.title = "My Chart"), configure os dados de categoria no nível do gráfico (chart.category_data = "A2:A6"), e adicione séries nomeadas (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Suporte a Fórmulas

Insira fórmulas compatíveis com Excel definindo cell.formula = "=SUM(A1:A5)" ou construindo um Cell(None, "=SUM(A1:A5)") e atribuindo-o à coleção de células.

Exportação Multi-Formato

Exporte pastas de trabalho para XLSX, CSV, TSV, Markdown e JSON usando um único workbook.save(path) chamada. Use SaveFormat constantes para controle explícito: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Use MarkdownSaveOptions para saída de Markdown de granulação fina (alinhamento, nível de cabeçalho, índice da planilha). Use MarkdownHandler.save_markdown_to_string(wb) para geração de Markdown em memória.

Nota: Aspose.Cells FOSS exporta para XLSX, CSV, TSV, Markdown e JSON. Exportação para PDF, HTML, PNG, TIFF, DOCX e PPTX não faz parte da biblioteca FOSS.

Ecossistema de Plugins

O opcional markitdown-aspose-cells-plugin pacote integra-se à biblioteca MarkItDown da Microsoft para adicionar suporte à leitura de XLSX. Instale-o com pip install markitdown-aspose-cells-plugin e use-o de forma transparente via o MarkItDown API.

Começando

Instalar 

pip install aspose-cells-foss

Olá Mundo 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Hello, Aspose.Cells FOSS!"
ws.cells["A2"].value = 42
workbook.save("hello.xlsx")

Exportar para Markdown 

from aspose.cells_foss import Workbook, Cell

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
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88

workbook.save_as_markdown("results.md")

Criar um Gráfico de Colunas 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

data = [("Q1", 50), ("Q2", 100), ("Q3", 170), ("Q4", 300)]
for i, (label, value) in enumerate(data):
    ws.cells[f"A{i+2}"].value = label
    ws.cells[f"B{i+2}"].value = value

chart = ws.charts.add_bar(6, 0, 20, 8)
chart.title = "Quarterly Revenue"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")

workbook.save("chart.xlsx")

Estilizar Células 

from aspose.cells_foss import Workbook, Cell, Font

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"] = Cell("Revenue Report")

cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FFFFFFFF"   # White text (AARRGGBB, no #)
cell.style.fill.set_solid_fill("FF1E64C8")  # Blue background

workbook.save("styled.xlsx")

Guias Disponíveis

Veja Também

 Português