モジュールの利用

プログラムが大きくなると、すべてのコードを1つのファイルに書き続けるのは現実的ではありません。Pythonでは、コードを複数のファイルに分割して管理できます。

1. ファイルの分割

プログラムが大きくなると、すべてのコードを1つのファイルに書き続けるのは現実的ではありません。Pythonでは、コードを複数のファイルに分割して管理できます。Pythonのコードが記述されたファイル(.py ファイル)のことをモジュールと呼びます。機能ごとにファイルを分けることで、コードの見通しがよくなり、一度書いた機能を複数のプログラムから再利用できるようになります。

2. import文

別のファイルに書かれたコードを読み込むにはimport文を使います。import文の書き方にはいくつかの種類がありますが、まずは基本となる import から学んでいきます。

📝 モジュール名について
import で指定するモジュール名は、ファイル名から .py を除いたものです。たとえば person.py というファイルを読み込む場合、モジュール名は person になります。

import を使うと、モジュール全体を読み込むことができます。

import モジュール名

この書き方で読み込んだ場合、使用時は モジュール名.クラス名() や モジュール名.関数名() のようにモジュール名を付けて呼び出します。

実際に試してみましょう。まず、任意の場所にmy_projectフォルダを作成します。

my_project/  ← このフォルダを作成

作成したフォルダをVisual Studio Codeで開きます。Visual Studio Codeのメニューから「ファイル」→「フォルダーを開く」を選択し、作成したフォルダを開いてください。

前の章 Python関数とクラス で作成した人物クラスを別ファイルに切り出します。Visual Studio Codeのエクスプローラーで右クリックし、「新しいファイル」を選択してperson.pyという名前で作成してください。

my_project/
└── person.py  ← このファイルを作成

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

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age

    def greet(self):
        return f"こんにちは、{self.name}です"

    def is_adult(self):
        return self.age >= 18

次に、person.pyを読み込んで使用するファイルを作成します。my_projectフォルダ内にmain.pyという名前でファイルを作成します。

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

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

import person

p = person.Person("田中太郎", 25)
print(p.greet())
print(f"成人かどうか: {p.is_adult()}")

以下のコマンドで、Python がインストールされていることを確認します。

Windowsの場合:

python --version

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

Python 3.x.x

Macの場合:

python3 --version

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

Python 3.x.x

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

インストールが確認できたら、ターミナルでmain.pyを実行します。

python main.py

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

こんにちは、田中太郎です
成人かどうか: True

import person でモジュール全体を読み込み、person.Person(...) のようにモジュール名を付けてクラスにアクセスしています。

3. from...import文

from...import を使うと、モジュールの中から特定のクラスや関数だけを読み込むことができます。

from モジュール名 import クラス名や関数名

この書き方で読み込んだ場合、モジュール名を付けずに直接名前を使えるため、コードが簡潔になります。

先ほどのmain.pyの内容を以下に書き換えて実行してみましょう。

from person import Person

person1 = Person("田中太郎", 25)
print(person1.greet())
print(f"成人かどうか: {person1.is_adult()}")

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

こんにちは、田中太郎です
成人かどうか: True

from person import Person と書くことで、Person を直接使えるようになりました。import person の場合は person.Person(...) とモジュール名を付ける必要がありましたが、from...import では Person(...) だけで済みます。

💡 ポイント
import と from...import のどちらを使うかは状況によりますが、特定のクラスや関数だけを使う場合は from...import の方がコードが読みやすくなります。

4. import as(別名を付ける)

as を使うと、モジュールに別名を付けて読み込むことができます。モジュール名が長い場合や、コード中で何度も使う場合に便利です。

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

import person as ps

p = ps.Person("田中太郎", 25)
print(p.greet())

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

こんにちは、田中太郎です

import person as ps と書くことで、person モジュールを ps という短い名前で使えるようになりました。

5. importの使い分け

ここまで学んだ3つのimportの書き方をまとめます。

書き方 用途 例
import モジュール名 モジュール全体を読み込む import person
from モジュール名 import 名前 特定の機能だけを読み込む from person import Person
import モジュール名 as 別名 別名を付けて読み込む import person as ps
💡 ポイント
from モジュール import * のようにワイルドカードで全てを読み込む書き方は推奨されません。名前の衝突が起きやすく、コードの可読性が下がります。必要な機能だけを明示的に読み込むようにしましょう。

6. if __name__ == "__main__" とは

モジュールを import で読み込むと、そのファイル内のコードが上から順番に実行されます。関数やクラスの定義だけであれば問題ありませんが、print() などの実行コードが書かれていると、読み込んだだけで意図せず実行されてしまいます。

if __name__ == "__main__":
    # このファイルが直接実行されたときだけ動く処理

if __name__ == "__main__": は、そのファイルが直接実行されたときだけ処理を実行し、import されたときは実行しないようにするための記述です。Pythonでは、直接実行されたファイルの __name__ 変数には自動的に "__main__" という値が設定され、import された場合はモジュール名が設定されます。

実際に試してみましょう。person.py を以下の内容に書き換えて保存します。

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age

    def greet(self):
        return f"こんにちは、{self.name}です"

if __name__ == "__main__":
    p = Person("田中太郎", 25)
    print(p.greet())

ターミナルで person.py を直接実行します。

python person.py

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

こんにちは、田中太郎です

person.py を直接実行しているため __name__ は "__main__" となり、if ブロック内の処理が実行されています。一方、main.py から import person で読み込んだ場合は、Person クラスの定義だけが読み込まれ、if ブロック内の print() は実行されません。

💡 ポイント
if __name__ == "__main__": は、関数やクラスの定義と実行部分を分離するために使われます。これにより、ファイルを「直接実行するスクリプト」としても「他のファイルから読み込むモジュール」としても使えるようになります。