Príručka pre vývojárov

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.

Kľúčové funkcie

Operácie s pracovnými zošismi a hárkami

Vytvorte nové zošity od začiatku alebo otvorte existujúce súbory XLSX alebo CSV. Navigujte v Workbook → Worksheets → Cells → Cell hierarchiu pomocou čistého, Pythonického API. Pridávajte, premenúvajte a odstraňujte hárky pomocou workbook.add_worksheet(name) a workbook.remove_worksheet(index_or_name). Pristupujte k jednotlivým bunkám podľa adresy (ws.cells["A1"]), nastavujte hodnoty priamo a iterujte cez vyplnené rozsahy.

Štýlovanie a formátovanie buniek

Používajte detailné formátovanie jednotlivých buniek. Ovládajte rodinu písma, veľkosť, farbu, tučné, kurzívu, podčiarknutie a prečiarknutie pomocou Font triedy. Nastavte pozadie pomocou cell.style.fill.set_solid_fill("FFRRGGBB"). Farby sú vyjadrené ako 8-znakové hexadecimálne reťazce AARRGGBB bez # predpony (napr.., "FFFF0000" pre nepriehľadnú červenú).

Vytváranie a vizualizácia grafov

Pridajte stĺpcové, čiarové, pruhové a koláčové grafy do hárkov pomocou špecializovaných metód, ako je ws.charts.add_bar(top_row, left_col, bottom_row, right_col) a ws.charts.add_line(...). Nastavte názov grafu ako reťazec (chart.title = "My Chart"), nakonfigurujte kategóriové údaje na úrovni grafu (chart.category_data = "A2:A6"), a pridajte pomenované série (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Podpora vzorcov

Zadajte Excel-kompatibilné vzorce nastavením cell.formula = "=SUM(A1:A5)" alebo konštruovať Cell(None, "=SUM(A1:A5)") a priradením do kolekcie buniek.

Export vo viacerých formátoch

Exportujte zošity do XLSX, CSV, TSV, Markdown a JSON pomocou jedného workbook.save(path) volania. Použite SaveFormat konštanty pre explicitnú kontrolu: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Použite MarkdownSaveOptions pre detailný výstup Markdown (zarovnanie, úroveň nadpisu, index pracovného hárku). Použite MarkdownHandler.save_markdown_to_string(wb) pre generovanie Markdown v pamäti.

Poznámka: Aspose.Cells FOSS exportuje do XLSX, CSV, TSV, Markdown a JSON. Export do PDF, HTML, PNG, TIFF, DOCX a PPTX nie je súčasťou knižnice FOSS.

Ekosystém pluginov

Voliteľný markitdown-aspose-cells-plugin balík integruje s knižnicou Microsoft MarkItDown a pridáva podporu čítania XLSX. Nainštalujte ho pomocou pip install markitdown-aspose-cells-plugin a používajte ho transparentne cez MarkItDown API.

Začíname

Inštalovať 

pip install aspose-cells-foss

Ahoj svet 

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

Exportovať do Markdownu 

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

Vytvoriť stĺpcový graf 

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

Štýlovať bunky 

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

Dostupné príručky

  • Export formátu tabuľky — Exportovať zošity medzi XLSX, CSV, TSV, Markdown a JSON.
  • Výpočet vzorcov — Zadajte a vyhodnoťte Excel-kompatibilné vzorce programovo.
  • Operácie s tabuľkami — Vytváranie zošitov, manipulácia s bunkami, operácie s rozsahmi a štýlovanie.
  • Začíname — Inštalácia, systémové požiadavky a váš prvý zošit.

Pozri tiež

 Slovenčina