
calamine
Cədvəllər üçün Saf Rust Kitabxanası
Rust‑da Sıfır Nüsxə Deserializasiyası ilə XLS, XLSX, XLSM, XLSB, ODS və daha çoxunu oxuyun.
Calamine nədir?
calamine, Excel və OpenDocument elektron cədvəl fayllarını oxumaq və deserializasiya etmək üçün yüksək performanslı, təmiz Rust kitabxanasıdır. XLS, XLSX, XLSM, XLSB, ODS və daha çox formatları dəstəkləyir, sürətli, təhlükəsiz və sıfır nüsxə məlumat çıxarışına yönəlib. Etibarlılıq və minimal asılılıqlar üçün dizayn edilmiş calamine, xarici sistem kitabxanalarından çəkinir və yalnız təmiz Rust tətbiqlərinə əsaslanır. API‑si, inkişafçılara hüceyrə dəyərlərini səmərəli şəkildə çıxarmağa, VBA layihələrini idarə etməyə və formulları mürəkkəb quraşdırma və ya icra vaxtı yükləməsi olmadan təhlil etməyə imkan verir.
Kitabxana performans-əhəmiyyətli tətbiqlərdə üstünlük göstərir və Python, C# və Go alternativlərinə nisbətən xeyli sürətli emal təklif edir. Daxili Serde inteqrasiyası ilə calamine, elektron cədvəl məlumatlarını Rust strukturlarına problemsiz şəkildə xəritələməyə imkan verir. Böyük fayllar üçün tənbəl yükləmə, başlıq sətiri konfiqurasiyası və chrono tarix/vaxt dəstəyi və şəkil məlumatı çıxarışı kimi əlavə xüsusiyyətləri dəstəkləyir. CLI alətləri, veb backendlər və ya gömülü sistemlər qurursunuzsa, calamine platformalar arasında güclü, proqnozlaşdırıla bilən performans təqdim edir.
Calamine ilə Başlamaq
calamine-dən istifadə etməyə başlamaq üçün onu Cargo vasitəsilə Rust layihənizə əlavə edin. cargo add calamine istifadə edərək birbaşa quraşdıra bilərsiniz və ya asılılığı Cargo.toml faylınıza əl ilə əlavə edin. Kitabxana crates.io saytında mövcuddur və mənbə kodu calamine GitHub ünvanında yerləşir. Daha inkişaf etmiş istifadə üçün tarix/vaxt dəstəyi üçün chrono və ya şəkil məlumatının çıxarılması üçün picture kimi əlavə xüsusiyyətləri aktivləşdirin. Kitabxana sabit Rust üzərində təmiz şəkildə tərtib olunur və heç bir xarici ikili fayl və ya sistem kitabxanası tələb etmir.
Calamine-i Cargo vasitəsilə quraşdırın
cargo add calamineSerde-əsaslı Cədvəl Deserializasiyası
calamine güclü Serde inteqrasiyası təmin edir, cədvəl məlumatlarını birbaşa Rust strukturlarına xəritələmək üçün. RangeDeserializerBuilder istifadə edərək, inkişafçılar güclü tipli məlumat modelləri təyin edə və sətirləri avtomatik olaraq strukturlaşdırılmış qeydlərə deserializasiya edə bilərlər. Kitabxana deserialize_as_f64_or_none və deserialize_as_f64_or_string kimi köməkçi funksiyaları ehtiva edir ki, qarışıq tipli sütunları incəliklə idarə etsin. Bu yanaşma tip təhlükəsizliyini təmin edir, təkrarlanan kodu azaldır və məlumat strukturlarının tərtib vaxtı yoxlanmasını mümkün edir. Xüsusilə məlumat boru kəmərləri, hesabat alətləri və ETL tətbiqlərində etibarlılıq və performansın kritik olduğu hallarda faydalıdır.
Cədvəl Sətirlərini Rust Strukturlarına Deserializasiya edin
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 Layihəsi və Formul Çıxarışı
calamine, Excel fayllarından VBA layihə modullarının və formul təriflərinin çıxarılmasını təmin edir. İnkişafçılar modullardan VBA kodunu əldə edə, qırılmış istinadları aşkar edə və təyin olunmuş adları və onların formullarını yoxlaya bilərlər. Bu imkan miqrasiya alətləri, audit vasitələri və köhnə sistemlərin təhlili üçün vacibdir. API, VBA metadata‑sına strukturlaşdırılmış çıxışı təmin edir və həm sadə, həm də mürəkkəb iş dəftəri introspeksiya ssenarilərini dəstəkləyir. Makroları təhlükəsizlik üçün təhlil edirsinizsə və ya köhnə Excel məntiqini çevirmək istəyirsinizsə, calamine gizli iş dəftəri məzmununa dəqiq, aşağı səviyyəli çıxış təqdim edir.
VBA kodunu və təyin edilmiş adları çıxarın
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);
}Tənbəl Yükləmə və Böyük Faylların İdarə Edilməsi
calamine, XLSX və XLSB faylları üçün tənbəl yükləməni dəstəkləyir, bütün vərəqləri bir anda yaddaşa yükləmədən böyük cədvəllərin səmərəli emalını mümkün edir. Başlıq sətirlərini konfiqurasiya edərək və aralıq əsaslı iterasiyadan istifadə edərək, inkişafçılar yaddaş izini minimuma endirə və ötürmə sürətini maksimuma çatdıra bilərlər. Bu xüsusiyyət, resursların məhdud olduğu serverless funksiyalar, CLI alətləri və gömülü yerləşdirmələr üçün xüsusilə dəyərlidir. Benchmarklar göstərir ki, calamine openpyxl və ClosedXML kimi alternativlərlə müqayisədə minimal yaddaş yükü ilə 1M+ sətiri oxuyur, bu da onu yüksək ölçülü data qəbul boru kəmərləri üçün ideal edir.
Böyük elektron cədvəlləri səmərəli şəkildə işləyin
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);
}Performans Optimallaşdırması və Benchmarklar
calamine istisna performans təqdim edir, 41 milyon hüceyrəni 25 saniyədən az müddətdə işləyir—Python, C# və Go kitabxanalarından 9,4x daha sürətlidir. Onun sıfır nüsxə (zero-copy) dizaynı və minimal heap ayırmaları CPU və yaddaş istifadəsini əhəmiyyətli dərəcədə azaldır. 186 MB-lik XLSX faylı üzərindəki benchmarklar göstərir ki, calamine yalnız 186 MB disk oxuması istifadə edir, excelize isə 1,5 GB tələb edir. Kitabxananın deterministik yaddaş davranışı və aşağı GC təzyiqi onu real‑zamanlı və gecikmə‑həssas tətbiqlər üçün uyğun edir. İnkişafçılar proqnozlaşdırıla bilən resurs istifadəsindən və müxtəlif iş yükləri üzrə sabit ötürmə sürətindən faydalanır.
