1. Produkter
  2.   Regneark
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

Open Source Rust-bibliotek for Excel XLSX-filer

Generer Excel 2007+ XLSX-filer med full formatering, diagrammer, formler og bilder via Rust API.

Hva er rust_xlsxwriter?

rust_xlsxwriter er en høyytelses, ren Rust-krate for å generere Excel XLSX-filer uten å kreve Excel eller eksterne avhengigheter. Den gjør det mulig for utviklere å programmatisk lage regneark med tekst, tall, datoer, formler, diagrammer, bilder, sammenslåtte celler, betinget formatering, datavalidering og mer. Designet for pålitelighet og hastighet, samsvarer den tett med Excels native filformat og støtter konstant minnemodus for store datasett. Biblioteket er en trofast Rust-omskriving av det populære Python XlsxWriter-biblioteket, med idiomatiske API-er og omfattende dokumentasjon.

rust_xlsxwriter fokuserer utelukkende på å skrive Excel-filer—ingen lesing eller endring av eksisterende filer. Den støtter moderne Excel-funksjoner som dynamiske matriser, sparklines, avmerkingsbokser, tekstbokser, tabeller, autofiltere, definerte navn og arbeidsboktemaer. Med valgfrie funksjoner som Serde-serialisering, chrono/jiff-datestøtte og Polars-integrasjon tilpasser den seg ulike Rust-økosystemer. Ytelsen er kun overgått av C-versjonen, og gir 3,8× raskere utførelse enn Pythons XlsxWriter. For fullstendige detaljer, se rust_xlsxwriter GitHub-repositorium.

Previous Next

Kom i gang med rust_xlsxwriter

rust_xlsxwriter er tilgjengelig på crates.io og kan installeres via `cargo add rust_xlsxwriter`. For forbedret funksjonalitet, aktiver valgfrie funksjoner som `constant_memory`, `chrono`, `serde` eller `polars`. Biblioteket krever Rust 1.56+ og kompileres til native binærfiler uten eksterne kjøretidsavhengigheter utover `zip`-kraten (som standard). Det er fullt dokumentert med en brukerguide, veiledning og kokebok. For detaljerte eksempler og kildekode, besøk rust_xlsxwriter GitHub-repositorium.

Installer rust_xlsxwriter via Cargo

cargo add rust_xlsxwriter

Skriv formaterte celler med tekst, tall og datoer

rust_xlsxwriter tilbyr et enkelt og intuitivt API for å skrive formatert innhold til Excel-celler. Utviklere kan bruke egendefinerte formater for tall, datoer, skrifttyper, kantlinjer, justering og farger ved hjelp av `Format`-strukturen. Biblioteket støtter skriving av ren tekst, numeriske verdier, datoer, formler og URL-er med valgfri formatering. Det støtter også rike multi-format-strenger for blandet formatering innenfor en enkelt celle. Dette gjør det ideelt for å generere rapporter, dashbord og dataeksport hvor visuell klarhet og struktur er avgjørende. API-et sikrer høy nøyaktighet med Excels native formateringsmotor.

Hvordan skrive formatert tekst, tall og datoer med 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")?;

Lag diagrammer, sparkline‑grafikk og bilder

rust_xlsxwriter støtter generering av profesjonelle diagrammer, sparkline-grafer og innsetting av bilder direkte i Excel-filer. Utviklere kan lage stolpe-, linje-, sektordiagrammer, sprednings- og områdediagrammer med tilpassbare akser, forklaringer og dataserier. Sparkline-grafer gir kompakt trendvisualisering i celler. Bilder (PNG, JPEG, GIF, BMP) kan settes inn og plasseres med skalering og forankringsalternativer. Disse visuelle elementene forbedrer datfortelling og rapporteringsmuligheter. Biblioteket sikrer kompatibilitet med Excel 2007+ og bevarer gjengivelsesnøyaktighet på tvers av plattformer.

Hvordan legge til et diagram og bilde i 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")?;

Avansert formatering: sammenslåtte celler, tabeller og betinget formatering

rust_xlsxwriter gjør det mulig med avanserte Excel-formateringsfunksjoner som sammenslåtte områder, strukturerte tabeller, autofilter og betingede formateringsregler. Utviklere kan slå sammen celler for overskrifter eller etiketter, bruke tabellstiler med stripete rader/kolonner, og definere filtere for brukerinteraktivitet. Betinget formatering støtter fargeskalaer, datastolper, ikonsett og egendefinerte formler for å fremheve trender eller avvik. Disse funksjonene forbedrer datalesbarhet og interaktivitet i genererte arbeidsbøker. API-et abstraherer komplekse XML-strukturer til intuitive Rust-metoder, og sikrer vedlikeholdbarhet og type-sikkerhet.

Hvordan slå sammen celler og legge til 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")?;

Ytelsesoptimalisering og støtte for store filer

rust_xlsxwriter er optimalisert for hastighet og minneeffektivitet, spesielt for store datasett. Den støtter konstant minnemodus (`constant_memory`-funksjonen), som skriver data inkrementelt til disk og minimerer heap-bruk. Denne modusen er ideell for å generere Excel-filer på flere megabyte uten OOM-feil. Benchmark‑resultater viser at den kjører ~3,8× raskere enn Pythons XlsxWriter og bare ~14 % tregere enn det native C‑biblioteket. Valgfrie funksjoner som `zmij` og `zlib` akselererer ytterligere numerisk skriving og komprimering. Disse egenskapene gjør den egnet for batch‑rapportering, ETL‑pipelines og server‑side Excel‑generering.

Hvordan aktivere konstant minnemodus for store filer?

cargo add rust_xlsxwriter -F constant_memory
use 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")?;
 Norsk