Geliştirici Kılavuzu

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.

Temel Özellikler

Çalışma Kitabı ve Çalışma Sayfası İşlemleri

Sıfırdan yeni çalışma kitapları oluşturun veya mevcut XLSX veya CSV dosyalarını açın. Hiyerarşiyi gezin Workbook → Worksheets → Cells → Cell hiyerarşiyi temiz, Pythonik bir API ile. Çalışma sayfalarını ekleyin, yeniden adlandırın ve kaldırın kullanarak workbook.add_worksheet(name) ve workbook.remove_worksheet(index_or_name). Bireysel hücrelere adresle erişin (ws.cells["A1"]), değerleri doğrudan ayarlayın ve doldurulmuş aralıklar üzerinde yineleyin.

Hücre Stil ve Biçimlendirme

Bireysel hücrelere ayrıntılı biçimlendirme uygulayın. Yazı tipi ailesi, boyutu, rengi, kalın, italik, altı çizili ve üstü çizili özelliklerini aracılığıyla kontrol edin Font sınıfı. Arka plan doldurmalarını kullanarak ayarlayın cell.style.fill.set_solid_fill("FFRRGGBB"). Renkler, ön ek olmadan 8 karakterli AARRGGBB onaltılık dizgeler olarak ifade edilir # önek (örneğin,., "FFFF0000" opak kırmızı için).

Grafik Oluşturma ve Görselleştirme

Çalışma sayfalarına sütun, çizgi, çubuk ve pasta grafiklerini, aşağıdaki gibi özel yöntemler kullanarak ekleyin ws.charts.add_bar(top_row, left_col, bottom_row, right_col) ve ws.charts.add_line(...). Grafik başlığını bir dize olarak ayarlayın (chart.title = "My Chart"), grafik seviyesinde kategori verilerini yapılandırın (chart.category_data = "A2:A6"), ve adlandırılmış serileri ekleyin (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Formül Desteği

Excel uyumlu formülleri ayarlayarak girin cell.formula = "=SUM(A1:A5)" veya bir şey inşa etme Cell(None, "=SUM(A1:A5)") ve onu hücreler koleksiyonuna atama.

Çoklu Biçim Dışa Aktarma

Tek bir kullanarak çalışma kitaplarını XLSX, CSV, TSV, Markdown ve JSON formatlarına dışa aktar workbook.save(path) çağrı. Kullan SaveFormat açık kontrol için sabitler: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Kullan MarkdownSaveOptions ince ayarlı Markdown çıktısı için (hizalama, başlık seviyesi, çalışma sayfası indeksi). Kullan MarkdownHandler.save_markdown_to_string(wb) bellek içi Markdown oluşturma için.

Not:Aspose.Cells FOSS, XLSX, CSV, TSV, Markdown ve JSON formatlarına dışa aktarır. PDF, HTML, PNG, TIFF, DOCX ve PPTX dışa aktarımları FOSS kütüphanesinin bir parçası değildir.

Eklenti Ekosistemi

İsteğe bağlı markitdown-aspose-cells-plugin paket, Microsoft’un MarkItDown kütüphanesiyle bütünleşerek XLSX okuma desteği ekler. Şununla kurun pip install markitdown-aspose-cells-plugin ve bunu şeffaf bir şekilde şu aracılığıyla kullanın MarkItDown API.

Başlarken

Yükle 

pip install aspose-cells-foss

Merhaba Dünya 

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

Markdown’a Dışa Aktar 

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

Sütun Grafiği Oluştur 

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

Hücreleri Biçimlendir 

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

Mevcut Kılavuzlar

Ayrıca Bakınız

 Türkçe