1. ما هي مكتبة calamine ولماذا تستخدمها؟

calamine هي مكتبة عالية الأداء مكتوبة بلغة Rust لقراءة ملفات Excel (بصيغ .xlsx، .xls، .xlsb، .ods). تمت كتابتها بلغة Rust الخالصة دون أي تبعيات خارجية، مما يجعلها الخيار الأمثل للمشاريع التي تتطلب سرعة عالية، أماناً في إدارة الذاكرة، وتشغيلاً عبر المنصات المختلفة. على عكس العديد من المكتبات الأخرى، لا تحتاج calamine إلى تثبيت Microsoft Office أو Java Runtime Environment.

الغرض الأساسي من calamine هو استخراج البيانات من جداول البيانات الإلكترونية. تدعم المكتبة قراءة الخلايا، الصفوف، الأعمدة، الأوراق، بالإضافة إلى التعامل مع الصيغ، التواريخ، الأرقام، والنصوص. تُعد المكتبة مفيدة بشكل خاص لأتمتة معالجة التقارير، استيراد البيانات من Excel إلى قواعد البيانات، تحليل الجداول الكبيرة، وإنشاء خطوط أنابيب معالجة البيانات (ETL).

صُممت calamine مع التركيز على الأداء: فهي تستخدم القراءة التدفقية والتحميل البطيء للبيانات، مما يسمح بمعالجة ملفات يصل حجمها إلى مئات الميغابايت دون استهلاك كبير للذاكرة العشوائية. تحظى المكتبة بدعم نشط من مجتمع Rust وتُستخدم في مشاريع معروفة مثل rust-xlsxwriter و tauri.

2. طريقة التثبيت

لإضافة مكتبة calamine إلى مشروع Rust، قم بتنفيذ الأمر التالي في الطرفية:

cargo add calamine

أو يمكنك إضافة التبعية يدوياً في ملف Cargo.toml:

[dependencies]
calamine = "0.24"

بعد ذلك، قم بتنفيذ cargo build لتحميل المكتبة وترجمتها. تأكد من تثبيت Rust (يُوصى بالإصدار 1.65 أو أحدث).

3. البداية السريعة

مثال بسيط لقراءة البيانات من ملف Excel:

use calamine::{open_workbook, Reader, Xlsx};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // فتح الملف
    let mut workbook: Xlsx<_> = open_workbook("data.xlsx")?;
    
    // الحصول على الورقة الأولى
    let sheet_name = workbook.sheet_names()[0].clone();
    let range = workbook.worksheet_range(&sheet_name)?;
    
    // طباعة المحتوى
    for row in range.rows() {
        for cell in row {
            print!("{:?}\t", cell);
        }
        println!();
    }
    
    Ok(())
}

يقوم هذا الكود بفتح الملف data.xlsx، وقراءة الورقة الأولى، ثم طباعة جميع الخلايا في وحدة التحكم. لاحظ استخدام open_workbook وهي دالة عامة لفتح الملفات بأي صيغة مدعومة.

4. الدوال والوظائف الأساسية

use calamine::{open_workbook, Xlsx};

fn main() {
    let mut workbook: Xlsx<_> = open_workbook("report.xlsx").expect("لا يمكن فتح الملف");
    println!("تم فتح الملف بنجاح");
}

أيضاً في المكتبة

دليل Symfony/Cache PHP: كامل مع أمثلة تطبيقية عميل HTTP للغة Go (Golang): أفضل المكتبات للعمل مع الشبكة ORM لـ Swift (iOS/macOS): مقارنة وأمثلة استخدام chrono في Rust: دليل شامل مع أمثلة عملية Prophet: التنبؤ بالسلاسل الزمنية من فيسبوك