1. منتجات
  2.   جدول
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

مكتبة Rust مفتوحة المصدر لملفات Excel XLSX

إنشاء ملفات Excel 2007+ XLSX مع تنسيق كامل، مخططات، صيغ وصور عبر واجهة برمجة تطبيقات Rust.

ما هو rust_xlsxwriter؟

rust_xlsxwriter هي حزمة Rust عالية الأداء وخالصة لتوليد ملفات Excel XLSX دون الحاجة إلى Excel أو أي تبعيات خارجية. تمكّن المطورين من إنشاء جداول بيانات برمجيًا تحتوي على نصوص، أرقام، تواريخ، صيغ، مخططات، صور، خلايا مدمجة، تنسيق شرطي، تحقق من البيانات، وأكثر من ذلك. صُممت للموثوقية والسرعة، وتطابق تنسيق ملف Excel الأصلي عن كثب وتدعم وضع الذاكرة الثابتة لمجموعات البيانات الكبيرة. المكتبة هي إعادة كتابة Rust مخلصة للمكتبة الشهيرة Python XlsxWriter، مع واجهات برمجة تطبيقات إيديوماتية ووثائق شاملة.

يركّز rust_xlsxwriter حصريًا على كتابة ملفات Excel — دون قراءة أو تعديل الملفات الموجودة. يدعم ميزات Excel الحديثة مثل المصفوفات الديناميكية، والرسوم المتحركة الصغيرة (sparklines)، ومربعات الاختيار، ومربعات النص، والجداول، والمرشحات التلقائية، والأسماء المعرفة، وسمات المصنف. مع ميزات اختيارية مثل تسلسل Serde، ودعم تواريخ chrono/jiff، وتكامل Polars، يتكيف مع بيئات Rust المتنوعة. أداؤه يأتي في المرتبة الثانية بعد النسخة المكتوبة بلغة C، حيث يقدم تنفيذًا أسرع بـ 3.8× مقارنةً بـ XlsxWriter الخاص بـ Python. للحصول على التفاصيل الكاملة، راجع مستودع rust_xlsxwriter على GitHub.

Previous Next

البدء مع rust_xlsxwriter

rust_xlsxwriter متاح على crates.io ويمكن تثبيته عبر `cargo add rust_xlsxwriter`. للحصول على وظائف محسّنة، فعّل الميزات الاختيارية مثل `constant_memory` و `chrono` و `serde` أو `polars`. تتطلب المكتبة Rust 1.56+ وتُترجم إلى ثنائيات أصلية دون أي تبعيات تشغيل خارجية بخلاف حزمة `zip` (افتراضيًا). هي موثقة بالكامل بدليل المستخدم، والبرنامج التعليمي، وكتاب الوصفات. للحصول على أمثلة مفصلة وكود المصدر، زر مستودع rust_xlsxwriter على GitHub.

تثبيت rust_xlsxwriter عبر Cargo

cargo add rust_xlsxwriter

كتابة خلايا منسقة بالنصوص والأرقام والتواريخ

rust_xlsxwriter يوفر واجهة برمجة تطبيقات بسيطة وبديهية لكتابة محتوى مُنسق إلى خلايا Excel. يمكن للمطورين تطبيق تنسيقات مخصصة للأرقام، والتواريخ، والخطوط، والحدود، والمحاذاة، والألوان باستخدام بنية `Format`. تدعم المكتبة كتابة النص العادي، والقيم الرقمية، والتواريخ، والصيغ، وعناوين URL مع تنسيق اختياري. كما تدعم سلاسل متعددة التنسيقات غنية لتنسيق مختلط داخل خلية واحدة. يجعل ذلك منها مثالية لإنشاء التقارير، ولوحات المعلومات، وتصدير البيانات حيث الوضوح البصري والبنية أمران أساسيان. تضمن الواجهة دقة عالية مع محرك تنسيق Excel الأصلي.

كيف تكتب نصوصًا، أرقامًا وتواريخ منسقة باستخدام Rust؟

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

let bold = Format::new().set_bold();
let decimal = Format::new().set_num_format("0.00");
let date_fmt = Format::new().set_num_format("yyyy-mm-dd");

worksheet.write_with_format(0, 0, "Hello", &bold)?;
worksheet.write(1, 0, 123.456)?;
worksheet.write_with_format(2, 0, 789.012, &decimal)?;
let date = ExcelDateTime::from_ymd(2023, 12, 25)?;
worksheet.write_with_format(3, 0, &date, &date_fmt)?;
workbook.save("formatted.xlsx")?;

إنشاء مخططات، مخططات صغيرة وصور

