rust_xlsxwriter

 
 

کتابخانه منبع باز Rust برای فایل‌های Excel XLSX

تولید فایل‌های Excel 2007+ XLSX با قالب‌بندی کامل، نمودارها، فرمول‌ها و تصاویر از طریق API Rust.

rust_xlsxwriter چیست؟

rust_xlsxwriter یک crate با عملکرد بالا و خالص Rust برای تولید فایل‌های Excel XLSX است که نیازی به Excel یا وابستگی‌های خارجی ندارد. این کتابخانه به توسعه‌دهندگان امکان می‌دهد به‌صورت برنامه‌نویسی‌شده صفحات گسترده شامل متن، عدد، تاریخ، فرمول، نمودار، تصویر، سلول‌های ادغام‌شده، قالب‌بندی شرطی، اعتبارسنجی داده و موارد دیگر را ایجاد کنند. این ابزار برای قابلیت اطمینان و سرعت طراحی شده و به‌دقت فرمت بومی Excel را تطبیق می‌دهد و حالت حافظه ثابت را برای مجموعه‌داده‌های بزرگ پشتیبانی می‌کند. این کتابخانه بازنویسی وفادار Rust از کتابخانه محبوب Python XlsxWriter است، با APIهای بومی و مستندات جامع.

rust_xlsxwriter به‌طور انحصاری بر نوشتن فایل‌های Excel تمرکز دارد—بدون خواندن یا تغییر فایل‌های موجود. این کتابخانه از ویژگی‌های مدرن Excel مانند آرایه‌های پویا، اسپارکلاین‌ها، چک‌باکس‌ها، جعبه‌های متن، جدول‌ها، فیلترهای خودکار، نام‌های تعریف‌شده و تم‌های کتاب کار پشتیبانی می‌کند. با ویژگی‌های اختیاری مانند سریال‌سازی Serde، پشتیبانی از تاریخ‌های chrono/jiff، و ادغام با Polars، به اکوسیستم‌های متنوع Rust سازگار می‌شود. عملکرد آن تنها پس از نسخه C بهتر است و اجرای ۳.۸× سریع‌تر نسبت به XlsxWriter پایتون ارائه می‌دهد. برای جزئیات کامل، به مخزن GitHub rust_xlsxwriter مراجعه کنید.

Previous Next

شروع کار با rust_xlsxwriter

rust_xlsxwriter در crates.io موجود است و می‌توان آن را با `cargo add rust_xlsxwriter` نصب کرد. برای عملکرد پیشرفته، ویژگی‌های اختیاری مانند `constant_memory`، `chrono`، `serde` یا `polars` را فعال کنید. این کتابخانه به Rust 1.56+ نیاز دارد و به باینری‌های بومی کامپایل می‌شود بدون وابستگی‌های زمان اجرا خارجی جز crate `zip` (به طور پیش‌فرض). مستندات کامل شامل راهنمای کاربر، آموزش و کتاب‌پخت دارد. برای مثال‌های دقیق و کد منبع، به مخزن GitHub rust_xlsxwriter مراجعه کنید.

نصب rust_xlsxwriter از طریق Cargo

cargo add rust_xlsxwriter

نوشتن سلول‌های قالب‌بندی‌شده با متن، اعداد و تاریخ‌ها

rust_xlsxwriter یک API ساده و شهودی برای نوشتن محتوای قالب‌بندی‌شده در سلول‌های Excel فراهم می‌کند. توسعه‌دهندگان می‌توانند با استفاده از ساختار `Format` قالب‌های سفارشی برای اعداد، تاریخ‌ها، قلم‌ها، حاشیه‌ها، تراز و رنگ‌ها اعمال کنند. این کتابخانه از نوشتن متن ساده، مقادیر عددی، تاریخ‌ها، فرمول‌ها و URLها با قالب‌بندی اختیاری پشتیبانی می‌کند. همچنین رشته‌های چندقالب غنی برای قالب‌بندی ترکیبی در یک سلول را پشتیبانی می‌نماید. این ویژگی آن را برای تولید گزارش‌ها، داشبوردها و خروجی‌های داده‌ای که وضوح بصری و ساختار مهم هستند، ایده‌آل می‌سازد. API اطمینان می‌دهد که با موتور قالب‌بندی بومی 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 از تولید نمودارهای حرفه‌ای، اسپارکلاین‌ها و درج مستقیم تصاویر در فایل‌های اکسل پشتیبانی می‌کند. توسعه‌دهندگان می‌توانند نمودارهای میله‌ای، خطی، دایره‌ای، پراکنده و مساحتی را با محورهای قابل تنظیم، افسانه‌ها و سری‌های داده ایجاد کنند. اسپارکلاین‌ها نمایش بصری فشرده‌ای از روندها را درون سلول‌ها فراهم می‌آورند. تصاویر (PNG، JPEG، GIF، BMP) می‌توانند درج و با گزینه‌های مقیاس‌بندی و لنگرگذاری موقعیت‌یابی شوند. این عناصر بصری روایت داده‌ها و قابلیت‌های گزارش‌دهی را تقویت می‌کنند. این کتابخانه سازگاری با Excel 2007+ را تضمین می‌کند و دقت رندرینگ را در سرتاسر پلتفرم‌ها حفظ می‌نماید.

چگونه یک نمودار و تصویر را به اکسل از طریق 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 ویژگی‌های پیشرفته قالب‌بندی اکسل مانند بازه‌های ادغام‌شده، جداول ساختاریافته، فیلترهای خودکار و قوانین قالب‌بندی شرطی را فعال می‌کند. توسعه‌دهندگان می‌توانند سلول‌ها را برای سرصفحه‌ها یا برچسب‌ها ادغام کنند، سبک‌های جدول را با ردیف‌ها/ستون‌های نواربندی‌شده اعمال کنند و فیلترها را برای تعامل کاربر تعریف نمایند. قالب‌بندی شرطی از مقیاس‌های رنگی، نوارهای داده، مجموعه‌های آیکون و فرمول‌های سفارشی برای برجسته‌سازی روندها یا ناهنجاری‌ها پشتیبانی می‌کند. این ویژگی‌ها خوانایی داده‌ها و تعامل در کتاب‌کارهای تولید شده را بهبود می‌بخشند. 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) پشتیبانی می‌کند که داده‌ها را به‌صورت افزایشی روی دیسک می‌نویسد و استفاده از heap را به حداقل می‌رساند. این حالت برای تولید فایل‌های Excel چند مگابایتی بدون خطای OOM ایده‌آل است. نتایج بنچمارک نشان می‌دهد که حدود ~3.8× سریع‌تر از XlsxWriter پایتون اجرا می‌شود و تنها ~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")?;
 فارسی