CSVファイルの読み込み

自動化の起点となる売上データを、CSVから Python 上に読み込むところから始めます。まずはCSVを扱うための標準ライブラリと、そのなかで使う csv.DictReader() の役割を押さえます。

1. csvモジュールとは

Pythonの標準ライブラリには、CSVファイルの読み書きを行うためのcsvモジュールが用意されています。前の章 Python関数とクラス で学んだopen()とsplit()でもCSVを読み込むことはできますが、csvモジュールを使うことで、より安全で簡潔にCSVファイルを扱えます。

📝 csvモジュールについて
csvモジュールはPythonの標準ライブラリに含まれており、追加のインストールは不要です。CSVファイルの読み込みにはcsv.reader()とcsv.DictReader()の2つの方法がありますが、本章では列名でデータにアクセスできるcsv.DictReader()を使用します。

2. csv.DictReaderによる読み込み

csv.DictReader()は、CSVファイルの各行を辞書として読み込むクラスです。ヘッダ行の列名がキー、各データ行の値が値になります。基本的な構文は以下のとおりです。

import csv

with open("ファイル名", "r", encoding="utf-8") as f:
    reader = csv.DictReader(f)
    for row in reader:
        print(row["列名"])

csv.DictReader()にファイルオブジェクトを渡すと、ヘッダ行を自動的に読み取り、各データ行を辞書型のオブジェクトとして返します。row["列名"]のように列名をキーにして値にアクセスできます。

実際に試してみましょう。main.pyに以下の内容を記述して保存します。

import csv

with open("sales.csv", "r", encoding="utf-8") as f:
    reader = csv.DictReader(f)
    for row in reader:
        print(row)

Visual Studio Codeのメニューから「ターミナル」→「新しいターミナル」を選択してターミナルを開きます。以下のコマンドで、Python がインストールされていることを確認します。

Windowsの場合:

python --version

以下のように Python のバージョンが表示されれば、インストールは確認できています。

Python 3.x.x

Macの場合:

python3 --version

以下のように Python のバージョンが表示されれば、インストールは確認できています。

Python 3.x.x

バージョンが表示されない場合は、Pythonのインストール を先に実施してください。

インストールが確認できたら、main.pyを実行して動作を確認しましょう。

💡 ポイント
Pythonの実行コマンドは環境によって異なります。Windowsではpython main.py、macOSではpython3 main.pyを使用します。以降のハンズオンでは「main.pyを実行して」と記載しますので、お使いの環境に合わせてコマンドを読み替えてください。

以下のように各行が辞書として表示されれば成功です。

{'date': '2025-01-06', 'product': 'ノート', 'category': '文房具', 'quantity': '10', 'unit_price': '200'}
{'date': '2025-01-06', 'product': 'ボールペン', 'category': '文房具', 'quantity': '5', 'unit_price': '150'}
{'date': '2025-01-06', 'product': 'コーヒー', 'category': '飲料', 'quantity': '8', 'unit_price': '300'}
{'date': '2025-01-07', 'product': 'ノート', 'category': '文房具', 'quantity': '3', 'unit_price': '200'}
{'date': '2025-01-07', 'product': 'お茶', 'category': '飲料', 'quantity': '12', 'unit_price': '150'}
{'date': '2025-01-07', 'product': 'コーヒー', 'category': '飲料', 'quantity': '5', 'unit_price': '300'}
{'date': '2025-01-08', 'product': '消しゴム', 'category': '文房具', 'quantity': '6', 'unit_price': '100'}
{'date': '2025-01-08', 'product': 'ボールペン', 'category': '文房具', 'quantity': '15', 'unit_price': '150'}
{'date': '2025-01-08', 'product': 'お茶', 'category': '飲料', 'quantity': '10', 'unit_price': '150'}

CSVファイルの1行目(date,product,category,quantity,unit_price)がキーとして使われ、2行目以降の各データ行が辞書に変換されていることが確認できます。

💡 ポイント
CSVから読み込んだ値は、数値であってもすべて文字列型になります。上の出力で'quantity': '10'のように数値が引用符で囲まれていることからもわかります。計算に使う場合はint()やfloat()で型変換が必要です。