1. Produkty
  2.   Arkusz
  3.   Rust
  4.   umya-spreadsheet

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.

Previous Next

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();
 Polski