売上データクラスの定義

CSVから読み込んだデータは辞書として扱えますが、ここでは前の章 Python関数とクラス で学んだクラスを使って売上データを管理します。クラスを使うことで、データの構造が明確になり、sale.dateのようにわかりやすい形でデータにアクセスできるようになります。

1. Saleクラスの作成

売上データを管理するSaleクラスを定義します。このクラスはmain.pyから読み込んで使うため、別ファイルとして作成します。Visual Studio Codeのエクスプローラーで右クリックし、「新しいファイル」を選択してmodels.pyという名前で作成してください。

sales-report/
├── sales.csv
├── models.py  ← このファイルを作成
└── main.py

models.pyに以下の内容を記述して保存します。

class Sale:
    def __init__(self, date, product, category, quantity, unit_price):
        self.date = date
        self.product = product
        self.category = category
        self.quantity = quantity
        self.unit_price = unit_price
        self.amount = quantity * unit_price

Saleクラスの__init__メソッドで、売上日、商品名、カテゴリ、数量、単価を属性として保持し、売上金額(amount)をquantity * unit_priceで自動的に計算しています。

2. main.pyの更新

次に、main.pyからSaleクラスを読み込んで使います。main.pyを以下の内容に書き換えて保存します。

import csv
from models import Sale

# 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)

# 読み込み結果の確認
for sale in sales:
    print(f"{sale.date} {sale.product}: {sale.quantity}個 × {sale.unit_price}円 = {sale.amount}円")

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

from models import Sale

この部分で、models.pyに定義したSaleクラスを読み込んでいます。これは前の章 Pythonライブラリ で学んだモジュールのインポートと同じ仕組みです。models.pyというファイル名から.pyを除いたmodelsがモジュール名になります。

for row in reader:

forループで、CSVの各行を1行ずつ処理します。rowには{"date": "2025-01-06", "product": "ノート", "category": "文房具", "quantity": "10", "unit_price": "200"}のような辞書が入ります。

    sale = Sale(
        date=row["date"],
        product=row["product"],
        category=row["category"],
        quantity=int(row["quantity"]),
        unit_price=int(row["unit_price"])
    )

辞書から値を取り出し、Saleクラスのインスタンスを作成しています。row["date"]のように、ヘッダ名をキーにして値を取り出せます。CSVから読み込んだ値はすべて文字列のため、数量と単価はint()で整数に変換してから渡しています。

    sales.append(sale)

作成したSaleインスタンスを、リストsalesに追加しています。このループが完了すると、CSVの全行分のSaleインスタンスがsalesリストに格納されます。

for sale in sales:
    print(f"{sale.date} {sale.product}: {sale.quantity}個 × {sale.unit_price}円 = {sale.amount}円")

最後に、salesリストに格納された各Saleインスタンスの属性をprintで出力し、正しく読み込めたかを確認しています。sale.amountはSaleクラスの__init__で自動計算された売上金額です。

main.pyを実行して動作を確認しましょう。以下のように各売上データが表示されます。

2025-01-06 ノート: 10個 × 200円 = 2000円
2025-01-06 ボールペン: 5個 × 150円 = 750円
2025-01-06 コーヒー: 8個 × 300円 = 2400円
2025-01-07 ノート: 3個 × 200円 = 600円
2025-01-07 お茶: 12個 × 150円 = 1800円
2025-01-07 コーヒー: 5個 × 300円 = 1500円
2025-01-08 消しゴム: 6個 × 100円 = 600円
2025-01-08 ボールペン: 15個 × 150円 = 2250円
2025-01-08 お茶: 10個 × 150円 = 1500円

sale.date、sale.product、sale.amountのように、属性名でデータにアクセスできています。