
umya-spreadsheet
Czysta biblioteka Rust dla plików XLSX/XLSM
Odczytuj, zapisuj, stylizuj i manipuluj arkuszami XLSX/XLSM bez żadnych zewnętrznych zależności.
Czym jest umya-spreadsheet?
umya-spreadsheet to wysokowydajna, czysta biblioteka Rust do odczytu i zapisu plików arkuszy Excel w formatach XLSX i XLSM. Zaprojektowana z myślą o bezpieczeństwie i wydajności, unika niebezpiecznego kodu oraz zewnętrznych zależności, co czyni ją idealną dla aplikacji desktopowych, przetwarzania po stronie serwera oraz środowisk WebAssembly. Biblioteka oferuje czyste, idiomatyczne API w Rust do dostępu do komórek, wierszy, kolumn, stylów, wykresów i obrazów, umożliwiając programistom tworzenie solidnych narzędzi arkuszowych bez konieczności korzystania z Microsoft Office lub interfejsu COM.
Z pełnym wsparciem dla leniwego ładowania, ochrony hasłem i bogatego formatowania, umya-spreadsheet wypełnia lukę między wydajnością a użytecznością. Obsługuje eksport CSV, generowanie wykresów, osadzanie obrazów oraz operacje na zakresach, takie jak przenoszenie i kopiowanie. Projekt jest aktywnie utrzymywany, dobrze udokumentowany i testowany, z naciskiem na poprawność i kompatybilność z nowoczesnymi funkcjami Excela. Programiści mogą integrować go z narzędziami CLI, backendami webowymi lub aplikacjami desktopowymi przy użyciu frameworków takich jak Tauri lub Axo.
Rozpoczęcie pracy z umya-spreadsheet
Aby rozpocząć korzystanie z umya-spreadsheet, dodaj go do swojego Cargo.toml za pomocą `umya-spreadsheet = "3.1.1"`. Aby uzyskać wsparcie dla WebAssembly, włącz funkcję `js`. Biblioteka jest lekka pod względem zależności i kompiluje się szybko. Po zainstalowaniu zaimportuj ją za pomocą `extern crate umya_spreadsheet;` i rozpocznij odczytywanie lub zapisywanie arkuszy kalkulacyjnych. Możesz także przeglądać umya-spreadsheet GitHub w poszukiwaniu przykładów, testów i dokumentacji. Obsługuje leniwe ładowanie dużych plików i oferuje solidną obsługę błędów.
Zainstaluj umya-spreadsheet za pomocą Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
Odczyt i zapis plików XLSX/XLSM
umya-spreadsheet zapewnia intuicyjne API do odczytu i zapisu plików XLSX i XLMS. Użyj `reader::xlsx::read()` aby wczytać skoroszyt z dysku, lub `new_file()` aby utworzyć pusty. Zapisywanie jest równie proste: wywołaj `writer::xlsx::write()` z skoroszytem i docelową ścieżką. Biblioteka obsługuje leniwe wczytywanie za pomocą `lazy_read()` w celu zwiększenia wydajności przy dużych plikach oraz umożliwia zapisy chronione hasłem lub ustawianie haseł po utworzeniu. Wszystkie operacje są bezpieczne, zero‑kopiowe tam, gdzie to możliwe, i unikają zewnętrznych binarek.
Jak odczytać i zapisać plik XLSX w języku 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();
Dostęp do komórek i manipulacja stylami
Dostęp i modyfikacja wartości komórek jest prosta: użyj `cell("A1")` lub `cell((1,1))` do odczytu, oraz `cell_mut()` do zapisu. Style są zarządzane za pomocą `style_mut()`, umożliwiając zmianę koloru tła, czcionki, obramowań i wyrównania. Biblioteka udostępnia bogaty zestaw właściwości stylu, zachowując jednocześnie gwarancje niezmienności tam, gdzie to możliwe. Możesz także pobierać sformatowane wartości, stosować logikę warunkową i masowo aktualizować style w zakresach. Dzięki temu jest idealna do generowania raportów, pulpitów nawigacyjnych lub eksportu danych z jednolitą formatacją.
Jak zmodyfikować wartość komórki i styl przy użyciu 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);
Obsługa wykresów i obrazów
umya-spreadsheet obsługuje tworzenie i edytowanie wykresów — w tym wykresów liniowych, słupkowych i obszarowych — poprzez definiowanie zakresów serii i znaczników. Możesz osadzać obrazy bezpośrednio w arkuszach przy użyciu struktury `Image`, z obsługą PNG i innych formatów w zależności od włączonych funkcji. Wykresy i obrazy integrują się płynnie z współrzędnymi komórek i warstwami rysunków, umożliwiając dynamiczne generowanie pulpitów nawigacyjnych. Chociaż niektóre zaawansowane funkcje rysowania są nadal rozwijane, podstawowa funkcjonalność jest gotowa do produkcji i rozszerzalna.
Jak dodać wykres liniowy do arkusza kalkulacyjnego przy użyciu 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);
Operacje na zakresach i ochrona hasłem
Wykonuj zaawansowane operacje, takie jak przenoszenie, kopiowanie i zmiana rozmiaru zakresów przy użyciu `move_range()`, umożliwiając dynamiczną reorganizację danych. Biblioteka obsługuje również skoroszyty chronione hasłem: zapisuj pliki za pomocą `write_with_password()` lub stosuj hasła do istniejących plików poprzez `set_password()`. Funkcje te są kluczowe dla bezpiecznego przetwarzania danych w aplikacjach korporacyjnych lub wrażliwych na zgodność. W połączeniu z projektem bez zależności i kompatybilnością z WASM, umya-spreadsheet zapewnia zarówno elastyczność, jak i bezpieczeństwo.
Jak przenieść zakres i zabezpieczyć plik hasłem przy użyciu 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();
