
umya-spreadsheet
ספרייה ב‑Rust טהור לקבצי XLSX/XLSM
קריאה, כתיבה, עיצוב וניהול של גיליונות XLSX/XLSM ללא תלות חיצונית.
מהו umya-spreadsheet?
umya-spreadsheet היא ספרייה בטכנולוגיית Rust גבוהה ביצועים וטהורה לקריאה וכתיבה של קבצי גיליון Excel בפורמטים XLSX ו‑XLSM. היא נועדה לבטיחות ויעילות, נמנעת מקוד לא בטוח ותלויות חיצוניות, מה שהופך אותה לאידיאלית ליישומי שולחן עבודה, עיבוד בצד השרת וסביבות WebAssembly. הספרייה מספקת API של Rust נקי ואידיאומטי לגישה לתאים, שורות, עמודות, סגנונות, תרשימים ותמונות, ומאפשרת למפתחים לבנות כלי גיליון אלקטרוני חזקים ללא צורך ב‑Microsoft Office או אינטרופ COM.
עם תמיכה מלאה בטעינה עצלה, הגנה בסיסמה ועיצוב עשיר, umya-spreadsheet מגשרת על הפער בין ביצועים לשימושיות. היא תומכת ביצוא CSV, יצירת תרשימים, הטמעת תמונות, ובפעולות על טווחים כגון העברה והעתקה. הפרויקט מתוחזק באופן פעיל, מתועד היטב ונבדק, עם דגש על נכונות ותאימות לתכונות המודרניות של Excel. מפתחים יכולים לשלב אותה בכלי CLI, גיבויים באינטרנט, או אפליקציות שולחן עבודה באמצעות מסגרות כמו Tauri או Axo.
התחלה עם umya-spreadsheet
כדי להתחיל להשתמש ב‑umya-spreadsheet, הוסף אותו לקובץ Cargo.toml שלך עם `umya-spreadsheet = "3.1.1"`. לתמיכה ב‑WebAssembly, אפשר את המאפיין `js`. הספרייה קלה בתלותים ומקמפלת במהירות. לאחר ההתקנה, ייבא אותה באמצעות `extern crate umya_spreadsheet;` והתחל לקרוא או לכתוב גיליונות אלקטרוניים. אתה יכול גם לחקור את GitHub של umya-spreadsheet לקבלת דוגמאות, מבחנים ותיעוד. הספרייה תומכת בטעינה עצלה לקבצים גדולים ומציעה טיפול שגיאות חזק.
התקנת umya-spreadsheet באמצעות Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
קריאה וכתיבה של קבצי XLSX/XLSM
umya-spreadsheet מספקת API אינטואיטיביים לקריאה וכתיבה של קבצי XLSX ו-XLMS. השתמש ב-`reader::xlsx::read()` כדי לטעון חוברת עבודה מהדיסק, או ב-`new_file()` כדי ליצור אחת ריקה. הכתיבה פשוטה באותה מידה: קרא ל-`writer::xlsx::write()` עם חוברת העבודה והנתיב הרצוי. הספרייה תומכת בטעינה עצלה באמצעות `lazy_read()` לשיפור הביצועים בקבצים גדולים, ומאפשרת כתיבה מוגנת בסיסמה או הגדרת סיסמאות לאחר היצירה. כל הפעולות בטוחות, ללא העתקה כאשר אפשרי, ומונעות שימוש בבינאריים חיצוניים.
איך לקרוא ולכתוב קובץ XLSX באמצעות Rust?
use std::path::Path;
// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();
// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();
גישה לתאים ועריכת סגנון
גישה ושינוי ערכי תאים היא פשוטה: השתמש ב-`cell(\"A1\")` או `cell((1,1))` לקריאה, וב-`cell_mut()` לכתיבה. סגנונות מנוהלים באמצעות `style_mut()`, המאפשרים שינוי צבע רקע, גופן, גבולות ויישור. הספרייה מציגה סט עשיר של מאפייני סגנון תוך שמירה על הבטחות אי-שינוי כאשר אפשרי. ניתן גם לקבל ערכים מעוצבים, להחיל לוגיקה מותנית, ולעדכן סגנונות במרוכז על פני טווחים. זה הופך אותה לאידיאלית ליצירת דוחות, לוחות מחוונים, או ייצוא נתונים עם עיצוב עקבי.
איך לשנות ערך תא וסגנון באמצעות Rust?
let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
.unwrap()
.cell_mut("A1")
.set_value("Hello, Rust!");
let mut style = book.sheet_by_name_mut("Sheet1")
.unwrap()
.style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);
תמיכה בתרשימים ותמונות
umya-spreadsheet תומך ביצירה ועריכת גרפים—כולל גרפי קו, עמודות ושטח—על ידי הגדרת טווחי סדרה וסמנים. ניתן לשבץ תמונות ישירות בגיליונות באמצעות המבנה `Image`, עם תמיכה ב‑PNG ובפורמטים אחרים בהתאם לתכונות המופעלות. גרפים ותמונות משולבות באופן חלק עם קואורדינטות תאים ושכבות ציור, מה שמאפשר יצירת לוחות מחוונים דינאמיים. בעוד שחלק מתכונות הציור המתקדמות עדיין מתפתחות, הפונקציונליות המרכזית מוכנה לייצור וניתנת להרחבה.
איך להוסיף גרף קו לגיליון אלקטרוני באמצעות Rust?
let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
umya_spreadsheet::structs::ChartType::LineChart,
from_marker,
to_marker,
series,
);
book.sheet_by_name_mut("Sheet1")
.unwrap()
.add_chart(chart);
פעולות על טווחים והגנה עם סיסמה
בצע פעולות מתקדמות כגון העברה, העתקה ושינוי גודל של טווחים באמצעות `move_range()`, המאפשרים ארגון מחדש דינאמי של נתונים. הספרייה תומכת גם בחוברות עבודה מוגנות בסיסמה: כתיבת קבצים עם `write_with_password()` או החלת סיסמאות על קבצים קיימים באמצעות `set_password()`. תכונות אלו קריטיות לטיפול מאובטח בנתונים ביישומים ארגוניים או רגישים לתקנות. בשילוב עם עיצוב ללא תלות חיצונית ותאימות ל‑WASM, umya-spreadsheet מספקת גם גמישות וגם אבטחה.
איך להעביר טווח ולהגן על קובץ עם סיסמה באמצעות Rust?
// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
.unwrap()
.move_range(range, &10, &2);
// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
&book,
Path::new("./protected.xlsx"),
"mypassword",
).unwrap();
