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.

Previous Next

Начало работы с 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();
 Русский