1. produkty
  2.   Tabulka
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

Open source Rust knihovna pro soubory Excel XLSX

Generujte soubory Excel 2007+ XLSX s plným formátováním, grafy, vzorci a obrázky pomocí Rust API.

Co je rust_xlsxwriter?

rust_xlsxwriter je vysoce výkonný, čistý Rust crate pro generování souborů Excel XLSX, aniž by vyžadoval Excel nebo externí závislosti. Umožňuje vývojářům programově vytvářet tabulky s textem, čísly, daty, vzorci, grafy, obrázky, sloučenými buňkami, podmíněným formátováním, ověřováním dat a dalšími prvky. Navržený pro spolehlivost a rychlost, úzce odpovídá nativnímu formátu souborů Excel a podporuje režim konstantní paměti pro velké datové sady. Knihovna je věrnou Rust přepisem populární knihovny Python XlsxWriter, s idiomatickými API a komplexní dokumentací.

rust_xlsxwriter se zaměřuje výhradně na zápis souborů Excel – nečte ani neupravuje existující soubory. Podporuje moderní funkce Excelu, jako jsou dynamické pole, sparkline grafy, zaškrtávací políčka, textová pole, tabulky, automatické filtry, definovaná jména a motivy sešitu. S volitelnými funkcemi, jako je serializace pomocí Serde, podpora dat chrono/jiff a integrace s Polars, se přizpůsobuje různorodým ekosystémům Rustu. Jeho výkon je jen o krok za verzí v C, poskytuje až 3,8‑násobně rychlejší provádění než Pythonova XlsxWriter. Pro úplné podrobnosti viz repozitář rust_xlsxwriter na GitHubu.

Previous Next

Začínáme s rust_xlsxwriter

rust_xlsxwriter je dostupný na crates.io a lze jej nainstalovat pomocí `cargo add rust_xlsxwriter`. Pro rozšířenou funkčnost povolte volitelné funkce jako `constant_memory`, `chrono`, `serde` nebo `polars`. Knihovna vyžaduje Rust 1.56+ a kompiluje se do nativních binárek bez externích runtime závislostí kromě crate `zip` (ve výchozím nastavení). Je plně zdokumentována pomocí uživatelské příručky, tutoriálu a kuchařky. Pro podrobné příklady a zdrojový kód navštivte repozitář rust_xlsxwriter na GitHubu.

Instalujte rust_xlsxwriter pomocí Cargo

cargo add rust_xlsxwriter

Zapisujte formátované buňky s textem, čísly a daty

rust_xlsxwriter poskytuje jednoduché a intuitivní API pro zápis formátovaného obsahu do buněk Excelu. Vývojáři mohou pomocí struktury `Format` použít vlastní formáty pro čísla, data, písma, okraje, zarovnání a barvy. Knihovna podporuje zápis prostého textu, číselných hodnot, dat, vzorců a URL s volitelným formátováním. Také podporuje bohaté řetězce s více formáty pro smíšené formátování v jedné buňce. To ji činí ideální pro generování reportů, dashboardů a exportu dat, kde jsou vizuální přehlednost a struktura zásadní. API zajišťuje vysokou věrnost s nativním formátovacím enginem Excelu.

Jak zapisovat formátovaný text, čísla a data v Rustu?

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

Vytvářejte grafy, sparkline a obrázky

rust_xlsxwriter podporuje generování profesionálních grafů, sparkline a vkládání obrázků přímo do souborů Excel. Vývojáři mohou vytvářet sloupcové, čárové, koláčové, rozptylové a plošné grafy s přizpůsobitelnými osami, legendami a datovými řadami. Sparkline poskytují kompaktní vizualizaci trendů v buňkách. Obrázky (PNG, JPEG, GIF, BMP) lze vložit a umístit s možnostmi škálování a ukotvení. Tyto vizuální prvky zlepšují vyprávění dat a možnosti reportování. Knihovna zajišťuje kompatibilitu s Excel 2007+ a zachovává věrnost vykreslování napříč platformami.

Jak přidat graf a obrázek do Excelu pomocí Rustu?

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

Pokročilé formátování: sloučené buňky, tabulky a podmíněné formátování

rust_xlsxwriter umožňuje pokročilé funkce formátování v Excelu, jako jsou sloučené oblasti, strukturované tabulky, automatické filtry a pravidla podmíněného formátování. Vývojáři mohou sloučit buňky pro záhlaví nebo popisky, použít styly tabulek s pruhovanými řádky/sloupci a definovat filtry pro uživatelskou interaktivitu. Podmíněné formátování podporuje barevné stupnice, datové pruhy, sady ikon a vlastní vzorce pro zvýraznění trendů nebo anomálií. Tyto funkce zlepšují čitelnost dat a interaktivitu v generovaných sešitech. API abstrahuje složité XML struktury do intuitivních metod v Rustu, což zajišťuje udržovatelnost a typovou bezpečnost.

Jak sloučit buňky a přidat tabulky s podmíněným formátováním?

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

Optimalizace výkonu a podpora velkých souborů

rust_xlsxwriter je optimalizován pro rychlost a úsporu paměti, zejména pro velké datové sady. Podporuje režim konstantní paměti (`constant_memory` feature), který zapisuje data postupně na disk a minimalizuje využití haldy. Tento režim je ideální pro generování multi‑megabyte Excel souborů bez chyb OOM. Benchmarky ukazují, že běží ~3.8× rychleji než Pythonova XlsxWriter a jen ~14% pomaleji než nativní knihovna v C. Volitelné funkce jako `zmij` a `zlib` dále urychlují zápis čísel a kompresi. Tyto schopnosti jej činí vhodným pro dávkové reportování, ETL pipelines a generování Excel na serveru.

Jak povolit režim konstantní paměti pro velké soubory?

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")?;
 Čeština