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\". הספרייה דורשת 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")?;
 עִברִית