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

rust_xlsxwriter

 
 

Perpustakaan Rust Sumber Terbuka untuk File Excel XLSX

Hasilkan File XLSX Excel 2007+ dengan Format Lengkap, Diagram, Rumus & Gambar melalui API Rust.

Apa itu rust_xlsxwriter?

rust_xlsxwriter adalah crate Rust murni yang berperforma tinggi untuk menghasilkan file Excel XLSX tanpa memerlukan Excel atau dependensi eksternal. Ini memungkinkan pengembang membuat spreadsheet secara programatik dengan teks, angka, tanggal, formula, diagram, gambar, sel yang digabungkan, pemformatan bersyarat, validasi data, dan lainnya. Dirancang untuk keandalan dan kecepatan, ia sangat cocok dengan format file asli Excel dan mendukung mode memori konstan untuk dataset besar. Perpustakaan ini merupakan penulisan ulang Rust yang setia dari pustaka Python XlsxWriter yang populer, dengan API idiomatik dan dokumentasi yang komprehensif.

rust_xlsxwriter berfokus secara eksklusif pada penulisan file Excel—tidak membaca atau memodifikasi file yang ada. Ini mendukung fitur Excel modern seperti array dinamis, sparklines, kotak centang, kotak teks, tabel, autofilter, nama yang didefinisikan, dan tema buku kerja. Dengan fitur opsional seperti serialisasi Serde, dukungan tanggal chrono/jiff, dan integrasi Polars, ia beradaptasi dengan beragam ekosistem Rust. Kinerjanya hanya di belakang versi C, memberikan eksekusi 3,8× lebih cepat dibandingkan XlsxWriter Python. Untuk detail lengkap, lihat repositori rust_xlsxwriter di GitHub.

Previous Next

Memulai rust_xlsxwriter

rust_xlsxwriter tersedia di crates.io dan dapat diinstal melalui `cargo add rust_xlsxwriter`. Untuk fungsionalitas yang lebih baik, aktifkan fitur opsional seperti `constant_memory`, `chrono`, `serde`, atau `polars`. Pustaka ini memerlukan Rust 1.56+ dan dikompilasi menjadi binari native tanpa ketergantungan runtime eksternal selain crate `zip` (secara default). Ia didokumentasikan secara lengkap dengan panduan pengguna, tutorial, dan buku masak. Untuk contoh terperinci dan kode sumber, kunjungi repositori GitHub rust_xlsxwriter.

Instal rust_xlsxwriter via Cargo

cargo add rust_xlsxwriter

Menulis Sel Terformat dengan Teks, Angka & Tanggal

rust_xlsxwriter menyediakan API yang sederhana dan intuitif untuk menulis konten terformat ke sel Excel. Pengembang dapat menerapkan format khusus untuk angka, tanggal, font, batas, perataan, dan warna menggunakan struct `Format`. Pustaka ini mendukung penulisan teks biasa, nilai numerik, tanggal, formula, dan URL dengan format opsional. Ia juga mendukung string multi-format kaya untuk format campuran dalam satu sel. Hal ini menjadikannya ideal untuk menghasilkan laporan, dasbor, dan ekspor data di mana kejelasan visual dan struktur sangat penting. API ini memastikan kesetiaan tinggi dengan mesin format native Excel.

Cara Menulis Teks, Angka & Tanggal Terformat 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")?;

Membuat Grafik, Sparkline & Gambar

rust_xlsxwriter mendukung pembuatan grafik profesional, sparkline, dan penyisipan gambar secara langsung ke dalam file Excel. Pengembang dapat membuat grafik batang, garis, pai, sebar, dan area dengan sumbu, legenda, dan seri data yang dapat disesuaikan. Sparkline menyediakan visualisasi tren yang ringkas di dalam sel. Gambar (PNG, JPEG, GIF, BMP) dapat disisipkan dan diposisikan dengan opsi penskalaan dan penempatan. Elemen visual ini meningkatkan penceritaan data dan kemampuan pelaporan. Perpustakaan ini memastikan kompatibilitas dengan Excel 2007+ dan mempertahankan kesetiaan rendering di seluruh platform.

Cara Menambahkan Diagram & Gambar ke Excel melalui 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")?;

Pemformatan Lanjutan: Sel Gabungan, Tabel & Pemformatan Bersyarat

rust_xlsxwriter memungkinkan fitur pemformatan Excel lanjutan seperti range yang digabung, tabel terstruktur, autofilter, dan aturan pemformatan bersyarat. Pengembang dapat menggabungkan sel untuk header atau label, menerapkan gaya tabel dengan baris/kolom berpita, dan mendefinisikan filter untuk interaktivitas pengguna. Pemformatan bersyarat mendukung skala warna, batang data, set ikon, dan rumus khusus untuk menyoroti tren atau anomali. Fitur-fitur ini meningkatkan keterbacaan data dan interaktivitas dalam workbook yang dihasilkan. API mengabstraksi struktur XML yang kompleks menjadi metode Rust yang intuitif, memastikan pemeliharaan dan keamanan tipe.

Cara Menggabungkan Sel & Menambahkan Tabel dengan Pemformatan Bersyarat?

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

Optimisasi Kinerja & Dukungan File Besar

rust_xlsxwriter dioptimalkan untuk kecepatan dan efisiensi memori, terutama untuk dataset besar. Ia mendukung mode memori konstan (`constant_memory` feature), yang menulis data secara bertahap ke disk, meminimalkan penggunaan heap. Mode ini ideal untuk menghasilkan file Excel berukuran multi-megabyte tanpa kesalahan OOM. Benchmark menunjukkan ia berjalan ~3.8× lebih cepat daripada XlsxWriter Python dan hanya ~14% lebih lambat dibandingkan perpustakaan C native. Fitur opsional seperti `zmij` dan `zlib` lebih mempercepat penulisan numerik dan kompresi. Kemampuan ini membuatnya cocok untuk pelaporan batch, pipeline ETL, dan pembuatan Excel sisi server.

Cara Mengaktifkan Mode Memori Konstan untuk File Besar?

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