
rust_xlsxwriter
Open source Rust-bibliotek til Excel XLSX-filer
Generer Excel 2007+ XLSX-filer med fuld formatering, diagrammer, formler & billeder via Rust API.
Hvad er rust_xlsxwriter?
rust_xlsxwriter er en højtydende, ren Rust-krate til at generere Excel XLSX-filer uden at kræve Excel eller eksterne afhængigheder. Den gør det muligt for udviklere at programmere oprettelse af regneark med tekst, tal, datoer, formler, diagrammer, billeder, flettede celler, betinget formatering, datavalidering og mere. Designet til pålidelighed og hastighed, matcher den nøje Excels native filformat og understøtter konstant hukommelsestilstand for store datasæt. Biblioteket er en trofast Rust-omskrivning af det populære Python XlsxWriter-bibliotek, med idiomatiske API'er og omfattende dokumentation.
rust_xlsxwriter fokuserer udelukkende på at skrive Excel-filer—ingen læsning eller ændring af eksisterende filer. Det understøtter moderne Excel-funktioner som dynamiske arrays, sparklines, afkrydsningsfelter, tekstbokse, tabeller, autofiltere, definerede navne og arbejdsbogstemaer. Med valgfrie funktioner som Serde-serialisering, chrono/jiff-datostøtte og Polars-integration tilpasser det sig forskellige Rust-økosystemer. Dets ydeevne er kun overgået af C-versionen og leverer 3,8× hurtigere udførelse end Python's XlsxWriter. For fulde detaljer, se rust_xlsxwriter GitHub-repositoriet.
Kom i gang med rust_xlsxwriter
rust_xlsxwriter er tilgængelig på crates.io og kan installeres via `cargo add rust_xlsxwriter`. For udvidet funktionalitet skal du aktivere valgfrie funktioner som `constant_memory`, `chrono`, `serde` eller `polars`. Biblioteket kræver Rust 1.56+ og kompileres til native binære filer uden eksterne runtime-afhængigheder udover `zip`-craten (som standard). Det er fuldt dokumenteret med en brugervejledning, tutorial og kogebog. For detaljerede eksempler og kildekode, besøg rust_xlsxwriter GitHub-repositorium.
Installer rust_xlsxwriter via Cargo
cargo add rust_xlsxwriterSkriv formaterede celler med tekst, tal og datoer
rust_xlsxwriter leverer et enkelt og intuitivt API til at skrive formateret indhold til Excel-celler. Udviklere kan anvende brugerdefinerede formater for tal, datoer, skrifttyper, kanter, justering og farver ved hjælp af `Format`-structen. Biblioteket understøtter skrivning af almindelig tekst, numeriske værdier, datoer, formler og URL'er med valgfri formatering. Det understøtter også rige multi-format strenge for blandet formatering inden for en enkelt celle. Dette gør det ideelt til at generere rapporter, dashboards og dataeksport, hvor visuel klarhed og struktur er afgørende. API'et sikrer høj nøjagtighed med Excels native formateringsmotor.
Hvordan skriver man formateret tekst, tal og datoer via 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")?;Opret diagrammer, sparklines og billeder
rust_xlsxwriter understøtter generering af professionelle diagrammer, sparklines og indlejring af billeder direkte i Excel-filer. Udviklere kan oprette søjle-, linje-, cirkel-, sprednings- og arealdiagrammer med tilpasselige akser, forklaringer og dataserier. Sparklines giver kompakt trendvisualisering inden for celler. Billeder (PNG, JPEG, GIF, BMP) kan indsættes og placeres med skalerings- og forankringsmuligheder. Disse visuelle elementer forbedrer datafortælling og rapporteringsmuligheder. Biblioteket sikrer kompatibilitet med Excel 2007+ og bevarer gengivelsesnøjagtighed på tværs af platforme.
Hvordan tilføjer man et diagram og et billede til Excel via 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")?;Avanceret formatering: Sammenflettede celler, tabeller og betinget formatering
rust_xlsxwriter muliggør avancerede Excel-formateringsfunktioner såsom sammenflettede områder, strukturerede tabeller, autofilter og betingede formateringsregler. Udviklere kan sammenflette celler til overskrifter eller etiketter, anvende tabelstilarter med båndede rækker/kolonner og definere filtre for brugerinteraktivitet. Betinget formatering understøtter farveskalaer, datastænger, ikon-sæt og brugerdefinerede formler for at fremhæve trends eller anomalier. Disse funktioner forbedrer datalæselighed og interaktivitet i genererede arbejdsbøger. API'en abstraherer komplekse XML-strukturer til intuitive Rust-metoder, hvilket sikrer vedligeholdelse og typesikkerhed.
Hvordan fletter man celler og tilføjer tabeller med betinget formatering?
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")?;Ydelsesoptimering og understøttelse af store filer
rust_xlsxwriter er optimeret til hastighed og hukommelseseffektivitet, især for store datasæt. Det understøtter konstant hukommelsestilstand (`constant_memory`-funktionen), som skriver data inkrementelt til disk og minimerer heap‑forbruget. Denne tilstand er ideel til at generere multi‑megabyte Excel‑filer uden OOM‑fejl. Benchmarks viser, at den kører ~3.8× hurtigere end Pythons XlsxWriter og kun ~14% langsommere end det native C‑bibliotek. Valgfrie funktioner som `zmij` og `zlib` accelererer yderligere numerisk skrivning og kompression. Disse muligheder gør den egnet til batch‑rapportering, ETL‑pipelines og server‑side Excel‑generering.
Hvordan aktiverer man konstant hukommelsestilstand for store filer?
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")?;