Guida per sviluppatori

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.

Caratteristiche principali

Operazioni su cartelle di lavoro e fogli di lavoro

Crea nuove cartelle di lavoro da zero o apri file XLSX o CSV esistenti. Naviga la Workbook → Worksheets → Cells → Cell gerarchia con un’API pulita e Pythonica. Aggiungi, rinomina e rimuovi fogli di lavoro usando workbook.add_worksheet(name) e workbook.remove_worksheet(index_or_name). Accedi alle singole celle per indirizzo (ws.cells["A1"]), imposta i valori direttamente e itera sui range popolati.

Stile e formattazione delle celle

Applica formattazione granulare alle singole celle. Controlla la famiglia del font, la dimensione, il colore, il grassetto, il corsivo, la sottolineatura e il barrato tramite il Font classe. Imposta i riempimenti di sfondo usando cell.style.fill.set_solid_fill("FFRRGGBB"). I colori sono espressi come stringhe esadecimali a 8 caratteri AARRGGBB senza un # prefisso (ad esempio,., "FFFF0000" per rosso opaco).

Creazione e visualizzazione di grafici

Aggiungi grafici a colonne, a linee, a barre e a torta ai fogli di lavoro usando metodi dedicati come ws.charts.add_bar(top_row, left_col, bottom_row, right_col) e ws.charts.add_line(...). Imposta il titolo del grafico come stringa (chart.title = "My Chart"), configura i dati di categoria a livello di grafico (chart.category_data = "A2:A6"), e aggiungi serie nominate (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Supporto alle formule

Inserisci formule compatibili con Excel impostando cell.formula = "=SUM(A1:A5)" o costruendo un Cell(None, "=SUM(A1:A5)") e assegnandolo alla raccolta di celle.

Esportazione multiformato

Esporta le cartelle di lavoro in XLSX, CSV, TSV, Markdown e JSON usando un unico workbook.save(path) chiamata. Usa SaveFormat costanti per il controllo esplicito: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Usa MarkdownSaveOptions per un output Markdown a grana fine (allineamento, livello di intestazione, indice del foglio di lavoro). Usa MarkdownHandler.save_markdown_to_string(wb) per la generazione di Markdown in memoria.

Nota: Aspose.Cells FOSS esporta in XLSX, CSV, TSV, Markdown e JSON. L’esportazione in PDF, HTML, PNG, TIFF, DOCX e PPTX non fa parte della libreria FOSS.

Ecosistema dei plugin

L’opzionale markitdown-aspose-cells-plugin pacchetto si integra con la libreria MarkItDown di Microsoft per aggiungere il supporto alla lettura di XLSX. Installalo con pip install markitdown-aspose-cells-plugin e usalo in modo trasparente tramite il MarkItDown API.

Per iniziare

Installa 

pip install aspose-cells-foss

Ciao Mondo 

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

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

Crea un grafico a colonne 

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

Stilizza le celle 

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

Guide disponibili

Vedi anche

 Italiano