
umya-spreadsheet
Чистая библиотека Rust для файлов XLSX/XLSM
Чтение, запись, стилизация и манипуляция электронными таблицами XLSX/XLSM без внешних зависимостей.
Что такое umya-spreadsheet?
umya-spreadsheet — это высокопроизводительная, чистая библиотека на Rust для чтения и записи файлов Excel‑таблиц в форматах XLSX и XLSM. Разработана с упором на безопасность и эффективность, она избегает небезопасного кода и внешних зависимостей, что делает её идеальной для настольных приложений, серверной обработки и сред WebAssembly. Библиотека предоставляет чистый, идиоматичный Rust‑API для доступа к ячейкам, строкам, столбцам, стилям, диаграммам и изображениям, позволяя разработчикам создавать надёжные инструменты работы с таблицами без необходимости использовать Microsoft Office или COM‑interop.
Полностью поддерживая отложенную загрузку, защиту паролем и богатое форматирование, umya-spreadsheet устраняет разрыв между производительностью и удобством использования. Она поддерживает экспорт в CSV, создание диаграмм, встраивание изображений и операции с диапазонами, такие как перемещение и копирование. Проект активно поддерживается, хорошо документирован и протестирован, с акцентом на корректность и совместимость с современными функциями Excel. Разработчики могут интегрировать её в инструменты командной строки, веб‑бэкенды или настольные приложения, используя фреймворки такие как 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();
