
umya-spreadsheet
XLSX/XLSM ファイル用の純粋な Rust ライブラリ
外部依存なしで XLSX/XLSM スプレッドシートを読み取り、書き込み、スタイル設定、操作できます。
umya-spreadsheet とは何ですか?
umya-spreadsheet は、XLSX および XLSM 形式の Excel スプレッドシートファイルの読み書きを行う、高性能な純粋 Rust ライブラリです。安全性と効率性を重視して設計されており、unsafe コードや外部依存を排除しているため、デスクトップアプリケーション、サーバーサイド処理、WebAssembly 環境に最適です。このライブラリは、セル、行、列、スタイル、チャート、画像にアクセスするためのクリーンで慣用的な Rust API を提供し、Microsoft Office や COM 相互運用に依存せずに堅牢なスプレッドシートツールを構築できます。
umya-spreadsheet は、遅延ロード、パスワード保護、リッチな書式設定をフルサポートし、パフォーマンスと使いやすさのギャップを埋めます。CSV エクスポート、チャート生成、画像埋め込み、範囲の移動やコピーといった操作をサポートしています。プロジェクトは積極的にメンテナンスされ、ドキュメントも充実しており、テストも行われていて、正確性と最新の Excel 機能との互換性に重点を置いています。開発者は Tauri や Axo といったフレームワークを使用して、CLI ツール、Web バックエンド、デスクトップアプリに統合できます。
umya-spreadsheet の入門
umya-spreadsheet の使用を開始するには、`umya-spreadsheet = "3.1.1"` を Cargo.toml に追加してください。WebAssembly のサポートには、`js` フィーチャーを有効にします。このライブラリは依存関係が少なく、コンパイルが速いです。インストール後は `extern crate umya_spreadsheet;` をインポートして、スプレッドシートの読み書きを開始できます。また、umya-spreadsheet GitHub でサンプル、テスト、ドキュメントを確認できます。大きなファイルに対しては遅延ロードをサポートし、堅牢なエラーハンドリングを提供します。
Cargo で umya-spreadsheet をインストール
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
XLSX/XLSM ファイルの読み書き
umya-spreadsheet は、XLSX および XLMS ファイルの読み書きのための直感的な API を提供します。 `reader::xlsx::read()` を使用してディスクからワークブックを読み込み、または `new_file()` で空のワークブックを作成します。 書き込みも同様に簡単です: ワークブックと保存先パスを指定して `writer::xlsx::write()` を呼び出します。 このライブラリは `lazy_read()` による遅延読み込みをサポートしており、大きなファイルでのパフォーマンスが向上します。また、パスワード保護された書き込みや、作成後にパスワードを設定することも可能です。 すべての操作は安全で、可能な限りゼロコピーを実現し、外部バイナリへの依存を回避します。
Rust で XLSX ファイルを読み書きする方法は?
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);
チャートと画像のサポート
umua-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();
