دليل المطور

Aspose.Cells FOSS for Python هي مكتبة مجانية ومفتوحة المصدر لمعالجة جداول البيانات برمجياً. سواء كنت تبني خطوط أنابيب البيانات، أو تولد تقارير آلية، أو تصدر نتائج التعلم الآلي إلى Excel، أو تحول دفاتر العمل إلى Markdown لسلاسل توثيق، فإن Aspose.Cells FOSS توفر API شاملة تغطي كل طبقة من طبقات معالجة جداول البيانات دون الحاجة إلى Microsoft Office.

الميزات الرئيسية

عمليات دفتر العمل والورقة

إنشاء دفاتر عمل جديدة من الصفر أو فتح ملفات XLSX أو CSV الموجودة. التنقل في هيكل Workbook → Worksheets → Cells → Cell باستخدام واجهة برمجة تطبيقات نظيفة وبايثونية. إضافة، إعادة تسمية، وإزالة أوراق العمل باستخدام 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")).

دعم الصيغ

أدخل صيغًا متوافقة مع Excel عن طريق ضبط 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 تتكامل مع مكتبة Microsoft MarkItDown لإضافة دعم قراءة ملفات XLSX.
قم بتثبيتها باستخدام pip install markitdown-aspose-cells-plugin واستخدمها بشكل شفاف عبر واجهة برمجة التطبيقات MarkItDown.

البدء

تثبيت 

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

تصدير إلى 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")

إنشاء مخطط عمودي 

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

الأدلة المتاحة

  • Spreadsheet Format Export — تصدير دفاتر العمل بين XLSX و CSV و TSV و Markdown و JSON.
  • Formula Calculation — إدخال وتقييم الصيغ المتوافقة مع Excel برمجيًا.
  • Spreadsheet Operations — إنشاء دفتر عمل، معالجة الخلايا، عمليات النطاق، وتنسيق.
  • Getting Started — التثبيت، متطلبات النظام، وأول دفتر عمل لك.

انظر أيضًا

 العربية