Python : if __name__ == “__main__” は、スクリプトとして直接実行したときのみ処理を行う

以下の摩訶不思議な if 文は一体何を意味しているのだろうか?まずは、アンダースコアがついた特殊変数について説明する。
エンジニア速報は Twitter の@commteで配信しています。
if __name__ == "__main__":
のポイント
- スクリプトとして直接実行したときのみ処理を行うことができる
- インポート元のファイルの末尾に加えることでスクリプトとしても使える
- 実行したいコードと実行したくないコードを分けることができる
特殊変数の意味
if __name__ == "__main__":
Python には特殊変数と呼ばれるものがあり、__名前__
の形をしている。有名なところでは、__init__
や__new__
がある。
公式ドキュメントでは以下のように言及されている。
予約済みの識別子種
システムで定義された (system-defined) 名前です。これらの名前はインタプリタと (標準ライブラリを含む) 実装上で定義されています; 現行のシステムでの名前は 特殊メソッド名 などで話題に挙げられています。 Python の将来のバージョンではより多くの名前が定義されることになります。
2. 字句解析 — Python 3.5.10 ドキュメント
次に、if 文の左辺と右辺に記述されている特殊変数の意味について説明しよう。
if 文の左辺に記述されている、特殊変数__name__
は、Python ごとに、そのファイル名が格納される。
if 文の右辺に記述されている、特殊変数__main__
は、Python コマンドから直接実行されたときに、この名前が格納される。
Python のスクリプトは、インポートしただけでファイルに記述した処理が実行されてしまう。しかし、自動実行が困るケースもある。できることなら、インポートされたときは自動実行をさせず、スクリプトとして直接実行したときだけ処理を行いたい。
そんなときに、この if 文で判定すると スクリプトとして直接実行したときのみ処理を行う ことができる。
Python のコードは、コマンドから直接実行されるか、他のプログラムをインポートして呼ばれる。その判定を行うことができる。インポート元のファイルの末尾に以下を加えることで、スクリプトとしても使えるようになる。
if __name__ == "__main__":
関数
まとめると、このコードは 「コマンドラインからスクリプトとして直接実行したときに、以降の処理を行う」 という意味である。
ひとまず、__name__
を「モジュール名」、__main__
を「直接実行」と解釈すると理解しやすい。
直接実行とは、コマンドから「python ファイル名.py」と入力することである。
記述方法
読込先のファイル
import インポート元
print('処理')
インポート元のファイル
def main()
print('処理')
if __name__ == "__main__":
main()
この記述を使うことで、インポートしたときに自動実行されないように判定しているので、実行したいコードと実行したくないコードを分けることができる。
変数 __name__
には、モジュール名が格納されている。Python のコードを直接実行すると、 __main__
として認識される。
モジュールがコマンドに渡されたときに、変数 __name__
の値が __main__
になる。
Python おすすめ本
スポンサード リンク
関連記事
- Python : 再帰は大きな問題が小さな問題に収束するように使う
- Python: f-string(f 文字列)と「:」の便利な使い方
- Python: bytes 型 と str 型の違い。変換方法
- Python: MySQL へ接続するモジュール mysqlclient(MySQLdb)の使い方
- Python: インポートしたときに「ModuleNotFoundError」になる場合の対処法
- Python: カウンタ。Counter()関数で要素数を計算する
- Python: Requests-HTML の使い方
- Python: BeautifulSoup 使い方(タイトル・HTML 取得など)
- Python: Requests モジュールの使い方(スクレイピング、データ収集など)
- Python: SQL の基本コマンドと sqlite3 モジュール
Leave a Comment