
calamine
Puhdas Rust -kirjasto taulukoille
Lue XLS-, XLSX-, XLSM-, XLSB-, ODS- ja muita tiedostoja nollakopioisella deserialisoinnilla Rustissa.
Mikä on calamine?
calamine on korkean suorituskyvyn, puhdas Rust-kirjasto Excel- ja OpenDocument-taulukkolaskentatiedostojen lukemiseen ja deserialisointiin. Se tukee formaatteja kuten XLS, XLSX, XLSM, XLSB, ODS ja muita, keskittyen nopeaan, turvalliseen ja nollakopiointiin perustuvaan tietojen poimintaan. Suunniteltu luotettavuuteen ja minimaalisilla riippuvuuksilla, calamine välttää ulkoisia järjestelmäkirjastoja ja perustuu pelkästään puhtaaseen Rust-toteutukseen. Sen API mahdollistaa kehittäjille soluarvojen tehokkaan poiminnan, VBA-projektien käsittelyn ja kaavojen jäsentämisen ilman monimutkaista asetusta tai ajonaikaista kuormitusta.
Kirjasto loistaa suorituskykykriittisissä sovelluksissa, tarjoten merkittävästi nopeampaa käsittelyä kuin Python-, C#- ja Go-vaihtoehdot. Sisäänrakennetun Serde-integraation avulla calamine mahdollistaa taulukkolaskentatietojen saumattoman kartoittamisen Rust-rakenteisiin. Se tukee laiskaa latausta suurille tiedostoille, otsikkorivin konfigurointia ja valinnaisia ominaisuuksia kuten chrono-päivä/aika-tuki ja kuvatietojen poiminta. Olitpa rakentamassa CLI-työkaluja, web‑taustajärjestelmiä tai sulautettuja järjestelmiä, calamine tarjoaa vankkaa, ennustettavaa suorituskykyä eri alustoilla.
Aloittaminen calamine:n kanssa
Aloittaaksesi calamine:n käytön, lisää se Rust-projektiisi Cargo:n kautta. Voit asentaa sen suoraan käyttämällä cargo add calamine tai lisätä riippuvuuden manuaalisesti Cargo.toml-tiedostoosi. Kirjasto on saatavilla crates.io-palvelussa ja sen lähdekoodi on isännöity calamine GitHubissa. Edistyneempää käyttöä varten ota käyttöön valinnaiset ominaisuudet, kuten chrono päivämäärä- ja aika-tukea varten tai picture kuvatietojen poimintaa varten. Kirjasto kääntyy puhtaasti vakaan Rustin kanssa, eikä se vaadi ulkoisia binääritiedostoja tai järjestelmäkirjastoja.
Asenna calamine Cargo:n kautta
cargo add calamineSerde-pohjainen taulukkolaskentaohjelman deserialisointi
calamine tarjoaa tehokkaan Serde-integraation taulukkolaskentatietojen kartoittamiseen suoraan Rust-rakenteisiin. Käyttämällä RangeDeserializerBuilder-luokkaa kehittäjät voivat määritellä vahvasti tyypitettyjä tietomalleja ja automaattisesti deserialisoida rivejä rakenteellisiin tietueisiin. Kirjasto sisältää apufunktioita, kuten deserialize_as_f64_or_none ja deserialize_as_f64_or_string, jotka käsittelevät sekoitettuja sarakkeita sujuvasti. Tämä lähestymistapa varmistaa tyyppiturvallisuuden, vähentää toistokoodia ja mahdollistaa tietorakenteiden käännösaikaisen validoinnin. Se on erityisen hyödyllinen data-putkistoissa, raportointityökaluissa ja ETL-sovelluksissa, joissa luotettavuus ja suorituskyky ovat kriittisiä.
Deserialisoi taulukon rivit Rust-rakenteiksi
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-projektin ja kaavojen poiminta
calamine mahdollistaa VBA-projektimoduulien ja kaavamääritelmien poiminnan Excel-tiedostoista. Kehittäjät voivat hakea VBA-koodia moduuleista, havaita rikkinäisiä viitteitä ja tarkastella määriteltyjä nimiä sekä niiden kaavoja. Tämä kyky on olennaista migraatiotyökaluille, auditointisovelluksille ja perintöjärjestelmien analyysille. API tarjoaa rakenteellisen pääsyn VBA-metatietoihin ja tukee sekä yksinkertaisia että monimutkaisia työkirjan tarkasteluskenaarioita. Olitpa sitten analysoimassa makroja turvallisuuden vuoksi tai muuntamassa vanhaa Excel-logiikkaa, calamine tarjoaa tarkan, matalan tason pääsyn piilotettuun työkirjan sisältöön.
Poimi VBA-koodi ja määritellyt nimet
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);
}Laiska lataus ja suurten tiedostojen käsittely
calamine tukee laiskaa latausta XLSX- ja XLSB-tiedostoille, mikä mahdollistaa suurten taulukoiden tehokkaan käsittelyn lataamatta kaikkia taulukoita muistiin kerralla. Määrittämällä otsikkorivit ja käyttämällä aluepohjaista iteraatiota, kehittäjät voivat minimoida muistin käytön ja maksimoida läpimenon. Tämä ominaisuus on erityisen arvokas serverittomille toiminnoille, CLI-työkaluille ja upotetuille käyttöönotolle, joissa resurssit ovat rajoitettuja. Vertailut osoittavat, että calamine lukee yli 1 M riviä minimaalisella muistikuormituksella verrattuna vaihtoehtoihin kuten openpyxl ja ClosedXML, mikä tekee siitä ihanteellisen suurten tietojen syöttöputkien skaalautuvuuteen.
Käsittele suuria taulukkolaskentatiedostoja tehokkaasti
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);
}Suorituskyvyn optimointi ja vertailuarvot
calamine tarjoaa poikkeuksellisen suorituskyvyn, käsittelee 41 miljoonaa solua alle 25 sekunnissa—ylittää Python-, C#- ja Go-kirjastot jopa 9,4‑kertaisesti. Sen zero-copy‑suunnittelu ja minimaaliset pinoallokaatiot vähentävät CPU- ja muistin käyttöä merkittävästi. Vertailut 186 MB:n XLSX‑tiedostolla osoittavat, että calamine käyttää vain 186 MB:n levyluettavaa verrattuna 1,5 GB:iin excelizessa. Kirjaston deterministinen muistikäyttäytyminen ja alhainen GC‑paine tekevät siitä sopivan reaaliaikaisiin ja latenssiherkkiin sovelluksiin. Kehittäjät hyötyvät ennustettavasta resurssien käytöstä ja tasaisesta läpimenosta erilaisissa kuormituksissa.
