1. Prodotti
  2.   Foglio di calcolo
  3.   Rust
  4.   xlsxwriter-rs

xlsxwriter-rs

 
 

Libreria Rust per la generazione di Excel XLSX

Crea file Excel XLSX pienamente compatibili con formattazione, celle unite, autofilter e immagini tramite API Rust.

Che cos'è xlsxwriter-rs?

xlsxwriter-rs è un binding Rust ad alte prestazioni per la diffusa libreria C libxlsxwriter, che consente agli sviluppatori di generare file Excel XLSX completamente compatibili direttamente dalle applicazioni Rust. Supporta una formattazione Excel completa, inclusi caratteri, colori, allineamento, bordi e formati numerici, oltre a funzionalità avanzate come celle unite, autofiltro, convalida dei dati e immagini PNG/JPEG incorporate. Progettato per affidabilità e velocità, xlsxwriter-rs è ideale per la generazione di report lato server, pipeline di esportazione dati e qualsiasi scenario che richieda la creazione programmatica di file Excel in Rust.

La libreria sfrutta la sicurezza della memoria di Rust e le astrazioni a costo zero per fornire un'API sicura ed efficiente per la generazione di Excel senza richiedere Microsoft Excel o dipendenze esterne come COM. Si integra perfettamente con Cargo e supporta flag di funzionalità opzionali per personalizzare il comportamento, come la disattivazione dei checksum MD5 o l'uso di zlib di sistema. Con la sua interfaccia Rust pulita e idiomatica e una documentazione completa, xlsxwriter-rs consente agli sviluppatori di creare strumenti robusti e multipiattaforma per la generazione di Excel mantenendo il pieno controllo sulla struttura e sul contenuto dei file.

Previous Next

Guida introduttiva a xlsxwriter-rs

Per iniziare a usare xlsxwriter-rs, aggiungilo al tuo Cargo.toml tramite cargo add xlsxwriter o includi manualmente [dependencies] con xlsxwriter = \"0.1\". La libreria richiede LLVM e Clang per la compilazione di bindgen. Per Windows, installa Visual Studio e LLVM, quindi imposta LIBCLANG_PATH sulla directory bin di LLVM. Dopo la configurazione, clona il repository, esegui git submodule update --init --recursive per scaricare la libreria C e costruisci gli esempi con cargo run --example hello_spreadsheet. La documentazione completa e gli esempi sono disponibili sul GitHub di xlsxwriter-rs.

Installa xlsxwriter-rs tramite Cargo

cargo add xlsxwriter

Supporto completo alla formattazione di Excel

xlsxwriter-rs offre capacità di formattazione complete, consentendo agli sviluppatori di personalizzare caratteri, colori, bordi, allineamento e formati numerici per singole celle o intervalli. È possibile applicare grassetto, corsivo, sottolineato, dimensione del carattere e colori personalizzati al testo, impostare colori di riempimento di sfondo, definire i bordi delle celle con vari stili (sottile, medio, spesso) e controllare l'allineamento orizzontale/verticale. Questo livello di controllo garantisce che i file Excel generati corrispondano agli standard professionali di reporting. La formattazione viene applicata utilizzando la struttura Format, che supporta il chaining dei metodi per una configurazione intuitiva. Questa funzionalità è essenziale per creare report, dashboard e esportazioni di dati visivamente distinti che migliorano la leggibilità e l'esperienza dell'utente.

Applica colore del carattere e allineamento alle celle

let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
    0, 0, 
    "Red text", 
    Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
    2, 0, 
    "Centered green text", 
    Some(&Format::new()
        .set_font_color(FormatColor::Green)
        .set_align(FormatAlignment::CenterAcross)
        .set_vertical_align(FormatVerticalAlignment::VerticalCenter)
    )
)?;

Celle e intervalli uniti

La libreria supporta l'unione di intervalli rettangolari di celle, il che è fondamentale per creare intestazioni, titoli e sezioni di dati raggruppati nei report Excel. Utilizzando il metodo merge_range, è possibile estendere su più righe e colonne applicando la formattazione all'intero blocco unito. Questo garantisce uno stile e un layout coerenti su fogli di calcolo complessi. Le celle unite sono pienamente compatibili con il motore di rendering di Excel e conservano la formattazione come l'allineamento del testo, i bordi e i colori di sfondo. Questa funzionalità è particolarmente utile per bilanci finanziari, dashboard e moduli dove il raggruppamento visivo migliora la comprensione dei dati e la qualità della presentazione.

Unisci un intervallo con formattazione personalizzata

sheet1.merge_range(
    2, 0, 
    3, 2, 
    "Hello, world", 
    Some(&Format::new()
        .set_font_color(FormatColor::Green)
        .set_align(FormatAlignment::CenterAcross)
        .set_vertical_align(FormatVerticalAlignment::VerticalCenter)
    )
)?;

Filtri automatici e convalida dei dati

xlsxwriter-rs consente la creazione programmatica di autofilter e regole di convalida dei dati, permettendo agli utenti di ordinare, filtrare e convalidare i dati direttamente in Excel. È possibile applicare un autofilter a un intervallo di celle usando set_autofilter, e definire elenchi a discesa per l'immissione dell'utente tramite la convalida dei dati. Questo supporta la convalida basata su elenchi, intervalli numerici, date e formule personalizzate. Queste funzionalità migliorano l'interattività e l'integrità dei dati nei fogli di calcolo, rendendoli adatti a moduli, modelli e inserimento dati collaborativo. I file XLSX generati mantengono tutte le funzionalità quando aperti in Excel, LibreOffice o Google Sheets, garantendo ampia compatibilità.

Applica autofiltro e convalida dei dati

// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;

// Add data validation (drop-down list) in B2
sheet1.data_validation(
    "B2", 
    DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;

Incorporare immagini e collegamenti ipertestuali

Puoi incorporare immagini PNG e JPEG direttamente nei fogli di lavoro Excel utilizzando xlsxwriter-rs, supportando il posizionamento, le dimensioni e la scala. Questo è ideale per aggiungere loghi, grafici o indicatori visivi ai report. Inoltre, la libreria supporta collegamenti ipertestuali e URL con formattazione personalizzabile (ad es., testo blu e sottolineature), consentendo link cliccabili a siti web, documenti o altri fogli. Queste funzionalità rendono xlsxwriter-rs adatto alla creazione di report e dashboard ricchi e interattivi che combinano dati, elementi visivi e navigazione. Tutti i contenuti incorporati sono pienamente compatibili con il motore di rendering di Excel e preservano l'integrità del layout su tutte le piattaforme.

Scrivi URL e incorpora immagine

// Write a clickable URL
sheet1.write_url(
    1, 1,
    "https://github.com/informationsea/xlsxwriter-rs",
    Some(&Format::new()
        .set_font_color(FormatColor::Blue)
        .set_underline(FormatUnderline::Single)
    )
)?;

// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;
 Italiano