calamine

 
 

Καθαρή Βιβλιοθήκη Rust για Φύλλα Εργασίας

Διαβάστε XLS, XLSX, XLSM, XLSB, ODS & περισσότερα με μη-αντιγραφική απο-σειριοποίηση στο Rust.

Τι είναι το calamine;

Το calamine είναι μια υψηλής απόδοσης, καθαρή βιβλιοθήκη Rust για ανάγνωση και αποσειριοποίηση αρχείων λογιστικών φύλλων Excel και OpenDocument. Υποστηρίζει μορφές όπως XLS, XLSX, XLSM, XLSB, ODS και άλλες, εστιάζοντας στην γρήγορη, ασφαλή και μη-αντιγραφική εξαγωγή δεδομένων. Σχεδιασμένο για αξιοπιστία και ελάχιστες εξαρτήσεις, το calamine αποφεύγει εξωτερικές βιβλιοθήκες συστήματος και βασίζεται αποκλειστικά σε καθαρές υλοποιήσεις Rust. Το API του επιτρέπει στους προγραμματιστές να εξάγουν αποδοτικά τιμές κελιών, να διαχειρίζονται έργα VBA και να αναλύουν τύπους χωρίς πολύπλοκη ρύθμιση ή φόρτο χρόνου εκτέλεσης.

Η βιβλιοθήκη διαπρέπει σε εφαρμογές κρίσιμες για την απόδοση, προσφέροντας σημαντικά ταχύτερη επεξεργασία σε σύγκριση με εναλλακτικές σε Python, C# και Go. Με ενσωματωμένη ενσωμάτωση Serde, το calamine επιτρέπει αδιάλειπτη αντιστοίχιση των δεδομένων λογιστικού φύλλου σε δομές Rust. Υποστηρίζει lazy loading για μεγάλα αρχεία, διαμόρφωση γραμμής κεφαλίδας και προαιρετικές λειτουργίες όπως υποστήριξη ημερομηνίας/ώρας chrono και εξαγωγή δεδομένων εικόνας. Είτε δημιουργείτε εργαλεία CLI, backend ιστού ή ενσωματωμένα συστήματα, το calamine παρέχει ισχυρή, προβλέψιμη απόδοση σε όλες τις πλατφόρμες.

Previous Next

Ξεκινώντας με το calamine

Για να αρχίσετε να χρησιμοποιείτε το calamine, προσθέστε το στο έργο Rust σας μέσω Cargo. Μπορείτε να το εγκαταστήσετε απευθείας χρησιμοποιώντας cargo add calamine ή να προσθέσετε χειροκίνητα την εξάρτηση στο Cargo.toml. Η βιβλιοθήκη είναι διαθέσιμη στο crates.io και ο πηγαίος κώδικας της φιλοξενείται στο calamine GitHub. Για προχωρημένη χρήση, ενεργοποιήστε προαιρετικές λειτουργίες όπως chrono για υποστήριξη ημερομηνίας/ώρας ή picture για εξαγωγή δεδομένων εικόνας. Η βιβλιοθήκη μεταγλωττίζεται καθαρά σε σταθερή έκδοση Rust και δεν απαιτεί εξωτερικά δυαδικά αρχεία ή βιβλιοθήκες συστήματος.

Εγκαταστήστε το calamine μέσω Cargo

cargo add calamine

Απο-σειριοποίηση Φύλλων Εργασίας με Serde

Το calamine παρέχει ισχυρή ενσωμάτωση του Serde για τη χαρτογράφηση δεδομένων υπολογιστικών φύλλων απευθείας σε δομές Rust. Χρησιμοποιώντας το RangeDeserializerBuilder, οι προγραμματιστές μπορούν να ορίσουν μοντέλα δεδομένων με ισχυρούς τύπους και να αποσυμπιέσουν αυτόματα τις γραμμές σε δομημένες εγγραφές. Η βιβλιοθήκη περιλαμβάνει βοηθητικές συναρτήσεις όπως deserialize_as_f64_or_none και deserialize_as_f64_or_string για να διαχειρίζεται με χάρη στήλες μικτής μορφής. Αυτή η προσέγγιση εξασφαλίζει ασφάλεια τύπων, μειώνει τον περιττό κώδικα και επιτρέπει την επικύρωση των δομών δεδομένων κατά τη μεταγλώττιση. Είναι ιδιαίτερα χρήσιμη για αγωγούς δεδομένων, εργαλεία αναφοράς και εφαρμογές ETL όπου η αξιοπιστία και η απόδοση είναι κρίσιμες.

