
umya-spreadsheet
Чиста бібліотека Rust для файлів XLSX/XLSM
Читання, запис, стилізація та маніпуляція електронними таблицями XLSX/XLSM без зовнішніх залежностей.
Що таке umya-spreadsheet?
umya-spreadsheet — це високопродуктивна, чиста бібліотека Rust для читання та запису файлів електронних таблиць Excel у форматах XLSX та XLSM. Розроблена з урахуванням безпеки та ефективності, вона уникає небезпечного коду та зовнішніх залежностей, що робить її ідеальною для настільних застосунків, серверної обробки та середовищ WebAssembly. Бібліотека надає чистий, ідіоматичний API Rust для доступу до клітинок, рядків, стовпців, стилів, діаграм та зображень, дозволяючи розробникам створювати надійні інструменти роботи з електронними таблицями без необхідності використання Microsoft Office чи COM‑interop.
З повною підтримкою відкладеного завантаження, захисту паролем та багатого форматування, umya-spreadsheet усуває розрив між продуктивністю та зручністю використання. Вона підтримує експорт у CSV, створення діаграм, вбудовування зображень та операції з діапазонами, такі як переміщення та копіювання. Проект активно підтримується, добре документований і протестований, з акцентом на правильність та сумісність із сучасними функціями Excel. Розробники можуть інтегрувати її у CLI‑інструменти, веб‑бекенди або настільні додатки, використовуючи фреймворки типу Tauri або Axo.
Початок роботи з umya-spreadsheet
Щоб почати використовувати umya-spreadsheet, додайте його до вашого Cargo.toml за допомогою `umya-spreadsheet = "3.1.1"`. Для підтримки WebAssembly увімкніть функцію `js`. Бібліотека має мінімальні залежності та швидко компілюється. Після встановлення імпортуйте її через `extern crate umya_spreadsheet;` і починайте читати або записувати електронні таблиці. Ви також можете дослідити umya-spreadsheet GitHub для прикладів, тестів та документації. Вона підтримує ліниве завантаження великих файлів і забезпечує надійне оброблення помилок.
Встановіть umya-spreadsheet через Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
Читання та запис файлів XLSX/XLSM
umya-spreadsheet надає інтуїтивно зрозумілі API для читання та запису файлів XLSX та XLMS. Використовуйте `reader::xlsx::read()` щоб завантажити робочу книгу з диска, або `new_file()` щоб створити порожню. Запис також простий: викличте `writer::xlsx::write()` з робочою книгою та шляхом призначення. Бібліотека підтримує ліниве завантаження через `lazy_read()` для підвищення продуктивності при великих файлах і дозволяє запис з захистом паролем або встановлення паролів після створення. Усі операції безпечні, за можливості без копіювання і уникають зовнішніх бінарних файлів.
Як читати та записувати файл XLSX за допомогою 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();
Доступ до клітинок та маніпуляція стилями
Доступ до значень клітинок та їх зміна прості: використовуйте `cell("A1")` або `cell((1,1))` для читання і `cell_mut()` для запису. Стилі керуються через `style_mut()`, що дозволяє змінювати колір фону, шрифт, межі та вирівнювання. Бібліотека надає широкий набір властивостей стилю, зберігаючи гарантії незмінності, де це можливо. Ви також можете отримати відформатовані значення, застосовувати умовну логіку та пакетно оновлювати стилі в діапазонах. Це робить її ідеальною для створення звітів, панелей інструментів або експорту даних з послідовним форматуванням.
Як змінити значення клітинки та стиль за допомогою 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);
Підтримка діаграм та зображень
umya-spreadsheet підтримує створення та редагування діаграм — включаючи лінійні, стовпчикові та площинні діаграми — шляхом визначення діапазонів серій та маркерів. Ви можете вбудовувати зображення безпосередньо в листи, використовуючи структуру `Image`, з підтримкою PNG та інших форматів залежно від увімкнених функцій. Діаграми та зображення безшовно інтегруються з координатами клітинок та шарами малювання, що дозволяє створювати динамічні панелі інструментів. Хоча деякі розширені функції малювання ще розвиваються, основна функціональність готова до виробничого використання та розширювана.
Як додати лінійний графік до електронної таблиці за допомогою 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);
Операції з діапазонами та захист паролем
Виконуйте розширені операції, такі як переміщення, копіювання та зміна розмірів діапазонів за допомогою `move_range()`, що дозволяє динамічну реорганізацію даних. Бібліотека також підтримує захищені паролем робочі книги: записуйте файли за допомогою `write_with_password()` або застосовуйте паролі до існуючих файлів через `set_password()`. Ці функції є критичними для безпечного управління даними в корпоративних або чутливих до відповідності застосунках. У поєднанні з дизайном без зовнішніх залежностей та сумісністю з WASM, umya-spreadsheet забезпечує як гнучкість, так і безпеку.
Як перемістити діапазон і захистити файл паролем за допомогою 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();
