
umya-spreadsheet
Libreria Rust Pura per File XLSX/XLSM
Leggi, Scrivi, Stila e Manipola Fogli di Calcolo XLSX/XLSM senza Dipendenze Esterne.
Che cos'è umya-spreadsheet?
umya-spreadsheet è una libreria Rust pura ad alte prestazioni per la lettura e la scrittura di file di fogli di calcolo Excel nei formati XLSX e XLSM. Progettata per la sicurezza e l'efficienza, evita codice non sicuro e dipendenze esterne, rendendola ideale per applicazioni desktop, elaborazione lato server e ambienti WebAssembly. La libreria fornisce un'API Rust pulita e idiomatica per accedere a celle, righe, colonne, stili, grafici e immagini, consentendo agli sviluppatori di creare strumenti di fogli di calcolo robusti senza dipendere da Microsoft Office o dall'interoperabilità COM.
Con pieno supporto per il caricamento lazy, la protezione con password e la formattazione avanzata, umya-spreadsheet colma il divario tra prestazioni e usabilità. Supporta l'esportazione CSV, la generazione di grafici, l'inserimento di immagini e le operazioni su intervalli come lo spostamento e la copia. Il progetto è attivamente mantenuto, ben documentato e testato, con un'attenzione alla correttezza e alla compatibilità con le funzionalità moderne di Excel. Gli sviluppatori possono integrarlo in strumenti CLI, backend web o applicazioni desktop utilizzando framework come Tauri o Axo.
Iniziare con umya-spreadsheet
Per iniziare a usare umya-spreadsheet, aggiungilo al tuo Cargo.toml con `umya-spreadsheet = "3.1.1"`. Per il supporto WebAssembly, abilita la funzionalità `js`. La libreria è leggera in dipendenze e si compila rapidamente. Una volta installata, importala tramite `extern crate umya_spreadsheet;` e inizia a leggere o scrivere fogli di calcolo. Puoi anche esplorare il GitHub di umya-spreadsheet per esempi, test e documentazione. Supporta il caricamento pigro per file di grandi dimensioni e offre una gestione robusta degli errori.
Installa umya-spreadsheet via Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
Leggere e scrivere file XLSX/XLSM
umya-spreadsheet fornisce API intuitive per leggere e scrivere file XLSX e XLMS. Usa `reader::xlsx::read()` per caricare una cartella di lavoro dal disco, o `new_file()` per crearne una vuota. La scrittura è altrettanto semplice: chiama `writer::xlsx::write()` con la cartella di lavoro e il percorso di destinazione. La libreria supporta il caricamento pigro tramite `lazy_read()` per migliorare le prestazioni su file di grandi dimensioni, e consente la scrittura protetta da password o l'impostazione di password dopo la creazione. Tutte le operazioni sono sicure, zero-copy dove possibile, ed evitano binari esterni.
Come leggere e scrivere un file XLSX tramite 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();
Accesso alle celle e manipolazione degli stili
L'accesso e la modifica dei valori delle celle è semplice: usa `cell("A1")` o `cell((1,1))` per la lettura, e `cell_mut()` per la scrittura. Gli stili sono gestiti tramite `style_mut()`, consentendo modifiche al colore di sfondo, al carattere, ai bordi e all'allineamento. La libreria espone un ricco insieme di proprietà di stile mantenendo, dove possibile, le garanzie di immutabilità. È inoltre possibile recuperare i valori formattati, applicare logica condizionale e aggiornare in batch gli stili su intervalli. Questo la rende ideale per generare report, dashboard o esportazioni di dati con formattazione coerente.
Come modificare il valore e lo stile di una cella tramite 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);
Supporto per grafici e immagini
umya-spreadsheet supporta la creazione e la modifica di grafici—including line, bar, and area charts—definendo intervalli di serie e marcatori. È possibile incorporare immagini direttamente nei fogli utilizzando la struttura `Image`, con supporto per PNG e altri formati a seconda delle funzionalità abilitate. I grafici e le immagini si integrano perfettamente con le coordinate delle celle e i livelli di disegno, consentendo la generazione dinamica di dashboard. Sebbene alcune funzionalità di disegno avanzate siano ancora in evoluzione, la funzionalità di base è pronta per la produzione e estensibile.
Come aggiungere un grafico a linee a un foglio di calcolo tramite 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);
Operazioni su intervalli e protezione con password
Esegui operazioni avanzate come spostare, copiare e ridimensionare intervalli usando `move_range()`, consentendo la riorganizzazione dinamica dei dati. La libreria supporta anche cartelle di lavoro protette da password: scrivi file con `write_with_password()` o applica password ai file esistenti tramite `set_password()`. Queste funzionalità sono fondamentali per la gestione sicura dei dati in applicazioni aziendali o sensibili alla conformità. In combinazione con un design a zero dipendenze e compatibilità WASM, umya-spreadsheet offre sia flessibilità che sicurezza.
Come spostare un intervallo e proteggere un file con password tramite 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();
