1. Produkty
  2.   Arkusz
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

Open source biblioteka Rust dla plików Excel XLSX

Generuj pliki Excel 2007+ XLSX z pełnym formatowaniem, wykresami, formułami i obrazami za pomocą API Rust.

Czym jest rust_xlsxwriter?

rust_xlsxwriter to wysokowydajny, czysty crate w języku Rust do generowania plików Excel XLSX bez konieczności posiadania Excela ani zewnętrznych zależności. Umożliwia programistom programowe tworzenie arkuszy kalkulacyjnych z tekstem, liczbami, datami, formułami, wykresami, obrazami, scalonymi komórkami, formatowaniem warunkowym, walidacją danych i nie tylko. Zaprojektowany z myślą o niezawodności i szybkości, ściśle odzwierciedla natywny format plików Excela i obsługuje tryb stałej pamięci dla dużych zestawów danych. Biblioteka jest wiernym przepisaniem w Rust popularnej biblioteki Python XlsxWriter, z idiomatycznym API i obszerną dokumentacją.

rust_xlsxwriter koncentruje się wyłącznie na zapisywaniu plików Excel — bez odczytu ani modyfikacji istniejących plików. Obsługuje nowoczesne funkcje Excela, takie jak dynamiczne tablice, sparklines, pola wyboru, pola tekstowe, tabele, autofiltrowanie, nazwy zdefiniowane i motywy skoroszytu. Dzięki opcjonalnym funkcjom, takim jak serializacja Serde, obsługa dat chrono/jiff oraz integracja z Polars, dostosowuje się do różnorodnych ekosystemów Rust. Jego wydajność jest jedynie drugą po wersji C, zapewniając 3,8‑krotnie szybsze wykonanie niż XlsxWriter w Pythonie. Aby uzyskać pełne szczegóły, zobacz repozytorium rust_xlsxwriter na GitHubie.

Previous Next

Rozpoczęcie pracy z rust_xlsxwriter

rust_xlsxwriter jest dostępny w crates.io i można go zainstalować za pomocą `cargo add rust_xlsxwriter`. Aby uzyskać rozszerzoną funkcjonalność, włącz opcjonalne funkcje takie jak `constant_memory`, `chrono`, `serde` lub `polars`. Biblioteka wymaga Rust 1.56+ i kompiluje się do natywnych binarek bez zewnętrznych zależności uruchomieniowych poza crate'em `zip` (domyślnie). Jest w pełni udokumentowana w przewodniku użytkownika, samouczku i książce kucharskiej. Aby zobaczyć szczegółowe przykłady i kod źródłowy, odwiedź repozytorium rust_xlsxwriter na GitHubie.

Zainstaluj rust_xlsxwriter za pomocą Cargo

cargo add rust_xlsxwriter

Zapisywanie sformatowanych komórek z tekstem, liczbami i datami

rust_xlsxwriter udostępnia prosty i intuicyjny interfejs API do zapisywania sformatowanej zawartości w komórkach Excela. Programiści mogą stosować własne formaty dla liczb, dat, czcionek, obramowań, wyrównania i kolorów przy użyciu struktury `Format`. Biblioteka obsługuje zapisywanie zwykłego tekstu, wartości liczbowych, dat, formuł i adresów URL z opcjonalnym formatowaniem. Obsługuje także bogate ciągi wieloformatowe umożliwiające mieszane formatowanie w jednej komórce. Dzięki temu jest idealna do generowania raportów, pulpitów nawigacyjnych i eksportów danych, gdzie kluczowa jest przejrzystość wizualna i struktura. API zapewnia wysoką wierność natywnemu silnikowi formatowania Excela.

Jak zapisywać sformatowany tekst, liczby i daty w 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")?;

Tworzenie wykresów, miniwykresów i obrazów

rust_xlsxwriter obsługuje generowanie profesjonalnych wykresów, sparkline'ów i osadzanie obrazów bezpośrednio w plikach Excel. Programiści mogą tworzyć wykresy słupkowe, liniowe, kołowe, punktowe i obszarowe z konfigurowalnymi osiami, legendami i seriami danych. Sparkline'y zapewniają zwartą wizualizację trendów w komórkach. Obrazy (PNG, JPEG, GIF, BMP) mogą być wstawiane i pozycjonowane z opcjami skalowania i kotwiczenia. Te elementy wizualne zwiększają opowiadanie historii danych i możliwości raportowania. Biblioteka zapewnia kompatybilność z Excel 2007+ i zachowuje wierność renderowania na różnych platformach.

Jak dodać wykres i obraz do Excela przy użyciu 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")?;

Zaawansowane formatowanie: scalone komórki, tabele i formatowanie warunkowe

rust_xlsxwriter umożliwia zaawansowane funkcje formatowania w Excelu, takie jak scalone zakresy, strukturalne tabele, autofiltrowanie i reguły formatowania warunkowego. Programiści mogą scalać komórki dla nagłówków lub etykiet, stosować style tabel z paskowanymi wierszami/kolumnami oraz definiować filtry dla interaktywności użytkownika. Formatowanie warunkowe obsługuje skale kolorów, paski danych, zestawy ikon oraz własne formuły, aby podświetlać trendy lub anomalie. Te funkcje poprawiają czytelność danych i interaktywność w generowanych skoroszytach. API abstrahuje złożone struktury XML do intuicyjnych metod w Rust, zapewniając łatwość utrzymania i bezpieczeństwo typów.

Jak scalić komórki i dodać tabele z formatowaniem warunkowym?

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

Optymalizacja wydajności i obsługa dużych plików

rust_xlsxwriter jest zoptymalizowany pod kątem szybkości i wydajności pamięci, szczególnie dla dużych zestawów danych. Obsługuje tryb stałej pamięci (`constant_memory` feature), który zapisuje dane stopniowo na dysk, minimalizując użycie sterty. Tryb ten jest idealny do generowania wielomegabajtowych plików Excel bez błędów OOM. Testy wydajności wykazują, że działa ~3.8× szybciej niż XlsxWriter w Pythonie i tylko ~14% wolniej niż natywna biblioteka C. Opcjonalne funkcje, takie jak `zmij` i `zlib`, dodatkowo przyspieszają zapisy liczbowe i kompresję. Te możliwości czynią go odpowiednim do raportowania wsadowego, potoków ETL i generowania Excel po stronie serwera.

Jak włączyć tryb stałej pamięci dla dużych plików?

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