Pythonのモジュールは、コードの再利用性と管理性を高めるための仕組みです。外部ライブラリや自作の関数・クラスを別ファイルにまとめ、必要に応じて読み込んで利用できます。ここでは、Pythonモジュールの基本的な使い方、実践的な活用方法を解説します。
1. モジュールのインポート
Pythonでモジュールを利用するには、まずモジュールをインポートする必要があります。モジュールのインポート方法は主に以下の3つです。
| 方法 | 説明 | 例 |
|---|---|---|
import モジュール名 |
モジュール全体をインポートする | import math |
from モジュール名 import 要素 |
モジュール内の特定の関数やクラスなどをインポートする | from math import sqrt |
import モジュール名 as 別名 |
モジュールに別名をつけてインポートする | import numpy as np |
補足
- Pythonの標準ライブラリはPythonインストール時に自動的にインストールされるため、追加のインストール作業は不要です。
- 外部ライブラリは
pipなどのパッケージ管理ツールを用いてインストールします。（例:pip install numpyなど）
2. モジュールの利用方法
インポートしたモジュールは、以下のように利用します。
2.1. モジュール内の関数を利用する
# mathモジュール全体をインポート import math # mathモジュールのsqrt関数（平方根を計算する関数）を利用 result = math.sqrt(16) # 16の平方根を計算 print(result) # 結果: 4.0
2.2 モジュール内の特定の関数をインポート
# mathモジュールからsqrt関数のみをインポート from math import sqrt # モジュール名を省略してsqrt関数を利用可能 result = sqrt(25) # 25の平方根を計算 print(result) # 結果: 5.0
2.3. モジュール内のクラスを利用する
# datetimeモジュールからdatetimeクラスをインポート from datetime import datetime # datetimeクラスのnowメソッド（現在時刻を取得するメソッド）を利用 now = datetime.now() print(now) # 現在の日時と時刻を表示
3. 自作モジュールの利用
自分で作成したPythonファイル（.py）もモジュールとして利用できます。
コード例
my_module.py というファイルを作成し、以下のコードを記述。
# my_module.py def my_add(x, y): """2つの数値の和を返す関数""" return x + y MY_CONSTANT = 10
- 別のPythonファイルから
my_module.pyをインポートして利用。
# main.py import my_module # my_module内の関数を利用 result = my_module.my_add(3, 5) print(result) # 結果: 8 #my_module内の定数を利用 print(my_module.MY_CONSTANT) # 結果:10
モジュールの配置について
- 自作モジュールは、利用するファイルと同じディレクトリに配置するのが最も簡単です。
- 異なるディレクトリに配置する場合は、環境変数
PYTHONPATHにモジュールのディレクトリを追加するか、sys.pathにモジュールのディレクトリを一時的に追加する（例:sys.path.append('/path/to/your/module')）必要があります。
4. モジュールのドキュメント
モジュールの機能や使い方を調べるには、公式ドキュメントを参照するか、help() 関数を利用します。
import math # mathモジュールのドキュメントを表示 help(math) # 特定の関数（例：math.sqrt）のドキュメントを表示 help(math.sqrt)
上記を実行すると詳細なドキュメントが表示されます
