Entwicklerhandbuch

Aspose.Cells FOSS for Python ist eine kostenlose, Open-Source-Bibliothek für die programmgesteuerte Tabellenkalkulationsverarbeitung. Egal, ob Sie Datenpipelines erstellen, automatisierte Berichte generieren, ML-Ergebnisse nach Excel exportieren oder Arbeitsmappen für Dokumentationspipelines in Markdown konvertieren, Aspose.Cells FOSS bietet eine umfassende API, die jede Ebene der Tabellenkalkulationsmanipulation abdeckt, ohne Microsoft Office zu benötigen.

Hauptmerkmale

Arbeitsmappen- und Arbeitsblattoperationen

Erstellen Sie neue Arbeitsmappen von Grund auf oder öffnen Sie vorhandene XLSX- oder CSV-Dateien. Navigieren Sie durch die Workbook → Worksheets → Cells → Cell-Hierarchie mit einer sauberen, Pythonic-API. Fügen Sie Arbeitsblätter hinzu, benennen Sie sie um und entfernen Sie sie mit workbook.add_worksheet(name) und workbook.remove_worksheet(index_or_name). Greifen Sie auf einzelne Zellen über die Adresse (ws.cells["A1"]) zu, setzen Sie Werte direkt und iterieren Sie über gefüllte Bereiche.

Zellgestaltung und -formatierung

Wenden Sie eine feinkörnige Formatierung auf einzelne Zellen an. Steuern Sie Schriftfamilie, Größe, Farbe, Fett, Kursiv, Unterstreichung und Durchstreichung über die Font‑Klasse. Legen Sie Hintergrundfüllungen mit cell.style.fill.set_solid_fill("FFRRGGBB") fest. Farben werden als 8‑stellige AARRGGBB‑Hex‑Strings ohne ein #‑Präfix ausgedrückt (z. B. "FFFF0000" für undurchsichtiges Rot).

Diagrammerstellung und -visualisierung

Fügen Sie Spalten-, Linien-, Balken- und Kreisdiagramme zu Arbeitsblättern hinzu, indem Sie dedizierte Methoden wie ws.charts.add_bar(top_row, left_col, bottom_row, right_col) und ws.charts.add_line(...) verwenden. Setzen Sie den Diagrammtitel als Zeichenkette (chart.title = "My Chart"), konfigurieren Sie die Kategoriedaten auf Diagrammebene (chart.category_data = "A2:A6") und fügen Sie benannte Serien hinzu (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Formelunterstützung

Geben Sie Excel‑kompatible Formeln ein, indem Sie cell.formula = "=SUM(A1:A5)" setzen oder ein Cell(None, "=SUM(A1:A5)") erstellen und es der Zellen‑Sammlung zuweisen.

Multi-Format-Export

Exportieren Sie Arbeitsmappen in XLSX, CSV, TSV, Markdown und JSON mit einem einzigen workbook.save(path) Aufruf. Verwenden Sie SaveFormat Konstanten für explizite Steuerung: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Verwenden Sie MarkdownSaveOptions für fein abgestimmte Markdown‑Ausgabe (Ausrichtung, Kopfzeilenebene, Arbeitsblattindex). Verwenden Sie MarkdownHandler.save_markdown_to_string(wb) für die In‑Memory‑Generierung von Markdown. Siehe Exportformat‑Beispiele für sofort einsetzbaren Code und Export‑Fehlerbehebung für Tipps und FAQ.

Hinweis: Aspose.Cells FOSS exportiert nach XLSX, CSV, TSV, Markdown und JSON. Der Export nach PDF, HTML, PNG, TIFF, DOCX und PPTX ist nicht Teil der FOSS‑Bibliothek.

Plugin-Ökosystem

Das optionale markitdown-aspose-cells-plugin-Paket integriert sich in die MarkItDown-Bibliothek von Microsoft, um XLSX-Leseunterstützung hinzuzufügen. Installieren Sie es mit pip install markitdown-aspose-cells-plugin und verwenden Sie es transparent über die MarkItDown-API.

Erste Schritte

Installieren 

pip install aspose-cells-foss

Hallo Welt 

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

Erstelle ein Säulendiagramm 

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

Zellen formatieren 

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

Verfügbare Anleitungen

Siehe auch

 Deutsch