
xlsxwriter-rs
مكتبة Rust لإنشاء Excel XLSX
إنشاء ملفات Excel XLSX متوافقة بالكامل مع تنسيق، خلايا مدمجة، فلاتر تلقائية وصور عبر واجهة برمجة تطبيقات Rust.
ما هو xlsxwriter-rs؟
xlsxwriter-rs هو ربط عالي الأداء للغة Rust لمكتبة libxlsxwriter C المستخدمة على نطاق واسع، يتيح للمطورين إنشاء ملفات Excel XLSX متوافقة بالكامل مباشرةً من تطبيقات Rust. يدعم تنسيق Excel الشامل، بما في ذلك الخطوط، الألوان، المحاذاة، الحدود، وتنسيقات الأرقام، بالإضافة إلى ميزات متقدمة مثل دمج الخلايا، الفلاتر التلقائية، التحقق من صحة البيانات، وتضمين صور PNG/JPEG. صُمم للموثوقية والسرعة، ويعد xlsxwriter-rs مثالياً لتوليد التقارير على الخادم، خطوط تصدير البيانات، وأي سيناريو يتطلب إنشاء ملفات Excel برمجياً باستخدام Rust.
تستفيد المكتبة من أمان الذاكرة في لغة Rust والطبقات المجردة ذات التكلفة الصفرية لتوفير واجهة برمجة تطبيقات آمنة وفعّالة لإنشاء ملفات Excel دون الحاجة إلى Microsoft Excel أو تبعيات خارجية مثل COM. تتكامل بسلاسة مع Cargo وتدعم أعلام الميزات الاختيارية لتخصيص السلوك، مثل تعطيل تدقيقات MD5 أو استخدام zlib النظام. بفضل واجهتها النظيفة والمتوافقة مع أسلوب Rust والوثائق الشاملة، تمكّن xlsxwriter-rs المطورين من بناء أدوات إنشاء Excel قوية وعابرة للمنصات مع الحفاظ على التحكم الكامل في بنية الملف ومحتواه.
بدء الاستخدام مع xlsxwriter-rs
لبدء استخدام xlsxwriter-rs، أضفه إلى ملف Cargo.toml عبر cargo add xlsxwriter أو قم بتضمينه يدويًا [dependencies] مع xlsxwriter = "0.1". تتطلب المكتبة LLVM و Clang لتجميع bindgen. لنظام Windows، قم بتثبيت Visual Studio و LLVM، ثم اضبط LIBCLANG_PATH إلى دليل bin الخاص بـ LLVM. بعد الإعداد، استنسخ المستودع، شغّل git submodule update --init --recursive لجلب مكتبة C، وبنِ الأمثلة باستخدام cargo run --example hello_spreadsheet. الوثائق الكاملة والأمثلة متاحة على GitHub الخاص بـ xlsxwriter-rs.
تثبيت xlsxwriter-rs عبر Cargo
cargo add xlsxwriterدعم كامل لتنسيق Excel
توفر مكتبة xlsxwriter-rs قدرات تنسيق شاملة، مما يسمح للمطورين بتخصيص الخطوط والألوان والحدود والمحاذاة وتنسيقات الأرقام للخلايا الفردية أو النطاقات. يمكنك تطبيق الخط العريض، المائل، التحته خط، حجم الخط، والألوان المخصصة على النص، ضبط ألوان تعبئة الخلفية، تعريف حدود الخلايا بأنماط مختلفة (رفيع، متوسط، سميك)، والتحكم في المحاذاة الأفقية/العمودية. يضمن هذا المستوى من التحكم أن ملفات Excel المُولدة تتطابق مع معايير التقارير المهنية. يتم تطبيق التنسيق باستخدام بنية Format، التي تدعم سلسلة الطرق لتكوين بديهي. هذه الميزة أساسية لإنشاء تقارير، لوحات معلومات، وتصديرات بيانات بصرية مميزة تحسن قابلية القراءة وتجربة المستخدم.
تطبيق لون الخط والمحاذاة على الخلايا
let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
0, 0,
"Red text",
Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
2, 0,
"Centered green text",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;دمج الخلايا والنطاقات
تدعم المكتبة دمج نطاقات خلايا مستطيلة، وهو أمر حيوي لإنشاء رؤوس، عناوين، وأقسام بيانات مجمعة في تقارير Excel. باستخدام طريقة merge_range، يمكنك توسيع النطاق عبر عدة صفوف وأعمدة مع تطبيق التنسيق على الكتلة المدمجة بالكامل. يضمن ذلك تنسيقًا ثابتًا وتخطيطًا موحدًا عبر جداول البيانات المعقدة. الخلايا المدمجة متوافقة تمامًا مع محرك عرض Excel وتحافظ على التنسيق مثل محاذاة النص، الحدود، وألوان الخلفية. هذه الميزة مفيدة بشكل خاص للبيانات المالية، لوحات التحكم، والنماذج حيث يعزز التجميع البصري فهم البيانات وجودة العرض.
دمج نطاق مع تنسيق مخصص
sheet1.merge_range(
2, 0,
3, 2,
"Hello, world",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;الفلاتر التلقائية والتحقق من صحة البيانات
يتيح xlsxwriter-rs إنشاء الفلاتر التلقائية وقواعد التحقق من البيانات برمجيًا، مما يسمح للمستخدمين بفرز وتصفية والتحقق من البيانات مباشرةً في Excel. يمكنك تطبيق فلتر تلقائي على نطاق من الخلايا باستخدام set_autofilter، وتعريف قوائم منسدلة لإدخال المستخدم عبر التحقق من البيانات. يدعم ذلك التحقق القائم على القوائم، والنطاقات الرقمية، والتواريخ، والصيغ المخصصة. تعزز هذه الميزات التفاعل وسلامة البيانات في جداول البيانات، مما يجعلها مناسبة للنماذج والقوالب وإدخال البيانات التعاوني. تحتفظ ملفات XLSX المُولدة بكامل وظائفها عند فتحها في Excel أو LibreOffice أو Google Sheets، مما يضمن توافقًا واسعًا.
تطبيق الفلتر التلقائي والتحقق من صحة البيانات
// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;
// Add data validation (drop-down list) in B2
sheet1.data_validation(
"B2",
DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;إدراج الصور والروابط التشعبية
يمكنك تضمين صور PNG و JPEG مباشرةً في أوراق عمل Excel باستخدام xlsxwriter-rs، مع دعم تحديد الموقع والحجم والتحجيم. هذا مثالي لإضافة الشعارات أو المخططات أو المؤشرات البصرية إلى التقارير. بالإضافة إلى ذلك، تدعم المكتبة الروابط التشعبية وعناوين URL مع تنسيق قابل للتخصيص (مثل النص الأزرق وتحت الخط)، مما يتيح روابط قابلة للنقر إلى المواقع الإلكترونية أو المستندات أو أوراق أخرى. تجعل هذه القدرات xlsxwriter-rs مناسبة لإنشاء تقارير ولوحات معلومات غنية وتفاعلية تجمع بين البيانات والمرئيات والتنقل. جميع المحتويات المضمنة متوافقة تمامًا مع محرك عرض Excel وتحافظ على سلامة التخطيط عبر المنصات.
كتابة عنوان URL وتضمين صورة
// Write a clickable URL
sheet1.write_url(
1, 1,
"https://github.com/informationsea/xlsxwriter-rs",
Some(&Format::new()
.set_font_color(FormatColor::Blue)
.set_underline(FormatUnderline::Single)
)
)?;
// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;