1. Produkti
  2.   Izklājlapa
  3.   Rust
  4.   calamine

calamine

 
 

Tīra Rust bibliotēka izklājlapām

Lasiet XLS, XLSX, XLSM, XLSB, ODS & More with Zero-Copy Deserialization in Rust.

Kas ir calamine?

calamine ir augstas veiktspējas, tīra Rust bibliotēka Excel un OpenDocument izklājlapu failu lasīšanai un deserializēšanai. Tā atbalsta formātus, piemēram, XLS, XLSX, XLSM, XLSB, ODS un citus, koncentrējoties uz ātru, drošu un nulles kopijas datu izguvi. Izstrādāta, lai nodrošinātu uzticamību un minimālu atkarību skaitu, calamine izvairās no ārējām sistēmas bibliotēkām un balstās tikai uz tīru Rust implementāciju. Tās API ļauj izstrādātājiem efektīvi izgūt šūnu vērtības, apstrādāt VBA projektus un parsēt formulas bez sarežģītas iestatīšanas vai izpildlaika pārslodzes.

Bibliotēka izceļas veiktspējas kritiskajās lietojumprogrammās, piedāvājot ievērojami ātrāku apstrādi nekā Python, C# un Go alternatīvas. Ar iebūvētu Serde integrāciju, calamine ļauj nevainojami pārveidot izklājlapu datus uz Rust struktūrām. Tā atbalsta “lazy” ielādi lieliem failiem, galvenes rindas konfigurāciju un papildu funkcijas, piemēram, chrono datuma/laika atbalstu un attēlu datu izguvi. Neatkarīgi no tā, vai veidojat CLI rīkus, tīmekļa aizmugures vai iegultas sistēmas, calamine nodrošina stabilu, prognozējamu veiktspēju visās platformās.

Previous Next

Sākums ar calamine

Lai sāktu izmantot calamine, pievienojiet to savam Rust projektam caur Cargo. To var instalēt tieši, izmantojot cargo add calamine, vai manuāli pievienot atkarību savam Cargo.toml. Bibliotēka ir pieejama vietnē crates.io, un tās pirmkods ir izvietots calamine GitHub. Lai izmantotu papildu iespējas, aktivējiet izvēles funkcijas, piemēram, chrono datuma/laika atbalstam vai picture attēlu datu izguvei. Bibliotēka tiek kompilēta tīri uz stabilā Rust un neprasa ārējus binārus vai sistēmas bibliotēkas.

Instalējiet calamine, izmantojot Cargo

cargo add calamine

Serdes balstīta izklājlapas deserializācija

calamine nodrošina spēcīgu Serde integrāciju, lai kartētu izklājlapu datus tieši uz Rust struktūrām. Izmantojot RangeDeserializerBuilder, izstrādātāji var definēt stingri tipizētus datu modeļus un automātiski deserializēt rindas strukturētos ierakstos. Bibliotēka ietver palīgfunkcijas, piemēram, deserialize_as_f64_or_none un deserialize_as_f64_or_string, lai eleganti apstrādātu jauktu tipu kolonnas. Šī pieeja nodrošina tipa drošību, samazina lieko kodu un ļauj kompilācijas laikā validēt datu struktūras. Tā ir īpaši noderīga datu cauruļvadiem, atskaites rīkiem un ETL lietojumprogrammām, kur uzticamība un veiktspēja ir kritiska.

Deserializējiet izklājlapas rindas Rust struktūrās

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 projekts un formulu izguve

calamine ļauj izvilkt VBA projektu moduļus un formulas definīcijas no Excel failiem. Izstrādātāji var izgūt VBA kodu no moduļiem, noteikt bojātas atsauces un pārbaudīt definētos nosaukumus un to formulas. Šī iespēja ir būtiska migrācijas rīkiem, audita utilītēm un mantoto sistēmu analīzei. API nodrošina strukturētu piekļuvi VBA metadatiem un atbalsta gan vienkāršus, gan sarežģītus darblapas introspekcijas scenārijus. Neatkarīgi no tā, vai analizējat makro drošībai vai pārveidojat mantoto Excel loģiku, calamine nodrošina precīzu, zemā līmeņa piekļuvi slēptajam darblapas saturam.

Izgūt VBA kodu un definētās nosaukumus

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ēna ielāde un lielu failu apstrāde

calamine atbalsta “lazy” ielādi XLSX un XLSB failiem, ļaujot efektīvi apstrādāt lielas izklājlapas, neielādējot visas lapas atmiņā vienlaicīgi. Konfigurējot galvenes rindas un izmantojot diapazona iterāciju, izstrādātāji var samazināt atmiņas patēriņu un maksimāli palielināt caurplūdi. Šī funkcija ir īpaši vērtīga serverless funkcijām, CLI rīkiem un iegultām izvietojumiem, kur resursi ir ierobežoti. Veiktie testi rāda, ka calamine spēj nolasīt vairāk nekā 1 miljonu rindu ar minimālu atmiņas patēriņu salīdzinājumā ar alternatīvām, piemēram, openpyxl un ClosedXML, padarot to par ideālu risinājumu lielapjoma datu ieguves cauruļvadiem.

Efektīvi apstrādāt lielas izklājlapas

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

Veiktspējas optimizācija un benchmarki

calamine nodrošina izcili veiktspēju, apstrādājot 41 miljonus šūnu mazāk nekā 25 sekunžu laikā — pārsniedzot Python, C# un Go bibliotēkas līdz pat 9,4 reizes. Tās nulles kopijas (zero-copy) dizains un minimālas kaudzes piešķiršanas būtiski samazina CPU un atmiņas patēriņu. Benchmark testi uz 186 MB XLSX faila parāda, ka calamine izmanto tikai 186 MB diska lasījumus pret 1,5 GB excelize. Bibliotēkas deterministiskā atmiņas uzvedība un zems GC spiediens padara to piemērotu reāllaika un latentuma jutīgām lietojumprogrammām. Izstrādātāji gūst labumu no prognozējama resursu patēriņa un konsekventas caurlaidības dažādos darba slodzēs.

 Latviski