
umya-spreadsheet
Καθαρή Βιβλιοθήκη Rust για Αρχεία XLSX/XLSM
Ανάγνωση, Εγγραφή, Στυλ και Διαχείριση Υπολογιστικών Φύλλων XLSX/XLSM χωρίς Εξωτερικές Εξαρτήσεις.
Τι είναι το umya-spreadsheet;
Το umya-spreadsheet είναι μια υψηλής απόδοσης, καθαρή βιβλιοθήκη Rust για ανάγνωση και εγγραφή αρχείων λογιστικών φύλλων Excel σε μορφές XLSX και XLSM. Σχεδιασμένο για ασφάλεια και αποδοτικότητα, αποφεύγει τον μη ασφαλή κώδικα και εξωτερικές εξαρτήσεις, καθιστώντας το ιδανικό για εφαρμογές επιφάνειας εργασίας, επεξεργασία στο διακομιστή και περιβάλλοντα WebAssembly. Η βιβλιοθήκη παρέχει ένα καθαρό, ιδιωματικό API Rust για πρόσβαση σε κελιά, σειρές, στήλες, στυλ, γραφήματα και εικόνες, επιτρέποντας στους προγραμματιστές να δημιουργούν ισχυρά εργαλεία λογιστικών φύλλων χωρίς να εξαρτώνται από το Microsoft Office ή το COM interop.
Με πλήρη υποστήριξη για lazy loading, προστασία με κωδικό πρόσβασης και πλούσια μορφοποίηση, το umya-spreadsheet γεφυρώνει το χάσμα μεταξύ απόδοσης και χρηστικότητας. Υποστηρίζει εξαγωγή CSV, δημιουργία γραφημάτων, ενσωμάτωση εικόνων και λειτουργίες περιοχής όπως μετακίνηση και αντιγραφή. Το έργο συντηρείται ενεργά, είναι καλά τεκμηριωμένο και δοκιμασμένο, με έμφαση στην ορθότητα και τη συμβατότητα με σύγχρονες δυνατότητες του Excel. Οι προγραμματιστές μπορούν να το ενσωματώσουν σε εργαλεία CLI, backend ιστού ή εφαρμογές επιφάνειας εργασίας χρησιμοποιώντας πλαίσια όπως το Tauri ή το Axo.
Ξεκινώντας με το umya-spreadsheet
Για να ξεκινήσετε να χρησιμοποιείτε το umya-spreadsheet, προσθέστε το στο Cargo.toml σας με `umya-spreadsheet = "3.1.1"`. Για υποστήριξη WebAssembly, ενεργοποιήστε τη δυνατότητα `js`. Η βιβλιοθήκη είναι ελαφριά σε εξαρτήσεις και μεταγλωττίζεται γρήγορα. Μόλις εγκατασταθεί, εισάγετέ την μέσω `extern crate umya_spreadsheet;` και αρχίστε να διαβάζετε ή να γράφετε λογιστικά φύλλα. Μπορείτε επίσης να εξερευνήσετε το umya-spreadsheet GitHub για παραδείγματα, δοκιμές και τεκμηρίωση. Υποστηρίζει lazy loading για μεγάλα αρχεία και προσφέρει ισχυρή διαχείριση σφαλμάτων.
Εγκατάσταση του umya-spreadsheet μέσω Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
Ανάγνωση & Εγγραφή Αρχείων XLSX/XLSM
Το umya-spreadsheet παρέχει διαισθητικά API για ανάγνωση και εγγραφή αρχείων XLSX και XLMS. Χρησιμοποιήστε `reader::xlsx::read()` για να φορτώσετε ένα βιβλίο εργασίας από το δίσκο, ή `new_file()` για να δημιουργήσετε ένα κενό. Η εγγραφή είναι εξίσου απλή: καλέστε `writer::xlsx::write()` με το βιβλίο εργασίας και τη διαδρομή προορισμού. Η βιβλιοθήκη υποστηρίζει lazy loading μέσω `lazy_read()` για βελτιωμένη απόδοση σε μεγάλα αρχεία, και επιτρέπει εγγραφή με προστασία κωδικού ή ορισμό κωδικών μετά τη δημιουργία. Όλες οι λειτουργίες είναι ασφαλείς, zero-copy όπου είναι δυνατόν, και αποφεύγουν εξωτερικά εκτελέσιμα.
Πώς να Διαβάσετε και να Γράψετε ένα Αρχείο XLSX μέσω Rust;
use std::path::Path;
// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();
// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();
Πρόσβαση σε Κελιά & Διαχείριση Στυλ
Η πρόσβαση και η τροποποίηση των τιμών των κελιών είναι απλή: χρησιμοποιήστε `cell("A1")` ή `cell((1,1))` για ανάγνωση, και `cell_mut()` για εγγραφή. Τα στυλ διαχειρίζονται μέσω `style_mut()`, επιτρέποντας αλλαγές στο χρώμα φόντου, τη γραμματοσειρά, τα περιγράμματα και την ευθυγράμμιση. Η βιβλιοθήκη εκθέτει ένα πλούσιο σύνολο ιδιοτήτων στυλ διατηρώντας τις εγγυήσεις αμεταβλητότητας όπου είναι δυνατόν. Μπορείτε επίσης να ανακτήσετε μορφοποιημένες τιμές, να εφαρμόσετε λογική υπό συνθήκη και να ενημερώσετε μαζικά τα στυλ σε περιοχές. Αυτό την καθιστά ιδανική για τη δημιουργία αναφορών, ταμπλό ή εξαγωγών δεδομένων με συνεπή μορφοποίηση.
Πώς να τροποποιήσετε την τιμή και το στυλ του κελιού μέσω Rust;
let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
.unwrap()
.cell_mut("A1")
.set_value("Hello, Rust!");
let mut style = book.sheet_by_name_mut("Sheet1")
.unwrap()
.style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);
Υποστήριξη Διαγραμμάτων & Εικόνων
Το umya-spreadsheet υποστηρίζει τη δημιουργία και την επεξεργασία διαγραμμάτων—συμπεριλαμβανομένων των γραμμικών, ραβδωτών και περιοχικών διαγραμμάτων—με τον ορισμό περιοχών σειράς και σημείων. Μπορείτε να ενσωματώσετε εικόνες απευθείας στα φύλλα χρησιμοποιώντας τη δομή `Image`, με υποστήριξη για PNG και άλλες μορφές ανάλογα με τις ενεργοποιημένες δυνατότητες. Τα διαγράμματα και οι εικόνες ενσωματώνονται άψογα με τις συντεταγμένες των κελιών και τα επίπεδα σχεδίασης, επιτρέποντας τη δυναμική δημιουργία ταμπλό. Ενώ ορισμένα προχωρημένα χαρακτηριστικά σχεδίασης βρίσκονται ακόμη σε εξέλιξη, η βασική λειτουργικότητα είναι έτοιμη για παραγωγή και επεκτάσιμη.
Πώς να προσθέσετε ένα γράφημα γραμμής σε ένα φύλλο εργασίας μέσω Rust;
let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
umya_spreadsheet::structs::ChartType::LineChart,
from_marker,
to_marker,
series,
);
book.sheet_by_name_mut("Sheet1")
.unwrap()
.add_chart(chart);
Λειτουργίες Περιοχής & Προστασία με Κωδικό
Εκτελέστε προχωρημένες λειτουργίες όπως η μετακίνηση, η αντιγραφή και η αλλαγή μεγέθους περιοχών χρησιμοποιώντας τη `move_range()`, επιτρέποντας τη δυναμική αναδιοργάνωση δεδομένων. Η βιβλιοθήκη υποστηρίζει επίσης βιβλία εργασίας με προστασία κωδικού πρόσβασης: γράψτε αρχεία με τη `write_with_password()` ή εφαρμόστε κωδικούς σε υπάρχοντα αρχεία μέσω της `set_password()`. Αυτά τα χαρακτηριστικά είναι κρίσιμα για ασφαλή διαχείριση δεδομένων σε επιχειρηματικές ή ευαίσθητες σε συμμόρφωση εφαρμογές. Σε συνδυασμό με σχεδίαση χωρίς εξαρτήσεις και συμβατότητα με WASM, το umya-spreadsheet προσφέρει τόσο ευελιξία όσο και ασφάλεια.
Πώς να μετακινήσετε μια περιοχή και να προστατεύσετε ένα αρχείο με κωδικό πρόσβασης μέσω Rust;
// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
.unwrap()
.move_range(range, &10, &2);
// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
&book,
Path::new("./protected.xlsx"),
"mypassword",
).unwrap();
