
rust_xlsxwriter
Libreria Rust open source per file Excel XLSX
Genera file Excel 2007+ XLSX con formattazione completa, grafici, formule e immagini tramite API Rust.
Che cos'è rust_xlsxwriter?
rust_xlsxwriter è un crate Rust puro ad alte prestazioni per generare file Excel XLSX senza richiedere Excel o dipendenze esterne. Consente agli sviluppatori di creare programmaticamente fogli di calcolo con testo, numeri, date, formule, grafici, immagini, celle unite, formattazione condizionale, convalida dei dati e molto altro. Progettato per affidabilità e velocità, corrisponde fedelmente al formato nativo di Excel e supporta la modalità di memoria costante per grandi set di dati. La libreria è una fedele riscrittura in Rust della popolare libreria Python XlsxWriter, con API idiomatiche e documentazione completa.
rust_xlsxwriter si concentra esclusivamente sulla scrittura di file Excel—nessuna lettura o modifica di file esistenti. Supporta le funzionalità moderne di Excel come array dinamici, sparklines, caselle di controllo, caselle di testo, tabelle, filtri automatici, nomi definiti e temi della cartella di lavoro. Con funzionalità opzionali come la serializzazione Serde, il supporto alle date chrono/jiff e l'integrazione con Polars, si adatta a diversi ecosistemi Rust. Le sue prestazioni sono seconde solo alla versione C, offrendo un'esecuzione 3,8× più veloce rispetto a XlsxWriter di Python. Per ulteriori dettagli, consulta il repository GitHub di rust_xlsxwriter.
Guida introduttiva a rust_xlsxwriter
rust_xlsxwriter è disponibile su crates.io e può essere installato tramite `cargo add rust_xlsxwriter`. Per funzionalità avanzate, abilita le funzionalità opzionali come `constant_memory`, `chrono`, `serde` o `polars`. La libreria richiede Rust 1.56+ e si compila in binari nativi senza dipendenze runtime esterne oltre al crate `zip` (per impostazione predefinita). È completamente documentata con una guida per l'utente, un tutorial e un ricettario. Per esempi dettagliati e il codice sorgente, visita il repository GitHub di rust_xlsxwriter.
Installa rust_xlsxwriter tramite Cargo
cargo add rust_xlsxwriterScrivi celle formattate con testo, numeri e date
rust_xlsxwriter fornisce un'API semplice e intuitiva per scrivere contenuti formattati nelle celle di Excel. Gli sviluppatori possono applicare formati personalizzati per numeri, date, caratteri, bordi, allineamento e colori usando la struct `Format`. La libreria supporta la scrittura di testo semplice, valori numerici, date, formule e URL con formattazione opzionale. Supporta anche stringhe multi-formato ricche per formattazioni miste all'interno di una singola cella. Questo lo rende ideale per generare report, dashboard e esportazioni di dati dove la chiarezza visiva e la struttura sono essenziali. L'API garantisce alta fedeltà con il motore di formattazione nativo di Excel.
Come scrivere testo, numeri e date formattati con Rust?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
let bold = Format::new().set_bold();
let decimal = Format::new().set_num_format("0.00");
let date_fmt = Format::new().set_num_format("yyyy-mm-dd");
worksheet.write_with_format(0, 0, "Hello", &bold)?;
worksheet.write(1, 0, 123.456)?;
worksheet.write_with_format(2, 0, 789.012, &decimal)?;
let date = ExcelDateTime::from_ymd(2023, 12, 25)?;
worksheet.write_with_format(3, 0, &date, &date_fmt)?;
workbook.save("formatted.xlsx")?;Crea grafici, sparkline e immagini
rust_xlsxwriter supporta la generazione di grafici professionali, sparklines e l'incorporamento di immagini direttamente nei file Excel. Gli sviluppatori possono creare grafici a barre, a linee, a torta, a dispersione e ad area con assi, legende e serie di dati personalizzabili. Le sparklines forniscono una visualizzazione compatta delle tendenze all'interno delle celle. Le immagini (PNG, JPEG, GIF, BMP) possono essere inserite e posizionate con opzioni di ridimensionamento e ancoraggio. Questi elementi visivi migliorano la narrazione dei dati e le capacità di reporting. La libreria garantisce la compatibilità con Excel 2007+ e preserva la fedeltà del rendering su tutte le piattaforme.
Come aggiungere un grafico e un'immagine a Excel tramite Rust?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
// Write sample data
for i in 0..5 {
worksheet.write_number(i, 0, (i + 1) as f64 * 10.0)?;
}
// Create a chart
let mut chart = Chart::new(ChartType::Column);
chart.add_series().set_values("Sheet1!$A$1:$A$5");
worksheet.insert_chart(0, 2, &chart)?;
// Insert an image
let image = Image::new("logo.png")?;
worksheet.insert_image(5, 2, &image)?;
workbook.save("chart_image.xlsx")?;Formattazione avanzata: celle unite, tabelle e formattazione condizionale
rust_xlsxwriter consente funzionalità avanzate di formattazione di Excel come intervalli uniti, tabelle strutturate, autofilter e regole di formattazione condizionale. Gli sviluppatori possono unire celle per intestazioni o etichette, applicare stili di tabella con righe/colonne a bande e definire filtri per l'interattività dell'utente. La formattazione condizionale supporta scale di colore, barre dei dati, set di icone e formule personalizzate per evidenziare tendenze o anomalie. Queste funzionalità migliorano la leggibilità dei dati e l'interattività nei workbook generati. L'API astrae strutture XML complesse in metodi Rust intuitivi, garantendo manutenibilità e sicurezza dei tipi.
Come unire le celle e aggiungere tabelle con formattazione condizionale?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
// Merge cells
let merge_fmt = Format::new()
.set_border(FormatBorder::Thin)
.set_align(FormatAlign::Center);
worksheet.merge_range(0, 0, 0, 2, "Report Header", &merge_fmt)?;
// Add table
worksheet.add_table(1, 0, 5, 2, Table::new().set_columns(&[
("Item", None),
("Value", None),
("Status", None),
]))?;
// Conditional formatting
worksheet.conditional_format(
2, 0, 5, 2,
ConditionalFormat::new()
.set_type(ConditionalFormatType::Cell)
.set_format(&Format::new().set_bg_color("#D8E4BC"))
.set_formula("=A2>100")
)?;
workbook.save("advanced.xlsx")?;Ottimizzazione delle prestazioni e supporto per file di grandi dimensioni
rust_xlsxwriter è ottimizzato per velocità ed efficienza della memoria, soprattutto per grandi set di dati. Supporta la modalità a memoria costante (`constant_memory` feature), che scrive i dati in modo incrementale su disco, riducendo al minimo l'uso dell'heap. Questa modalità è ideale per generare file Excel multi-megabyte senza errori OOM. I benchmark mostrano che è circa ~3.8× più veloce rispetto a XlsxWriter di Python e solo ~14% più lento rispetto alla libreria C nativa. Funzionalità opzionali come `zmij` e `zlib` accelerano ulteriormente la scrittura numerica e la compressione. Queste capacità lo rendono adatto per reportistica batch, pipeline ETL e generazione di Excel lato server.
Come abilitare la modalità di memoria costante per file di grandi dimensioni?
cargo add rust_xlsxwriter -F constant_memoryuse rust_xlsxwriter::*;
let mut workbook = Workbook::new();
workbook.set_constant_memory(true); // Enable constant memory mode
let worksheet = workbook.add_worksheet();
for i in 0..100_000 {
worksheet.write_number(i, 0, i as f64)?;
}
workbook.save("large_file.xlsx")?;