
umya-spreadsheet
Tiszta Rust könyvtár XLSX/XLSM fájlokhoz
XLSX/XLSM táblázatok olvasása, írása, stílusozása és manipulálása nulla külső függőséggel.
Mi az umya-spreadsheet?
az umya-spreadsheet egy nagy teljesítményű, tiszta Rust könyvtár az Excel táblázatfájlok (XLSX és XLSM formátum) olvasásához és írásához. Biztonságra és hatékonyságra tervezve kerülőleg a nem biztonságos kódot és külső függőségeket, így ideális asztali alkalmazásokhoz, szerveroldali feldolgozáshoz és WebAssembly környezetekhez. A könyvtár tiszta, idiomatikus Rust API-t biztosít a cellák, sorok, oszlopok, stílusok, diagramok és képek eléréséhez, lehetővé téve a fejlesztők számára, hogy robusztus táblázatkezelő eszközöket építsenek anélkül, hogy a Microsoft Office vagy a COM interopra támaszkodnának.
Teljes körű támogatással a lusta betöltéshez, jelszóvédelemhez és gazdag formázáshoz, az umya-spreadsheet áthidalja a teljesítmény és a használhatóság közötti szakadékot. Támogatja a CSV exportot, diagramgenerálást, képbeágyazást és a tartományműveleteket, mint a mozgatás és másolás. A projekt aktívan karbantartott, jól dokumentált és tesztelt, a helyességre és a modern Excel funkciókkal való kompatibilitásra összpontosítva. A fejlesztők integrálhatják CLI eszközökbe, web backendekbe vagy asztali alkalmazásokba olyan keretrendszerekkel, mint a Tauri vagy az Axo.
Az umya-spreadsheet használatának megkezdése
Az umya-spreadsheet használatának megkezdéséhez add hozzá a Cargo.toml-hoz a következővel: `umya-spreadsheet = "3.1.1"`. A WebAssembly támogatáshoz engedélyezd a `js` funkciót. A könyvtár könnyű függőségekkel rendelkezik, és gyorsan fordul. A telepítés után importáld a `extern crate umya_spreadsheet;` segítségével, és kezdj el táblázatokat olvasni vagy írni. Továbbá felfedezheted a umya-spreadsheet GitHub oldalt példák, tesztek és dokumentáció miatt. Támogatja a nagy fájlok lazy betöltését, és robusztus hibakezelést kínál.
Umya-spreadsheet telepítése Cargo-n keresztül
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
XLSX/XLSM fájlok olvasása és írása
az umya-spreadsheet intuitív API-kat biztosít az XLSX és XLMS fájlok olvasásához és írásához. Használja a `reader::xlsx::read()`-t egy munkafüzet betöltéséhez a lemezről, vagy a `new_file()`-t egy üres létrehozásához. Az írás ugyanolyan egyszerű: hívja a `writer::xlsx::write()`-t a munkafüzettel és a célúttal. A könyvtár támogatja a lusta betöltést a `lazy_read()` segítségével a nagy fájlok teljesítményének javítása érdekében, és lehetővé teszi a jelszóval védett írást vagy a jelszavak beállítását a létrehozás után. Minden művelet biztonságos, ahol lehetséges, nulla másolással, és elkerüli a külső binárisok használatát.
Hogyan olvassunk és írjunk XLSX fájlt Rust segítségével?
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();
Cellák elérése és stílus manipulációja
A cellák értékeinek elérése és módosítása egyszerű: használja a `cell("A1")` vagy `cell((1,1))` függvényeket az olvasáshoz, és a `cell_mut()`-t az íráshoz. A stílusok a `style_mut()` segítségével kezelhetők, lehetővé téve a háttérszín, betűtípus, szegélyek és igazítás módosítását. A könyvtár gazdag stílus tulajdonságkészletet kínál, miközben ahol lehetséges, az immutabilitási garanciákat fenntartja. Lekérdezheti a formázott értékeket, alkalmazhat feltételes logikát, és kötegelt módon frissítheti a stílusokat tartományokban. Ez ideálissá teszi jelentések, műszerfalak vagy adatexportok generálására, egységes formázással.
Hogyan módosítsuk a cella értékét és stílusát Rust segítségével?
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);
Diagramok és képek támogatása
az umya-spreadsheet támogatja diagramok létrehozását és szerkesztését—beleértve a vonal-, oszlop- és területdiagramokat—a sorozat tartományok és jelölők meghatározásával. Képeket ágyazhatsz be közvetlenül a munkalapokba az `Image` struktúra használatával, PNG és egyéb formátumok támogatásával, a bekapcsolt funkcióktól függően. A diagramok és képek zökkenőmentesen integrálódnak a cellakoordinátákkal és a rajzrétegekkel, lehetővé téve a dinamikus műszerfal generálását. Bár néhány fejlett rajzfunkció még fejlődés alatt áll, a fő funkciók termelésre készek és bővíthetőek.
Hogyan adjunk hozzá vonaldiagramot egy táblázathoz Rust segítségével?
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);
Tartomány műveletek és jelszóvédelem
Végrehajthatsz fejlett műveleteket, például tartományok áthelyezését, másolását és átméretezését a `move_range()` használatával, lehetővé téve a dinamikus adatújraszervezést. A könyvtár támogatja a jelszóval védett munkafüzeteket is: fájlok írása `write_with_password()`-val, vagy jelszavak alkalmazása meglévő fájlokra a `set_password()` segítségével. Ezek a funkciók kritikusak a vállalati vagy megfelelőségi érzékeny alkalmazásokban a biztonságos adatkezeléshez. A null függőségi tervezés és a WASM kompatibilitás kombinációjával az umya-spreadsheet rugalmas és biztonságos megoldást nyújt.
Hogyan mozgassunk egy tartományt és védjünk egy fájlt jelszóval Rust segítségével?
// 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();
