【Python】同じディレクトリの__init__を使うとcircular importになる

事象

同じディレクトリDに

D
┠ __init__.py
┠ M1.py
┗ M2.py

の3ファイルがあるとしましょう。
それぞれが以下のスクリプト記述がされているとします。

__init__.py

from D.M1 import f1
from D.M2 import f2

M1.py

from D import f2

def f1():
    print("f1")
    f2()

M2.py

def f2():
    print("f2")

ここで、外からD.M1をimportするとcircular importエラーが発生します。

原因

M1とM2モジュールは、M1→M2の一方通行依存関係なので、機能的には循環参照にはなっていません。

しかし、

M1.py

from D import f2

の部分で、M1は__init__.pyをimportしています。
そして、__init__.pyがM1.pyをimportしているため、綺麗にcircular importになるわけです。

対策

同じディレクトリのモジュールを参照するときは、丁寧にそのファイルを指定してモジュールを呼びましょう

このように修正します。

M1.py

-from D import f2
+from D.M2 import f2

def f1():
    print("f1")
    f2()

また、モジュールに依存関係があるときは、同じディレクトリに配置するのではなく、ディレクトリを作って下位モジュールであると明示するのがモジュール設計的には綺麗だと思います。