【Python】__name__ == '__main_

（最終更新月：2023年9月）

✔このような疑問をお持ちの方へ

「Pythonの__main__って何のために使うの？」

「Pythonにおける__main__の機能が知りたい」

「__main__の具体的な使用例は何？」

✔当記事で得られる知識

Python __main__の性質
__main__の活用法とその書き方
Pythonにおける__main__の実践的な使用例

当記事では、Python __main__の基本的な特性から、より広範囲な応用法まで、具体的な例を交えて、詳細に説明します。

ぜひ最後までお読みください。

筆者プロフィール

【現職】プロダクトマネージャー

【副業】ブログ（月間20万PV）/YouTube/Web・アプリ制作

「プログラミング × ライティング × 営業」の経験を活かし、30後半からのIT系職へシフト。現在はプロダクトマネージャーとして、さまざまな関係者の間に入り奮闘してます。当サイトでは、実際に手を動かせるWebアプリの開発を通じて、プログラミングはもちろん、IT職に必要な情報を提供していきます。

【当ブログで紹介しているサイト】

当サイトチュートリアルで作成したデモ版日報アプリ

Django × Reactで開発したツール系Webアプリ

✔人に見せても恥ずかしくないコードを書こう

「リーダブルコード」は、わかりやすく良いコードの定義を教えてくれる本です。

見るからにきれいなコードの書き方
コードの分割方法
変数や関数の命名規則

エンジニアのスタンダートとすべき基準を一から解説しています。

何回も読むのに値する本なので、ぜひ手にとって読んでみてください。

リーダブルコード ―より良いコードを書くためのシンプルで実践的なテクニック

created by Rinker

Python言語とmain

こちらでは、Pythonの基本的な特徴とそのプログラムの基本構造について深く掘り下げます。

Pythonの基本特徴と利点
Pythonプログラムの基礎構築
【初心者向け】Pythonの__main__とは

Pythonの基本特徴と利点

Pythonは、その簡潔かつ読みやすい構文で、初心者が学びやすいと評価されています。

以下のような特徴を持ち、強力で柔軟なプログラミング言語です。

動的型付け
自動メモリ管理
高レベルの組み込みデータ型

幅広いライブラリとフレームワークにより、さまざまなアプリケーションの開発を容易にします。

Webアプリ開発にはDjangoフレームワークが使えます。

【Django】チュートリアル｜日報アプリの開発から公開まで

Djangoのチュートリアルをお探しですか？具体的に「手を動かして作ってみたい！」という方へ向けて、誰でもできる簡易的な日報アプリの開発を通じて、Djangoの様々な機能に触れていくシリーズとなっています。PythonでWebアプリを作りたい方、必見の記事となります！

Pythonプログラムの基礎構築

Pythonプログラムは一連のステートメントで構成されます。

これらのステートメントは上から下へと順に実行され、条件分岐やループ、関数の呼び出しを通じてプログラムのフローを制御するもの。

例えば、以下に簡単なPythonプログラムの例を示します。

def greeting(name):
    return f"Hello, {name}!"

print(greeting("Python"))

引数として名前を取り、挨拶メッセージを返す関数greetingを定義。

print関数を使用してgreeting関数の結果を表示します。

【初心者向け】Pythonのmainとは

Pythonの__main__とは、Pythonのスクリプトで重要な役割を果たす特殊なメソッドです。

これは、スクリプトが直接実行された時だけに実行される部分を定義します。

__main__関数を知ることで、Pythonスクリプトの動作の理解が深まり、より効果的なコードを書けるのです。

Python mainのメリット

こちらでは、__main__を活用するメリットを見ていきましょう。

処理の流れを示す「Python main」の重要性
テスト易性と変数衝突の予防
__main__以外のケース

処理の流れを示すmainの重要性

__main__を理解することは、プログラム（スクリプト）を直接実行したい場合に、とても重要です。

なぜなら__main__で指定したブロックについては、スクリプトが直接実行された場合に限り実行できるからです。

これにより、プログラムの主要な処理の流れを明確に示せます。

def main():
    print("This is the main function.")

if __name__ == "__main__":
    main()

main関数がスクリプトの主要な処理を担当し、スクリプトが直接実行された場合にのみmain関数が呼び出されます。

テストと変数の衝突予防

__main__を使用することで、各関数やクラスの独立したテストが容易です。

main関数内で変数を定義することで、グローバルスコープでの変数の衝突を防げます。

以下に例を示します。

def main():
    var = "This is a local variable in main function."
    print(var)

if __name__ == "__main__":
    main()

この例では、変数varはmain関数のローカルスコープ内でのみ存在します。

これにより、同じ名前の変数が別の場所で定義されていても、main関数内のvarと衝突することはありません。

nameとmainの理解

こちらでは、__name__と__main__の特殊な変数について深く理解を深めます。

nameについての見解
「main」の意味と使用方法

nameについての見解

__name__は、Pythonが内部で使用する特殊な変数で、現在のモジュール名を保持します。

スクリプトが直接実行されると、__name__の値は__main__です。

スクリプトがほかのスクリプトからインポートされると、__name__の値はそのモジュールの名前（ファイル名）になります。

