標準ライブラリの使用

ここまでは自分で作成したファイルを読み込む方法を学びました。Pythonには、日付操作やJSON処理など、すぐに使える豊富な標準ライブラリが用意されています。標準ライブラリは自分でインストールする必要がなく、同じ import 文で読み込んですぐに使うことができます。たとえば import os と書くだけで、OS情報の取得やファイルパスの操作などの機能が利用できるようになります。

ここからは、実務でよく使われる代表的な標準ライブラリのモジュールを紹介します。

1. OS操作(osモジュール)

osは、OS(オペレーティングシステム)の機能にアクセスするための標準ライブラリのモジュールです。ファイルやディレクトリの操作、パスの処理、環境変数の取得など、システム管理やインフラ運用で頻繁に使用します。import os で読み込んで使います。

1.1 os.getcwd()(カレントディレクトリの取得)

os.getcwd()

os.getcwd() は引数を取らず、現在の作業ディレクトリ(カレントディレクトリ)のパスを文字列(str)で返します。

main.py に以下の内容を記述して実行してみましょう。

import os

current_dir = os.getcwd()
print(f"カレントディレクトリ: {current_dir}")

実行すると以下のように出力されます(パスは実行環境によって異なります)。

カレントディレクトリ: /Users/username/my_project

os.getcwd() が現在の作業ディレクトリのパスを返し、f-stringで整形して表示しています。パスの値は実行環境によって異なります。

1.2 os.listdir()(ディレクトリ内の一覧取得)

os.listdir(パス)

os.listdir() は引数にディレクトリのパス(str)を1つ受け取り、そのディレクトリ内のファイル名とフォルダ名をリスト(list)で返します。引数を省略するとカレントディレクトリの一覧を返します。

import os

files = os.listdir(".")
print(f"ファイル一覧: {files}")

実行すると以下のように出力されます(内容は実行環境によって異なります)。

ファイル一覧: ['main.py', 'models', 'data.json']

os.listdir(".") がカレントディレクトリ内のファイル名とフォルダ名をリストで返しています。main.py(ファイル)、models(フォルダ)、data.json(ファイル)がリストの要素として表示されています。

📝 . とは
"." はカレントディレクトリ(現在の作業ディレクトリ)を意味します。".." は1つ上の親ディレクトリを意味します。これらはPythonに限らず、OS全般で使われる表記です。

1.3 os.path.join()(パスの結合)

os.path.join(パス1, パス2, ...)

os.path.join() は引数に複数のパス文字列を受け取り、OSに適した区切り文字(Linuxでは /、Windowsでは \)で結合した文字列(str)を返します。文字列の + で直接パスを結合するとOSごとの違いが問題になりますが、os.path.join() を使えばどのOSでも正しいパスを生成できます。

import os

path = os.path.join("models", "person.py")
print(f"結合したパス: {path}")

data_path = os.path.join("/Users", "username", "my_project", "data.json")
print(f"絶対パス: {data_path}")

実行すると以下のように出力されます。

結合したパス: models/person.py
絶対パス: /Users/username/my_project/data.json

os.path.join() が引数のパス文字列をOSに適した区切り文字 / で結合しています。1つ目は相対パス同士、2つ目は絶対パスの各要素を結合した例です。

1.4 os.path.exists()(パスの存在確認)

os.path.exists(パス)

os.path.exists() は引数にファイルまたはディレクトリのパス(str)を1つ受け取り、そのパスが存在するかどうかを True または False で返します。

import os

print(os.path.exists("main.py"))
print(os.path.exists("not_found.txt"))
print(os.path.exists("models"))

実行すると以下のように出力されます。

True
False
True

main.py は存在するため True、not_found.txt は存在しないため False、models はディレクトリとして存在するため True が返されています。

💡 ポイント
os.path.isfile() はファイルかどうか、os.path.isdir() はディレクトリかどうかを判定します。os.path.exists() はファイルでもディレクトリでも存在すれば True を返します。

1.5 os.environ(環境変数の取得)

os.environ[キー名]
os.environ.get(キー名, デフォルト値)

os.environ はOSの環境変数を辞書のように扱えるオブジェクトです。os.environ[キー名] でキーを指定して値を取得できます。キーが存在しない場合はエラー(KeyError)が発生するため、os.environ.get() を使うとデフォルト値を指定できて安全です。

import os

# PATH環境変数を取得
path = os.environ.get("PATH", "未設定")
print(f"PATH: {path}")

# 存在しない環境変数はデフォルト値を返す
db_host = os.environ.get("DB_HOST", "localhost")
print(f"DB_HOST: {db_host}")

実行すると以下のように出力されます(PATH の値は実行環境によって異なります)。

PATH: /usr/local/bin:/usr/bin:/bin
DB_HOST: localhost

PATH 環境変数はOSに設定されているため、その値が表示されています。DB_HOST は環境変数として存在しないため、os.environ.get() の第2引数で指定したデフォルト値 "localhost" が返されています。

