Vývojářská příručka

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.

Klíčové funkce

Operace se sešitem a listy

Vytvořte nové sešity od nuly nebo otevřete existující soubory XLSX nebo CSV. Procházejte Workbook → Worksheets → Cells → Cell hierarchii pomocí čistého, Pythonického API. Přidávejte, přejmenovávejte a odstraňujte listy pomocí workbook.add_worksheet(name) a workbook.remove_worksheet(index_or_name). Přistupujte k jednotlivým buňkám podle adresy (ws.cells["A1"]), nastavte hodnoty přímo a iterujte přes vyplněné oblasti.

Formátování a stylování buněk

Použijte podrobné formátování jednotlivých buněk. Ovládejte rodinu písma, velikost, barvu, tučnost, kurzívu, podtržení a přeškrtnutí pomocí Font třídy. Nastavte výplně pozadí pomocí cell.style.fill.set_solid_fill("FFRRGGBB"). Barvy jsou vyjádřeny jako 8‑znakové hexadecimální řetězce AARRGGBB bez # předpony (např., "FFFF0000" pro neprůhlednou červenou).

Vytváření a vizualizace grafů

Přidejte sloupcové, čárové, pruhové a koláčové grafy do listů pomocí vyhrazených metod, jako je ws.charts.add_bar(top_row, left_col, bottom_row, right_col) a ws.charts.add_line(...). Nastavte název grafu jako řetězec (chart.title = "My Chart"), nakonfigurujte data kategorií na úrovni grafu (chart.category_data = "A2:A6"), a přidejte pojmenované řady (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Podpora vzorců

Vkládejte Excel‑kompatibilní vzorce nastavením cell.formula = "=SUM(A1:A5)" nebo vytvářením a Cell(None, "=SUM(A1:A5)") a přiřazením k kolekci buněk.

Export do více formátů

Exportujte sešity do XLSX, CSV, TSV, Markdown a JSON pomocí jediného workbook.save(path) volání. Použijte SaveFormat konstanty pro explicitní řízení: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Použijte MarkdownSaveOptions pro jemně řízený výstup Markdown (zarovnání, úroveň nadpisu, index listu). Použijte MarkdownHandler.save_markdown_to_string(wb) pro generování 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 není součástí knihovny FOSS.

Ekosystém pluginů

Volitelný markitdown-aspose-cells-plugin balíček integruje s knihovnou Microsoft MarkItDown a přidává podporu čtení XLSX. Nainstalujte jej pomocí pip install markitdown-aspose-cells-plugin a použijte jej transparentně přes MarkItDown API.

Začínáme

Instalovat 

pip install aspose-cells-foss

Ahoj světe 

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

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

Vytvořit sloupcový 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")

Styly buněk 

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ůvodce

  • Export formátu tabulky — Exportujte sešity mezi XLSX, CSV, TSV, Markdown a JSON.
  • Výpočet vzorců — Vkládejte a programově vyhodnocujte vzorce kompatibilní s Excelem.
  • Operace s tabulkami — Vytváření sešitů, manipulace s buňkami, operace s oblastmi a stylování.
  • Začínáme — Instalace, systémové požadavky a váš první sešit.

Viz také

 Čeština