
calamine
Perpustakaan Rust Tulen untuk Hamparan
Baca XLS, XLSX, XLSM, XLSB, ODS & Lainnya dengan Penyahserian Tanpa Salinan dalam Rust.
Apakah calamine?
calamine ialah perpustakaan Rust tulen berprestasi tinggi untuk membaca dan menyahseri fail hamparan Excel dan OpenDocument. Ia menyokong format seperti XLS, XLSX, XLSM, XLSB, ODS, dan lain-lain, dengan fokus pada pengekstrakan data yang cepat, selamat, dan tanpa salinan. Direka untuk kebolehpercayaan dan kebergantungan minimum, calamine mengelakkan perpustakaan sistem luar dan bergantung sepenuhnya pada pelaksanaan Rust tulen. API‑nya membolehkan pembangun mengekstrak nilai sel dengan cekap, mengendalikan projek VBA, dan mengurai formula tanpa persediaan yang rumit atau beban masa jalan.
Perpustakaan ini cemerlang dalam aplikasi yang kritikal terhadap prestasi, menawarkan pemprosesan yang jauh lebih pantas berbanding alternatif Python, C#, dan Go. Dengan integrasi Serde terbina, calamine membolehkan pemetaan data hamparan secara lancar ke struktur Rust. Ia menyokong pemuatan malas untuk fail besar, konfigurasi baris tajuk, dan ciri pilihan seperti sokongan tarikh/masa chrono serta pengekstrakan data gambar. Sama ada anda membina alat CLI, backend web, atau sistem terbenam, calamine memberikan prestasi yang kukuh dan dapat diramalkan merentasi platform.
Mula Menggunakan calamine
Untuk mula menggunakan calamine, tambahkan ia ke projek Rust anda melalui Cargo. Anda boleh memasangnya secara langsung menggunakan cargo add calamine atau menambah kebergantungan secara manual ke dalam Cargo.toml. Perpustakaan ini tersedia di crates.io dan kod sumbernya dihoskan di GitHub calamine. Untuk penggunaan lanjutan, aktifkan ciri pilihan seperti chrono untuk sokongan tarikh/masa atau picture untuk pengekstrakan data imej. Perpustakaan ini disusun dengan bersih pada Rust stabil dan tidak memerlukan binari luaran atau perpustakaan sistem.
Pasang calamine melalui Cargo
cargo add calamineDeserialisasi Hamparan Berasaskan Serde
calamine menyediakan integrasi Serde yang kuat untuk memetakan data hamparan secara langsung ke struktur Rust. Dengan menggunakan RangeDeserializerBuilder, pembangun dapat mendefinisikan model data berjenis kuat dan secara automatik menyahseri baris menjadi rekod berstruktur. Perpustakaan ini termasuk fungsi bantuan seperti deserialize_as_f64_or_none dan deserialize_as_f64_or_string untuk mengendalikan lajur berjenis campuran dengan elegan. Pendekatan ini memastikan keselamatan jenis, mengurangkan boilerplate, dan membolehkan pengesahan pada masa kompilasi bagi struktur data. Ia sangat berguna untuk saluran data, alat pelaporan, dan aplikasi ETL di mana kebolehpercayaan dan prestasi adalah kritikal.
Deserialisasi Baris Hamparan ke dalam Struktur 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);
} Pengekstrakan Projek VBA dan Formula
calamine membolehkan pengekstrakan modul projek VBA dan definisi formula daripada fail Excel. Pembangun boleh mendapatkan kod VBA daripada modul, mengesan rujukan yang rosak, dan memeriksa nama yang ditakrifkan serta formulanya. Keupayaan ini penting untuk alat migrasi, utiliti audit, dan analisis sistem legasi. API menyediakan akses berstruktur kepada metadata VBA dan menyokong kedua-dua senario introspeksi buku kerja yang mudah dan kompleks. Sama ada anda menganalisis makro untuk keselamatan atau menukar logik Excel legasi, calamine memberikan akses tepat pada peringkat rendah kepada kandungan buku kerja yang tersembunyi.
Ekstrak Kod VBA dan Nama Terdefinisi
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);
}Pemuat Malas dan Pengendalian Fail Besar
calamine menyokong pemuatan malas untuk fail XLSX dan XLSB, membolehkan pemprosesan berkesan hamparan besar tanpa memuatkan semua helaian ke dalam memori sekaligus. Dengan mengkonfigurasi baris tajuk dan menggunakan iterasi berasaskan julat, pembangun dapat meminimumkan jejak memori dan memaksimumkan kadar aliran. Ciri ini sangat berharga untuk fungsi tanpa pelayan, alat CLI, dan penyebaran terbenam di mana sumber terhad. Penanda aras menunjukkan calamine membaca lebih daripada 1 juta baris dengan beban memori yang minimum berbanding alternatif seperti openpyxl dan ClosedXML, menjadikannya ideal untuk paip pengambilan data berskala tinggi.
Proses Hamparan Besar dengan Cekap
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);
}Pengoptimuman Prestasi dan Penanda Aras
calamine memberikan prestasi luar biasa, memproses 41 juta sel dalam masa kurang daripada 25 saat—mengatasi perpustakaan Python, C#, dan Go sehingga 9.4 kali ganda. Reka bentuk zero-copy dan peruntukan heap yang minimum mengurangkan penggunaan CPU dan memori dengan ketara. Penilaian pada fail XLSX berukuran 186MB menunjukkan calamine hanya menggunakan bacaan cakera 186MB berbanding 1.5GB untuk excelize. Tingkah laku memori yang deterministik dan tekanan GC yang rendah menjadikan perpustakaan ini sesuai untuk aplikasi masa nyata dan sensitif kependaman. Pembangun mendapat manfaat daripada penggunaan sumber yang dapat diramalkan dan kadar aliran yang konsisten merentasi beban kerja yang pelbagai.
