開発者ガイド

Aspose.Cells FOSS for Python は、プログラムによるスプレッドシート処理のための無料かつオープンソースのライブラリです。データパイプラインの構築、レポートの自動生成、機械学習結果の Excel へのエクスポート、またはドキュメントパイプライン用にワークブックを Markdown に変換する場合でも、Aspose.Cells FOSS は Microsoft Office を必要とせずにスプレッドシート操作のすべての層をカバーする包括的な API を提供します。

主な機能

ワークブックとワークシートの操作

ゼロから新しいワークブックを作成するか、既存のXLSXまたはCSVファイルを開きます。
クリーンでPythonicなAPIを使用してWorkbook → Worksheets → Cells → Cell階層をナビゲートします。
workbook.add_worksheet(name)とworkbook.remove_worksheet(index_or_name)を使用してワークシートを追加、名前変更、削除します。
アドレス（ws.cells["A1"]）で個々のセルにアクセスし、値を直接設定し、入力された範囲を反復処理します。

セルのスタイリングとフォーマット

個々のセルに対して細かい書式設定を適用します。Font クラスを使用してフォントファミリー、サイズ、色、太字、斜体、下線、取り消し線を制御します。cell.style.fill.set_solid_fill("FFRRGGBB") を使用して背景塗りつぶしを設定します。色は # プレフィックスなしの8文字の AARRGGBB 16進文字列で表現されます（例: "FFFF0000" は不透明な赤）。

チャート作成と可視化

ws.charts.add_bar(top_row, left_col, bottom_row, right_col) と ws.charts.add_line(...) のような専用メソッドを使用して、ワークシートに列、折れ線、棒、円グラフを追加します。チャートタイトルを文字列として設定します（chart.title = "My Chart"）、チャートレベルでカテゴリデータを構成します（chart.category_data = "A2:A6"）、そして名前付きシリーズを追加します（chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")）。

数式サポート

Excel互換の数式を、cell.formula = "=SUM(A1:A5)" を設定するか、Cell(None, "=SUM(A1:A5)") を構築してセルコレクションに割り当てることで入力します。

マルチフォーマットエクスポート

単一の workbook.save(path) 呼び出しを使用して、ワークブックを XLSX、CSV、TSV、Markdown、JSON にエクスポートします。
明示的な制御のために SaveFormat 定数を使用します: SaveFormat.XLSX、SaveFormat.CSV、SaveFormat.TSV、SaveFormat.MARKDOWN、SaveFormat.JSON。
細かい Markdown 出力（配置、ヘッダーレベル、ワークシートインデックス）のために MarkdownSaveOptions を使用します。
インメモリ Markdown 生成のために MarkdownHandler.save_markdown_to_string(wb) を使用します。

注: Aspose.Cells FOSS は XLSX、CSV、TSV、Markdown、JSON にエクスポートできます。PDF、HTML、PNG、TIFF、DOCX、PPTX のエクスポートは FOSS ライブラリの一部ではありません。

プラグイン エコシステム

オプションの markitdown-aspose-cells-plugin パッケージは、Microsoft の MarkItDown ライブラリと統合し、XLSX の読み取りサポートを追加します。pip install markitdown-aspose-cells-plugin を使用してインストールし、MarkItDown API を介して透過的に利用できます。

はじめに

インストール 

pip install aspose-cells-foss

こんにちは世界 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Hello, Aspose.Cells FOSS!"
ws.cells["A2"].value = 42
workbook.save("hello.xlsx")

Markdownにエクスポート 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88

workbook.save_as_markdown("results.md")

列チャートを作成 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

data = [("Q1", 50), ("Q2", 100), ("Q3", 170), ("Q4", 300)]
for i, (label, value) in enumerate(data):
    ws.cells[f"A{i+2}"].value = label
    ws.cells[f"B{i+2}"].value = value

chart = ws.charts.add_bar(6, 0, 20, 8)
chart.title = "Quarterly Revenue"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")

workbook.save("chart.xlsx")

セルのスタイル 

from aspose.cells_foss import Workbook, Cell, Font

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"] = Cell("Revenue Report")

cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FFFFFFFF"   # White text (AARRGGBB, no #)
cell.style.fill.set_solid_fill("FF1E64C8")  # Blue background

workbook.save("styled.xlsx")

利用可能なガイド

  • Spreadsheet Format Export — XLSX、CSV、TSV、Markdown、JSON 間でワークブックをエクスポートします。
  • Formula Calculation — Excel 互換の数式をプログラムで入力および評価します。
  • Spreadsheet Operations — ワークブックの作成、セル操作、範囲操作、スタイリング。
  • Getting Started — インストール、システム要件、最初のワークブック。

参照

 日本語