راهنمای توسعه‌دهنده

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.

ویژگی‌های کلیدی

عملیات کتاب‌کار و برگه‌کار

یک کتاب‌کار جدید را از ابتدا ایجاد کنید یا فایل‌های XLSX یا CSV موجود را باز کنید. به Workbook → Worksheets → Cells → Cell سلسله‌مراتبی با یک API تمیز و پایتونیک. با استفاده از workbook.add_worksheet(name) و workbook.remove_worksheet(index_or_name). به‌سلول‌های منفرد با آدرس (ws.cells["A1"])، مقادیر را به‌صورت مستقیم تنظیم کنید و بر روی بازه‌های پرشده تکرار کنید.

استایل‌دهی و قالب‌بندی سلول

قالب‌بندی دقیق را بر روی سلول‌های منفرد اعمال کنید. خانواده، اندازه، رنگ، ضخیم، ایتالیک، زیرخط و خط‌خورده قلم را از طریق Font کلاس. پس‌زمینه‌ها را با استفاده از cell.style.fill.set_solid_fill("FFRRGGBB"). رنگ‌ها به‌صورت رشته‌های هگز 8 کاراکتری AARRGGBB بدون # پیشوند (مثلاً., "FFFF0000" برای قرمز مات).

ایجاد و تجسم نمودار

ستون، خط، میله و نمودارهای دایره‌ای را به برگه‌ها اضافه کنید با استفاده از روش‌های اختصاصی مانند ws.charts.add_bar(top_row, left_col, bottom_row, right_col) و ws.charts.add_line(...). عنوان نمودار را به‌صورت یک رشته تنظیم کنید (chart.title = "My Chart")، داده‌های دسته‌بندی را در سطح نمودار پیکربندی کنید (chart.category_data = "A2:A6")، و سری‌های نام‌گذاری‌شده را اضافه کنید (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

پشتیبانی از فرمول‌ها

فرمول‌های سازگار با اکسل را با تنظیم cell.formula = "=SUM(A1:A5)" یا ساختن یک Cell(None, "=SUM(A1:A5)") و اختصاص آن به مجموعه سلول‌ها.

صادرات چندفرمت

کتاب‌کارها را به فرمت‌های XLSX، CSV، TSV، Markdown و JSON با استفاده از یک workbook.save(path) فراخوانی. استفاده SaveFormat ثابت‌ها برای کنترل صریح: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. استفاده کنید MarkdownSaveOptions برای خروجی دقیق Markdown (تراز، سطح سرصفحه، شاخص برگه). استفاده کنید MarkdownHandler.save_markdown_to_string(wb) برای تولید Markdown در حافظه.

توجه: Aspose.Cells FOSS به XLSX، CSV، TSV، Markdown و JSON صادر می‌شود. صادرات PDF، HTML، PNG، TIFF، DOCX و PPTX بخشی از کتابخانه FOSS نیست.

اکوسیستم افزونه‌ها

اختیاری markitdown-aspose-cells-plugin پکیج با کتابخانه MarkItDown مایکروسافت یکپارچه می‌شود تا پشتیبانی از خواندن XLSX را اضافه کند. با نصب آن pip install markitdown-aspose-cells-plugin و به‌صورت شفاف از طریق MarkItDown API.

شروع کار

نصب 

pip install aspose-cells-foss

سلام دنیا 

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

صادرات به مارک‌داون 

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

ایجاد نمودار ستونی 

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

قالب‌بندی سلول‌ها 

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

راهنماهای موجود

همچنین ببینید

 فارسی