JSONファイルへの出力

集計結果をJSON形式のファイルに出力します。ただし、前の章で学んだjson.dump()は辞書やリストをJSONに変換できますが、CategorySummaryのようなクラスのインスタンスをそのまま渡すことはできません。そこで、インスタンスを辞書に変換するto_dict()メソッドを追加します。

1. to_dict()メソッドの追加

クラスのインスタンスを辞書に変換するメソッドの基本的な構文は以下のとおりです。

class クラス名:
    def to_dict(self):
        return {
            "キー1": self.属性1,
            "キー2": self.属性2,
        }

to_dict()メソッドは、インスタンスの属性を辞書にまとめて返します。これにより、json.dump()に渡せる形式に変換できます。

models.pyのCategorySummaryクラスにto_dict()メソッドを追加します。add()メソッドの下に以下のコードを追加してください。

class CategorySummary:
    def __init__(self, category):
        self.category = category
        self.total_quantity = 0
        self.total_amount = 0

    def add(self, sale):
        self.total_quantity += sale.quantity
        self.total_amount += sale.amount

    # ====== ↓ ここから追加 ======
    def to_dict(self):
        return {
            "category": self.category,
            "total_quantity": self.total_quantity,
            "total_amount": self.total_amount
        }
    # ====== ↑ ここまで追加 ======

追加したto_dict()メソッドを解説します。

    def to_dict(self):
        return {
            "category": self.category,
            "total_quantity": self.total_quantity,
            "total_amount": self.total_amount
        }

インスタンスの属性を辞書にまとめて返しています。例えば、文房具カテゴリのCategorySummaryでto_dict()を呼ぶと、{"category": "文房具", "total_quantity": 39, "total_amount": 6200}という辞書が返されます。この辞書をjson.dump()に渡すことで、JSON形式でファイルに出力できるようになります。

2. main.pyの更新

main.pyにJSON出力処理を追加します。インポート文にjsonを追加し、集計結果の表示の後にJSON出力のコードを追加してください。

import csv
import json  # ← 追加
from models import Sale, CategorySummary

# CSVファイルの読み込み
sales = []
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)

# カテゴリ別の集計
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 に出力しました")
# ====== ↑ ここまで追加 ======

追加したJSON出力部分を解説します。

result = []
for summary in summaries.values():
    result.append(summary.to_dict())

summaries辞書から各CategorySummaryインスタンスを取り出し、to_dict()で辞書に変換してリストにまとめています。この時点でresultは[{"category": "文房具", "total_quantity": 39, ...}, {"category": "飲料", ...}]のようなリストになります。

with open("summary.json", "w", encoding="utf-8") as f:
    json.dump(result, f, ensure_ascii=False, indent=4)

json.dump()は前の章で学んだとおり、Pythonのリストや辞書をJSON形式でファイルに書き出す関数です。ensure_ascii=Falseで日本語をそのまま出力し、indent=4で読みやすくインデントを付けています。

main.pyを実行して動作を確認しましょう。summary.jsonファイルが作成されるので、Visual Studio Codeのエクスプローラーからsummary.jsonを開いて内容を確認してください。以下のようなJSONが出力されていれば成功です。

[
    {
        "category": "文房具",
        "total_quantity": 39,
        "total_amount": 6200
    },
    {
        "category": "飲料",
        "total_quantity": 35,
        "total_amount": 7200
    }
]

カテゴリごとの販売個数と売上合計がJSON形式で出力されています。このJSONファイルは、他のプログラムやツールで読み込んで利用することができます。