1. produkty
  2.   Tabulka
  3.   Rust
  4.   umya-spreadsheet

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.

Previous Next

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();
 Čeština