階層が異なるモジュールの呼び出し方法

2023年10月13日

Pythonでは、異なる階層にあるモジュールを呼び出す際に、モジュールのパスを適切に設定する必要があります。以下に、異なる階層にあるモジュールを呼び出す方法を説明します。

例えば、以下のようなディレクトリ構造を考えましょう:

markdown
my_project/
    ├── main_script.py
    └── my_package/
        ├── sub_package/
        │   └── my_module.py
        └── __init__.py

my_project フォルダ内には main_script.py というPythonスクリプトがあり、このスクリプトから my_module.py を呼び出す方法を説明します。

1. モジュールのパスを追加する:

main_script.py で my_module.py を呼び出す前に、Pythonに対してモジュールのパスを追加する必要があります。これを行う方法の一つは、sys.path リストにモジュールのディレクトリを追加することです。

python
import sys
sys.path.append("パス/ツー/my_package/sub_package")  # my_module.py のあるディレクトリを追加

2. モジュールをインポートする:

my_module.py をインポートすることができるようになります。以下は main_script.py のコード例です。

python
from my_package.sub_package import my_module

my_module.my_function()  # my_module.py 内の関数を呼び出す

この方法により、異なる階層にあるモジュールを呼び出すことができます。ただし、モジュールのパスを明示的に指定する必要がある点に注意してください。また、モジュールが別のPythonパッケージ内にある場合、__init__.py ファイルがそれぞれのパッケージ内に存在する必要があります。