xlsxwriter-rs

 
 

Excel XLSX生成のためのRustライブラリ

Rust APIを使用して、書式設定、結合セル、オートフィルタ、画像を備えた完全互換のExcel XLSXファイルを作成します。

xlsxwriter-rs とは何ですか?

xlsxwriter-rs は、広く使用されている libxlsxwriter C ライブラリの高性能 Rust バインディングであり、開発者が Rust アプリケーションから直接完全に互換性のある Excel XLSX ファイルを生成できるようにします。フォント、カラー、配置、罫線、数値形式など、包括的な Excel 書式設定をサポートするとともに、結合セル、オートフィルタ、データ検証、埋め込み PNG/JPEG 画像といった高度な機能も提供します。信頼性と高速性を重視して設計された xlsxwriter-rs は、サーバーサイドのレポート生成、データエクスポートパイプライン、Rust でのプログラム的な Excel ファイル作成が必要なあらゆるシナリオに最適です。

このライブラリは、Rust のメモリ安全性とゼロコスト抽象化を活用し、Microsoft Excel や COM のような外部依存関係を必要とせずに、Excel 生成のための安全で効率的な API を提供します。Cargo とシームレスに統合され、MD5 チェックサムの無効化やシステム zlib の使用など、動作をカスタマイズするオプションの機能フラグをサポートします。クリーンで慣用的な Rust インターフェースと包括的なドキュメントにより、xlsxwriter-rs は開発者がファイル構造と内容を完全に制御しながら、堅牢でクロスプラットフォームな Excel 生成ツールを構築できるよう支援します。

Previous Next

xlsxwriter-rs の開始方法

xlsxwriter-rs の使用を開始するには、cargo add xlsxwriter を使って Cargo.toml に追加するか、[dependencies] に手動で xlsxwriter = "0.1" を記述してください。ライブラリは bindgen のコンパイルに LLVM と Clang が必要です。Windows の場合は Visual Studio と LLVM をインストールし、LIBCLANG_PATH を LLVM の bin ディレクトリに設定します。設定が完了したらリポジトリをクローンし、git submodule update --init --recursive を実行して C ライブラリを取得し、cargo run --example hello_spreadsheet でサンプルをビルドします。完全なドキュメントと例は xlsxwriter-rs GitHub で入手できます。

Cargo で xlsxwriter-rs をインストール

cargo add xlsxwriter

完全な Excel 書式設定サポート

xlsxwriter-rs は包括的な書式設定機能を提供し、開発者がフォント、色、罫線、配置、数値形式を個々のセルまたは範囲ごとにカスタマイズできるようにします。太字、斜体、下線、フォントサイズ、カスタムカラーをテキストに適用したり、背景塗りつぶし色を設定したり、さまざまなスタイル(細線、中線、太線)のセル罫線を定義したり、水平/垂直の配置を制御したりできます。このレベルの制御により、生成された Excel ファイルがプロフェッショナルなレポート基準に合致します。書式設定は Format 構造体を使用して適用され、メソッドチェーンをサポートして直感的に構成できます。この機能は、可読性とユーザーエクスペリエンスを向上させる、視覚的に際立ったレポート、ダッシュボード、データエクスポートの作成に不可欠です。

セルにフォントカラーと配置を適用

let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
    0, 0, 
    "Red text", 
    Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
    2, 0, 
    "Centered green text", 
    Some(&Format::new()
        .set_font_color(FormatColor::Green)
        .set_align(FormatAlignment::CenterAcross)
        .set_vertical_align(FormatVerticalAlignment::VerticalCenter)
    )
)?;

結合セルと範囲

このライブラリはセルの矩形範囲の結合をサポートしており、Excelレポートでヘッダー、タイトル、グループ化されたデータセクションを作成する際に重要です。merge_range メソッドを使用すると、複数の行と列にまたがって結合ブロック全体に書式設定を適用できます。これにより、複雑なスプレッドシート全体で一貫したスタイリングとレイアウトが保証されます。結合されたセルは Excel のレンダリングエンジンと完全に互換性があり、テキストの配置、罫線、背景色などの書式設定が保持されます。この機能は、財務諸表、ダッシュボード、フォームなど、視覚的なグルーピングがデータの理解とプレゼンテーションの品質を向上させる場面で特に有用です。

カスタム書式で範囲を結合する

sheet1.merge_range(
    2, 0, 
    3, 2, 
    "Hello, world", 
    Some(&Format::new()
        .set_font_color(FormatColor::Green)
        .set_align(FormatAlignment::CenterAcross)
        .set_vertical_align(FormatVerticalAlignment::VerticalCenter)
    )
)?;

オートフィルタとデータ検証

xlsxwriter-rs は、オートフィルタとデータ検証ルールのプログラムによる作成を可能にし、ユーザーが Excel で直接データを並べ替え、フィルタリングし、検証できるようにします。set_autofilter を使用してセル範囲にオートフィルタを適用でき、データ検証を通じてユーザー入力用のドロップダウンリストを定義できます。これにより、リストベースの検証、数値範囲、日付、カスタム数式がサポートされます。これらの機能は、スプレッドシートのインタラクティブ性とデータ整合性を向上させ、フォーム、テンプレート、共同データ入力に適しています。生成された XLSX ファイルは、Excel、LibreOffice、Google Sheets で開いた際に完全な機能を保持し、広範な互換性を確保します。

オートフィルタとデータ検証を適用する

// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;

// Add data validation (drop-down list) in B2
sheet1.data_validation(
    "B2", 
    DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;

画像とハイパーリンクの埋め込み

xlsxwriter-rs を使用して、PNG および JPEG 画像を Excel ワークシートに直接埋め込むことができ、位置指定、サイズ変更、スケーリングをサポートします。これは、レポートにロゴ、チャート、または視覚的指標を追加するのに最適です。さらに、ライブラリはハイパーリンクと URL をカスタマイズ可能な書式設定(例: 青いテキストと下線)でサポートし、ウェブサイト、ドキュメント、または他のシートへのクリック可能なリンクを実現します。これらの機能により、xlsxwriter-rs はデータ、ビジュアル、ナビゲーションを組み合わせたリッチでインタラクティブなレポートやダッシュボードの作成に適しています。埋め込まれたすべてのコンテンツは Excel のレンダリングエンジンと完全に互換性があり、プラットフォーム間でレイアウトの整合性を保ちます。

URLを書き込み、画像を埋め込む

// Write a clickable URL
sheet1.write_url(
    1, 1,
    "https://github.com/informationsea/xlsxwriter-rs",
    Some(&Format::new()
        .set_font_color(FormatColor::Blue)
        .set_underline(FormatUnderline::Single)
    )
)?;

// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;
 日本