
umya-spreadsheet
Pure Rust-bibliotheek voor XLSX/XLSM-bestanden
XLSX/XLSM-spreadsheets lezen, schrijven, stijlen en manipuleren zonder externe afhankelijkheden.
Wat is umya-spreadsheet?
umya-spreadsheet is een high-performance, pure Rust-bibliotheek voor het lezen en schrijven van Excel-spreadsheetbestanden in XLSX- en XLSM-formaten. Ontworpen voor veiligheid en efficiëntie, vermijdt het onveilige code en externe afhankelijkheden, waardoor het ideaal is voor desktoptoepassingen, server-side verwerking en WebAssembly-omgevingen. De bibliotheek biedt een schone, idiomatische Rust-API voor het benaderen van cellen, rijen, kolommen, stijlen, grafieken en afbeeldingen, waardoor ontwikkelaars robuuste spreadsheettools kunnen bouwen zonder afhankelijk te zijn van Microsoft Office of COM-interoperabiliteit.
Met volledige ondersteuning voor lazy loading, wachtwoordbeveiliging en rijke opmaak overbrugt umya-spreadsheet de kloof tussen prestaties en bruikbaarheid. Het ondersteunt CSV-export, grafiekgeneratie, het insluiten van afbeeldingen en bereikbewerkingen zoals verplaatsen en kopiëren. Het project wordt actief onderhouden, is goed gedocumenteerd en getest, met een focus op correctheid en compatibiliteit met moderne Excel-functies. Ontwikkelaars kunnen het integreren in CLI-tools, web-backends of desktopapplicaties met frameworks zoals Tauri of Axo.
Aan de slag met umya-spreadsheet
Om umya-spreadsheet te beginnen gebruiken, voeg het toe aan je Cargo.toml met `umya-spreadsheet = "3.1.1"`. Voor WebAssembly-ondersteuning, schakel de `js`-functie in. De bibliotheek is licht qua afhankelijkheden en compileert snel. Zodra het geïnstalleerd is, importeer je het via `extern crate umya_spreadsheet;` en begin je met het lezen of schrijven van spreadsheets. Je kunt ook de umya-spreadsheet GitHub verkennen voor voorbeelden, tests en documentatie. Het ondersteunt lazy loading voor grote bestanden en biedt robuuste foutafhandeling.
Installeer umya-spreadsheet via Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
XLSX/XLSM-bestanden lezen en schrijven
umya-spreadsheet biedt intuïtieve API's voor het lezen en schrijven van XLSX- en XLMS-bestanden. Gebruik `reader::xlsx::read()` om een werkmap van de schijf te laden, of `new_file()` om een lege te maken. Schrijven is even eenvoudig: roep `writer::xlsx::write()` aan met de werkmap en het doelpad. De bibliotheek ondersteunt lazy loading via `lazy_read()` voor verbeterde prestaties bij grote bestanden, en staat wachtwoordbeveiligd schrijven of het instellen van wachtwoorden na creatie toe. Alle bewerkingen zijn veilig, zero-copy waar mogelijk, en vermijden externe binaries.
Hoe een XLSX-bestand lezen en schrijven met 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();
Celtoegang en stijlmanipulatie
Toegang krijgen tot en het wijzigen van celwaarden is eenvoudig: gebruik `cell("A1")` of `cell((1,1))` om te lezen, en `cell_mut()` om te schrijven. Stijlen worden beheerd via `style_mut()`, waardoor achtergrondkleur, lettertype, randen en uitlijning kunnen worden aangepast. De bibliotheek biedt een rijke set stijl‑eigenschappen terwijl waar mogelijk immutabiliteitsgaranties behouden blijven. Je kunt ook opgemaakte waarden ophalen, conditionele logica toepassen en stijlen in batch bijwerken over bereiken. Dit maakt het ideaal voor het genereren van rapporten, dashboards of data‑exports met consistente opmaak.
Hoe celwaarde en stijl wijzigen via 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);
Grafieken en afbeeldingsondersteuning
umua-spreadsheet ondersteunt het maken en bewerken van grafieken—waaronder lijn-, staaf- en gebiedsgrafieken—door seriesbereiken en markers te definiëren. Je kunt afbeeldingen direct in bladen insluiten met de `Image` struct, met ondersteuning voor PNG en andere formaten afhankelijk van ingeschakelde functies. Grafieken en afbeeldingen integreren naadloos met celcoördinaten en tekenlagen, waardoor dynamische dashboardgeneratie mogelijk is. Hoewel sommige geavanceerde tekenfuncties nog in ontwikkeling zijn, is de kernfunctionaliteit productie-klaar en uitbreidbaar.
Hoe een lijndiagram toevoegen aan een spreadsheet via 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);
Bereikbewerkingen en wachtwoordbeveiliging
Voer geavanceerde bewerkingen uit, zoals het verplaatsen, kopiëren en aanpassen van bereiken met `move_range()`, waardoor dynamische datareorganisatie mogelijk is. De bibliotheek ondersteunt ook wachtwoordbeveiligde werkmappen: schrijf bestanden met `write_with_password()` of pas wachtwoorden toe op bestaande bestanden via `set_password()`. Deze functies zijn cruciaal voor veilige gegevensverwerking in bedrijfs- of compliance-gevoelige toepassingen. In combinatie met een zero-dependency ontwerp en WASM-compatibiliteit levert umua-spreadsheet zowel flexibiliteit als beveiliging.
Hoe een bereik verplaatsen en een bestand met wachtwoord beveiligen via 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();
