
calamine
ספרייה ב‑Rust טהור לגיליונות
קרא XLS, XLSX, XLSM, XLSB, ODS ועוד עם דסיריאליזציה ללא העתקה ב‑Rust.
מהו calamine?
calamine היא ספרייה בעלת ביצועים גבוהים, כתובה ב‑Rust טהור, לקריאה ולפירוק של קבצי גיליונות אלקטרוניים של Excel ו‑OpenDocument. היא תומכת בפורמטים כגון XLS, XLSX, XLSM, XLSB, ODS ועוד, ומתמקדת בחילוץ נתונים מהיר, בטוח וללא העתקה. הספרייה נועדה לאמינות ולתלות מינימלית, ומונעת שימוש בספריות מערכת חיצוניות ומתבססת רק על יישומים בטהור Rust. ה‑API שלה מאפשר למפתחים לחלץ ערכי תאים ביעילות, לטפל בפרויקטי VBA ולנתח נוסחאות ללא הגדרה מורכבת או עומס זמן ריצה.
הספרייה מצטיינת ביישומים קריטיים לביצועים, ומציעה עיבוד מהיר משמעותית יותר מאלטרנטיבות ב‑Python, C# ו‑Go. עם אינטגרציה מובנית של Serde, calamine מאפשרת מיפוי חלק של נתוני הגיליון למבני Rust. היא תומכת בטעינה עצלה לקבצים גדולים, בתצורת שורת כותרת, ובתכונות אופציונליות כגון תמיכה בתאריכים/זמנים של chrono וחילוץ נתוני תמונות. בין אם אתה בונה כלי CLI, גיבויים לאינטרנט או מערכות משובצות, calamine מספקת ביצועים חזקים וניתנים לחיזוי על פני פלטפורמות.
התחלה עם calamine
כדי להתחיל להשתמש ב‑calamine, הוסף אותו לפרויקט Rust שלך דרך Cargo. אתה יכול להתקין אותו ישירות באמצעות cargo add calamine או להוסיף ידנית את התלות לקובץ Cargo.toml שלך. הספרייה זמינה בcrates.io וקוד המקור שלה מתארח בGitHub של calamine. לשימוש מתקדם, אפשר תכונות אופציונליות כמו chrono לתמיכה בתאריך/זמן או picture לחילוץ נתוני תמונה. הספרייה מתורגמת בצורה נקייה על Rust יציב ואינה דורשת קבצים בינאריים חיצוניים או ספריות מערכת.
התקנת calamine דרך Cargo
cargo add calamineדסיריאליזציה של גיליון אלקטרוני מבוססת Serde
calamine מספקת אינטגרציה חזקה עם Serde למיפוי נתוני גיליונות אל מבני Rust ישירות. באמצעות RangeDeserializerBuilder, מפתחים יכולים להגדיר מודלים חזקים טיפוסית ולבצע דסיריאליזציה אוטומטית של שורות לרשומות מובנות. הספרייה כוללת פונקציות עזר כגון deserialize_as_f64_or_none ו-deserialize_as_f64_or_string לטיפול בעמודות בעלות סוגים מעורבים בצורה חלקה. גישה זו מבטיחה בטיחות טיפוס, מצמצמת קוד מיותר, ומאפשרת אימות בזמן הקומפילציה של מבני הנתונים. היא שימושית במיוחד לצינורות נתונים, כלי דיווח, ויישומי ETL שבהם אמינות וביצועים הם קריטיים.
דסיריאליזציה של שורות גיליון אלקטרוני למבני Rust
use calamine::{deserialize_as_f64_or_none, open_workbook, RangeDeserializerBuilder, Reader, Xlsx};
use serde::Deserialize;
#[derive(Deserialize)]
struct Record {
metric: String,
#[serde(deserialize_with = "deserialize_as_f64_or_none")]
value: Option,
}
let mut excel: Xlsx<_> = open_workbook("file.xlsx")?;
let range = excel.worksheet_range("Sheet1")?;
let iter = RangeDeserializerBuilder::with_headers(&["metric", "value"]).from_range(&range)?;
for result in iter {
let record: Record = result?;
println!("{:?}", record);
} חילוץ פרויקט VBA ונוסחאות
calamine מאפשר חילוץ מודולי פרויקט VBA והגדרות נוסחאות מקבצי Excel. מפתחים יכולים לאחזר קוד VBA ממודולים, לאתר הפניות שבורות, ולבדוק שמות מוגדרים והנוסחאות שלהם. יכולת זו חיונית לכלי הגירה, כלי ביקורת וניתוח מערכות מורשת. ה-API מספק גישה מובנית למטא-נתוני VBA ותומך בתרחישי חקירה של חוברות עבודה פשוטים ומורכבים כאחד. בין אם אתה מנתח מקרו לצורכי אבטחה או ממיר לוגיקה של Excel ישן, calamine מספק גישה מדויקת ברמת נמוכה לתוכן החבילה המוסתר.
חילוץ קוד VBA ושמות מוגדרים
use calamine::{open_workbook_auto, Reader};
let mut workbook = open_workbook_auto("file.xlsx")?;
if let Ok(Some(vba)) = workbook.vba_project() {
let module = vba.get_module("Module1").unwrap();
println!("{}", module);
for ref in vba.get_references() {
if ref.is_missing() { println!("Broken: {}", ref.name); }
}
}
for (name, formula) in workbook.defined_names() {
println!("{}: {}", name, formula);
}טעינה עצלה וטיפול בקבצים גדולים
calamine תומך בטעינה עצלה (lazy loading) לקבצי XLSX ו‑XLSB, מה שמאפשר עיבוד יעיל של גיליונות גדולים מבלי לטעון את כל הגליונות לזיכרון בבת אחת. על ידי קביעת שורות כותרת ושימוש באיטרציה מבוססת טווח, מפתחים יכולים למזער את footprint הזיכרון ולהגדיל את קצב העיבוד. תכונה זו בעלת ערך גבוה במיוחד עבור פונקציות ללא שרת, כלי CLI, והפצות משובצות שבהן המשאבים מוגבלים. מדדי ביצועים מראים ש‑calamine קורא יותר ממיליון שורות עם עומס זיכרון מינימלי בהשוואה לחלופות כגון openpyxl ו‑ClosedXML, מה שהופך אותו לאידיאלי לצינורות קלט נתונים בקנה מידה גבוה.
עיבוד גיליונות אלקטרוניים גדולים ביעילות
use calamine::{open_workbook, Reader, Xlsx};
let mut excel: Xlsx<_> = open_workbook("large.xlsx")?;
let range = excel
.worksheet_range("Sheet1")?
.expect("Sheet not found");
for row in range.rows() {
// Process row without loading entire file
process_row(row);
}אופטימיזציית ביצועים ובדיקות ביצועים
calamine מספקת ביצועים יוצאי דופן, מעבדת 41 מיליון תאים בפחות מ‑25 שניות—מתעלה על ספריות Python, C# ו‑Go בעד 9.4 פעמים. העיצוב ללא העתקה והקצאות ערימה מינימליות מצמצמים משמעותית את השימוש במעבד ובזיכרון. מדדי ביצועים על קובץ XLSX בגודל 186 מ״ב מראים ש‑calamine משתמשת רק ב‑186 מ״ב קריאות דיסק לעומת 1.5 ג״ב עבור excelize. ההתנהגות הזיכרונית הדטרמיניסטית והלחץ הנמוך על מנגנון האיסוף (GC) של הספרייה הופכים אותה למתאימה ליישומים בזמן אמת ובעלי רגישות לשיהוי. המפתחים נהנים משימוש משאבים צפוי ותפוקה עקבית על פני עומסי עבודה מגוונים.