📝 環境変数とは
環境変数は、OS上で動作するプログラムに設定値を渡すための仕組みです。データベースの接続先やAPIキーなど、環境ごとに異なる値をコードに直接書かずに管理できます。サーバの運用やアプリケーションのデプロイで頻繁に使われる重要な概念です。

1.6 主要なos操作まとめ

関数 説明 例
os.getcwd() カレントディレクトリを取得 os.getcwd() → "/Users/username"
os.listdir() ディレクトリ内の一覧を取得 os.listdir(".") → ["main.py", ...]
os.path.join() パスを結合 os.path.join("a", "b.py") → "a/b.py"
os.path.exists() パスの存在確認 os.path.exists("main.py") → True
os.environ.get() 環境変数を取得 os.environ.get("HOME") → "/Users/username"

2. 日付・時刻操作(datetimeモジュール)

datetimeは、日付と時刻を扱うための標準ライブラリのモジュールです。データの記録やスケジュール管理などで使用します。from datetime import datetime で読み込んで使います。

2.1 datetime.now()(現在日時の取得)

datetime.now()

datetime.now() は引数を取らず、現在の日付と時刻を datetime オブジェクトとして返します。datetime オブジェクトには year、month、day、hour、minute、second などの属性があり、それぞれの値を取り出すことができます。

main.py に以下の内容を記述して実行してみましょう。

from datetime import datetime

now = datetime.now()
print(f"現在日時: {now}")
print(f"年: {now.year}")
print(f"月: {now.month}")
print(f"日: {now.day}")

実行すると以下のように出力されます(日時は実行時の値になります)。

現在日時: 2025-01-15 14:30:00.123456
年: 2025
月: 1
日: 15

datetime.now() が現在の日時を datetime オブジェクトとして返し、そのまま表示すると 年-月-日 時:分:秒.マイクロ秒 の形式になります。.year、.month、.day で個々の値を取り出せています。

2.2 strftime()(日時を文字列に変換)

datetimeオブジェクト.strftime(フォーマット文字列)

strftime() は引数にフォーマット文字列(str)を1つ受け取り、指定した形式で整形した文字列(str)を返します。フォーマット文字列の中で %Y や %m などの指定子を使って、表示形式を指定します。

from datetime import datetime

now = datetime.now()
print(f"日付: {now.strftime('%Y-%m-%d')}")
print(f"時刻: {now.strftime('%H:%M:%S')}")
print(f"整形: {now.strftime('%Y/%m/%d %H:%M:%S')}")

実行すると以下のように出力されます(日時は実行時の値になります)。

日付: 2025-01-15
時刻: 14:30:00
整形: 2025/01/15 14:30:00

strftime() がフォーマット文字列に従って日時を文字列に変換しています。%Y-%m-%d で「年-月-日」、%H:%M:%S で「時:分:秒」、%Y/%m/%d %H:%M:%S で「年/月/日 時:分:秒」の形式にそれぞれ整形されています。

主要なフォーマット指定子の一覧です。

指定子 意味 例
%Y 西暦4桁 2025
%m 月(ゼロ埋め) 01
%d 日(ゼロ埋め) 15
%H 時(24時間) 14
%M 分 30
%S 秒 00

2.3 strptime()(文字列を日時に変換)

datetime.strptime(日付文字列, フォーマット文字列)

strptime() は第1引数に日付を表す文字列、第2引数にその文字列の形式を指定するフォーマット文字列を受け取り、datetime オブジェクトを返します。外部から取得した日付データを扱う際に使います。

from datetime import datetime

date_str = "2025-01-15 10:30:00"
date_obj = datetime.strptime(date_str, "%Y-%m-%d %H:%M:%S")

print(f"年: {date_obj.year}")
print(f"月: {date_obj.month}")
print(f"日: {date_obj.day}")

実行すると以下のように出力されます。

年: 2025
月: 1
日: 15

strptime() が文字列 "2025-01-15 10:30:00" をフォーマット "%Y-%m-%d %H:%M:%S" に従って解析し、datetime オブジェクトに変換しています。変換後のオブジェクトから .year、.month、.day でそれぞれの値を取り出せています。

📝 strftime と strptime の違い
strftime() は日時オブジェクトを文字列に変換します(format の f)。strptime() は文字列を日時オブジェクトに変換します(parse の p)。データの出力時に strftime() を使い、データの読み込み時に strptime() を使う場面が多いです。

2.4 timedelta(日付の計算)

timedelta(days=日数, hours=時間数)

timedelta は from datetime import timedelta で読み込みます。引数に days(日数)や hours(時間数)などを指定して、時間の差分を表すオブジェクトを作成します。datetime オブジェクトに + や - で加減算することで、未来や過去の日時を求められます。

from datetime import datetime, timedelta

now = datetime.now()

one_day_later = now + timedelta(days=1)
print(f"1日後: {one_day_later.strftime('%Y-%m-%d')}")

