
calamine
Ren Rust-bibliotek til regneark
Læs XLS, XLSX, XLSM, XLSB, ODS og mere med nul‑kopi deserialisering i Rust.
Hvad er calamine?
calamine er et højtydende, rent Rust-bibliotek til læsning og deserialisering af Excel- og OpenDocument-regnearksfiler. Det understøtter formater som XLS, XLSX, XLSM, XLSB, ODS og flere, med fokus på hurtig, sikker og nul‑kopi dataudtræk. Designet til pålidelighed og minimale afhængigheder undgår calamine eksterne systembiblioteker og baserer sig udelukkende på rene Rust-implementeringer. Dets API gør det muligt for udviklere at effektivt udtrække celleværdier, håndtere VBA-projekter og parse formler uden kompleks opsætning eller køretidsomkostninger.
Biblioteket udmærker sig i performance‑kritiske applikationer og tilbyder betydeligt hurtigere behandling end alternativer i Python, C# og Go. Med indbygget Serde-integration gør calamine det muligt at sømløst mappe regnearksdata til Rust‑strukturer. Det understøtter lazy loading for store filer, konfiguration af header‑række og valgfrie funktioner som chrono dato-/tid‑support og udtræk af billeddata. Uanset om du bygger CLI‑værktøjer, web‑backends eller indlejrede systemer, leverer calamine robust og forudsigelig ydeevne på tværs af platforme.
Kom i gang med calamine
For at begynde at bruge calamine, tilføj den til dit Rust-projekt via Cargo. Du kan installere den direkte ved at bruge cargo add calamine eller manuelt tilføje afhængigheden til din Cargo.toml. Biblioteket er tilgængeligt på crates.io og kildekoden er hostet på calamine GitHub. For avanceret brug, aktivér valgfrie funktioner som chrono til dato-/tidstøtte eller picture til udtræk af billeddata. Biblioteket kompilerer rent på stabil Rust og kræver ingen eksterne binære filer eller systembiblioteker.
Installer calamine via Cargo
cargo add calamineSerde-baseret regnearksdeserialisering
calamine leverer kraftfuld Serde-integration til at kortlægge regnearksdata direkte til Rust-strukturer. Ved at bruge RangeDeserializerBuilder kan udviklere definere stærkt typede datamodeller og automatisk deserialisere rækker til strukturerede poster. Biblioteket inkluderer hjælpefunktioner som deserialize_as_f64_or_none og deserialize_as_f64_or_string for at håndtere kolonner med blandede typer på en elegant måde. Denne tilgang sikrer type-sikkerhed, reducerer boilerplate og muliggør kompileringstid validering af datastrukturer. Det er især nyttigt for datapipelines, rapporteringsværktøjer og ETL-applikationer, hvor pålidelighed og ydeevne er kritiske.
Deserialiser regnearksrækker 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-projekt og formeludtrækning
calamine muliggør udtræk af VBA-projektmoduler og formelddefinitioner fra Excel-filer. Udviklere kan hente VBA-kode fra moduler, opdage ødelagte referencer og inspicere definerede navne og deres formler. Denne funktion er essentiel for migrationsværktøjer, revisionsværktøjer og analyse af ældre systemer. API'et giver struktureret adgang til VBA-metadata og understøtter både simple og komplekse arbejdsbogs‑introspektionsscenarier. Uanset om du analyserer makroer for sikkerhed eller konverterer ældre Excel‑logik, leverer calamine præcis, lav‑niveau adgang til skjult arbejdsbogsindhold.
Udtræk VBA-kode og definerede navne
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);
}Doven indlæsning og håndtering af store filer
calamine understøtter lazy loading for XLSX- og XLSB-filer, hvilket muliggør effektiv behandling af store regneark uden at indlæse alle ark i hukommelsen på én gang. Ved at konfigurere header‑rækker og bruge intervalbaseret iteration kan udviklere minimere hukommelsesforbruget og maksimere gennemløbet. Denne funktion er især værdifuld for serverløse funktioner, CLI‑værktøjer og indlejrede implementeringer, hvor ressourcerne er begrænsede. Benchmark‑resultater viser, at calamine læser over 1 M rækker med minimal hukommelsesbelastning sammenlignet med alternativer som openpyxl og ClosedXML, hvilket gør den ideel til høj‑skala data‑indtags‑pipelines.
Behandl 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);
}Ydelsesoptimering og benchmarks
calamine leverer enestående ydeevne og behandler 41 millioner celler på under 25 sekunder—overgår Python-, C#- og Go-biblioteker med op til 9,4 gange. Dens zero-copy design og minimale heap-allokeringer reducerer CPU- og hukommelsesforbrug betydeligt. Benchmark-tests på en 186 MB XLSX-fil viser, at calamine kun bruger 186 MB disk-læsninger sammenlignet med 1,5 GB for excelize. Bibliotekets deterministiske hukommelsesadfærd og lave GC-tryk gør det velegnet til realtids- og latenstidssensitive applikationer. Udviklere drager fordel af forudsigeligt ressourceforbrug og ensartet gennemløb på tværs af forskellige arbejdsbelastninger.
