Panduan Pengembang

Aspose.Cells FOSS for Python adalah perpustakaan gratis, sumber terbuka untuk pemrosesan spreadsheet secara programatik. Baik Anda sedang membangun pipeline data, menghasilkan laporan otomatis, mengekspor hasil ML ke Excel, atau mengonversi workbook ke Markdown untuk pipeline dokumentasi, Aspose.Cells FOSS menyediakan API komprehensif yang mencakup setiap lapisan manipulasi spreadsheet tanpa memerlukan Microsoft Office.

Fitur Utama

Operasi Workbook dan Worksheet

Buat workbook baru dari awal atau buka file XLSX atau CSV yang sudah ada. Jelajahi hierarki Workbook → Worksheets → Cells → Cell dengan API yang bersih dan bersifat Pythonic. Tambahkan, ganti nama, dan hapus worksheet menggunakan workbook.add_worksheet(name) dan workbook.remove_worksheet(index_or_name). Akses sel individual berdasarkan alamat (ws.cells["A1"]), tetapkan nilai secara langsung, dan iterasi pada rentang yang terisi.

Penggayaan dan Pemformatan Sel

Terapkan pemformatan granular pada sel individu. Kendalikan keluarga font, ukuran, warna, tebal, miring, garis bawah, dan coret melalui kelas Font. Atur isian latar belakang menggunakan cell.style.fill.set_solid_fill("FFRRGGBB"). Warna dinyatakan sebagai string heksadesimal 8‑karakter AARRGGBB tanpa awalan # (misalnya, "FFFF0000" untuk merah pekat).

Pembuatan dan Visualisasi Diagram

Tambahkan diagram kolom, garis, batang, dan pai ke lembar kerja menggunakan metode khusus seperti ws.charts.add_bar(top_row, left_col, bottom_row, right_col) dan ws.charts.add_line(...). Atur judul diagram sebagai string (chart.title = "My Chart"), konfigurasikan data kategori pada tingkat diagram (chart.category_data = "A2:A6"), dan tambahkan seri bernama (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Dukungan Formula

Masukkan formula yang kompatibel dengan Excel dengan mengatur cell.formula = "=SUM(A1:A5)" atau membuat sebuah Cell(None, "=SUM(A1:A5)") dan menetapkannya ke koleksi sel.

Ekspor Multi-Format

Ekspor workbook ke XLSX, CSV, TSV, Markdown, dan JSON menggunakan satu panggilan workbook.save(path). Gunakan konstanta SaveFormat untuk kontrol eksplisit: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Gunakan MarkdownSaveOptions untuk output Markdown yang terperinci (penyelarasan, tingkat header, indeks lembar kerja). Gunakan MarkdownHandler.save_markdown_to_string(wb) untuk pembuatan Markdown dalam memori. Lihat Export Format Examples untuk kode siap pakai dan Export Troubleshooting untuk tip dan FAQ.

Catatan: Aspose.Cells FOSS mengekspor ke XLSX, CSV, TSV, Markdown, dan JSON. Ekspor PDF, HTML, PNG, TIFF, DOCX, dan PPTX tidak termasuk dalam perpustakaan FOSS.

Ekosistem Plugin

Paket opsional markitdown-aspose-cells-plugin mengintegrasikan dengan pustaka MarkItDown milik Microsoft untuk menambahkan dukungan pembacaan XLSX. Instal dengan pip install markitdown-aspose-cells-plugin dan gunakan secara transparan melalui API MarkItDown.

Memulai

Instal 

pip install aspose-cells-foss

Halo Dunia 

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

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

Buat Diagram Kolom 

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

Gaya Sel 

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

Panduan Tersedia

Lihat Juga

 Bahasa Indonesia