rust_xlsxwriter

 
 

ספריית Rust בקוד פתוח לקבצי Excel XLSX

צור קבצי Excel 2007+ XLSX עם עיצוב מלא, גרפים, נוסחאות ותמונות באמצעות API של Rust.

מהו rust_xlsxwriter?

rust_xlsxwriter הוא חבילה (crate) בטכנולוגיית Rust בעלת ביצועים גבוהים, המשמשת ליצירת קבצי Excel XLSX ללא צורך ב‑Excel או בתלויות חיצוניות. היא מאפשרת למפתחים ליצור גיליונות אלקטרוניים באופן תכנותי עם טקסט, מספרים, תאריכים, נוסחאות, גרפים, תמונות, תאים ממוזגים, עיצוב מותנה, אימות נתונים ועוד. תוכננה לאמינות ומהירות, והיא תואמת במדויק את פורמט הקובץ הטבעי של Excel ותומכת במצב זיכרון קבוע עבור מערכי נתונים גדולים. הספרייה היא גרסה נאמנה ב‑Rust של ספריית Python הפופולרית XlsxWriter, עם API idiomatic ותיעוד מקיף.

rust_xlsxwriter מתמקד באופן בלעדי בכתיבת קבצי Excel — ללא קריאה או שינוי של קבצים קיימים. הוא תומך בתכונות מודרניות של Excel כגון מערכים דינמיים, ספארקלאיינס, תיבות סימון, תיבות טקסט, טבלאות, מסננים אוטומטיים, שמות מוגדרים, ונושאי חוברת עבודה. עם תכונות אופציונליות כמו סריאליזציית Serde, תמיכת תאריכים chrono/jiff, ושילוב עם Polars, הוא מתאים למגוון מערכות האקוסיסטם של Rust. הביצועים שלו הם רק אחרי גרסת ה‑C, ומספקים ביצוע מהיר ב‑3.8× יותר מאשר XlsxWriter של Python. לפרטים מלאים, ראו את מאגר ה‑GitHub של rust_xlsxwriter.

Previous Next

התחלה עם rust_xlsxwriter

rust_xlsxwriter זמין ב‑crates.io וניתן להתקין אותו באמצעות `cargo add rust_xlsxwriter`. לקבלת פונקציונליות משופרת, אפשר להפעיל תכונות אופציונליות כגון `constant_memory`, `chrono`, `serde`, או `polars`. הספרייה דורשת Rust 1.56+ ומקמפלת לבינאריים מקומיים ללא תלות בזמן ריצה חיצונית מעבר ל‑`zip` crate (בברירת מחדל). היא מתועדת במלואה עם מדריך משתמש, מדריך לימוד, וספר מתכונים. לדוגמאות מפורטות וקוד המקור, בקרו ב‑מאגר 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 תומך ביצירת גרפים מקצועיים, ספארקליינס והטמעת תמונות ישירות בקבצי 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")?;
 עִברִית