Pythonアプリケーションを起動する - 変更履歴

Nakamuri: /* 注意 */

2026-10-10T02:21:54Z

‎注意

Nakamuri: /* まとめ */

2026-10-10T01:31:25Z

‎まとめ

Nakamuri: /* まとめ */

2026-10-10T01:30:51Z

‎まとめ

Nakamuri: /* まとめ */

2026-10-10T01:26:23Z

‎まとめ

Nakamuri: /* パッケージを -m オプションで起動 */

2026-10-10T01:20:39Z

‎パッケージを -m オプションで起動

Nakamuri: /* パッケージを -m オプションで起動 */

2026-10-10T01:01:58Z

‎パッケージを -m オプションで起動

Nakamuri: /* 注意 */

2026-10-10T00:59:33Z

‎注意

Nakamuri: /* まとめ */

2026-10-10T00:58:06Z

‎まとめ

Nakamuri: /* まとめ */

2026-10-10T00:56:09Z

‎まとめ

Nakamuri: /* まとめ */

2026-10-10T00:51:04Z

‎まとめ

@@ 95行: / 95行: @@
 ===注意===
-WindowsのPIM版のシステムpythonにアプリをパッケージとしてインストールする場合、コマンドは Scriptsディレクトリにインストールされますが、Scriptsディレクトリに PATH は通ってないので'''コマンドを起動できません'''。'''py install --refresh''' を打つと '''~AppData/Local/Python/bin''' にもコマンドが登録されて使えるようになります。
+WindowsのPIM版のシステムpythonにアプリをパッケージとしてインストールする場合、コマンドは Scriptsディレクトリにインストールされますが、Scriptsディレクトリに PATH は通ってないので'''コマンドを起動できません'''。'''py install --refresh''' を打つと '''~/AppData/Local/Python/bin''' にもコマンドが登録されて使えるようになります。
 仮想環境の場合、パッケージをインストールすると仮想環境の Scriptsディレクトリにコマンドが登録されるので、即使えるようになります。

@@ 127行: / 127行: @@
 pythonのアプリの起動方法を紹介しました。
-pythonのアプリをどこでも使えるツールとして使えるようにするなら'''「エントリポイント(コマンド)」'''が最も強力な起動方法でしょう。
+pythonのアプリをどこでも使えるツールとして使えるようにするなら'''「エントリポイント(コマンド)」'''が最も強力な起動方法でしょう。以下にその特徴と注意点をまとめておきます。
 {| class="wikitable"

←前の版		2026年10月10日 (土) 01:30時点における版
124行:		124行:

	==まとめ==		==まとめ==
		+
		+	pythonのアプリの起動方法を紹介しました。
		+
		+	pythonのアプリをどこでも使えるツールとして使えるようにするなら'''「エントリポイント(コマンド)」'''が最も強力な起動方法でしょう。

	{\| class="wikitable"		{\| class="wikitable"

@@ 128行: / 128行: @@
 |+ pythonアプリ起動方法　まとめ
 |-
-! 起動方法 !! __name__ !! sys.path !! 特徴・備考
+! 起動方法 !! 起動コード ||__name__ !! sys.path !! 特徴・備考
 |-
-| ファイル指定 || "__main__" || ファイルのディレクトリが追加 || 最も基本的
+| ファイル指定 || 指定ファイルのモジュールレベルのコード || "__main__" || ファイルのディレクトリが追加 || 最も基本的
 |-
-| ディレクトリ指定 || "__main__" || ディレクトリが追加 || __main__.py が指定ディレクトリに必要
+| ディレクトリ指定 || __main__.py のモジュールレベルのコード ||  "__main__" || ディレクトリが追加 || __main__.py が指定ディレクトリに必要
 |-
-| ファイル指定(zipファイル内) || "__main__" || ファイルのディレクトリが追加 || アプリを単一ファイルで配布できる。
+| ファイル指定(zipファイル内) ||  指定ファイルのモジュールレベルのコード || "__main__" || ファイルのディレクトリが追加 || アプリを単一ファイルで配布できる。
 |-
-| ディレクトリ指定(zipファイル内) || "__main__" || ディレクトリが追加 || __main__.py が指定ディレクトリに必要。
+| ディレクトリ指定(zipファイル内) || __main__.py のモジュールレベルのコード || "__main__" || ディレクトリが追加 || __main__.py が指定ディレクトリに必要。
 アプリを単一ファイルで配布できる。
@@ 142行: / 142行: @@
 zipファイルのトップに __main__.py を置けば、zipファイルをスクリプトファイルのように扱える。
 |-
-| エントリポイント(コマンド) || モジュール名そのまま || パッケージディレクトリが事前に追加
+| エントリポイント(コマンド) || pyproject.toml で指定された モジュールの関数 || モジュール名そのまま || パッケージディレクトリが事前に追加
 || pyproject.tomlで設定要。
 パッケージをインストールする必要あり。
@@ 148行: / 148行: @@
 コマンドは複数登録可能なので、様々な機能を一つのアプリで提供できる。
 |-
-| モジュール指定(-m) || "__main__" || パッケージディレクトリが事前に追加
+| モジュール指定(-m) || 指定モジュールファイル又は __main__.py のモジュールレベルコード || "__main__" || パッケージディレクトリが事前に追加
 | モジュールファイル又は__main__.pyが必要。
 パッケージをインストールする必要あり。
 |}

@@ 112行: / 112行: @@
 パッケージがモジュールファイルの場合は、モジュールのモジュールレベルのコードが、
 パッケージディレクトリに __main__.py が有る場合は __main__.py のモジュールレベルのコードが実行されます。
 実行されるパッケージはインストール済みなので、'''sys.path にはパッケージのトップディレクトリが予め設定済み'''です。

@@ 115行: / 115行: @@
 実行されるパッケージはインストール済みなので、'''sys.path にはパッケージのトップディレクトリが予め設定済み'''です。
-'''モジュールの __name__ 変数が "__main__" にセットされます'''。
+'''起動されるモジュールの __name__ 変数が "__main__" にセットされます'''。
 -m オプションでの起動の特徴は、'''py -3.14 -m XXXX''' や python3.14 -m XXXX というように、

@@ 97行: / 97行: @@
 WindowsのPIM版のシステムpythonにアプリをパッケージとしてインストールする場合、コマンドは Scriptsディレクトリにインストールされますが、Scriptsディレクトリに PATH は通ってないので'''コマンドを起動できません'''。'''py install --refresh''' を打つと '''~AppData/Local/Python/bin''' にもコマンドが登録されて使えるようになります。
-仮想環境の場合、パッケージをインストールすると仮想環境の Scripysディレクトリにコマンドが登録されるので、即使えるようになります。
+仮想環境の場合、パッケージをインストールすると仮想環境の Scriptsディレクトリにコマンドが登録されるので、即使えるようになります。
 PIM版のシステムpythonにアプリをパッケージとしてインストールする場合、複数のシステムpythonに同じアプリをインストールすると、同じコマンド名が競合することになります。この場合 py install --refresh は新しい pythonのものを優先して登録するので注意してください。基本アプリは仮想環境で実行しましょう。