
calamine
Rent Rust-bibliotek för kalkylblad
Läs XLS, XLSX, XLSM, XLSB, ODS & mer med nollkopieringsdeserialisering i Rust.
Vad är calamine?
calamine är ett högpresterande, rent Rust-bibliotek för att läsa och deserialisera Excel- och OpenDocument-kalkylbladsfiler. Det stöder format som XLS, XLSX, XLSM, XLSB, ODS och fler, med fokus på snabb, säker och nollkopieringsdatatillgång. Designat för pålitlighet och minimala beroenden undviker calamine externa systembibliotek och förlitar sig enbart på rena Rust-implementationer. Dess API gör det möjligt för utvecklare att effektivt extrahera cellvärden, hantera VBA-projekt och tolka formler utan komplicerad konfiguration eller körningstid overhead.
Biblioteket utmärker sig i prestandakritiska applikationer och erbjuder avsevärt snabbare bearbetning än Python-, C#- och Go-alternativ. Med inbyggd Serde-integration möjliggör calamine sömlös mappning av kalkylbladsdata till Rust-strukturer. Det stödjer lazy loading för stora filer, konfiguration av rubrikrad och valfria funktioner som chrono datum-/tidstöd och extrahering av bilddata. Oavsett om du bygger CLI-verktyg, webb‑backend eller inbäddade system levererar calamine robust och förutsägbar prestanda på alla plattformar.
Komma igång med calamine
För att börja använda calamine, lägg till den i ditt Rust‑projekt via Cargo. Du kan installera den direkt med cargo add calamine eller manuellt lägga till beroendet i din Cargo.toml. Biblioteket finns på crates.io och dess källkod är hostad på calamine GitHub. För avancerad användning, aktivera valfria funktioner som chrono för datum/tid‑stöd eller picture för extrahering av bilddata. Biblioteket kompileras rent på stabil Rust och kräver inga externa binärer eller systembibliotek.
Installera calamine via Cargo
cargo add calamineSerde-baserad avserialisering av kalkylblad
calamine erbjuder kraftfull Serde-integration för att mappa kalkylbladsdata direkt till Rust-strukturer. Med RangeDeserializerBuilder kan utvecklare definiera starkt typade datamodeller och automatiskt deserialisera rader till strukturerade poster. Biblioteket inkluderar hjälpfunktioner som deserialize_as_f64_or_none och deserialize_as_f64_or_string för att hantera kolumner med blandade typer på ett smidigt sätt. Detta tillvägagångssätt säkerställer typ‑säkerhet, minskar boilerplate och möjliggör validering av datastrukturer vid kompilering. Det är särskilt användbart för datapipelines, rapporteringsverktyg och ETL‑applikationer där pålitlighet och prestanda är kritiska.
Deserialisera kalkylbladsrader till 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 och formelutdragning
calamine möjliggör extrahering av VBA-projektmoduler och formeldefinitioner från Excel-filer. Utvecklare kan hämta VBA-kod från moduler, upptäcka brutna referenser och granska definierade namn och deras formler. Denna funktion är avgörande för migrationsverktyg, revisionsverktyg och analys av äldre system. API:et ger strukturerad åtkomst till VBA-metadata och stöder både enkla och komplexa scenarier för arbetsboksinspektion. Oavsett om du analyserar makron för säkerhet eller konverterar äldre Excel-logik, levererar calamine exakt, låg‑nivå åtkomst till dolda arbetsboksinnehåll.
Extrahera VBA-kod och definierade namn
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);
}Lätt laddning och hantering av stora filer
calamine stöder lazy loading för XLSX- och XLSB-filer, vilket möjliggör effektiv bearbetning av stora kalkylblad utan att ladda alla blad i minnet samtidigt. Genom att konfigurera rubrikrader och använda intervallbaserad iteration kan utvecklare minimera minnesfotavtrycket och maximera genomströmningen. Denna funktion är särskilt värdefull för serverlösa funktioner, CLI-verktyg och inbäddade distributioner där resurser är begränsade. Prestandatester visar att calamine läser över 1 M rader med minimal minnesbelastning jämfört med alternativ som openpyxl och ClosedXML, vilket gör den idealisk för högskaliga datainmatningspipelines.
Bearbeta stora kalkylblad 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);
}Prestandaoptimering och benchmarkar
calamine levererar exceptionell prestanda och bearbetar 41 miljoner celler på under 25 sekunder—och slår Python-, C#- och Go-bibliotek med upp till 9,4 gånger. Dess zero‑copy‑design och minimala heap‑allokeringar minskar CPU‑ och minnesanvändning avsevärt. Benchmarkar på en 186 MB XLSX‑fil visar att calamine endast använder 186 MB disk‑läsningar jämfört med 1,5 GB för excelize. Bibliotekets deterministiska minnesbeteende och låga GC‑tryck gör det lämpligt för realtids‑ och latenskänsliga applikationer. Utvecklare drar nytta av förutsägbar resursanvändning och konsekvent genomströmning över olika arbetsbelastningar.
