モジュールとパッケージ

コードが大きくなるにつれて、すべてを 1 つのファイルに入れるのは賢明ではありません。モジュールを使うとコードを複数のファイルに分割でき、パッケージを使うと関連するモジュールを一緒に整理できます。モジュラープログラミングを学ぶことは、真の「エンジニアリング」への入り口です。

1. モジュールとは

Python では、.py ファイルがモジュールです。import を使って他のモジュールの機能を取り込めます：

例：標準ライブラリモジュールのインポート

# モジュール全体をインポート
import math
print(math.pi)              # 3.141592653589793
print(math.sqrt(16))        # 4.0

# 特定の関数をインポート
from random import randint
print(randint(1, 10))       # 1 から 10 の間のランダムな整数

# 複数のアイテムをインポート
from datetime import datetime, timedelta
now = datetime.now()
print(now)                  # 現在時刻

Python には標準ライブラリモジュールの大規模なコレクションが付属しています——math、random、datetime、os、json……これらは Python をインストールした時点で既に存在し、import するだけで使えます。

2. カスタムモジュール

モジュールの作成は簡単です——.py ファイルを書くだけです。

my_tools.py

# これはカスタムモジュール：my_tools.py

def greet(name):
    return f"Hello, {name}"

def add(a, b):
    return a + b

PI = 3.14159

main.py（モジュールを使用）

例：カスタムモジュールのインポートと使用

# カスタムモジュールをインポート
import my_tools

print(my_tools.greet("Zhang San"))   # Hello, Zhang San
print(my_tools.add(5, 3))            # 8
print(my_tools.PI)                   # 3.14159

3. if __name__ == "__main__"

これは非常に重要な Python のパターンです——ファイルをインポート可能なモジュールとしても、直接実行可能なスクリプトとしても機能させます：

例：if name の二重目的パターン

# calculator.py
def add(a, b):
    return a + b

def subtract(a, b):
    return a - b

# 以下のコードは、このファイルが直接実行された場合のみ実行
if __name__ == "__main__":
    print("Testing calculator functions:")
    print(f"3 + 5 = {add(3, 5)}")
    print(f"10 - 4 = {subtract(10, 4)}")

この場合：

• python calculator.py と実行 → テストコードが実行される（__name__ == "__main__" が True）
• 別のファイルで import calculator とする → テストコードは実行されない（__name__ は "calculator"）

4. パッケージ

多数のモジュールがある場合は、パッケージを使って整理します——パッケージは __init__.py ファイルを含むディレクトリです：

my_package/
├── __init__.py      ← このファイルが必要（空でも可）
├── math_tools.py
└── string_tools.py

# math_tools.py
def multiply(a, b):
    return a * b

def divide(a, b):
    if b == 0:
        return "Cannot divide by zero"
    return a / b

# string_tools.py
def reverse(text):
    return text[::-1]

def count_vowels(text):
    vowels = "aeiouAEIOU"
    return sum(1 for c in text if c in vowels)

例：パッケージからのモジュール使用

# パッケージを使用
from my_package import math_tools, string_tools

print(math_tools.multiply(3, 5))           # 15
print(string_tools.reverse("Python"))      # nohtyP

5. サードパーティライブラリと pip

Python の力は、豊富なサードパーティライブラリのエコシステムから来ています。pip でインストールします：

pip install requests          # HTTP リクエストライブラリ
pip install numpy             # 数値計算
pip install pandas            # データ分析
pip install flask             # Web フレームワーク

requirements.txt

プロジェクトを他の人と共有するときは、どのサードパーティライブラリが必要かを伝える必要があります。requirements.txt がその目的です：

requests==2.31.0
numpy==1.24.0
pandas==2.0.0
flask==3.0.0

受け取った側は 1 つのコマンドですべての依存関係をインストールできます：

pip install -r requirements.txt

requirements.txt の生成

pip freeze > requirements.txt

よくあるユースケース

• コードの再利用：ユーティリティ関数を別のモジュールに抽出し、複数のプロジェクトで共有
• プロジェクト構成：パッケージを使って機能別に整理（例：models/、utils/、views/）
• 依存関係管理：requirements.txt でサードパーティライブラリのバージョンを管理
• 二重目的スクリプト：if __name__ == "__main__" でファイルをインポート可能かつ直接実行可能に

❓ よくある質問

📖 まとめ

• .py ファイルがモジュール。import で使用
• from module import name で特定のアイテムのみインポート
• if __name__ == "__main__" でファイルをモジュールとスクリプトの両方として機能させる
• パッケージは __init__.py を含むディレクトリで、複数モジュールを整理
• pip install package_name でサードパーティライブラリをインストール
• requirements.txt でプロジェクトの依存関係を記録。pip install -r requirements.txt で一括インストール

📝 練習問題

1. 初級（難易度 ⭐）：モジュール geometry.py を作成し、2 つの関数 circle_area(radius) と rectangle_area(width, height) を含めてください。その後、別のファイルでインポートして使用します。

2. 中級（難易度 ⭐⭐）：geometry.py に if __name__ == "__main__" ブロックを追加し、関数をテストしてください。直接実行するとテストが実行され、インポートするとスキップされることを確認します。

3. 上級（難易度 ⭐⭐⭐）：パッケージ string_utils/ を作成し、2 つのモジュール validators.py（検証関数：is_email()、is_phone()）と transformers.py（変換関数：to_snake_case()、to_camel_case()）を含めます。パッケージの外にテストスクリプトを作成し、これらの機能をインポートして使用します。