
rust_xlsxwriter
Excel XLSXファイル用のオープンソースRustライブラリ
Rust APIを使用して、完全な書式設定、チャート、数式、画像を備えたExcel 2007以降のXLSXファイルを生成します。
rust_xlsxwriter とは何ですか?
rust_xlsxwriter は、Excel や外部依存関係を必要とせずに Excel XLSX ファイルを生成するための、高性能な純粋 Rust クレートです。開発者はテキスト、数値、日付、数式、チャート、画像、結合セル、条件付き書式、データ検証などをプログラムで作成できます。信頼性と速度を重視して設計されており、Excel のネイティブファイル形式にほぼ完全に一致し、大規模データセット向けの定数メモリモードをサポートします。このライブラリは、人気のある Python XlsxWriter ライブラリを忠実に Rust へ移植したもので、慣用的な API と包括的なドキュメントが提供されています。
rust_xlsxwriter は Excel ファイルの書き込みに特化しており、既存ファイルの読み取りや変更は行いません。動的配列、スパークライン、チェックボックス、テキストボックス、テーブル、オートフィルタ、定義名、ブックテーマなど、最新の Excel 機能をサポートしています。Serde シリアライズ、chrono/jiff 日付サポート、Polars 連携といったオプション機能により、さまざまな Rust エコシステムに適応します。そのパフォーマンスは C バージョンに次いで高速で、Python の XlsxWriter より 3.8 倍速い実行速度を実現しています。詳細については、rust_xlsxwriter GitHub リポジトリをご覧ください。
rust_xlsxwriter の入門
rust_xlsxwriter は crates.io で入手可能で、`cargo add rust_xlsxwriter` によってインストールできます。機能を拡張するには、`constant_memory`、`chrono`、`serde`、`polars` などのオプション機能を有効にします。このライブラリは Rust 1.56 以上が必要で、`zip` クレート(デフォルト)以外の外部ランタイム依存はなく、ネイティブバイナリにコンパイルされます。ユーザーガイド、チュートリアル、クックブックを含む完全なドキュメントが用意されています。詳細な例やソースコードについては、rust_xlsxwriter GitHub リポジトリをご覧ください。
Cargo を使用して rust_xlsxwriter をインストール
cargo add rust_xlsxwriterテキスト、数値、日付を含む書式設定されたセルの書き込み
rust_xlsxwriter は、Excel のセルに書式設定されたコンテンツを書き込むためのシンプルで直感的な API を提供します。開発者は `Format` 構造体を使用して、数値、日付、フォント、罫線、配置、色などのカスタム書式を適用できます。このライブラリは、プレーンテキスト、数値、日付、数式、URL をオプションの書式設定とともに書き込むことをサポートします。また、単一セル内で混在した書式を持つリッチなマルチフォーマット文字列もサポートしています。これにより、視覚的な明瞭さと構造が重要なレポート、ダッシュボード、データエクスポートの生成に最適です。API は Excel のネイティブ書式エンジンと高い忠実度を保証します。
Rust で書式設定されたテキスト、数値、日付を書く方法は?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
let bold = Format::new().set_bold();
let decimal = Format::new().set_num_format("0.00");
let date_fmt = Format::new().set_num_format("yyyy-mm-dd");
worksheet.write_with_format(0, 0, "Hello", &bold)?;
worksheet.write(1, 0, 123.456)?;
worksheet.write_with_format(2, 0, 789.012, &decimal)?;
let date = ExcelDateTime::from_ymd(2023, 12, 25)?;
worksheet.write_with_format(3, 0, &date, &date_fmt)?;
workbook.save("formatted.xlsx")?;チャート、スパークライン、画像の作成
rust_xlsxwriter は、プロフェッショナルなチャート、スパークライン、および画像を直接 Excel ファイルに埋め込む機能をサポートしています。開発者は、棒グラフ、折れ線グラフ、円グラフ、散布図、エリアチャートを、軸、凡例、データ系列をカスタマイズ可能な形で作成できます。スパークラインはセル内にコンパクトなトレンド可視化を提供します。画像(PNG、JPEG、GIF、BMP)は挿入でき、スケーリングやアンカリングオプションで位置を調整できます。これらのビジュアル要素は、データストーリーテリングとレポート機能を強化します。このライブラリは Excel 2007 以降との互換性を保証し、プラットフォーム間でのレンダリング忠実度を保ちます。
Rust を使用して Excel にチャートと画像を追加する方法は?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
// Write sample data
for i in 0..5 {
worksheet.write_number(i, 0, (i + 1) as f64 * 10.0)?;
}
// Create a chart
let mut chart = Chart::new(ChartType::Column);
chart.add_series().set_values("Sheet1!$A$1:$A$5");
worksheet.insert_chart(0, 2, &chart)?;
// Insert an image
let image = Image::new("logo.png")?;
worksheet.insert_image(5, 2, &image)?;
workbook.save("chart_image.xlsx")?;高度な書式設定:結合セル、テーブル、条件付き書式
rust_xlsxwriter は、結合範囲、構造化テーブル、オートフィルタ、条件付き書式ルールなどの高度な Excel 書式設定機能を提供します。開発者はヘッダーやラベル用にセルを結合したり、帯状の行/列を持つテーブルスタイルを適用したり、ユーザーインタラクティブなフィルタを定義したりできます。条件付き書式は、カラースケール、データバー、アイコンセット、カスタム数式をサポートし、トレンドや異常をハイライトします。これらの機能は、生成されたブックのデータ可読性とインタラクティブ性を向上させます。API は複雑な XML 構造を直感的な Rust メソッドに抽象化し、保守性と型安全性を確保します。
条件付き書式を使用してセルを結合し、テーブルを追加する方法は?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
// Merge cells
let merge_fmt = Format::new()
.set_border(FormatBorder::Thin)
.set_align(FormatAlign::Center);
worksheet.merge_range(0, 0, 0, 2, "Report Header", &merge_fmt)?;
// Add table
worksheet.add_table(1, 0, 5, 2, Table::new().set_columns(&[
("Item", None),
("Value", None),
("Status", None),
]))?;
// Conditional formatting
worksheet.conditional_format(
2, 0, 5, 2,
ConditionalFormat::new()
.set_type(ConditionalFormatType::Cell)
.set_format(&Format::new().set_bg_color("#D8E4BC"))
.set_formula("=A2>100")
)?;
workbook.save("advanced.xlsx")?;パフォーマンス最適化と大容量ファイルのサポート
rust_xlsxwriter は速度とメモリ効率を最適化しており、特に大規模データセットに適しています。`constant_memory` 機能を使用した定常メモリモードをサポートしており、データをディスクに段階的に書き込み、ヒープ使用量を最小化します。このモードは、OOM エラーなしで数メガバイト規模の Excel ファイルを生成するのに最適です。ベンチマークでは、Python の XlsxWriter より約 3.8× 高速で、ネイティブ C ライブラリより約 14% しか遅くないことが示されています。`zmij` や `zlib` といったオプション機能は、数値書き込みや圧縮をさらに高速化します。これらの機能により、バッチレポート、ETL パイプライン、サーバーサイドの Excel 生成に適しています。
大きなファイル用に定数メモリモードを有効にする方法は?
cargo add rust_xlsxwriter -F constant_memoryuse rust_xlsxwriter::*;
let mut workbook = Workbook::new();
workbook.set_constant_memory(true); // Enable constant memory mode
let worksheet = workbook.add_worksheet();
for i in 0..100_000 {
worksheet.write_number(i, 0, i as f64)?;
}
workbook.save("large_file.xlsx")?;