PythonのTypeError: 'module' object is not callableエラーの原因と解決方法

Pythonのモジュールは、特に自分で定義する場合には混乱しやすいものです。「TypeError: 'module' object is not callable」は、Python開発者がクラスやモジュールを扱う際によく遭遇するエラーの一つです。

この記事では、このエラーの意味と発生理由を解説し、実際のサンプルコードを通じて解決方法をわかりやすく紹介します。

エラーの内容：TypeError: 'module' object is not callable

拡張子が「.py」で終わるPythonファイルは、すべてモジュールとして扱われます。

モジュールは、関数・変数・クラスをメインプログラムの外で定義できるため、Pythonにおいて非常に重要な役割を果たします。これにより、コードを複数のファイルに分割し、目的ごとに整理して管理することが可能になります。

ただし、モジュールは正しい方法でインポート・呼び出しする必要があります。誤った使い方をすると、Pythonは次のエラーを返します。

TypeError: 'module' object is not callable

このエラーは、モジュールを関数のように呼び出そうとしたときに発生します。

エラーが発生する例

まず、「cakes」というモジュールを定義してみましょう。このモジュールには、テキストファイルの内容を読み取る read_file 関数が1つ含まれています。

モジュール名はファイル名によって決まります。モジュール名を「cakes」にしたいので、コードは cakes.py というファイルに記述します。

def read_file():
    all_cakes = []
    with open("cakes.txt", "r") as cake_file:
        cake_list = cake_file.readlines()
        for c in cake_list:
            all_cakes.append(c.replace("\n", ""))

    return all_cakes

この関数は「cakes.txt」というファイルの内容を読み込み、ファイル内の各行を順番に処理して、「all_cakes」というリストに追加していきます。

replace() メソッドは、改行文字（"\n"）を空文字に置き換えるために使われており、これにより余分な改行が取り除かれます。最後に、関数は「all_cakes」を返します。

次に、app.py というファイルを作成し、以下のコードを貼り付けてください。

import cakes

cake_list = cakes()
print(cake_list)

このコードは「cakes」モジュールを使って「cakes.txt」の内容を読み取り、見つかったケーキのリストを出力することを意図しています。

しかし、実行すると次のようなエラーが発生します。

Traceback (most recent call last):
  File "main.py", line 3, in <module>
    cakes = cakes()
TypeError: 'module' object is not callable

コードがエラーを返してしまいました。

解決方法

まず、app.py のimport文を確認してみましょう。

import cakes

ここでは「cakes」モジュールをインポートしています。これにより、「cakes.py」ファイル内で宣言されたすべての変数・クラス・関数が利用可能になります。

次に、問題となっている行を見てみましょう。

cake_list = cakes()

「cakes」モジュールには関数が1つしか含まれていませんが、コード上ではどの関数を呼び出したいのかが指定されていません。Pythonはモジュール名と関数名を区別できないため、何を実行すればよいのか判断できず、このエラーが発生します。

このエラーを解決するには、モジュール自体ではなく、呼び出したい関数の名前を明示的に指定します。

import cakes

cake_list = cakes.read_file()
print(cake_list)

もう一度コードを実行してみましょう。

['Cinnamon Babka', 'Chocolate Cupcake']

今度はケーキのリストが正常に出力されました。

app.py では cakes.read_file() を呼び出しています。Pythonは「cakes」モジュールが格納されている「cakes.py」ファイルを参照し、その中の read_file() 関数を見つけて実行します。

その結果は「cake_list」という変数に代入され、コンソールに出力されます。

関数を直接インポートする方法

別の解決策として、必要な関数だけを直接インポートすることもできます。

from cakes import read_file

cake_list = read_file()
print(cake_list)

実行結果：

['Cinnamon Babka', 'Chocolate Cupcake']

先ほどの例では「cakes」モジュール全体をインポートしましたが、今回は「cakes」モジュールから read_file という1つの関数だけをインポートしています。

この方法を使うと、cakes.read_file() と書く必要がなく、直接 read_file() と呼び出せる点に注目してください。これは、関数をコード内に直接取り込んでいるためです。

まとめ

Pythonモジュールのコードは別ファイルに存在しており、モジュールから関数や値をインポートする方法はいくつかあります。そのため、書き方を間違えやすいポイントでもあります。

モジュールを扱う際は、アクセスしたい関数・クラス・変数を正しく参照することが大切です。関数を呼び出したい場合は、モジュール自体を呼び出すのではなく、「モジュール名.関数名」の形式で、または from モジュール import 関数 の形式で、対象の関数を明確に指定しましょう。

これで、あなたもプロの開発者のように、このPythonのTypeErrorを自信を持って解決できるはずです！