
calamine
Pure Rust-bibliotheek voor spreadsheets
Lees XLS, XLSX, XLSM, XLSB, ODS en meer met zero-copy-deserialisatie in Rust.
Wat is calamine?
calamine is een high-performance, pure Rust bibliotheek voor het lezen en deserialiseren van Excel- en OpenDocument-spreadsheetbestanden. Het ondersteunt formaten zoals XLS, XLSX, XLSM, XLSB, ODS en meer, met de focus op snelle, veilige en zero-copy gegevensextractie. Ontworpen voor betrouwbaarheid en minimale afhankelijkheden, vermijdt calamine externe systeembibliotheken en vertrouwt uitsluitend op pure Rust-implementaties. De API stelt ontwikkelaars in staat om efficiënt celwaarden te extraheren, VBA-projecten te verwerken en formules te parseren zonder complexe configuratie of runtime overhead.
De bibliotheek blinkt uit in prestatiekritische toepassingen en biedt aanzienlijk snellere verwerking dan alternatieven in Python, C# en Go. Met ingebouwde Serde-integratie maakt calamine naadloze mapping van spreadsheetgegevens naar Rust-structuren mogelijk. Het ondersteunt lazy loading voor grote bestanden, configuratie van de koprij, en optionele functies zoals chrono datum/tijd-ondersteuning en extractie van afbeeldingsgegevens. Of je nu CLI-tools, web-backends of embedded systemen bouwt, calamine levert robuuste, voorspelbare prestaties op alle platformen.
Aan de slag met calamine
Om calamine te gebruiken, voeg het toe aan je Rust-project via Cargo. Je kunt het direct installeren met cargo add calamine of de afhankelijkheid handmatig toevoegen aan je Cargo.toml. De bibliotheek is beschikbaar op crates.io en de broncode wordt gehost op calamine GitHub. Voor geavanceerd gebruik kun je optionele functies inschakelen, zoals chrono voor datum/tijdondersteuning of picture voor het extraheren van afbeeldingsgegevens. De bibliotheek compileert schoon op stabiele Rust en vereist geen externe binaries of systeem‑bibliotheken.
Installeer calamine via Cargo
cargo add calamineSerde-gebaseerde spreadsheet-deserialisatie
calamine biedt krachtige Serde-integratie voor het rechtstreeks in kaart brengen van spreadsheetgegevens naar Rust-structs. Met RangeDeserializerBuilder kunnen ontwikkelaars sterk getypeerde datamodellen definiëren en automatisch rijen deserialiseren naar gestructureerde records. De bibliotheek bevat hulpfuncties zoals deserialize_as_f64_or_none en deserialize_as_f64_or_string om gemengde kolommen elegant af te handelen. Deze aanpak garandeert typeveiligheid, vermindert boilerplate en maakt compile‑tijdvalidatie van datastructuren mogelijk. Het is vooral nuttig voor datapijplijnen, rapportagetools en ETL-toepassingen waar betrouwbaarheid en prestaties cruciaal zijn.
Deserialiseer spreadsheetrijen naar Rust-structuren
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-project en formule-extractie
calamine maakt het mogelijk om VBA-projectmodules en formuledefinities uit Excel-bestanden te extraheren. Ontwikkelaars kunnen VBA-code uit modules ophalen, gebroken verwijzingen detecteren en gedefinieerde namen en hun formules inspecteren. Deze mogelijkheid is essentieel voor migratietools, audit-hulpmiddelen en analyse van legacy-systemen. De API biedt gestructureerde toegang tot VBA-metadata en ondersteunt zowel eenvoudige als complexe werkboek‑introspectiescenario's. Of je nu macro's analyseert voor beveiliging of legacy Excel-logica converteert, calamine levert precieze, low‑level toegang tot verborgen werkboekinhoud.
VBA-code en gedefinieerde namen extraheren
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);
}Lazy loading en verwerking van grote bestanden
calamine ondersteunt lazy loading voor XLSX- en XLSB-bestanden, waardoor efficiënte verwerking van grote spreadsheets mogelijk is zonder alle bladen in één keer in het geheugen te laden. Door header‑rijen te configureren en iteratie op basis van bereiken te gebruiken, kunnen ontwikkelaars de geheugengebruik minimaliseren en de doorvoer maximaliseren. Deze functie is bijzonder waardevol voor serverless‑functies, CLI‑tools en embedded implementaties waar middelen beperkt zijn. Benchmarks tonen aan dat calamine meer dan 1 miljoen rijen leest met minimale geheugenbelasting vergeleken met alternatieven zoals openpyxl en ClosedXML, waardoor het ideaal is voor grootschalige data‑ingestiepijplijnen.
Grote spreadsheets efficiënt verwerken
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);
}Prestatie-optimalisatie en benchmarks
calamine levert uitzonderlijke prestaties, verwerkt 41 miljoen cellen in minder dan 25 seconden—en overtreft Python-, C#- en Go-bibliotheken tot wel 9,4x. Het zero-copy-ontwerp en minimale heap‑allocaties verminderen CPU- en geheugengebruik aanzienlijk. Benchmarks op een XLSX‑bestand van 186 MB tonen aan dat calamine slechts 186 MB schijf‑lezingen gebruikt versus 1,5 GB voor excelize. Het deterministische geheugengedrag van de bibliotheek en de lage GC‑druk maken het geschikt voor realtime- en latentie‑gevoelige toepassingen. Ontwikkelaars profiteren van voorspelbaar resource‑gebruik en consistente doorvoer over diverse workloads.
