calamine

 
 

Gryna Rust biblioteka skaičiuoklėms

Skaitykite XLS, XLSX, XLSM, XLSB, ODS ir daugiau su nulinės kopijos deserializacija Rust kalboje.

Kas yra calamine?

calamine yra aukštos našumo, grynas Rust biblioteka, skirta Excel ir OpenDocument skaičiuoklių failų skaitymui ir deserializavimui. Ji palaiko formatus, tokius kaip XLS, XLSX, XLSM, XLSB, ODS ir kt., sutelkia dėmesį į greitą, saugų ir be kopijavimo duomenų išgavimą. Sukurta patikimumui ir minimaliai priklausomybei, calamine vengia išorinių sisteminių bibliotekų ir remiasi tik grynais Rust įgyvendinimais. Jos API leidžia kūrėjams efektyviai išgauti langelių reikšmes, tvarkyti VBA projektus ir analizuoti formules be sudėtingos konfigūracijos ar vykdymo našumo.

Biblioteka puikiai veikia našumo kritiškose programose, siūlydama žymiai greitesnį apdorojimą nei Python, C# ir Go alternatyvos. Su integruota Serde integracija, calamine leidžia sklandžiai susieti skaičiuoklių duomenis su Rust struktūromis. Ji palaiko tingų įkėlimą dideliems failams, antraštės eilutės konfigūraciją ir pasirenkamus funkcionalumus, tokius kaip chrono datos/laiko palaikymas ir paveikslų duomenų išgavimas. Nesvarbu, ar kuriate CLI įrankius, interneto backendus ar įterptines sistemas, calamine suteikia patikimą, prognozuojamą našumą visose platformose.

Previous Next

Pradžia su calamine

Norėdami pradėti naudoti calamine, pridėkite jį į savo Rust projektą per Cargo. Galite įdiegti jį tiesiogiai naudodami cargo add calamine arba rankiniu būdu pridėti priklausomybę į savo Cargo.toml. Biblioteka yra prieinama crates.io ir jos šaltinio kodas talpinamas calamine GitHub. Išplėstam naudojimui įjunkite pasirenkamus funkcionalumus, pvz., chrono datos/laiko palaikymui arba picture vaizdų duomenų išgavimui. Biblioteka sklandžiai kompiliuojama stabilioje Rust versijoje ir nereikalauja išorinių binarinių failų ar sisteminių bibliotekų.

Įdiekite calamine per Cargo

cargo add calamine

Serde pagrindu veikianti skaičialapio deserializacija

calamine suteikia galingą Serde integraciją, leidžiančią tiesiogiai susieti skaičiuoklių duomenis su Rust struktūromis. Naudojant RangeDeserializerBuilder, kūrėjai gali apibrėžti griežtai tipizuotus duomenų modelius ir automatiškai deserializuoti eilutes į struktūruotus įrašus. Biblioteka apima pagalbines funkcijas, tokias kaip deserialize_as_f64_or_none ir deserialize_as_f64_or_string, kad sklandžiai tvarkytų mišrių tipų stulpelius. Šis požiūris užtikrina tipų saugumą, sumažina šablonų kiekį ir leidžia atlikti kompiliacijos metu duomenų struktūrų validaciją. Tai ypač naudinga duomenų srautams, ataskaitų įrankiams ir ETL programoms, kur patikimumas ir našumas yra kritiški.

Deserializuokite skaičialapio eilutes į Rust struktūras

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 projekto ir formulės išgavimas

calamine leidžia išgauti VBA projekto modulius ir formulės apibrėžimus iš Excel failų. Kūrėjai gali gauti VBA kodą iš modulių, aptikti sugadintas nuorodas ir peržiūrėti apibrėžtus pavadinimus bei jų formules. Ši galimybė yra būtina migracijos įrankiams, audito priemonėms ir senų sistemų analizei. API suteikia struktūruotą prieigą prie VBA metaduomenų ir palaiko tiek paprastus, tiek sudėtingus darbaknygės introspekcijos scenarijus. Nesvarbu, ar analizuojate makrokomandas dėl saugumo, ar konvertuojate seną Excel logiką, calamine suteikia tikslų, žemo lygio priėjimą prie paslėpto darbaknygės turinio.

Išgauti VBA kodą ir apibrėžtus vardus

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ėtas įkėlimas ir didelių failų tvarkymas

calamine palaiko tingų įkėlimą (lazy loading) XLSX ir XLSB failams, leidžiant efektyviai apdoroti didelius skaičiuoklių lapus be vienu metu įkelti visų lapų į atmintį. Konfigūruojant antraštės eilutes ir naudojant intervalų iteraciją, kūrėjai gali sumažinti atminties naudojimą ir padidinti pralaidumą. Ši funkcija ypač vertinga serverless funkcijoms, CLI įrankiams ir įterptiems diegimams, kur ištekliai yra riboti. Testai rodo, kad calamine perskaito daugiau nei 1 mln. eilučių su minimalia atminties sąnaudų kaina, lyginant su alternatyvomis, tokiomis kaip openpyxl ir ClosedXML, todėl ji yra ideali didelio masto duomenų įsisavinimo konvejeriams.

Efektyviai apdoroti didelius skaičiuoklių lapus

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);
}

Veikimo optimizavimas ir našumo testai

calamine suteikia išskirtinį našumą, apdorodama 41 milijoną langelių per mažiau nei 25 sekundes—viršijant Python, C# ir Go bibliotekas iki 9,4 kartų. Jos nulinio kopijavimo dizainas ir minimalūs krūvos paskirstymai ženkliai sumažina CPU ir atminties naudojimą. Testai su 186 MB XLSX failu rodo, kad calamine naudoja tik 186 MB diskų skaitymus, lyginant su 1,5 GB excelize. Bibliotekos deterministinis atminties elgesys ir mažas GC spaudimas daro ją tinkamą realaus laiko ir jautrioms vėlavimo programoms. Kūrėjai gauna naudos iš prognozuojamo išteklių naudojimo ir nuoseklaus pralaidumo įvairiose apkrovose.

 Lietuvių