
xlsxwriter-rs
Bibliotecă Rust pentru generarea Excel XLSX
Creează fișiere Excel XLSX complet compatibile cu formatare, celule îmbinate, autofiltre și imagini prin API-ul Rust.
Ce este xlsxwriter-rs?
xlsxwriter-rs este o legătură Rust de înaltă performanță pentru biblioteca C libxlsxwriter, utilizată pe scară largă, permițând dezvoltatorilor să genereze fișiere Excel XLSX complet compatibile direct din aplicații Rust. Suportă formatare Excel cuprinzătoare, inclusiv fonturi, culori, aliniere, borduri și formate numerice, precum și funcționalități avansate precum celule îmbinate, autofiltre, validarea datelor și imagini PNG/JPEG încorporate. Proiectat pentru fiabilitate și viteză, xlsxwriter-rs este ideal pentru generarea de rapoarte pe server, fluxuri de export de date și orice scenariu care necesită crearea programatică de fișiere Excel în Rust.
Biblioteca valorifică siguranța memoriei și abstracțiile fără costuri ale limbajului Rust pentru a oferi un API sigur și eficient pentru generarea de fișiere Excel, fără a necesita Microsoft Excel sau dependențe externe precum COM. Se integrează perfect cu Cargo și suportă steaguri de funcționalitate opționale pentru personalizarea comportamentului, cum ar fi dezactivarea sumelor de control MD5 sau utilizarea zlib-ului sistemului. Cu interfața sa curată, idiomatică în Rust și documentația cuprinzătoare, xlsxwriter-rs permite dezvoltatorilor să construiască instrumente robuste, cross-platform, pentru generarea de fișiere Excel, menținând control total asupra structurii și conținutului fișierului.
Începerea cu xlsxwriter-rs
Pentru a începe să utilizați xlsxwriter-rs, adăugați-l în Cargo.toml prin cargo add xlsxwriter sau includeți manual [dependencies] cu xlsxwriter = "0.1". Biblioteca necesită LLVM și Clang pentru compilarea bindgen. Pentru Windows, instalați Visual Studio și LLVM, apoi setați LIBCLANG_PATH la directorul bin al LLVM. După configurare, clonați depozitul, rulați git submodule update --init --recursive pentru a descărca biblioteca C și construiți exemplele cu cargo run --example hello_spreadsheet. Documentația completă și exemplele sunt disponibile pe GitHub-ul xlsxwriter-rs.
Instalați xlsxwriter-rs prin Cargo
cargo add xlsxwriterSuport complet pentru formatarea Excel
xlsxwriter-rs oferă capabilități complete de formatare, permițând dezvoltatorilor să personalizeze fonturi, culori, borduri, aliniere și formate numerice pentru celule individuale sau intervale. Poți aplica îngroșare (bold), italic, subliniere, dimensiunea fontului și culori personalizate textului, seta culori de umplere de fundal, defini borduri de celule cu diverse stiluri (subțire, mediu, gros), și controla alinierea orizontală/verticală. Acest nivel de control asigură că fișierele Excel generate respectă standardele profesionale de raportare. Formatarea este aplicată utilizând structura Format, care suportă înlănțuirea de metode pentru o configurare intuitivă. Această funcționalitate este esențială pentru crearea de rapoarte, tablouri de bord și exporturi de date vizual distincte, care îmbunătățesc lizibilitatea și experiența utilizatorului.
Aplicați culoarea fontului și alinierea la celule
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)
)
)?;Celule și intervale fuzionate
Biblioteca suportă îmbinarea intervalelor dreptunghiulare de celule, ceea ce este esențial pentru crearea antetelor, titlurilor și secțiunilor de date grupate în rapoartele Excel. Folosind metoda merge_range, poți extinde pe mai multe rânduri și coloane în timp ce aplici formatarea întregului bloc îmbinat. Aceasta asigură un stil și un aspect coerent în foile de calcul complexe. Celulele îmbinate sunt pe deplin compatibile cu motorul de redare al Excel și păstrează formatarea, cum ar fi alinierea textului, bordurile și culorile de fundal. Această funcție este deosebit de utilă pentru situații financiare, tablouri de bord și formulare în care gruparea vizuală îmbunătățește înțelegerea datelor și calitatea prezentării.
Îmbină un interval cu formatare personalizată
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)
)
)?;Filtre automate și validarea datelor
xlsxwriter-rs permite crearea programatică de autofiltre și reguli de validare a datelor, permițând utilizatorilor să sorteze, să filtreze și să valideze datele direct în Excel. Poți aplica un autofiltru pe un interval de celule utilizând set_autofilter și poți defini liste derulante pentru introducerea de către utilizator prin validarea datelor. Aceasta suportă validarea bazată pe liste, intervale numerice, date și formule personalizate. Aceste funcționalități îmbunătățesc interactivitatea și integritatea datelor în foi de calcul, făcându-le potrivite pentru formulare, șabloane și introducere colaborativă de date. Fișierele XLSX generate păstrează funcționalitatea completă când sunt deschise în Excel, LibreOffice sau Google Sheets, asigurând o compatibilitate largă.
Aplică autofiltru și validarea datelor
// 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"])
)?;Încorporare imagini și hyperlinkuri
Poți încorpora imagini PNG și JPEG direct în foile de calcul Excel utilizând xlsxwriter-rs, suportând poziționarea, redimensionarea și scalarea. Aceasta este ideală pentru adăugarea de logo-uri, grafice sau indicatori vizuali în rapoarte. În plus, biblioteca suportă hyperlink-uri și URL-uri cu formatare personalizabilă (de exemplu, text albastru și subliniere), permițând linkuri clicabile către site-uri web, documente sau alte foi. Aceste capabilități fac ca xlsxwriter-rs să fie potrivit pentru crearea de rapoarte și tablouri de bord interactive și bogate, care combină date, elemente vizuale și navigare. Tot conținutul încorporat este pe deplin compatibil cu motorul de redare al Excel și păstrează integritatea aspectului pe toate platformele.
Scrie URL și încorporează imaginea
// 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")?;