1. Produse
  2.   Foaie de calcul
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

Bibliotecă Rust open source pentru fișiere Excel XLSX

Generează fișiere Excel 2007+ XLSX cu formatare completă, grafice, formule și imagini prin API Rust.

Ce este rust_xlsxwriter?

rust_xlsxwriter este o crate Rust de înaltă performanță, pură, pentru generarea fișierelor Excel XLSX fără a necesita Excel sau dependențe externe. Permite dezvoltatorilor să creeze programatic foi de calcul cu text, numere, date, formule, grafice, imagini, celule îmbinate, formatare condițională, validare a datelor și altele. Proiectat pentru fiabilitate și viteză, se potrivește îndeaproape cu formatul nativ al Excel și suportă modul de memorie constantă pentru seturi mari de date. Biblioteca este o rescriere fidelă în Rust a popularei biblioteci Python XlsxWriter, cu API-uri idiomatice și documentație cuprinzătoare.

rust_xlsxwriter se concentrează exclusiv pe scrierea fișierelor Excel—fără citire sau modificare a fișierelor existente. Suportă funcționalități moderne Excel, cum ar fi matrici dinamice, sparklines, casete de bifare, casete de text, tabele, autofiltre, nume definite și teme de registru de lucru. Cu funcționalități opționale precum serializarea Serde, suport pentru date chrono/jiff și integrarea cu Polars, se adaptează la diverse ecosisteme Rust. Performanța sa este a doua doar față de versiunea C, oferind o execuție de 3.8× mai rapidă decât XlsxWriter din Python. Pentru detalii complete, vedeți repozitoriul GitHub rust_xlsxwriter.

Previous Next

Începerea utilizării rust_xlsxwriter

rust_xlsxwriter este disponibil pe crates.io și poate fi instalat prin `cargo add rust_xlsxwriter`. Pentru funcționalități suplimentare, activați caracteristicile opționale precum `constant_memory`, `chrono`, `serde` sau `polars`. Biblioteca necesită Rust 1.56+ și se compilează în binare native fără dependențe de runtime externe în afara pachetului `zip` (implicit). Este complet documentată cu un ghid de utilizare, tutorial și carte de bucate. Pentru exemple detaliate și cod sursă, vizitați repozitoriul GitHub rust_xlsxwriter.

Instalează rust_xlsxwriter prin Cargo

cargo add rust_xlsxwriter

Scrie celule formatate cu text, numere și date

rust_xlsxwriter oferă un API simplu și intuitiv pentru a scrie conținut formatat în celulele Excel. Dezvoltatorii pot aplica formate personalizate pentru numere, date, fonturi, borduri, aliniere și culori utilizând structura `Format`. Biblioteca suportă scrierea de text simplu, valori numerice, date, formule și URL-uri cu formatare opțională. De asemenea, suportă șiruri multi-format bogate pentru formatare mixtă într-o singură celulă. Acest lucru îl face ideal pentru generarea de rapoarte, tablouri de bord și exporturi de date unde claritatea vizuală și structura sunt esențiale. API-ul asigură o fidelitate ridicată cu motorul de formatare nativ al Excel.

Cum să scrii text, numere și date formatate prin 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")?;

Creează grafice, sparkline-uri și imagini

rust_xlsxwriter suportă generarea de grafice profesionale, sparkline-uri și încorporarea imaginilor direct în fișiere Excel. Dezvoltatorii pot crea grafice de tip bară, linie, plăcintă, dispersie și zonă cu axe, legende și serii de date personalizabile. Sparkline-urile oferă vizualizare compactă a tendințelor în interiorul celulelor. Imaginile (PNG, JPEG, GIF, BMP) pot fi inserate și poziționate cu opțiuni de scalare și ancorare. Aceste elemente vizuale îmbunătățesc povestirea datelor și capacitățile de raportare. Biblioteca asigură compatibilitatea cu Excel 2007+ și păstrează fidelitatea redării pe diferite platforme.

Cum să adaugi un grafic și o imagine în Excel prin 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")?;

Formatare avansată: celule îmbinate, tabele și formatare condițională

rust_xlsxwriter permite funcții avansate de formatare în Excel, cum ar fi intervale fuzionate, tabele structurate, autofiltre și reguli de formatare condiționată. Dezvoltatorii pot fuziona celule pentru antete sau etichete, aplica stiluri de tabel cu rânduri/coloane alternante și defini filtre pentru interactivitatea utilizatorului. Formatarea condiționată suportă scale de culori, bare de date, seturi de pictograme și formule personalizate pentru a evidenția tendințe sau anomalii. Aceste funcții îmbunătățesc lizibilitatea datelor și interactivitatea în registrele de lucru generate. API-ul abstractizează structurile XML complexe în metode Rust intuitive, asigurând mentenabilitatea și siguranța tipurilor.

Cum să îmbini celulele și să adaugi tabele cu formatare condițională?

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

Optimizarea performanței și suport pentru fișiere mari

rust_xlsxwriter este optimizat pentru viteză și eficiență a memoriei, în special pentru seturi mari de date. Suportă modul de memorie constantă (`constant_memory` funcționalitate), care scrie datele incremental pe disc, minimizând utilizarea heap-ului. Acest mod este ideal pentru generarea de fișiere Excel de mai mulți megabytes fără erori OOM. Benchmark-urile arată că rulează ~3.8× mai repede decât XlsxWriter din Python și doar ~14% mai lent decât biblioteca nativă C. Funcționalități opționale precum `zmij` și `zlib` accelerează și mai mult scrierea numerică și comprimarea. Aceste capabilități îl fac potrivit pentru rapoarte în lot, conducte ETL și generarea de Excel pe server.

Cum să activezi modul de memorie constantă pentru fișiere mari?

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")?;
 Română