Introdução

Trabalhar com planilhas do Excel de forma programática é um requisito comum no processamento de dados, relatórios e fluxos de trabalho de automação. Aspose-cells-foss é uma biblioteca Python de código aberto que permite criar, ler e modificar. .xlsx Livros de trabalho sem qualquer dependência do Microsoft Excel ou outras suítes de escritório.

Emissão sob o n? 2 do artigo 8? Licença MIT, aspose-cells-foss fornece uma rica superfície de API cobrindo valores de células, fórmulas, estilo, gráficos, tabelas, formas, imagens, validação de dados, comentários, hiperlinks, filtros automáticos e formatação condicional. A biblioteca requer Python 3.7 ou superior e é instalada com um único sistema de configuração em formato PDF. pip Comando.

Este post percorre as capacidades de gerenciamento de planilha que aspose-cells-foss traz para seus projetos Python, com exemplos de código funcional baseados na API real.

O que está incluído

Valores e fórmulas de célula

A Comissão Cell classe suporta inteiros, flutuantes, strings e fórmulas. Você pode definir um valor diretamente através de put_value() ou atribuir uma sequência de fórmulas ao formula A propriedade. FormulaEvaluator A classe pode avaliar fórmulas programaticamente.

from aspose.cells_foss import Workbook, Cell

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

# Set different value types
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14159)
ws.cells["A3"] = Cell("Revenue Report")

# Set a formula
ws.cells["A4"] = Cell(None, "=SUM(A1:A2)")

# Check the stored values
print(ws.cells["A1"].value)    # 42
print(ws.cells["A4"].formula)  # =SUM(A1:A2)

Estilo e formato

A Comissão Style classe fornece métodos para preenchimentos, bordas, formatos de números e alinhamento. Aplique um estilo a qualquer célula com Cell.apply_style().

from aspose.cells_foss import Workbook, Cell, Style

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"] = Cell("Total")
ws.cells["B1"] = Cell(25000)

style = Style()
style.set_fill_color("FFD9E1F2")
style.set_border("bottom", "thin", "FF000000", 1)
style.set_number_format("#,##0.00")
ws.cells["B1"].apply_style(style)

wb.save("styled_report.xlsx")

Gráficos

A Comissão ChartCollection Oferta de classes dedicadas a: add_line(), add_bar(), add_pie(), add_scatter(), e muitos outros métodos para inserir gráficos em uma planilha. Uma vez criado, configure o Chart Título, legenda, dados de categoria e série do objeto.

from aspose.cells_foss import Workbook

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

# Populate data
months = ["Jan", "Feb", "Mar", "Apr"]
sales = [120, 150, 180, 200]
for i, (m, s) in enumerate(zip(months, sales), 2):
    ws.cells[f"A{i}"].value = m
    ws.cells[f"B{i}"].value = s
ws.cells["A1"].value = "Month"
ws.cells["B1"].value = "Sales"

# Create a line chart
chart = ws.charts.add_line(0, 4, 20, 12)
chart.title = "Monthly Sales"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Sales")
chart.show_legend = True

wb.save("sales_chart.xlsx")

Validação de dados

A Comissão DataValidation class permite que você aplique listas suspensas, intervalos de números e regras de validação personalizadas em intervals de células. As propriedades incluem: type, operator, formula1, formula2, alert_style, error_title, e error_message.

from aspose.cells_foss import Workbook

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

# Add a dropdown validation
dv = ws.data_validations.add("B2:B100")
dv.type = 3       # List validation
dv.formula1 = '"Yes,No,Pending"'
dv.show_error_message = True
dv.error_title = "Invalid Entry"
dv.error_message = "Please select Yes, No, or Pending."

wb.save("validated.xlsx")

Filtros e tabelas automáticos

Aplicar o filtro automático com a AutoFilter classe por telefone set_range() Para dados estruturados, o sistema de cálculo da data é a base do processo. TableCollection.add() O método cria tabelas ListObject com estilos e filtros automáticos.

from aspose.cells_foss import Workbook

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

# Populate header + data
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
for i, (n, s) in enumerate([("Alice", 92), ("Bob", 78), ("Carol", 95)], 2):
    ws.cells[f"A{i}"].value = n
    ws.cells[f"B{i}"].value = s

# Apply an auto-filter
ws.auto_filter.set_range(0, 0, 3, 1)

# Or create a structured table
table = ws.tables.add(0, 0, 3, 1, True, "ScoreTable")

wb.save("filtered_data.xlsx")

Proteção de folhas e livros de trabalho

Proteger os quadros de trabalho com: Workbook.protect() e folhas de cálculo individuais com: Worksheet.protect().A API de proteção suporta permissões granulares, como permitir a formatação ou inserir linhas enquanto bloqueia exclusões.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Protected content"

# Protect the worksheet with a password
ws.protect("secret123", format_cells=True, insert_rows=True,
           delete_columns=False, delete_rows=False)

# Protect the workbook structure
wb.protect("workbook_pass", lock_structure=True, lock_windows=False)
wb.save("protected.xlsx")

Começo rápido

Instalar o pacote a partir do PyPI:

pip install aspose-cells-foss>=26.3.1

Crie uma pasta de trabalho, preencha alguns dados e salve-os:

from aspose.cells_foss import Workbook, Cell, Style

# Create a new workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Quarterly Report"

# Add headers with styling
header_style = Style()
header_style.set_fill_color("FF4472C4")
for col, label in enumerate(["Region", "Q1", "Q2", "Q3", "Q4"], 1):
    cell_ref = f"{chr(64 + col)}1"
    ws.cells[cell_ref] = Cell(label)
    ws.cells[cell_ref].apply_style(header_style)

# Add data rows
data = [
    ("North", 12000, 15000, 13000, 16000),
    ("South", 9000, 11000, 10500, 12000),
    ("East", 14000, 13500, 15000, 17000),
]
for r, row in enumerate(data, 2):
    for c, val in enumerate(row, 1):
        ws.cells[f"{chr(64 + c)}{r}"].value = val

# Save as XLSX
wb.save("quarterly_report.xlsx")

# Also export to CSV
wb.save_as_csv("quarterly_report.csv")

Formatos suportados

Formatos de imagemExtensãoLeia.Escrever .
XLSX.xlsx- Sim , sim .- Sim , sim .
CSV.csv- Sim , sim .- Sim , sim .
TSV.tsvNão, não.- Sim , sim .
JSON.jsonNão, não.- Sim , sim .
Marca de desvio.mdNão, não.- Sim , sim .

A Comissão SaveFormat enum define estes formatos de saída: AUTO, XLSX, CSV, TSV, MARKDOWN, e JSON.A biblioteca lê: .xlsx arquivos nativos e pode importar dados CSV através de Workbook.load_csv().

Open Source & Licenciamento

Aspose-cells-foss é liberado sob a forma de Licença MIT,O código-fonte está disponível no sítio Web www.codesign.org/en/, que permite a utilização ilimitada em projectos comerciais e não comerciais. GitHub.A biblioteca depende de … pycryptodome (>= 3,15,0) e olefile (>= 0,46) para o suporte à encriptação.

Começar a Fazer

Explore a documentação completa e o material de referência para começar a construir com aspose-cells-foss: