1. Produse
  2.   Foaie de calcul
  3.   Rust
  4.   umya-spreadsheet

umya-spreadsheet

 
 

Bibliotecă Rust pură pentru fișiere XLSX/XLSM

Citește, scrie, stilizează și manipulează foi de calcul XLSX/XLSM fără nicio dependență externă.

Ce este umya-spreadsheet?

umya-spreadsheet este o bibliotecă Rust pură, de înaltă performanță, pentru citirea și scrierea fișierelor de tip foaie de calcul Excel în formatele XLSX și XLSM. Proiectată pentru siguranță și eficiență, evită codul nesigur și dependențele externe, făcând-o ideală pentru aplicații desktop, procesare pe server și medii WebAssembly. Biblioteca oferă o API Rust curată și idiomatică pentru accesarea celulelor, rândurilor, coloanelor, stilurilor, diagramelor și imaginilor, permițând dezvoltatorilor să construiască instrumente robuste de foi de calcul fără a se baza pe Microsoft Office sau interfața COM.

Cu suport complet pentru încărcare leneșă, protecție prin parolă și formatare avansată, umya-spreadsheet face puntea dintre performanță și utilizabilitate. Suportă exportul CSV, generarea de diagrame, încorporarea de imagini și operații pe intervale, cum ar fi mutarea și copierea. Proiectul este întreținut activ, bine documentat și testat, cu accent pe corectitudine și compatibilitate cu funcționalitățile moderne ale Excel. Dezvoltatorii îl pot integra în instrumente CLI, backend-uri web sau aplicații desktop utilizând cadre precum Tauri sau Axo.

Previous Next

Începerea utilizării umya-spreadsheet

Pentru a începe să utilizați umya-spreadsheet, adăugați-l în Cargo.toml cu `umya-spreadsheet = "3.1.1"`. Pentru suport WebAssembly, activați funcția `js`. Biblioteca este ușoară în dependențe și se compilează rapid. Odată instalat, importați-l prin `extern crate umya_spreadsheet;` și începeți să citiți sau să scrieți foi de calcul. De asemenea, puteți explora GitHub-ul umya-spreadsheet pentru exemple, teste și documentație. Suportă încărcarea leneșă pentru fișiere mari și oferă o gestionare robustă a erorilor.

Instalați umya-spreadsheet prin Cargo

[dependencies]
umya-spreadsheet = "3.1.1"

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

Citire și scriere fișiere XLSX/XLSM

umya-spreadsheet oferă API-uri intuitive pentru citirea și scrierea fișierelor XLSX și XLMS. Folosiți `reader::xlsx::read()` pentru a încărca un registru de lucru de pe disc, sau `new_file()` pentru a crea unul gol. Scrierea este la fel de simplă: apelați `writer::xlsx::write()` cu registrul de lucru și calea țintă. Biblioteca suportă încărcarea leneșă prin `lazy_read()` pentru performanță îmbunătățită la fișiere mari și permite scrierea protejată prin parolă sau setarea parolelor după creare. Toate operațiunile sunt sigure, zero-copy acolo unde este posibil și evită binarele externe.

Cum să citiți și să scrieți un fișier XLSX cu 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();

Acces la celule și manipularea stilurilor

Accesarea și modificarea valorilor celulelor este simplă: utilizați `cell("A1")` sau `cell((1,1))` pentru citire și `cell_mut()` pentru scriere. Stilurile sunt gestionate prin `style_mut()`, permițând modificări ale culorii de fundal, fontului, bordurilor și aliniamentului. Biblioteca expune un set bogat de proprietăți de stil menținând garanțiile de imutabilitate acolo unde este posibil. De asemenea, puteți recupera valorile formatate, aplica logică condițională și actualiza în lot stilurile pe intervale. Acest lucru o face ideală pentru generarea de rapoarte, tablouri de bord sau exporturi de date cu formatare consistentă.

Cum să modifici valoarea și stilul unei celule prin 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);

Suport pentru grafice și imagini

umya-spreadsheet suportă crearea și editarea diagramelor—incluzând diagrame de tip linie, bară și zonă—prin definirea intervalelor de serii și a markerelor. Poți încorpora imagini direct în foi utilizând structura `Image`, cu suport pentru PNG și alte formate în funcție de caracteristicile activate. Diagramele și imaginile se integrează perfect cu coordonatele celulelor și cu straturile de desen, permițând generarea dinamică a tablourilor de bord. Deși unele funcționalități avansate de desen sunt încă în dezvoltare, funcționalitatea de bază este gata pentru producție și extensibilă.

Cum să adaugi un grafic liniar într-o foaie de calcul prin 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);

Operații pe interval și protecție prin parolă

Efectuează operații avansate precum mutarea, copierea și redimensionarea intervalelor utilizând `move_range()`, permițând reorganizarea dinamică a datelor. Biblioteca suportă, de asemenea, registre de lucru protejate prin parolă: scrie fișiere cu `write_with_password()` sau aplică parole fișierelor existente prin `set_password()`. Aceste funcționalități sunt esențiale pentru gestionarea securizată a datelor în aplicații enterprise sau sensibile la conformitate. Împreună cu designul fără dependențe și compatibilitatea WASM, umya-spreadsheet oferă atât flexibilitate, cât și securitate.

Cum să muți un interval și să protejezi un fișier cu parolă prin 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();
 Română