売上データクラスの定義
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のように、属性名でデータにアクセスできています。