Απο-σειριοποίηση Γραμμών Φύλλου Εργασίας σε Δομές Rust

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 και Τύπων

Το calamine επιτρέπει την εξαγωγή των μονάδων έργου VBA και των ορισμών τύπων από αρχεία Excel. Οι προγραμματιστές μπορούν να ανακτήσουν τον κώδικα VBA από τις μονάδες, να εντοπίσουν σπασμένες αναφορές και να εξετάσουν τα ορισμένα ονόματα και τους τύπους τους. Αυτή η δυνατότητα είναι ουσιώδης για εργαλεία μετεγκατάστασης, βοηθήματα ελέγχου και ανάλυση παλαιών συστημάτων. Το API παρέχει δομημένη πρόσβαση στα μεταδεδομένα VBA και υποστηρίζει τόσο απλά όσο και σύνθετα σενάρια διερεύνησης βιβλίου εργασίας. Είτε αναλύετε μακροεντολές για ασφάλεια είτε μετατρέπετε την κληρονομική λογική του Excel, το calamine παρέχει ακριβή, χαμηλού επιπέδου πρόσβαση στο κρυφό περιεχόμενο του βιβλίου εργασίας.

Εξαγωγή κώδικα VBA και ορισμένων ονομάτων

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

Αργή Φόρτωση και Διαχείριση Μεγάλων Αρχείων

Το calamine υποστηρίζει lazy loading για αρχεία XLSX και XLSB, επιτρέποντας αποδοτική επεξεργασία μεγάλων λογιστικών φύλλων χωρίς να φορτώνει όλα τα φύλλα στη μνήμη ταυτόχρονα. Με τη ρύθμιση των γραμμών κεφαλίδας και τη χρήση επανάληψης βάσει περιοχής, οι προγραμματιστές μπορούν να ελαχιστοποιήσουν το αποτύπωμα μνήμης και να μεγιστοποιήσουν τη διαπερατότητα. Αυτή η δυνατότητα είναι ιδιαίτερα πολύτιμη για λειτουργίες χωρίς διακομιστή, εργαλεία CLI και ενσωματωμένες αναπτύξεις όπου οι πόροι είναι περιορισμένοι. Τα benchmarks δείχνουν ότι το calamine διαβάζει πάνω από 1 εκατομμύριο γραμμές με ελάχιστη επιβάρυνση μνήμης σε σύγκριση με εναλλακτικές όπως το openpyxl και το ClosedXML, καθιστώντας το ιδανικό για αγωγούς υψηλής κλίμακας εισαγωγής δεδομένων.

Αποτελεσματική επεξεργασία μεγάλων λογιστικών φύλλων

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

Βελτιστοποίηση Απόδοσης και Δοκιμές Απόδοσης

Το calamine προσφέρει εξαιρετική απόδοση, επεξεργαζόμενο 41 εκατομμύρια κελιά σε λιγότερο από 25 δευτερόλεπτα—υπερβαίνοντας τις βιβλιοθήκες Python, C# και Go έως και 9,4 φορές. Ο σχεδιασμός του χωρίς αντιγραφή και οι ελάχιστες κατανομές heap μειώνουν σημαντικά τη χρήση CPU και μνήμης. Τα benchmarks σε αρχείο XLSX 186 MB δείχνουν ότι το calamine χρησιμοποιεί μόνο 186 MB ανάγνωση δίσκου σε σύγκριση με 1,5 GB για το excelize. Η ντετερμινιστική συμπεριφορά μνήμης της βιβλιοθήκης και η χαμηλή πίεση GC την καθιστούν κατάλληλη για εφαρμογές σε πραγματικό χρόνο και ευαίσθητες στην καθυστέρηση. Οι προγραμματιστές επωφελούνται από προβλέψιμη χρήση πόρων και συνεπή απόδοση σε διάφορα φορτία εργασίας.

 Ελληνικά