يدعم rust_xlsxwriter إنشاء مخططات احترافية، ومخططات صغيرة (sparklines)، وإدراج الصور مباشرةً في ملفات Excel. يمكن للمطورين إنشاء مخططات شريطية، خطية، دائرية، مبعثرة، ومساحية مع محاور، وسُبل إيضاح، وسلاسل بيانات قابلة للتخصيص. توفر المخططات الصغيرة تصورًا مدمجًا للاتجاهات داخل الخلايا. يمكن إدراج الصور (PNG، JPEG، GIF، BMP) وتحديد موضعها مع خيارات التحجيم والتثبيت. تعزز هذه العناصر البصرية سرد البيانات وقدرات التقارير. تضمن المكتبة التوافق مع Excel 2007+ وتحافظ على دقة العرض عبر المنصات.

كيف تضيف مخططًا وصورةً إلى Excel باستخدام Rust؟

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

// Write sample data
for i in 0..5 {
    worksheet.write_number(i, 0, (i + 1) as f64 * 10.0)?;
}

// Create a chart
let mut chart = Chart::new(ChartType::Column);
chart.add_series().set_values("Sheet1!$A$1:$A$5");
worksheet.insert_chart(0, 2, &chart)?;

// Insert an image
let image = Image::new("logo.png")?;
worksheet.insert_image(5, 2, &image)?;

workbook.save("chart_image.xlsx")?;

تنسيق متقدم: خلايا مدمجة، جداول وتنسيق شرطي

يتيح rust_xlsxwriter ميزات تنسيق متقدمة في Excel مثل النطاقات المدمجة، الجداول المنظمة، الفلاتر التلقائية، وقواعد التنسيق الشرطي. يمكن للمطورين دمج الخلايا للعناوين أو التسميات، تطبيق أنماط الجداول مع صفوف/أعمدة متناوبة، وتحديد الفلاتر لتفاعل المستخدم. يدعم التنسيق الشرطي مقاييس الألوان، أشرطة البيانات، مجموعات الأيقونات، والصيغ المخصصة لتسليط الضوء على الاتجاهات أو الشذوذ. تحسن هذه الميزات قابلية قراءة البيانات وتفاعلها في المصنفات المُنشأة. تقوم واجهة برمجة التطبيقات (API) بتجريد هياكل XML المعقدة إلى أساليب Rust بديهية، مما يضمن القابلية للصيانة وسلامة النوع.

كيف تدمج الخلايا وتضيف جداول مع التنسيق الشرطي؟

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

// Merge cells
let merge_fmt = Format::new()
    .set_border(FormatBorder::Thin)
    .set_align(FormatAlign::Center);
worksheet.merge_range(0, 0, 0, 2, "Report Header", &merge_fmt)?;

// Add table
worksheet.add_table(1, 0, 5, 2, Table::new().set_columns(&[
    ("Item", None),
    ("Value", None),
    ("Status", None),
]))?;

// Conditional formatting
worksheet.conditional_format(
    2, 0, 5, 2,
    ConditionalFormat::new()
        .set_type(ConditionalFormatType::Cell)
        .set_format(&Format::new().set_bg_color("#D8E4BC"))
        .set_formula("=A2>100")
)?;

workbook.save("advanced.xlsx")?;

تحسين الأداء ودعم الملفات الكبيرة

rust_xlsxwriter مُحسّن للسرعة وكفاءة الذاكرة، خاصةً مع مجموعات البيانات الكبيرة. يدعم وضع الذاكرة الثابتة (`constant_memory` feature)، الذي يكتب البيانات تدريجيًا إلى القرص، مما يقلل من استخدام الكومة. هذا الوضع مثالي لإنشاء ملفات Excel متعددة الميغابايت دون أخطاء نفاد الذاكرة (OOM). تُظهر المعايير أنه يعمل أسرع بحوالي ~3.8× من XlsxWriter الخاص بـ Python وبطيئًا فقط بحوالي ~14% مقارنةً بمكتبة C الأصلية. الميزات الاختيارية مثل `zmij` و `zlib` تُسرّع كتابة الأرقام والضغط أكثر. تجعل هذه القدرات الأداة مناسبة لتقارير الدُفعات، خطوط أنابيب ETL، وإنشاء Excel على الخادم.

كيف تمكّن وضع الذاكرة الثابتة للملفات الكبيرة؟

cargo add rust_xlsxwriter -F constant_memory
use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
workbook.set_constant_memory(true); // Enable constant memory mode

let worksheet = workbook.add_worksheet();
for i in 0..100_000 {
    worksheet.write_number(i, 0, i as f64)?;
}

workbook.save("large_file.xlsx")?;
 عربي