1. Produkter
  2.   Regneark
  3.   Rust
  4.   calamine

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.

Previous Next

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 calamine

Serde-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.

 Dansk