Przewodnik programisty

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.

Kluczowe funkcje

Operacje na skoroszytach i arkuszach

Utwórz nowe skoroszyty od podstaw lub otwórz istniejące pliki XLSX lub CSV. Nawiguj po Workbook → Worksheets → Cells → Cell hierarchii przy użyciu czystego, Pythonicznego API. Dodawaj, zmieniaj nazwy i usuwaj arkusze za pomocą workbook.add_worksheet(name) i workbook.remove_worksheet(index_or_name). Uzyskaj dostęp do pojedynczych komórek po adresie (ws.cells["A1"]), ustawiaj wartości bezpośrednio i iteruj po wypełnionych zakresach.

Stylowanie i formatowanie komórek

Zastosuj szczegółowe formatowanie do pojedynczych komórek. Kontroluj rodzinę czcionki, rozmiar, kolor, pogrubienie, kursywę, podkreślenie i przekreślenie za pomocą Font klasy. Ustaw wypełnienia tła przy użyciu cell.style.fill.set_solid_fill("FFRRGGBB"). Kolory są wyrażane jako 8‑znakowe ciągi szesnastkowe AARRGGBB bez # prefiksu (np., "FFFF0000" dla nieprzezroczystej czerwieni).

Tworzenie i wizualizacja wykresów

Dodaj wykresy kolumnowe, liniowe, słupkowe i kołowe do arkuszy przy użyciu dedykowanych metod, takich jak ws.charts.add_bar(top_row, left_col, bottom_row, right_col) i ws.charts.add_line(...). Ustaw tytuł wykresu jako ciąg znaków (chart.title = "My Chart"), skonfiguruj dane kategorii na poziomie wykresu (chart.category_data = "A2:A6"), i dodaj nazwane serie (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Obsługa formuł

Wprowadzaj formuły zgodne z Excelem, ustawiając cell.formula = "=SUM(A1:A5)" lub konstruując Cell(None, "=SUM(A1:A5)") i przypisując go do kolekcji komórek.

Eksport wieloformatowy

Eksportuj skoroszyty do XLSX, CSV, TSV, Markdown i JSON przy użyciu jednego workbook.save(path) wywołaj. Użyj SaveFormat stałe dla jawnej kontroli: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Użyj MarkdownSaveOptions do precyzyjnego generowania Markdown (wyrównanie, poziom nagłówka, indeks arkusza). Użyj MarkdownHandler.save_markdown_to_string(wb) do generowania Markdown w pamięci.

Uwaga: Aspose.Cells FOSS eksportuje do XLSX, CSV, TSV, Markdown i JSON. Eksport do PDF, HTML, PNG, TIFF, DOCX i PPTX nie jest częścią biblioteki FOSS.

Ekosystem wtyczek

Opcjonalny markitdown-aspose-cells-plugin pakiet integruje się z biblioteką Microsoft MarkItDown, aby dodać obsługę odczytu XLSX. Zainstaluj go za pomocą pip install markitdown-aspose-cells-plugin i używaj go transparentnie poprzez MarkItDown API.

Rozpoczęcie

Zainstaluj 

pip install aspose-cells-foss

Witaj świecie 

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

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

Utwórz wykres kolumnowy 

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

Stylizuj komórki 

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

Dostępne przewodniki

Zobacz także

 Polski