1. Producten
  2.   Spreadsheet
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

Open Source Rust-bibliotheek voor Excel XLSX-bestanden

Genereer Excel 2007+ XLSX-bestanden met volledige opmaak, grafieken, formules & afbeeldingen via Rust API.

Wat is rust_xlsxwriter?

rust_xlsxwriter is een high‑performance, pure Rust‑crate voor het genereren van Excel‑XLSX‑bestanden zonder dat Excel of externe afhankelijkheden nodig zijn. Het stelt ontwikkelaars in staat om programmatisch spreadsheets te maken met tekst, cijfers, datums, formules, grafieken, afbeeldingen, samengevoegde cellen, voorwaardelijke opmaak, gegevensvalidatie en meer. Ontworpen voor betrouwbaarheid en snelheid, komt het nauw overeen met het native bestandsformaat van Excel en ondersteunt het constant geheugenmodus voor grote datasets. De bibliotheek is een getrouwe Rust‑herimplementatie van de populaire Python‑XlsxWriter‑bibliotheek, met idiomatische API’s en uitgebreide documentatie.

rust_xlsxwriter richt zich uitsluitend op het schrijven van Excel-bestanden—geen lezen of wijzigen van bestaande bestanden. Het ondersteunt moderne Excel-functies zoals dynamische arrays, sparklines, selectievakjes, tekstvakken, tabellen, autofilters, gedefinieerde namen en werkmapthema's. Met optionele functies zoals Serde-serialisatie, chrono/jiff-datumondersteuning en Polars-integratie past het zich aan diverse Rust-ecosystemen aan. De prestaties staan op de tweede plaats na de C-versie en leveren een 3,8× snellere uitvoering dan Python's XlsxWriter. Voor volledige details, zie de rust_xlsxwriter GitHub-repository.

Previous Next

Aan de slag met rust_xlsxwriter

rust_xlsxwriter is beschikbaar op crates.io en kan geïnstalleerd worden via `cargo add rust_xlsxwriter`. Voor verbeterde functionaliteit, schakel optionele functies in zoals `constant_memory`, `chrono`, `serde` of `polars`. De bibliotheek vereist Rust 1.56+ en compileert naar native binaries zonder externe runtime-afhankelijkheden behalve de `zip` crate (standaard). Het is volledig gedocumenteerd met een gebruikershandleiding, tutorial en kookboek. Voor gedetailleerde voorbeelden en broncode, bezoek de rust_xlsxwriter GitHub-repository.

Installeer rust_xlsxwriter via Cargo

cargo add rust_xlsxwriter

Geformatteerde cellen schrijven met tekst, cijfers en datums

rust_xlsxwriter biedt een eenvoudige en intuïtieve API om opgemaakte inhoud naar Excel-cellen te schrijven. Ontwikkelaars kunnen aangepaste opmaak toepassen voor getallen, datums, lettertypen, randen, uitlijning en kleuren met behulp van de `Format` struct. De bibliotheek ondersteunt het schrijven van platte tekst, numerieke waarden, datums, formules en URL's met optionele opmaak. Het ondersteunt ook rijke multi-opmaak strings voor gemengde opmaak binnen één cel. Dit maakt het ideaal voor het genereren van rapporten, dashboards en data‑exports waar visuele duidelijkheid en structuur essentieel zijn. De API zorgt voor hoge getrouwheid met de native opmaakengine van Excel.

Hoe geformatteerde tekst, cijfers en datums schrijven 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")?;

Grafieken, sparklines en afbeeldingen maken

rust_xlsxwriter ondersteunt het genereren van professionele grafieken, sparklines en het insluiten van afbeeldingen direct in Excel-bestanden. Ontwikkelaars kunnen staaf-, lijn-, taart-, spreidings- en gebiedsgrafieken maken met aanpasbare assen, legenda's en gegevensreeksen. Sparklines bieden compacte trendvisualisatie binnen cellen. Afbeeldingen (PNG, JPEG, GIF, BMP) kunnen worden ingevoegd en gepositioneerd met schaal- en verankeringsopties. Deze visuele elementen verbeteren het vertellen van data en rapportagemogelijkheden. De bibliotheek zorgt voor compatibiliteit met Excel 2007+ en behoudt de weergavefidelity over platforms.

Hoe voeg je een grafiek en afbeelding toe aan 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")?;

Geavanceerde opmaak: samengevoegde cellen, tabellen en voorwaardelijke opmaak

rust_xlsxwriter maakt geavanceerde Excel-opmaakfuncties mogelijk, zoals samengevoegde bereiken, gestructureerde tabellen, autofilters en regels voor voorwaardelijke opmaak. Ontwikkelaars kunnen cellen samenvoegen voor kopteksten of labels, tabelstijlen toepassen met afwisselende rijen/kolommen, en filters definiëren voor gebruikersinteractiviteit. Voorwaardelijke opmaak ondersteunt kleurschalen, gegevensbalken, pictogramsets en aangepaste formules om trends of anomalieën te markeren. Deze functies verbeteren de leesbaarheid van data en de interactiviteit in gegenereerde werkmappen. De API abstraheert complexe XML-structuren naar intuïtieve Rust-methoden, waardoor onderhoudbaarheid en typeveiligheid worden gegarandeerd.

Hoe cellen samenvoegen en tabellen toevoegen met voorwaardelijke opmaak?

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")?;

Prestatieoptimalisatie en ondersteuning voor grote bestanden

rust_xlsxwriter is geoptimaliseerd voor snelheid en geheugenefficiëntie, vooral voor grote datasets. Het ondersteunt de constant memory-modus (`constant_memory`-functie), die gegevens incrementeel naar schijf schrijft, waardoor het heap-gebruik wordt geminimaliseerd. Deze modus is ideaal voor het genereren van Excel-bestanden van meerdere megabytes zonder OOM-fouten. Benchmarks tonen aan dat het ongeveer ~3.8× sneller is dan Python’s XlsxWriter en slechts ~14% langzamer dan de native C-bibliotheek. Optionele functies zoals `zmij` en `zlib` versnellen numerieke schrijfbewerkingen en compressie verder. Deze mogelijkheden maken het geschikt voor batchrapportage, ETL-pijplijnen en server-side Excel-generatie.

Hoe constant geheugenmodus inschakelen voor grote bestanden?

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")?;
 Dutch