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) を使用して、ファイルパスから形式を自動的に検出します。