
calamine
Tiszta Rust könyvtár táblázatokhoz
Olvassa be az XLS, XLSX, XLSM, XLSB, ODS és egyebeket nullmásolásos deszerializációval Rustban.
Mi az a calamine?
calamine egy nagy teljesítményű, tiszta Rust könyvtár Excel és OpenDocument táblázatfájlok olvasására és deszerializálására. Támogatja az olyan formátumokat, mint az XLS, XLSX, XLSM, XLSB, ODS és továbbiak, a gyors, biztonságos és nullamásolatos adatkinyerésre összpontosítva. Megbízhatóságra és minimális függőségekre tervezve, a calamine elkerüli a külső rendszerkönyvtárakat, és kizárólag tiszta Rust megvalósításokra támaszkodik. API-ja lehetővé teszi a fejlesztők számára, hogy hatékonyan kinyerjék a cellaértékeket, kezeljék a VBA projekteket, és képleteket elemezzenek bonyolult beállítás vagy futásidejű terhelés nélkül.
A könyvtár kiemelkedik a teljesítménykritikus alkalmazásokban, jelentősen gyorsabb feldolgozást kínálva, mint a Python, C# és Go alternatívák. Beépített Serde integrációval a calamine zökkenőmentes leképezést tesz lehetővé a táblázat adatok és a Rust struktúrák között. Támogatja a nagy fájlok lusta betöltését, a fejlécsor konfigurációját, valamint opcionális funkciókat, mint a chrono dátum/idő támogatás és a képadatok kinyerése. Akár CLI eszközöket, web backendeket vagy beágyazott rendszereket építesz, a calamine robusztus, előre látható teljesítményt nyújt minden platformon.
A calamine használatának megkezdése
A calamine használatának megkezdéséhez add hozzá a Rust projektedhez a Cargo segítségével. Telepítheted közvetlenül a cargo add calamine paranccsal, vagy manuálisan hozzáadhatod a függőséget a Cargo.toml fájlodhoz. A könyvtár elérhető a crates.io oldalon, és a forráskódja a calamine GitHub oldalon van tárolva. Haladó használathoz engedélyezd az opcionális funkciókat, például a chrono-t a dátum/idő támogatáshoz vagy a picture-t a képadatok kinyeréséhez. A könyvtár tisztán lefordítható a stabil Rust verzióval, és nem igényel külső binárisokat vagy rendszerkönyvtárakat.
A calamine telepítése Cargo-n keresztül
cargo add calamineSerde-alapú táblázat deszerializálás
calamine erőteljes Serde integrációt biztosít a táblázat adatok közvetlen Rust struktúrákba való leképezéséhez. A RangeDeserializerBuilder használatával a fejlesztők erősen típusos adatmodelleket definiálhatnak, és automatikusan deszerializálhatják a sorokat strukturált rekordokká. A könyvtár olyan segédfüggvényeket tartalmaz, mint a deserialize_as_f64_or_none és a deserialize_as_f64_or_string, amelyek elegánsan kezelik a vegyes típusú oszlopokat. Ez a megközelítés biztosítja a típusbiztonságot, csökkenti a sablonkódot, és lehetővé teszi az adatstruktúrák fordítási időbeni validálását. Különösen hasznos adatcsővezetékek, jelentéskészítő eszközök és ETL alkalmazások esetén, ahol a megbízhatóság és a teljesítmény kritikus.
Táblázat sorok deszerializálása Rust struktúrákba
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 és képlet kinyerése
calamine lehetővé teszi a VBA projektmodulok és képletdefiníciók kinyerését Excel-fájlokból. A fejlesztők visszanyerhetik a VBA kódot a modulokból, felderíthetik a hibás hivatkozásokat, és megvizsgálhatják a definiált neveket és azok képleteit. Ez a képesség elengedhetetlen migrációs eszközök, auditsegédletek és örökölt rendszer elemzése számára. Az API strukturált hozzáférést biztosít a VBA metaadatokhoz, és támogatja mind az egyszerű, mind a komplex munkafüzet introspekciós forgatókönyveket. Akár a makrókat biztonsági célból elemzi, akár az örökölt Excel logikát konvertálja, a calamine pontos, alacsony szintű hozzáférést nyújt a rejtett munkafüzet tartalomhoz.
VBA kód és definiált nevek kinyerése
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);
}Lusta betöltés és nagy fájlok kezelése
calamine támogatja a lusta betöltést XLSX és XLSB fájlok esetén, lehetővé téve nagy táblázatok hatékony feldolgozását anélkül, hogy egyszerre az összes munkalapot a memóriába töltené. Fejlécsorok konfigurálásával és tartományalapú iterációval a fejlesztők minimalizálhatják a memóriahasználatot és maximalizálhatják az áteresztőképességet. Ez a funkció különösen értékes szerver nélküli függvények, CLI eszközök és beágyazott telepítések számára, ahol a erőforrások korlátozottak. A benchmarkok azt mutatják, hogy a calamine 1 M+ sort olvas minimális memóriaigénnyel az olyan alternatívákhoz képest, mint az openpyxl és a ClosedXML, így ideális a nagy léptékű adatbefogadó csővezetékekhez.
Nagy táblázatok hatékony feldolgozása
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);
}Teljesítményoptimalizálás és benchmarkok
A calamine kimagasló teljesítményt nyújt, 41 millió cellát dolgoz fel kevesebb mint 25 másodperc alatt – ezzel akár 9,4‑szoros gyorsabb, mint a Python, C# és Go könyvtárak. Nulla másolásos tervezése és minimális heap lefoglalásai jelentősen csökkentik a CPU- és memóriahasználatot. Egy 186 MB-os XLSX fájlon végzett benchmarkok azt mutatják, hogy a calamine csak 186 MB lemezolvasást igényel, szemben az excelize 1,5 GB-jával. A könyvtár determinisztikus memória viselkedése és alacsony GC nyomása alkalmassá teszi valós‑idő és késleltetés‑érzékeny alkalmazásokra. A fejlesztők előnyben részesítik a kiszámítható erőforrás‑használatot és a konzisztens áteresztőképességet különféle munkaterhelések között.
