
calamine
Rent Rust-bibliotek for regneark
Les XLS, XLSX, XLSM, XLSB, ODS og mer med nullkopi-deserialisering i Rust.
Hva er calamine?
calamine er et høyytelses, rent Rust-bibliotek for lesing og deserialisering av Excel- og OpenDocument-regnearkfiler. Det støtter formater som XLS, XLSX, XLSM, XLSB, ODS og flere, med fokus på rask, sikker og null‑kopi datainnhenting. Designet for pålitelighet og minimale avhengigheter, unngår calamine eksterne systembiblioteker og baserer seg kun på rene Rust-implementasjoner. API-et gjør det mulig for utviklere å effektivt hente ut celleverdier, håndtere VBA-prosjekter og parse formler uten kompleks oppsett eller kjøretidskostnad.
Biblioteket utmerker seg i ytelseskritiske applikasjoner, og tilbyr betydelig raskere behandling enn alternativer i Python, C# og Go. Med innebygd Serde-integrasjon gjør calamine det enkelt å mappe regnearkdata til Rust-strukturer. Det støtter lat lasting for store filer, konfigurasjon av overskriftsrad, og valgfrie funksjoner som chrono dato-/tidstøtte og uttrekk av bildedata. Enten du bygger CLI-verktøy, web‑backend eller innebygde systemer, leverer calamine robust og forutsigbar ytelse på tvers av plattformer.
Kom i gang med calamine
For å begynne å bruke calamine, legg den til Rust-prosjektet ditt via Cargo. Du kan installere den direkte ved å bruke cargo add calamine eller manuelt legge til avhengigheten i din Cargo.toml. Biblioteket er tilgjengelig på crates.io og kildekoden er hostet på calamine GitHub. For avansert bruk, aktiver valgfrie funksjoner som chrono for dato-/tidstøtte eller picture for uttrekk av bildedata. Biblioteket kompilerer rent på stabil Rust og krever ingen eksterne binærfiler eller systembiblioteker.
Installer calamine via Cargo
cargo add calamineSerde-basert regnearkdeserialisering
calamine gir kraftig Serde-integrasjon for å kartlegge regnearkdata direkte til Rust-strukturer. Ved å bruke RangeDeserializerBuilder kan utviklere definere sterkt typede datamodeller og automatisk deserialisere rader til strukturerte poster. Biblioteket inkluderer hjelpefunksjoner som deserialize_as_f64_or_none og deserialize_as_f64_or_string for å håndtere kolonner med blandet type på en elegant måte. Denne tilnærmingen sikrer type-trygghet, reduserer boilerplate, og muliggjør kompileringstidvalidering av datastrukturer. Den er spesielt nyttig for datapipelines, rapporteringsverktøy og ETL-applikasjoner hvor pålitelighet og ytelse er kritisk.
Deserialiser regnearkrader til Rust-strukturer
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-prosjekt og formeluttrekk
calamine gjør det mulig å hente ut VBA-prosjektmoduler og formeldedefinisjoner fra Excel-filer. Utviklere kan hente VBA-kode fra moduler, oppdage ødelagte referanser og inspisere definerte navn og deres formler. Denne funksjonaliteten er essensiell for migrasjonsverktøy, revisjonsverktøy og analyse av eldre systemer. API-et gir strukturert tilgang til VBA-metadata og støtter både enkle og komplekse arbeidsbok‑introspeksjonsscenarier. Enten du analyserer makroer for sikkerhet eller konverterer eldre Excel‑logikk, leverer calamine presis, lavnivå tilgang til skjult arbeidsbokinnhold.
Ekstraher VBA-kode og definerte navn
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);
}Lat lasting og håndtering av store filer
calamine støtter lazy loading for XLSX- og XLSB-filer, noe som gjør det mulig å behandle store regneark effektivt uten å laste alle ark inn i minnet på én gang. Ved å konfigurere overskriftsrader og bruke områdebasert iterasjon kan utviklere minimere minnebruk og maksimere gjennomstrømning. Denne funksjonen er spesielt verdifull for serverløse funksjoner, CLI‑verktøy og innebygde distribusjoner der ressursene er begrenset. Benchmark‑tester viser at calamine leser over 1 M rader med minimal minneoverhead sammenlignet med alternativer som openpyxl og ClosedXML, noe som gjør den ideell for høy‑skala datainntaks‑pipelines.
Behandle store regneark effektivt
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);
}Ytelsesoptimalisering og ytelsesmålinger
calamine leverer eksepsjonell ytelse, og behandler 41 millioner celler på under 25 sekunder—som overgår Python-, C#- og Go-biblioteker med opptil 9,4 ganger. Dens zero-copy‑design og minimale heap‑allokeringer reduserer CPU- og minnebruk betydelig. Resultater på en 186 MB XLSX‑fil viser at calamine kun bruker 186 MB disklesing sammenlignet med 1,5 GB for excelize. Bibliotekets deterministiske minneatferd og lave GC‑press gjør det egnet for sanntids- og latensfølsomme applikasjoner. Utviklere drar nytte av forutsigbar ressursbruk og jevn gjennomstrømning på tvers av ulike arbeidsbelastninger.
