umya-spreadsheet

 
 

Чиста Rust библиотека за XLSX/XLSM файлове

Четете, записвайте, стилизирайте и манипулирайте XLSX/XLSM електронни таблици без външни зависимости.

Какво е umya-spreadsheet?

umya-spreadsheet е високопроизводителна, чиста Rust библиотека за четене и записване на Excel файлове в формати XLSX и XLSM. Проектирана за безопасност и ефективност, тя избягва небезопасен код и външни зависимости, което я прави идеална за настолни приложения, сървърна обработка и WebAssembly среди. Библиотеката предоставя чист, идиоматичен Rust API за достъп до клетки, редове, колони, стилове, диаграми и изображения, позволявайки на разработчиците да създават стабилни инструменти за електронни таблици без да разчитат на Microsoft Office или COM interop.

С пълна поддръжка за lazy loading, защита с парола и богато форматиране, umya-spreadsheet запълва пропастта между производителност и удобство. Тя поддържа експортиране в CSV, генериране на диаграми, вграждане на изображения и операции с диапазони като преместване и копиране. Проектът се поддържа активно, е добре документиран и тестван, с фокус върху коректността и съвместимостта с модерните функции на Excel. Разработчиците могат да я интегрират в CLI инструменти, уеб бекендове или настолни приложения, използвайки рамки като Tauri или Axo.

Previous Next

Започване с umya-spreadsheet

За да започнете да използвате umya-spreadsheet, добавете го към вашия Cargo.toml с `umya-spreadsheet = "3.1.1"`. За поддръжка на WebAssembly, активирайте функцията `js`. Библиотеката е лека по зависимости и се компилира бързо. След инсталацията, импортирайте я чрез `extern crate umya_spreadsheet;` и започнете да четете или записвате електронни таблици. Можете също да разгледате umya-spreadsheet GitHub за примери, тестове и документация. Тя поддържа lazy loading за големи файлове и предлага стабилна обработка на грешки.

Инсталиране на 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();
 Български