xlsxwriter-rs

 
 

کتابخانه Rust برای تولید Excel XLSX

ایجاد فایل‌های Excel XLSX کاملاً سازگار با فرمت‌بندی، سلول‌های ترکیبی، فیلترهای خودکار و تصاویر از طریق API Rust.

xlsxwriter-rs چیست؟

xlsxwriter-rs یک بایندینگ Rust با عملکرد بالا برای کتابخانه C پرکاربرد libxlsxwriter است که به توسعه‌دهندگان امکان می‌دهد فایل‌های Excel XLSX کاملاً سازگار را مستقیماً از برنامه‌های Rust تولید کنند. این کتابخانه از قالب‌بندی جامع Excel پشتیبانی می‌کند، از جمله قلم‌ها، رنگ‌ها، تراز، حاشیه‌ها و فرمت‌های عددی، و همچنین ویژگی‌های پیشرفته‌ای مانند ادغام سلول‌ها، فیلترهای خودکار، اعتبارسنجی داده‌ها و درج تصاویر PNG/JPEG. با طراحی برای قابلیت اطمینان و سرعت، xlsxwriter-rs برای تولید گزارش‌های سمت سرور، خطوط لوله استخراج داده و هر سناریویی که نیاز به ایجاد برنامه‌نویسی فایل Excel در Rust دارد، ایده‌آل است.

این کتابخانه از ایمنی حافظه Rust و انتزاع‌های بدون هزینه استفاده می‌کند تا یک API ایمن و کارآمد برای تولید Excel فراهم کند بدون نیاز به Microsoft Excel یا وابستگی‌های خارجی مانند COM. این کتابخانه به‌صورت یکپارچه با Cargo ادغام می‌شود و از پرچم‌های ویژگی اختیاری برای سفارشی‌سازی رفتار پشتیبانی می‌کند، مانند غیرفعال‌سازی چک‌سام‌های MD5 یا استفاده از zlib سیستم. با رابط تمیز و بومی Rust و مستندات جامع، xlsxwriter-rs به توسعه‌دهندگان امکان می‌دهد ابزارهای تولید Excel قوی و چندپلتفرمی بسازند در حالی که کنترل کامل بر ساختار و محتوای فایل را حفظ می‌کنند.

Previous Next

شروع کار با xlsxwriter-rs

برای شروع استفاده از xlsxwriter-rs، آن را به Cargo.toml خود اضافه کنید با استفاده از cargo add xlsxwriter یا به‌صورت دستی [dependencies] را با xlsxwriter = \"0.1\" وارد کنید. این کتابخانه برای کامپایل bindgen به LLVM و Clang نیاز دارد. برای ویندوز، 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

پشتیبانی کامل از قالب‌بندی اکسل

xlsxwriter-rs قابلیت‌های جامع قالب‌بندی را فراهم می‌کند و به توسعه‌دهندگان امکان سفارشی‌سازی فونت‌ها، رنگ‌ها، حاشیه‌ها، ترازها و قالب‌های عددی برای سلول‌ها یا بازه‌های جداگانه را می‌دهد. می‌توانید متن را با بولد، ایتالیک، زیرخط، اندازه فونت و رنگ‌های سفارشی اعمال کنید، رنگ پس‌زمینه را تنظیم کنید، حاشیه‌های سلول را با سبک‌های مختلف (باریک، متوسط، ضخیم) تعریف کنید و تراز افقی/عمودی را کنترل کنید. این سطح از کنترل اطمینان می‌دهد که فایل‌های اکسل تولید شده با استانداردهای حرفه‌ای گزارش‌گیری مطابقت داشته باشند. قالب‌بندی با استفاده از ساختار 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 امکان ایجاد برنامه‌نویسی فیلترهای خودکار و قوانین اعتبارسنجی داده را فراهم می‌کند و به کاربران اجازه می‌دهد تا داده‌ها را مستقیماً در اکسل مرتب، فیلتر و اعتبارسنجی کنند. می‌توانید با استفاده از set_autofilter یک فیلتر خودکار را بر روی یک بازه از سلول‌ها اعمال کنید و لیست‌های کشویی برای ورودی کاربر از طریق اعتبارسنجی داده تعریف کنید. این قابلیت از اعتبارسنجی مبتنی بر لیست، بازه‌های عددی، تاریخ‌ها و فرمول‌های سفارشی پشتیبانی می‌کند. این ویژگی‌ها تعامل و یکپارچگی داده‌ها را در صفحات گسترده افزایش می‌دهند و آنها را برای فرم‌ها، قالب‌ها و ورود داده‌های مشترک مناسب می‌سازند. فایل‌های XLSX تولید شده تمام عملکردها را هنگام باز شدن در اکسل، 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 جاسازی کنید، به‌طوری که موقعیت، اندازه و مقیاس‌گذاری را پشتیبانی می‌کند. این برای افزودن لوگوها، نمودارها یا نشانگرهای بصری به گزارش‌ها ایده‌آل است. علاوه بر این، کتابخانه از پیوندهای فراخوانی (hyperlinks) و 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")?;
 فارسی