Guia de Desenvolvedores

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.

Características principais

Operações de folhas e blocos de trabalho

Crie novas pastas de trabalho a partir do zero, adicione folhas de cálculo e exporte para XLSX ou CSV. Navegue no Workbook → Worksheets → Cells → Cell hierarquia com uma API Python limpa. Adicionar, renomear e remover folhas de trabalho usando o workbook.add_worksheet(name) e a) workbook.remove_worksheet(index_or_name).Acesso a células individuais por endereço (ws.cells["A1"]), definir valores diretamente e iterar sobre intervalos preenchidos.

Estilo e formatação de células

Aplicar formatação granular a células individuais. Controle família de fontes, tamanho, cor, negrito, itálico, sublinhado e marcado através do botão “Corre” da página web. Font classe. Configurar preenchimentos de fundo usando cell.style.fill.set_solid_fill("FFRRGGBB").As cores são expressas como cadeias hexagonais de 8 caracteres AARRGGBB sem um código-fonte. # Prefixo (por exemplo,., "FFFF0000" para vermelho opaco).

Criação e visualização de gráficos

Adicionar coluna, linha, barra e gráficos em torta para folhas de trabalho usando métodos dedicados como: ws.charts.add_bar(top_row, left_col, bottom_row, right_col) e a) ws.charts.add_line(...).Configurar o título do gráfico como uma cadeia de caracteres (chart.title = "My Chart"), configurar dados de categoria a nível gráfico (chart.category_data = "A2:A6"), e acrescentar séries nomeadas (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Suporte à fórmula

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

Exportação em vários formatos

Exportar livros de trabalho para XLSX, CSV, Markdown e JSON usando um único workbook.save(path) - Não, não. SaveFormat Constantes para controlo explícito: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.MARKDOWN, SaveFormat.JSON.- Usar . MarkdownSaveOptions para a saída de Markdown com grãos finos (alinhamento, nível de cabeçalho, índice da folha de cálculo). MarkdownHandler.save_markdown_to_string(wb) para a geração de Markdown na memória. Ver Exemplos de formato de exportação para código pronto a utilizar e Solução de problemas na exportação para dicas e perguntas frequentes.

Nota:: A biblioteca FOSS abrange formatos de planilha e marcação. Funções avançadas de renderização e conversão de documentos estão disponíveis na edição comercial.

Ecossistema de plugins

O opcional markitdown-aspose-cells-plugin Instale-o para adicionar suporte de leitura de planilha através do MarkItDown API. Instala-o com o pip install markitdown-aspose-cells-plugin e utilizá-la de forma transparente através da MarkItDown API.

Começar a Fazer

Instalar

Instalar o pacote a partir de PyPI usando pip antes de importar qualquer aspose.cells_foss classes nos seus scripts Python:

pip install aspose-cells-foss

Olá Mundo .

Criar um Workbook, definir um valor de célula, e chamar workbook.save() para escrever um arquivo XLSX:

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")

Exportação para Markdown

Chama-me . workbook.save_as_markdown() com um caminho de saída para exportar a primeira planilha como uma tabela de Marcação:

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")

Crie um gráfico de colunas

Escrever dados em células de folha de cálculo, chamar ws.charts.add_bar() com os limites de colocação do gráfico, configure o intervalo de título e categoria e salve a pasta de trabalho:

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")

Células de estilo

Configurar propriedades de fonte (enrolado, tamanho, cor) e preencher o fundo da célula modificando cell.style.font e a) cell.style.fill antes de guardar:

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")

Guia disponível

Ver também:

 Português