
calamine
Perpustakaan Rust Murni untuk Spreadsheet
Baca XLS, XLSX, XLSM, XLSB, ODS & Lebih Banyak dengan Deserialisasi Tanpa Penyalinan di Rust.
Apa itu calamine?
calamine adalah pustaka Rust murni yang berperforma tinggi untuk membaca dan mendeserialisasi file spreadsheet Excel dan OpenDocument. Ia mendukung format seperti XLS, XLSX, XLSM, XLSB, ODS, dan lainnya, dengan fokus pada ekstraksi data yang cepat, aman, dan tanpa penyalinan. Dirancang untuk keandalan dan ketergantungan minimal, calamine menghindari perpustakaan sistem eksternal dan hanya mengandalkan implementasi Rust murni. API-nya memungkinkan pengembang untuk secara efisien mengekstrak nilai sel, menangani proyek VBA, dan mengurai formula tanpa pengaturan yang rumit atau beban runtime.
Pustaka ini unggul dalam aplikasi yang kritis terhadap kinerja, menawarkan pemrosesan yang jauh lebih cepat dibandingkan alternatif Python, C#, dan Go. Dengan integrasi Serde bawaan, calamine memungkinkan pemetaan data spreadsheet ke struct Rust secara mulus. Ia mendukung pemuatan malas untuk file besar, konfigurasi baris header, dan fitur opsional seperti dukungan tanggal/waktu chrono serta ekstraksi data gambar. Baik Anda membangun alat CLI, backend web, atau sistem tertanam, calamine memberikan kinerja yang kuat dan dapat diprediksi di semua platform.
Memulai dengan calamine
Untuk mulai menggunakan calamine, tambahkan ke proyek Rust Anda melalui Cargo. Anda dapat menginstalnya langsung menggunakan cargo add calamine atau secara manual menambahkan dependensi ke Cargo.toml. Perpustakaan ini tersedia di crates.io dan kode sumbernya dihosting di GitHub calamine. Untuk penggunaan lanjutan, aktifkan fitur opsional seperti chrono untuk dukungan tanggal/waktu atau picture untuk ekstraksi data gambar. Perpustakaan ini dikompilasi dengan bersih pada Rust stabil dan tidak memerlukan binari eksternal atau pustaka sistem.
Instal calamine melalui Cargo
cargo add calamineDeserialisasi Spreadsheet Berbasis Serde
calamine menyediakan integrasi Serde yang kuat untuk memetakan data spreadsheet secara langsung ke struct Rust. Dengan menggunakan RangeDeserializerBuilder, pengembang dapat mendefinisikan model data yang bertipe kuat dan secara otomatis mendeseralisasi baris menjadi catatan terstruktur. Perpustakaan ini menyertakan fungsi bantuan seperti deserialize_as_f64_or_none dan deserialize_as_f64_or_string untuk menangani kolom tipe campuran dengan elegan. Pendekatan ini memastikan keamanan tipe, mengurangi boilerplate, dan memungkinkan validasi struktur data pada waktu kompilasi. Ini sangat berguna untuk pipeline data, alat pelaporan, dan aplikasi ETL di mana keandalan dan kinerja sangat penting.
Deserialisasi Baris Spreadsheet menjadi Struct 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);
} Ekstraksi Proyek VBA dan Rumus
calamine memungkinkan ekstraksi modul proyek VBA dan definisi rumus dari file Excel. Pengembang dapat mengambil kode VBA dari modul, mendeteksi referensi yang rusak, dan memeriksa nama yang didefinisikan serta rumusnya. Kemampuan ini penting untuk alat migrasi, utilitas audit, dan analisis sistem warisan. API menyediakan akses terstruktur ke metadata VBA dan mendukung skenario introspeksi workbook baik yang sederhana maupun kompleks. Baik Anda menganalisis makro untuk keamanan atau mengonversi logika Excel lama, calamine memberikan akses tingkat rendah yang tepat ke konten workbook tersembunyi.
Ekstrak Kode VBA dan Nama yang Didefinisikan
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 Lambat dan Penanganan File Besar
calamine mendukung pemuatan malas (lazy loading) untuk file XLSX dan XLSB, memungkinkan pemrosesan spreadsheet besar secara efisien tanpa memuat semua lembar ke memori sekaligus. Dengan mengonfigurasi baris header dan menggunakan iterasi berbasis rentang, pengembang dapat meminimalkan jejak memori dan memaksimalkan throughput. Fitur ini sangat berharga untuk fungsi serverless, alat CLI, dan penyebaran tersemat di mana sumber daya terbatas. Benchmark menunjukkan calamine membaca lebih dari 1 juta baris dengan overhead memori minimal dibandingkan alternatif seperti openpyxl dan ClosedXML, menjadikannya ideal untuk pipeline ingest data berskala tinggi.
Proses Spreadsheet Besar Secara Efisien
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);
}Optimisasi Kinerja dan Tolok Ukur
calamine memberikan kinerja luar biasa, memproses 41 juta sel dalam kurang dari 25 detik—mengungguli pustaka Python, C#, dan Go hingga 9,4 kali. Desain zero-copy dan alokasi heap minimalnya secara signifikan mengurangi penggunaan CPU dan memori. Benchmark pada file XLSX berukuran 186 MB menunjukkan calamine hanya menggunakan pembacaan disk 186 MB dibandingkan 1,5 GB untuk excelize. Perilaku memori deterministik perpustakaan ini dan tekanan GC yang rendah menjadikannya cocok untuk aplikasi waktu nyata dan sensitif latensi. Pengembang mendapat manfaat dari penggunaan sumber daya yang dapat diprediksi dan throughput yang konsisten di berbagai beban kerja.
