1. Produk
  2.   Spreadsheet
  3.   Rust
  4.   umya-spreadsheet

umya-spreadsheet

 
 

Pustaka Rust Murni untuk File XLSX/XLSM

Baca, Tulis, Gaya, dan Manipulasi Spreadsheet XLSX/XLSM dengan Nol Ketergantungan Eksternal.

Apa itu umya-spreadsheet?

umya-spreadsheet adalah pustaka Rust murni yang berperforma tinggi untuk membaca dan menulis file spreadsheet Excel dalam format XLSX dan XLSM. Dirancang untuk keamanan dan efisiensi, pustaka ini menghindari kode tidak aman dan ketergantungan eksternal, menjadikannya ideal untuk aplikasi desktop, pemrosesan sisi server, dan lingkungan WebAssembly. Pustaka ini menyediakan API Rust yang bersih dan idiomatik untuk mengakses sel, baris, kolom, gaya, diagram, dan gambar, memungkinkan pengembang membangun alat spreadsheet yang kuat tanpa bergantung pada Microsoft Office atau interop COM.

Dengan dukungan penuh untuk pemuatan malas, perlindungan kata sandi, dan pemformatan kaya, umya-spreadsheet menjembatani kesenjangan antara kinerja dan kegunaan. Ia mendukung ekspor CSV, pembuatan diagram, penyematan gambar, dan operasi rentang seperti memindahkan dan menyalin. Proyek ini dikelola secara aktif, terdokumentasi dengan baik, dan diuji, dengan fokus pada keakuratan serta kompatibilitas dengan fitur Excel modern. Pengembang dapat mengintegrasikannya ke dalam alat CLI, backend web, atau aplikasi desktop menggunakan kerangka kerja seperti Tauri atau Axo.

Previous Next

Memulai dengan umya-spreadsheet

Untuk mulai menggunakan umya-spreadsheet, tambahkan ke Cargo.toml Anda dengan `umya-spreadsheet = "3.1.1"`. Untuk dukungan WebAssembly, aktifkan fitur `js`. Pustaka ini ringan dalam dependensi dan dikompilasi dengan cepat. Setelah terpasang, impor dengan `extern crate umya_spreadsheet;` dan mulai membaca atau menulis spreadsheet. Anda juga dapat menjelajahi GitHub umya-spreadsheet untuk contoh, tes, dan dokumentasi. Ia mendukung pemuatan malas untuk file besar dan menawarkan penanganan error yang kuat.

Instal umya-spreadsheet via Cargo

[dependencies]
umya-spreadsheet = "3.1.1"

# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }

Membaca & Menulis File XLSX/XLSM

umya-spreadsheet menyediakan API yang intuitif untuk membaca dan menulis file XLSX dan XLMS. Gunakan `reader::xlsx::read()` untuk memuat workbook dari disk, atau `new_file()` untuk membuat yang kosong. Penulisan juga sama sederhana: panggil `writer::xlsx::write()` dengan workbook dan jalur target. Perpustakaan mendukung pemuatan malas melalui `lazy_read()` untuk meningkatkan kinerja pada file besar, dan memungkinkan penulisan yang dilindungi kata sandi atau menetapkan kata sandi setelah pembuatan. Semua operasi aman, zero-copy bila memungkinkan, dan menghindari binari eksternal.

Cara Membaca dan Menulis File XLSX via Rust?

use std::path::Path;

// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();

// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();

Akses Sel & Manipulasi Gaya

Mengakses dan memodifikasi nilai sel sangat sederhana: gunakan `cell("A1")` atau `cell((1,1))` untuk membaca, dan `cell_mut()` untuk menulis. Gaya dikelola melalui `style_mut()`, memungkinkan perubahan warna latar belakang, font, batas, dan perataan. Perpustakaan menyediakan serangkaian properti gaya yang kaya sambil mempertahankan jaminan imutabilitas bila memungkinkan. Anda juga dapat mengambil nilai yang diformat, menerapkan logika kondisional, dan memperbarui gaya secara batch di seluruh rentang. Hal ini menjadikannya ideal untuk menghasilkan laporan, dasbor, atau ekspor data dengan format yang konsisten.

Cara Memodifikasi Nilai Sel dan Gaya melalui Rust?

let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .cell_mut("A1")
    .set_value("Hello, Rust!");

let mut style = book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);

Dukungan Grafik & Gambar

umya-spreadsheet mendukung pembuatan dan penyuntingan diagram—termasuk diagram garis, batang, dan area—dengan mendefinisikan rentang seri dan penanda. Anda dapat menyematkan gambar langsung ke dalam lembar menggunakan struktur `Image`, dengan dukungan untuk PNG dan format lain tergantung pada fitur yang diaktifkan. Diagram dan gambar terintegrasi secara mulus dengan koordinat sel dan lapisan gambar, memungkinkan pembuatan dasbor dinamis. Meskipun beberapa fitur menggambar lanjutan masih dalam pengembangan, fungsi inti sudah siap produksi dan dapat diperluas.

Cara Menambahkan Diagram Garis ke Spreadsheet melalui Rust?

let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
    umya_spreadsheet::structs::ChartType::LineChart,
    from_marker,
    to_marker,
    series,
);
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .add_chart(chart);

Operasi Rentang & Perlindungan Kata Sandi

Lakukan operasi lanjutan seperti memindahkan, menyalin, dan mengubah ukuran rentang menggunakan `move_range()`, memungkinkan reorganisasi data dinamis. Perpustakaan ini juga mendukung buku kerja yang dilindungi kata sandi: menulis file dengan `write_with_password()` atau menerapkan kata sandi pada file yang ada melalui `set_password()`. Fitur-fitur ini penting untuk penanganan data yang aman dalam aplikasi perusahaan atau yang sensitif terhadap kepatuhan. Dikombinasikan dengan desain tanpa ketergantungan dan kompatibilitas WASM, umya-spreadsheet memberikan fleksibilitas dan keamanan.

Cara Memindahkan Rentang dan Melindungi File dengan Kata Sandi melalui Rust?

// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .move_range(range, &10, &2);

// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
    &book,
    Path::new("./protected.xlsx"),
    "mypassword",
).unwrap();
 Indonesia