エラーハンドリング
実際にツールを使う場面では、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を使うことで、プログラムがエラーで停止するのを防ぎ、ユーザにわかりやすいメッセージを表示できます。特にファイル操作では、ファイルが存在しないなどのエラーが起こりやすいため、エラーハンドリングを行うことが重要です。 |