モジュールとしてのPythonファイル（script.py）

print(__name__)

インポートするとPrintにより、モジュール名が表示される

>>> import script
script

「main」の意味と使用方法

__main__は、現在のスクリプトが直接実行されていることを示す特殊な値です。

if __name__ == "__main__":

こちら条件式は、スクリプトが直接実行されているときにのみTrueになります。

スクリプトが直接実行されたときにのみ実行されるコードを指定できます。

if name == ‘main’の解釈と使い方

こちらでは、if name == ‘main’の具体的な解釈と使用方法について説明します。

“if name == ‘main'”の意義と適用例
モジュールテストとコマンド使用の事例

if name == ‘main‘の意義と適用例

“if __name__ == ‘__main__'”は、Pythonスクリプトが直接実行されているか、ほかのスクリプトからインポートされているかを判定するための条件文です。

“if __name__ == ‘__main__’:”以降のコードは、スクリプトが直接実行されたときにのみ実行されます。

以下が具体的な使用例です。

# file: mymodule.py

def hello_world():
    print("Hello, world!")

if __name__ == "__main__":
    hello_world()

直接実行すると、”Hello, world!”と表示されます。

このスクリプトを他のスクリプトからインポートすると、”Hello, world!”は表示されません。

モジュールテストとコマンド使用の事例

“if name == ‘main'”は、モジュールのテストやコマンドラインからの直接実行を可能にします。

以下が具体的な例です。

# file: mymodule.py

def add(a, b):
    return a + b

if __name__ == "__main__":
    print(add(1, 2))

自身が直接実行された場合にのみ、add関数を呼び出します。

これは、add関数の動作を確認するための簡単なテストとして役立つコードです。

Pythonプログラムの実行方法

Pythonプログラムの基本的な実行方法について解説します。

Pythonコードの実行ステップ
コマンドラインを用いたPythonスクリプトの実行

Pythonコードの実行ステップ

Pythonコードは通常、Pythonインタープリタを通じて実行されます。

具体的なステップは次のとおりです。

テキストエディタでPythonコードを書く（または既存のPythonファイルを開く）。
ファイルを.py拡張子で保存する。
Pythonインタープリタを起動して、保存したPythonファイルを指定して実行する。

これらのステップはPythonの基本的な実行手順であり、多くのPythonプログラムやスクリプトに適用されます。

コマンドラインを用いたPythonスクリプトの実行

Pythonスクリプトは、コマンドライン（ターミナルやシェル）を通じても実行できます。

以下に具体的な手順を示します。

ターミナルを開き、Pythonスクリプトが保存されているディレクトリに移動
コマンドを使用して、Pythonスクリプトを実行

例えば、前述したmymodule.pyスクリプトを実行するには、次のようにコマンドを入力します。

python mymodule.py

このコマンドを実行すると、mymodule.py内の”if name == ‘main’:”以降のコードが実行されます。

Pythonにおけるmainの使用例

ここでは、Python「__main__」の基本的な使用例を示します。

初心者に適した具体例を見ていきましょう。

__main__の基本コード例
初心者に適した__main__の使用例

mainの基本コード例

「Python main」の基本的な使用例は以下の通りです。

def main():
    print("Hello, World!")

if __name__ == "__main__":
    main()

この例では、main関数が定義され、その中で”Hello, World!”が出力される処理が書かれています。

そして、”if name == ‘main’:”という条件がTrue（つまり、スクリプトが直接実行されている場合）のときだけ、main条件式が呼び出されます。

初心者に適したmainの使用例

初心者には、少し複雑な例を見ることも有用です。

以下に、main関数内で他の関数を呼び出す例を示します。

def greet(name):
    return f"Hello, {name}!"

def main():
    print(greet("World"))

if __name__ == "__main__":
    main()

main関数内でgreet関数が呼び出されています。

mainの最適な習慣

Pythonの__main__を使用する上でのベストプラクティスと効果的なコーディングテクニックを解説します。

以下のトピックについて詳しく説明します：

__main__を最大限に活用するためのベストプラクティス
__main__使用時の効果的なコーディングテクニック

「main」を最大限に活用するためのベストプラクティス

Python mainを最大限に活用するためのいくつかのベストプラクティスを紹介します：

__main__
スクリプトの主要な処理をカプセル化するために使用します。この条件分岐内にコードを書くことで、そのコードがスクリプトが直接実行されたときだけ実行できます。
関数の定義
main関数外で定義された関数は、ほかのPythonスクリプトからもアクセス可能です。コードの再利用性が高まります。
テストの容易性
if name == ‘main’:のパターンは、ユニットテストを容易にします。テストを実行する際に必要な状況を再現しやすくなります。

「main」使用時の効果的なコーディングテクニック

__main__を使用する際の効果的なコーディングテクニックとしては以下のようなものがあります。

コマンドライン引数の処理
Pythonの標準ライブラリには、コマンドライン引数を処理するためのモジュールがあります（例：argparse）。これらのモジュールを活用することで、スクリプトをより汎用性の高いものにできます。
ロギング
ログメッセージは、プログラムの動作を理解するのに役立ちます。Pythonのloggingモジュールを使用すると、ロギングを簡単に実装できます。