
umya-spreadsheet
Čistá knihovna v Rustu pro soubory XLSX/XLSM
Čtěte, zapisujte, stylujte a manipulujte s tabulkami XLSX/XLSM bez jakýchkoli externích závislostí.
Co je umya-spreadsheet?
umya-spreadsheet je vysoce výkonná, čistá knihovna v Rustu pro čtení a zápis souborů Excel tabulek ve formátech XLSX a XLSM. Navržena pro bezpečnost a efektivitu, vyhýbá se nebezpečnému kódu a externím závislostem, což ji činí ideální pro desktopové aplikace, serverové zpracování a prostředí WebAssembly. Knihovna poskytuje čisté, idiomatické Rust API pro přístup k buňkám, řádkům, sloupcům, stylům, grafům a obrázkům, což vývojářům umožňuje vytvářet robustní nástroje pro tabulky bez nutnosti spoléhat se na Microsoft Office nebo COM interop.
S plnou podporou lazy loadingu, ochrany heslem a bohatého formátování, umya-spreadsheet překonává propast mezi výkonem a použitelností. Podporuje export do CSV, generování grafů, vkládání obrázků a operace s oblastmi, jako je přesouvání a kopírování. Projekt je aktivně udržován, dobře zdokumentován a testován, s důrazem na správnost a kompatibilitu s moderními funkcemi Excelu. Vývojáři jej mohou integrovat do CLI nástrojů, webových backendů nebo desktopových aplikací pomocí frameworků jako Tauri nebo Axo.
Začínáme s umya-spreadsheet
Chcete-li začít používat umya-spreadsheet, přidejte jej do svého Cargo.toml pomocí `umya-spreadsheet = "3.1.1"`. Pro podporu WebAssembly povolte funkci `js`. Knihovna má málo závislostí a rychle se kompiluje. Po instalaci ji importujte pomocí `extern crate umya_spreadsheet;` a začněte číst nebo zapisovat tabulky. Můžete také prozkoumat umya-spreadsheet GitHub pro příklady, testy a dokumentaci. Podporuje lazy loading pro velké soubory a nabízí robustní zpracování chyb.
Instalace umya-spreadsheet pomocí Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
Čtení a zápis souborů XLSX/XLSM
umya-spreadsheet poskytuje intuitivní API pro čtení a zápis souborů XLSX a XLMS. Použijte `reader::xlsx::read()` k načtení sešitu z disku nebo `new_file()` k vytvoření prázdného. Zápis je stejně jednoduchý: zavolejte `writer::xlsx::write()` s sešitem a cílovou cestou. Knihovna podporuje líné načítání pomocí `lazy_read()` pro zlepšení výkonu u velkých souborů a umožňuje zápis chráněný heslem nebo nastavení hesla po vytvoření. Všechny operace jsou bezpečné, zero-copy kde je to možné, a vyhýbají se externím binárkám.
Jak číst a zapisovat soubor XLSX pomocí Rustu?
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();
Přístup k buňkám a úprava stylů
Přístup a úprava hodnot buněk je jednoduchá: použijte `cell("A1")` nebo `cell((1,1))` pro čtení a `cell_mut()` pro zápis. Styly jsou spravovány pomocí `style_mut()`, což umožňuje změny barvy pozadí, písma, okrajů a zarovnání. Knihovna poskytuje bohatou sadu vlastností stylů a zároveň zachovává záruky neměnnosti, kde je to možné. Můžete také získat formátované hodnoty, aplikovat podmíněnou logiku a hromadně aktualizovat styly v rozsazích. To ji činí ideální pro generování zpráv, dashboardů nebo exportu dat s konzistentním formátováním.
Jak upravit hodnotu buňky a styl pomocí Rustu?
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);
Podpora grafů a obrázků
umya-spreadsheet podporuje vytváření a úpravu grafů—včetně čárových, sloupcových a plošných grafů—definováním rozsahů sérií a značek. Můžete vkládat obrázky přímo do listů pomocí struktury `Image`, s podporou PNG a dalších formátů v závislosti na povolených funkcích. Grafy a obrázky se hladce integrují s buňkovými souřadnicemi a kreslicími vrstvami, což umožňuje dynamické generování dashboardů. Zatímco některé pokročilé kreslicí funkce se stále vyvíjejí, základní funkčnost je připravena pro produkční nasazení a rozšiřitelná.
Jak přidat čárový graf do tabulky pomocí Rustu?
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);
Operace s oblastmi a ochrana heslem
Provádějte pokročilé operace, jako je přesouvání, kopírování a změna velikosti rozsahů pomocí `move_range()`, což umožňuje dynamickou reorganizaci dat. Knihovna také podporuje sešity chráněné heslem: zapisujte soubory pomocí `write_with_password()` nebo aplikujte hesla na existující soubory pomocí `set_password()`. Tyto funkce jsou klíčové pro bezpečnou manipulaci s daty v podnicích nebo aplikacích citlivých na soulad. V kombinaci s návrhem bez závislostí a kompatibilitou s WASM poskytuje umya-spreadsheet jak flexibilitu, tak bezpečnost.
Jak přesunout oblast a chránit soubor heslem pomocí Rustu?
// 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();
