エラーハンドリング

実際にツールを使う場面では、CSVファイルが存在しない場合など、想定外の状況が発生することがあります。まず、エラーハンドリングがない状態でどうなるかを確認してみましょう。

1. エラーを体験する

Visual Studio Codeのエクスプローラーでsales.csvのファイル名をsales_backup.csvに変更してください。ファイルを右クリックし「名前の変更」を選択すると変更できます。

この状態でmain.pyを実行してみましょう。以下のようなエラーが表示され、プログラムが途中で停止します。

Traceback (most recent call last):
  File "main.py", line 8, in <module>
    with open("sales.csv", "r", encoding="utf-8") as f:
FileNotFoundError: [Errno 2] No such file or directory: 'sales.csv'

これはFileNotFoundErrorというエラーで、指定したファイルが見つからなかったことを示しています。エラーメッセージは英語で表示され、プログラムもその場で停止してしまいます。このままでは、ツールを使うユーザにとって何が起きたのかわかりにくい状態です。また、エラー処理が入っていないと、処理が途中で止まることで中途半端なファイルが作成されるなど、予期しない挙動を引き起こすこともあります。

2. try/exceptの追加

前の章で学んだtry/exceptを使って、このエラーに対処します。main.pyのCSVファイル読み込み部分を以下のように変更してください。

import csv
import json
import sys
from models import Sale, CategorySummary

# CSVファイルの読み込み
sales = []
try:  # ← 追加
    with open("sales.csv", "r", encoding="utf-8") as f:
        reader = csv.DictReader(f)
        for row in reader:
            sale = Sale(
                date=row["date"],
                product=row["product"],
                category=row["category"],
                quantity=int(row["quantity"]),
                unit_price=int(row["unit_price"])
            )
            sales.append(sale)
# ====== ↓ ここから追加 ======
except FileNotFoundError:
    print("エラー: ファイル 'sales.csv' が見つかりません。")
    exit(1)

if len(sales) == 0:
    print("エラー: 売上データが0件です。CSVファイルの内容を確認してください。")
    exit(1)
# ====== ↑ ここまで追加 ======

# カテゴリ別の集計
summaries = {}
for sale in sales:
    if sale.category not in summaries:
        summaries[sale.category] = CategorySummary(sale.category)
    summaries[sale.category].add(sale)

# 集計結果の表示
print("=== カテゴリ別売上集計 ===")
for summary in summaries.values():
    print(f"  {summary.category}: {summary.total_quantity}個 / {summary.total_amount}円")

# JSONファイルへの出力
result = []
for summary in summaries.values():
    result.append(summary.to_dict())

with open("summary.json", "w", encoding="utf-8") as f:
    json.dump(result, f, ensure_ascii=False, indent=4)
print("\n集計結果を summary.json に出力しました")

# コマンドライン引数から目標金額を取得
if len(sys.argv) < 2:
    print("エラー: 目標金額を引数で指定してください(例: python main.py 15000)")
    exit(1)

target = int(sys.argv[1])

# 売上目標の判定
total_amount = 0
for summary in summaries.values():
    total_amount += summary.total_amount

print(f"\n売上合計: {total_amount}円(目標: {target}円)")

if total_amount >= target:
    print("目標達成です!")
elif total_amount >= target * 0.8:
    print(f"目標まであと一歩です(あと{target - total_amount}円)")
else:
    print(f"目標未達成です(あと{target - total_amount}円)")

追加したコードを解説します。

try:
    with open("sales.csv", "r", encoding="utf-8") as f:

tryブロックでopen()を囲むことで、ファイルが存在しない場合のエラーに備えています。

except FileNotFoundError:
    print("エラー: ファイル 'sales.csv' が見つかりません。")
    exit(1)

FileNotFoundErrorが発生した場合、日本語のエラーメッセージを表示し、exit(1)でプログラムを終了します。

if len(sales) == 0:
    print("エラー: 売上データが0件です。CSVファイルの内容を確認してください。")
    exit(1)

ファイルが存在してもデータが0件の場合は、その旨を表示して終了します。

3. 動作確認

ファイル名は先ほどsales_backup.csvに変更したままなので、そのままmain.pyを実行してみましょう。今度は以下のようにわかりやすいメッセージが表示されます。

エラー: ファイル 'sales.csv' が見つかりません。

先ほどの英語のエラーメッセージと比べて、何が起きたかがすぐにわかるようになりました。確認できたら、sales_backup.csvのファイル名をsales.csvに戻してください。

💡 ポイント
try/exceptを使うことで、プログラムがエラーで停止するのを防ぎ、ユーザにわかりやすいメッセージを表示できます。特にファイル操作では、ファイルが存在しないなどのエラーが起こりやすいため、エラーハンドリングを行うことが重要です。