1. Produkte
  2.   Kalkulationstabelle
  3.   Rust
  4.   umya-spreadsheet

umya-spreadsheet

 
 

Reine Rust-Bibliothek für XLSX/XLSM-Dateien

Lesen, Schreiben, Gestalten und Manipulieren von XLSX/XLSM-Tabellen ohne externe Abhängigkeiten.

Was ist umya-spreadsheet?

umya-spreadsheet ist eine leistungsstarke, reine Rust-Bibliothek zum Lesen und Schreiben von Excel-Tabellendateien im XLSX- und XLSM-Format. Sie ist auf Sicherheit und Effizienz ausgelegt, vermeidet unsicheren Code und externe Abhängigkeiten und ist damit ideal für Desktop-Anwendungen, serverseitige Verarbeitung und WebAssembly-Umgebungen. Die Bibliothek bietet eine saubere, idiomatische Rust-API zum Zugriff auf Zellen, Zeilen, Spalten, Stile, Diagramme und Bilder, sodass Entwickler robuste Tabellenkalkulations‑Tools erstellen können, ohne auf Microsoft Office oder COM‑Interop angewiesen zu sein.

Mit voller Unterstützung für Lazy Loading, Passwortschutz und umfangreiche Formatierung überbrückt umya-spreadsheet die Lücke zwischen Leistung und Benutzerfreundlichkeit. Es unterstützt den CSV-Export, die Diagrammerstellung, das Einbetten von Bildern und Bereichsoperationen wie Verschieben und Kopieren. Das Projekt wird aktiv gepflegt, ist gut dokumentiert und getestet, mit Fokus auf Korrektheit und Kompatibilität zu modernen Excel‑Funktionen. Entwickler können es in CLI‑Tools, Web‑Backends oder Desktop‑Apps mit Frameworks wie Tauri oder Axo integrieren.

Previous Next

Erste Schritte mit umya-spreadsheet

Um umya-spreadsheet zu verwenden, fügen Sie es zu Ihrer Cargo.toml mit `umya-spreadsheet = "3.1.1"` hinzu. Für WebAssembly-Unterstützung aktivieren Sie das `js`-Feature. Die Bibliothek ist leichtgewichtig in Bezug auf Abhängigkeiten und kompiliert schnell. Nach der Installation importieren Sie sie über `extern crate umya_spreadsheet;` und beginnen mit dem Lesen oder Schreiben von Tabellenkalkulationen. Sie können auch das umya-spreadsheet GitHub für Beispiele, Tests und Dokumentation erkunden. Es unterstützt Lazy Loading für große Dateien und bietet eine robuste Fehlerbehandlung.

Umya-spreadsheet via Cargo installieren

[dependencies]
umya-spreadsheet = "3.1.1"

# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }

XLSX/XLSM-Dateien lesen & schreiben

umya-spreadsheet bietet intuitive APIs zum Lesen und Schreiben von XLSX- und XLMS-Dateien. Verwenden Sie `reader::xlsx::read()`, um eine Arbeitsmappe von der Festplatte zu laden, oder `new_file()`, um eine leere zu erstellen. Das Schreiben ist ebenso einfach: Rufen Sie `writer::xlsx::write()` mit der Arbeitsmappe und dem Zielpfad auf. Die Bibliothek unterstützt Lazy Loading über `lazy_read()` für verbesserte Leistung bei großen Dateien und ermöglicht das Schreiben mit Passwortschutz oder das Festlegen von Passwörtern nach der Erstellung. Alle Vorgänge sind sicher, nach Möglichkeit nullkopierfrei und vermeiden externe Binärdateien.

Wie liest und schreibt man eine XLSX-Datei mit 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();

Zellzugriff & Stilmanipulation

Der Zugriff auf und die Änderung von Zellwerten ist unkompliziert: Verwenden Sie `cell("A1")` oder `cell((1,1))` zum Lesen und `cell_mut()` zum Schreiben. Stile werden über `style_mut()` verwaltet, wodurch Hintergrundfarbe, Schriftart, Rahmen und Ausrichtungsänderungen möglich sind. Die Bibliothek stellt ein umfangreiches Set an Stileigenschaften bereit und bewahrt nach Möglichkeit Unveränderlichkeitsgarantien. Sie können auch formatierte Werte abrufen, bedingte Logik anwenden und Stile stapelweise über Bereiche aktualisieren. Das macht sie ideal für die Erstellung von Berichten, Dashboards oder Datenexporten mit konsistenter Formatierung.

Wie man Zellenwert und -stil über Rust ändert?

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

Diagramme & Bildunterstützung

umua-spreadsheet unterstützt das Erstellen und Bearbeiten von Diagrammen – einschließlich Linien-, Balken- und Flächendiagrammen – durch die Definition von Serienbereichen und Markern. Sie können Bilder direkt in Tabellenblätter einbetten, indem Sie die `Image` struct verwenden, mit Unterstützung für PNG und andere Formate, abhängig von aktivierten Funktionen. Diagramme und Bilder integrieren sich nahtlos in Zellkoordinaten und Zeichenebenen, wodurch die dynamische Dashboard-Erstellung ermöglicht wird. Während einige erweiterte Zeichenfunktionen noch in Entwicklung sind, ist die Kernfunktionalität produktionsreif und erweiterbar.

Wie man ein Liniendiagramm zu einer Tabelle mittels Rust hinzufügt?

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

Bereichsoperationen & Passwortschutz

Führen Sie erweiterte Operationen wie das Verschieben, Kopieren und Ändern der Größe von Bereichen mit `move_range()` durch, um eine dynamische Datenumorganisation zu ermöglichen. Die Bibliothek unterstützt zudem passwortgeschützte Arbeitsmappen: Schreiben Sie Dateien mit `write_with_password()` oder wenden Sie Passwörter auf bestehende Dateien über `set_password()` an. Diese Funktionen sind entscheidend für die sichere Datenverarbeitung in Unternehmens- oder compliance‑sensiblen Anwendungen. In Kombination mit einem null‑Abhängigkeits‑Design und WASM‑Kompatibilität bietet umua-spreadsheet sowohl Flexibilität als auch Sicherheit.

Wie man einen Bereich verschiebt und eine Datei mit Passwort über Rust schützt?

// 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();
 Deutsch