Pythonの組み込み属性「__name__」とは？役割と使い方をわかりやすく解説

Pythonの組み込み属性 __name__ は、クラス、型、関数、メソッド、ディスクリプタ、ジェネレータインスタンスなど、オブジェクトの名前を取得・出力するために使われる特殊な属性です。

__name__の基本的な動作

Pythonインタープリタがモジュール（ソースファイル）をメインプログラムとして直接実行した場合、特殊変数 __name__ には "__main__" という値が自動的に設定されます。一方、そのファイルが別のモジュールからインポートされた場合には、__name__ にはそのモジュール名が設定されます。

この仕組みを利用することで、「スクリプトとして直接実行されたときだけ特定の処理を行う」といった制御が可能になります。if __name__ == "__main__": という記述は、まさにこの特性を活かした定番のイディオムです。

使用例

以下のコードは、__name__ の使い方を示したものです。

class Bar(object):
    def foo(self):
        """ これはdocstring（ドキュメント文字列）の一例です。

            定義された関数に関する有用な情報を記述できます。
        """
        pass

    print(foo.__name__)

print(Bar.__name__)

実行結果

このコードを実行すると、次のような出力が得られます。

foo
Bar

このように、関数に対して __name__ を参照すると関数名（foo）が、クラスに対して参照するとクラス名（Bar）がそれぞれ文字列として返されることが確認できます。デバッグやログ出力、動的な処理の分岐など、さまざまな場面で活用できる便利な属性です。