Ghid pentru dezvoltatori

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.

Funcționalități cheie

Operații cu registru de lucru și foi de lucru

Creează noi registre de lucru de la zero sau deschide fișiere XLSX sau CSV existente. Navighează în Workbook → Worksheets → Cells → Cell ierarhia cu un API curat, Pythonic. Adaugă, redenumește și elimină foi de lucru utilizând workbook.add_worksheet(name) și workbook.remove_worksheet(index_or_name). Accesează celulele individuale prin adresă (ws.cells["A1"]), setează valorile direct și iterează peste intervalele populate.

Stilizare și formatare a celulelor

Aplică formatare granulară celulelor individuale. Controlează familia fontului, dimensiunea, culoarea, îngroșarea, cursiva, sublinierea și tăierea prin intermediul Font clasei. Setează umpleri de fundal utilizând cell.style.fill.set_solid_fill("FFRRGGBB"). Culorile sunt exprimate ca șiruri hexazecimale de 8 caractere AARRGGBB fără un # prefix (de ex., "FFFF0000" pentru roșu opac).

Crearea și vizualizarea diagramelor

Adaugă grafice de tip coloană, linie, bară și plăcintă în foi de lucru utilizând metode dedicate, cum ar fi ws.charts.add_bar(top_row, left_col, bottom_row, right_col) și ws.charts.add_line(...). Setați titlul graficului ca un șir (chart.title = "My Chart") configurați datele de categorie la nivelul graficului (chart.category_data = "A2:A6") și adăugați serii numite (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Suport pentru formule

Introduceți formule compatibile cu Excel prin setarea cell.formula = "=SUM(A1:A5)" sau construind un Cell(None, "=SUM(A1:A5)") și atribuindu-l colecției de celule.

Export multi-format

Exportați registrele de lucru în XLSX, CSV, TSV, Markdown și JSON utilizând un singur workbook.save(path) apel. Utilizați SaveFormat constante pentru control explicit: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Utilizați MarkdownSaveOptions pentru ieșire Markdown detaliată (aliniere, nivel de titlu, index de foaie de lucru). Utilizați MarkdownHandler.save_markdown_to_string(wb) pentru generarea Markdown în memorie.

Notă: Aspose.Cells FOSS exportă în XLSX, CSV, TSV, Markdown și JSON. Exportul în PDF, HTML, PNG, TIFF, DOCX și PPTX nu face parte din biblioteca FOSS.

Ecosistem de pluginuri

Opționalul markitdown-aspose-cells-plugin pachet se integrează cu biblioteca MarkItDown de la Microsoft pentru a adăuga suport de citire XLSX. Instalați-l cu pip install markitdown-aspose-cells-plugin și folosiți-l transparent prin MarkItDown API.

Începeți

Instalare 

pip install aspose-cells-foss

Salut, lume 

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

Exportă în 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")

Creează un grafic cu coloane 

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

Stilizează celulele 

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

Ghiduri disponibile

Vezi și

 Română