three_days_ago = now - timedelta(days=3)
print(f"3日前: {three_days_ago.strftime('%Y-%m-%d')}")

two_hours_later = now + timedelta(hours=2)
print(f"2時間後: {two_hours_later.strftime('%Y-%m-%d %H:%M:%S')}")

実行すると以下のように出力されます(日時は実行時の値になります)。

1日後: 2025-01-16
3日前: 2025-01-12
2時間後: 2025-01-15 16:30:00

timedelta(days=1) を加算して翌日の日付、timedelta(days=3) を減算して3日前の日付、timedelta(hours=2) を加算して2時間後の日時がそれぞれ計算されています。strftime() で見やすい形式に整形して表示しています。

3. JSONの扱い(jsonモジュール)

JSON(JavaScript Object Notation)は、データを交換するための軽量なテキストフォーマットです。APIの応答や設定ファイルなど、さまざまな場面で使われています。JSONの構造はPythonの辞書やリストとよく似ており、Pythonでは標準ライブラリの json モジュールを使って簡単に変換できます。import json で読み込んで使います。

3.1 json.loads()(JSON文字列 → Python辞書)

json.loads(JSON文字列)

json.loads() は引数にJSON形式の文字列(str)を1つ受け取り、Pythonの辞書(dict)やリスト(list)に変換して返します。

main.py に以下の内容を記述して実行してみましょう。

import json

json_string = '{"name": "田中太郎", "age": 18, "grade": 3}'

student = json.loads(json_string)

print(student)
print(student["name"])

実行すると以下のように出力されます。

{'name': '田中太郎', 'age': 18, 'grade': 3}
田中太郎

json.loads() によってJSON文字列がPythonの辞書に変換され、通常の辞書と同じようにキーを指定して値にアクセスできます。

3.2 json.dumps()(Python辞書 → JSON文字列)

json.dumps(辞書またはリスト, ensure_ascii=False)

json.dumps() は第1引数にPythonの辞書やリストを受け取り、JSON形式の文字列(str)に変換して返します。ensure_ascii=False を指定すると日本語がそのまま出力されます。指定しない場合、日本語は \uXXXX のようなエスケープ文字に変換されます。

import json

student = {
    "name": "田中太郎",
    "age": 18,
    "grade": 3
}

json_string = json.dumps(student, ensure_ascii=False)
print(json_string)

実行すると以下のように出力されます。

{"name": "田中太郎", "age": 18, "grade": 3}

json.dumps() がPythonの辞書をJSON形式の文字列に変換しています。ensure_ascii=False を指定しているため、日本語がそのまま表示されています。

3.3 json.load()(JSONファイル → Python辞書)

json.load(ファイルオブジェクト)

json.load() は引数に open() で開いたファイルオブジェクトを1つ受け取り、JSONファイルの内容をPythonの辞書やリストに変換して返します。

まず、読み込み用のJSONファイルを作成します。my_projectフォルダ内にdata.jsonという名前でファイルを作成してください。

my_project/
├── main.py
└── data.json  ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。

{
    "name": "田中太郎",
    "age": 18,
    "grade": 3,
    "subjects": ["数学", "英語", "国語"]
}

次に、main.py に以下の内容を記述して実行してみましょう。

import json

with open("data.json", "r", encoding="utf-8") as f:
    student = json.load(f)

print(student["name"])
print(student["subjects"])

実行すると以下のように出力されます。

田中太郎
['数学', '英語', '国語']

json.load() がJSONファイルの内容をPythonの辞書に変換しています。変換後は通常の辞書と同じようにキーを指定して値にアクセスでき、student["name"] で文字列、student["subjects"] でリストが取得できています。

3.4 json.dump()(Python辞書 → JSONファイル)

json.dump(辞書またはリスト, ファイルオブジェクト, ensure_ascii=False, indent=4)

json.dump() は第1引数にPythonの辞書やリスト、第2引数に書き込み先のファイルオブジェクトを受け取り、JSON形式でファイルに書き出します。indent を指定すると、読みやすいようにインデント付きで整形されます。戻り値はありません。

import json

student = {
    "name": "田中太郎",
    "age": 18,
    "grade": 3,
    "subjects": ["数学", "英語", "国語"]
}

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

print("output.json に保存しました")

実行すると output.json が作成されます。ファイルを開くと以下のような内容が書き込まれています。

{
    "name": "田中太郎",
    "age": 18,
    "grade": 3,
    "subjects": [
        "数学",
        "英語",
        "国語"
    ]
}

json.dump() がPythonの辞書をJSON形式でファイルに書き出しています。indent=4 を指定しているため、4スペースのインデント付きで読みやすく整形されています。ensure_ascii=False により日本語もそのまま出力されています。

💡 ポイント
json.loads() / json.dumps() は文字列との変換、json.load() / json.dump() はファイルとの変換です。末尾に s が付くかどうかで区別できます(s は string の略です)。