Aspose.Cells FOSS for Python のはじめ方

Aspose.Cells FOSS for Python のはじめ方

aspose-cells-foss for Python は、スプレッドシートファイルの作成、読み取り、変換のための無料の MIT ライセンスライブラリです — Microsoft Office は不要、ネイティブ拡張も不要、PyPI の純粋な Python です。

ステップバイステップガイド

ステップ 1: パッケージをインストール

pip で PyPI からインストール:

pip install aspose-cells-foss

インストールを確認:

from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")

ステップ 2: 必要なクラスをインポートする

from aspose.cells_foss import Workbook, SaveFormat

ステップ 3: ワークブックを作成しデータを書き込む

新しいワークブックを作成するには Workbook() を使用します。add_worksheet() でワークシートを追加し、cells プロパティでセルグリッドにアクセスし、Cells.cell(row, col) を使って Cell を取得します。Cell.put_value() で値を設定します:

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook()
ws = wb.add_worksheet("Sales")

cells = ws.cells
cells.cell(1, 1).put_value("Product")
cells.cell(1, 2).put_value("Revenue")
cells.cell(2, 1).put_value("Widget A")
cells.cell(2, 2).put_value(12500)
cells.cell(3, 1).put_value("Widget B")
cells.cell(3, 2).put_value(8750)

wb.save("sales.xlsx", SaveFormat.XLSX)
print("sales.xlsx written.")

ステップ 4: ワークブックを再び読み込む

ファイルパスを Workbook(file_path) に渡して既存のファイルをロードします。インデックスまたは名前で get_worksheet() を使用し、value プロパティでセルの値を読み取ります:

from aspose.cells_foss import Workbook

wb = Workbook("sales.xlsx")
ws = wb.get_worksheet(0)
cells = ws.cells

print(f"A1: {cells.cell(1, 1).value}")
print(f"B2: {cells.cell(2, 2).value}")

ステップ 5: 他のフォーマットに保存する

Workbook.save() は SaveFormat を通じて複数のフォーマットをサポートしています。カンマ区切りの出力には SaveFormat.CSV を、Markdown テーブルには SaveFormat.MARKDOWN を使用します:

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook("sales.xlsx")
wb.save("sales.csv", SaveFormat.CSV)
wb.save("sales.md", SaveFormat.MARKDOWN)
print("CSV and Markdown exports written.")

一般的な問題と対処法

ModuleNotFoundError: No module named 'aspose' アクティブな仮想環境にパッケージをインストールします(インストールガイドを参照)。次で確認してください pip show aspose-cells-foss.

FileNotFoundError ワークブックを読み込むとき 使用 pathlib.Path ポータブルパスを構築するには: Workbook(str(Path("data") / "file.xlsx")).

セルの値が返されます None 読み取り後 セルが空であるか範囲外です。使用 Cell.is_empty() 読み取る前にチェックするために value.

CSV 出力には最初のシートのみが含まれます save() with SaveFormat.CSV アクティブなワークシートのみをエクスポートします。使用 set_active_worksheet() エクスポートしたいシートを選択してから保存してください。

XLSX ファイルが Excel で開かれません 必ず渡してください SaveFormat.XLSX 明示的に指定してください。これがない場合、形式はファイル拡張子から推測されます;パスに拡張子がない場合は .xlsx 拡張子がないと、出力が無効になる可能性があります。

よくある質問

aspose-cells-foss は Microsoft Office が必要ですか?

いいえ。このライブラリは、Microsoft Office、COM オートメーション、Windows API に依存せず、純粋な Python でスプレッドシートファイルをネイティブに読み書きします。

サポートされている Python バージョンはどれですか?

Python 3.7 以降です。このパッケージは Windows、macOS、Linux、Docker コンテナ上で動作します。

このライブラリは商用利用でも無料ですか?

はい。MIT ライセンスでリリースされています。商用アプリケーションを含むあらゆる目的で使用、改変、再配布が可能です。

シート内のすべてのセルをどのように反復処理しますか?

行ごとに反復処理するには Cells.iter_rows() を使用します:

from aspose.cells_foss import Workbook

wb = Workbook("data.xlsx")
ws = wb.get_worksheet(0)
for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
    print(row)

どのフォーマットに保存できますか?

SaveFormat は XLSX、CSV、TSV、MARKDOWN、および JSON をサポートしています。SaveFormat.from_extension(file_path) を使用して、ファイルパスから形式を自動的に検出します。

参照

 日本語