tknotebook - 新しいページ [ja]

Pythonアプリケーションを起動する

2026-10-09T09:32:37Z

Nakamuri: /* 注意 */

[[Category:コンピュータ]][[Category:Python]]
[[メインページ]]>[[コンピュータの部屋#Python]]>[[Python Tips]]

==はじめに==

python でアプリケーションを起動するのに最も単純な方法は
python <pythonスクリプトファイルのパス>
でしょう。基本の基本です。

しかし、pythonにはアプリケーションを起動するための様々な方法が用意されています。この記事では、pythonでスクリプトを起動するためのいくつかの方法を紹介します。

==スクリプトファイルを指定して起動する ==

既に「はじめに」で紹介した通り、アプリケーションは
python <pythonスクリプトファイルのパス>
で起動できます。

<pythonスクリプトファイルのパス>のファイルのモジュールレベルのコードが起動されます。起動されるモジュールにローカルな __name__ 変数は "__main__" に設定されます。

sys.path には <pythonスクリプトファイルのパス> のディレクトリが追加されます。

=== 注意 ===

sys.path にはアプリケーションのモジュールやパッケージのトップディレクトリが追加されないとモジュールやパッケージの検索がおかしくなります。
<pythonスクリプトファイルのパス> のディレクトリにはモジュールやパッケージのトップディレクトリを指定しましょう。

==ディレクトリを指定して起動する ==

アプリケーションを
python <ディレクトリのパス>
で起動できます。

<ディレクトリのパス>に__main__.py が無ければ
python.exe: can't find '__main__' module in　<ディレクトリのパス>
とエラーが表示されて実行できません。

<ディレクトリのパス>に__main__.py が有れば、__main__.py のモジュールレベルのコードが起動されます。
起動される__main__.pyにローカルな __name__ 変数は "__main__" に設定されます。

sys.path には <ディレクトリのパス> が追加されます。

=== 注意 ===

sys.path にはアプリケーションのモジュールやパッケージのトップディレクトリが追加されないと
モジュールやパッケージの検索がおかしくなります。
<ディレクトリのパス>にはモジュールやパッケージのトップディレクトリを指定しましょう。

==zipファイル内のファイルから起動する==

python はzipで固められたアプリを起動できます。
やり方は簡単で、zipファイルをディレクトリであるかのようにして、zipファイル内のファイルを指定します。

python <zipファイル名のパス>/<zip内ファイルのパス>

起動されるコードから、zipファイル内の他のモジュールやパッケージを普通に import できます。
でも、zip内の他のファイルにアクセスするには zip 内のファイルを閲覧するライブラリを使う必要が有ります。

python <zipファイル名のパス>/<zip内ディレクトリのパス>

で起動した場合は、zipファイル内に <zip内ディレクトリのパス> が存在し、
<zip内ディレクトリのパス> が指定するディレクトリ内に '''__main__.py''' が存在していることが必要です。
python　は __main__.py のモジュールレベルのコードを起動します。

また、
python <zipファイル名のパス>
という形式の起動では、zipファイル内のトップに __main__.py ファイルが存在している必要が有ります。
この __main__.py が起動されます。

結局のところ、zipファイルはディレクトリとみなされ、
zipファイル内のファイルやディレクトリを指定して起動を行っているだけで、
起動の様子は'''「[[#スクリプトファイルを指定して起動する|スクリプトファイルを指定して起動する]]」'''や
'''「[[#ディレクトリを指定して起動する|ディレクトリを指定して起動する]]」''' と全く同じです。
'''__name__変数'''や '''sys.path へのディレクトリの追加'''や'''注意'''も同じなので、そのあたりは
'''「[[#スクリプトファイルを指定して起動する|スクリプトファイルを指定して起動する]]」'''や
'''「[[#ディレクトリを指定して起動する|ディレクトリを指定して起動する]]」'''を参照してください。

==パッケージのエントリポイントを実行する==

アプリケーションがパッケージとして pythonランタイムや仮想環境にインストールされている場合、
アプリケーションをコマンドで起動できます。

アプリケーションがパッケージの '''pyproject.toml''' に
[project.scripts]
コマンドの名称 = "パッケージ名:関数名"
が記述されていると、パッケージを pip や uv などで環境に登録すると、
コマンド(Windowsの場合はコマンドの名称.exe) がpython実行環境に登録されます。
つまり CLI からコマンドとして起動できるようになります。

'''複数のコマンドを登録できます。'''

コマンドが起動するのは '''[project.scripts]''' に記述されたパッケージの関数です。つまり関数が直に起動されます。
但し、関数が実行される前に、パッケージの初期化(パッケージファイルのモジュールレベルのコード、又は __init__.py のモジュールレベルのコード)が実行されます。

'''実行されるpythonファイルの __name__ 変数は "__main__" にセットされません'''。実行されるファイルのモジュール名がセットされます。'''実行されるパッケージはインストール済みなので、sys.path にはパッケージのトップディレクトリが予め設定済みです'''。

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

仮想環境の場合、パッケージをインストールすると仮想環境の Scriptsディレクトリにコマンドが登録されるので、即使えるようになります。

PIM版のシステムpythonにアプリをパッケージとしてインストールする場合、複数のシステムpythonに同じアプリをインストールすると、同じコマンド名が競合することになります。この場合 py install --refresh は新しい pythonのものを優先して登録するので注意してください。基本アプリは仮想環境で実行しましょう。

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

アプリケーションがパッケージとして pythonランタイムや仮想環境にインストールされている場合、
アプリケーションのパッケージやモジュールを -m オプションで起動できます。
python -m <モジュール名>
通常パッケージがディレクトリの場合、実行するコードが無いのでパッケージを実行することはできませんが、
パッケージがモジュールファイルの場合や、パッケージディレクトリが __main__.py ファイルを持っている場合、
python -m パッケージ名でパッケージを起動できます。

パッケージがモジュールファイルの場合は、モジュールのモジュールレベルのコードが、
パッケージディレクトリに __main__.py が有る場合は __main__.py のモジュールレベルのコードが実行されます。

但し、__main__.py が実行される前に、__init__.py が有れば、そのモジュールレベルのコードが実行されます。

実行されるパッケージはインストール済みなので、'''sys.path にはパッケージのトップディレクトリが予め設定済み'''です。

'''起動されるモジュールの __name__ 変数が "__main__" にセットされます'''。

-m オプションでの起動の特徴は、'''py -3.14 -m XXXX''' や python3.14 -m XXXX というように、
pythonの版を指定して起動できる点です。コマンドによるエントリポイント起動のようなややこしさはありません。
必要に応じて使い分けてください。

==まとめ==

pythonのアプリの起動方法を紹介しました。

pythonのアプリをどこでも使えるツールとして使えるようにするなら'''「エントリポイント(コマンド)」'''が最も強力な起動方法でしょう。以下にその特徴と注意点をまとめておきます。

{| class="wikitable"
|+ pythonアプリ起動方法　まとめ
|-
! 起動方法 !! 起動コード ||__name__ !! sys.path !! 特徴・備考
|-
| ファイル指定 || 指定ファイルのモジュールレベルのコード || "__main__" || ファイルのディレクトリが追加 || 最も基本的
|-
| ディレクトリ指定 || __main__.py のモジュールレベルのコード || "__main__" || ディレクトリが追加 || __main__.py が指定ディレクトリに必要
|-
| ファイル指定(zipファイル内) || 指定ファイルのモジュールレベルのコード || "__main__" || ファイルのディレクトリが追加 || アプリを単一ファイルで配布できる。
|-
| ディレクトリ指定(zipファイル内) || __main__.py のモジュールレベルのコード || "__main__" || ディレクトリが追加 || __main__.py が指定ディレクトリに必要。

アプリを単一ファイルで配布できる。

zipファイルのトップに __main__.py を置けば、zipファイルをスクリプトファイルのように扱える。
|-
| エントリポイント(コマンド) || pyproject.toml で指定されたモジュールの関数 || モジュール名そのまま || パッケージディレクトリが事前に追加
|| pyproject.tomlで設定要。
パッケージをインストールする必要あり。

コマンドは複数登録可能なので、様々な機能を一つのアプリで提供できる。
|-
| モジュール指定(-m) || 指定モジュールファイル又は __main__.py のモジュールレベルコード || "__main__" || パッケージディレクトリが事前に追加
| モジュールファイル又は__main__.pyが必要。
パッケージをインストールする必要あり。
|}

Python Install Manager とは

2026-10-07T11:34:38Z

Nakamuri: /* 注意 */

[[Category:コンピュータ]][[Category:Python]]
[[メインページ]]>[[コンピュータの部屋#Python]]>[[Python Tips]]

== はじめに ==

2025年10月7日 python3.14 はリリースされると共に、python の新しいインストーラ Python Install Manager(PIM) がリリースされました。

PIM はこれまでの個別のランタイム用インストーラーとは異なり、
複数の python ランタイムを自在にインストール/アンインストールするためのインストールマネージャーで
特定の python ランタイムとは独立した存在です。今のところ Windows 専用ですが、これまでの特定の python ランタイムとは
異なる考え方で作られています。

# 複数の python ランタイムを自在にインストール/アンインストールでき管理できる。
# 従来の python コマンドの他に linux版等と互換な名称のpython3 コマンドが提供されるようになった。
# バージョン番号付きの python3.13 コマンドなども提供され、py コマンドを使わなくても python のバージョンが指定できるようになった。
# 従来、各ランライムの Scripts ディレクトリに格納されていた、パッケージと共にインストールされるコマンドが、一つのディレクトリに集約され、いつでも利用できるようになった。

以下に PIM の詳細を説明します。

== インストール ==

まず、インストールから説明します。

実は、PIM のインストールでは、pythonの旧来のバージョンや python Launcherを完全にアンインストールしないといろいろな不具合に襲われます。
下記URLの手順に従って、古い python は削除した方が良いでしょう。古いランタイムと python Launcher(pyコマンド)の両方を削除して下さい。

'''Python完全アンインストール手順'''
https://www.insource-da.co.jp/dxpedia/02_0008.html

実はこれだけでも不十分で、[設定]→[アプリの詳細設定]→[アプリ実行エイリアス]
の画面で、'''python.exe'''/'''pythonw.exe'''/'''python3.exe''' を OFF にすることをお勧めします。

'''アプリ実行エイリアス'''とは ~/AppData/Local/Microsoft/WindowsApps に置かれるコマンドのことで、
上記の設定で削除することができます。ここには notepad.exe など様々などこからでも使えるコマンドが登録されていて、
python.exe は利用者が python コマンドを打鍵したとき MSストアへ誘導するなどの機能が有りますが、pythonランタイムと衝突して
様々な不具合を生じさせることが報告されていますので、OFFにすることを強く推奨します。

[[ファイル:アプリ実行エイリアス python.png|700px]]

以上の掃除が終わったら、PIMをインストールしましょう。

'''PIM(Python Install Manager)'''のインストーラは '''https://www.python.org/downloads/''' からもダウンロードできますし、
'''MSストア'''から['''Python Install Manager''']を選んでインストールすることもできます。MSストア版と python.org版は同一です。

尚、PIMは自動更新ですので、手動での更新は不要です。

== 最初の pythonランタイムのインストール ==

PIM がインストールされた時点では python ランタイムは何もインストールされていません。

powershellのコマンドラインで
py
と叩くと、最新版の pythonランタイムのインストールが始まり、終わると最新のpythonが起動します。

インストールは従来の python インストーラに比べとんでもなく高速です。

python ランタイムは '''~/AppData/Local/Python の pythoncore-3.14-64''' というようなフォルダにインストールされますが
ここには PATH が通っていません。python や他のコマンドを起動するコマンド群は '''~/AppData/Local/Python/bin''' に置かれます。
こちらには PATH が通っています。

python.exe, pythonw.exe, python3.exe, pythonw3.exe、python3-64.exe, pythonw3-64.exe はインストールした pythonランタイムのうち、最新のランタイムのpythonを起動するコマンドです。

pip.exe, pip3.exe はインストールした pythonランタイムのうち、最新のランタイムのpipを起動するコマンドです。

python3.14.exe, python3.14-64.exe, pythonw3,14.exe, pythonw3.14-64.exe 等の pythonランタイムバージョンが付いたコマンドは、指定バージョンの pythonランタイムの python を起動します。

==pythonランタイムのインストール==

pythonのランタイムを追加インストールするには
py install <バージョン>
例 py install 3.12
というように、python install コマンドに pythonランタイムのバージョンを指定します。

インストールする pythonランタイムが既にインストール済みの pythonランタイムより古ければ '''~/AppData/Local/Python/bin''' に有る
python.exe, pythonw.exe, python3.exe, pythonw3.exe、python3-64.exe, pythonw3-64.exe は更新されず、最新の python を呼び出すように保たれます。

インストールする pythonランタイムが既にインストール済みの pythonランタイムより新しければ '''~/AppData/Local/Python/bin''' に有る
python.exe, pythonw.exe, python3.exe, pythonw3.exe、python3-64.exe, pythonw3-64.exe は更新され、最新の python を呼び出すようになります。

バージョン付きのコマンド python<バージョン>.exe, python<バージョン>-64.exe, pythonw<バージョン>.exe, pythonw<バージョン>-64.exe が新たに追加されます。

===注意===

pythonランタイムのインストールでは、マイナーバージョンまで指定すると(例: 3.14)、その時点の最新のパッチバージョンがインストールされますが、
以下のようにパッチバージョンまで指定することもできます。
py install 3.14.6
この場合は、既に python3.14 がインストール済みである場合、上書きするか問合せが行われます。
上書きする場合、インストール済みの3.14は削除されて、指定されたパッチバージョンがインストールされます。
インストール前の python が 3.14.7 ならインストールで古い 3.14.6 に戻ります。

つまり、マイナーバージョンが同時に2種類インストールされることはないということです。
これは旧来のインストーラーでも同じです。パッチバージョンはバグフィックスであり、基本的に同じランタイムという考え方だからです。

==pythonランタイムのアンインストール==

pythonのランタイムをインストールするには
py uninstall <バージョン>
例 py uninstall 3.12
というように、python uninstall コマンドに pythonランタイムのバージョンを指定します。

アンインストールする pythonランタイムが削除されることによって、インストール済みの pythonランタイムの最も新たしいバージョンが変化すれば、 '''~/AppData/Local/Python/bin''' に有る python.exe, pythonw.exe, python3.exe, pythonw3.exe、python3-64.exe, pythonw3-64.exe が更新され、インストール済みの pythonランタイムの最も新たしいバージョンのpython を呼び出すようになります。

バージョン付きのコマンド python<バージョン>.exe, python<バージョン>-64.exe, pythonw<バージョン>.exe, pythonw<バージョン>-64.exe は削除されます。

==pythonランタイムの一覧==

インストールされている python ランタイムの一覧は

py list
Tag Name Managed By Version Alias
3.14[-64] * Python 3.14.8 PythonCore 3.14.8 python3[-64].exe, python3.14[-64].exe
3.13[-64] Python 3.13.16 PythonCore 3.13.16 python3.13[-64].exe

で表示できます。

これでも十分ですが、インストール先を確認したい場合はこれも有用です。

py -0p
-V:3.14[-64] * C:\Users\中村拓男\AppData\Local\Python\pythoncore-3.14-64\python.exe
-V:3.13[-64] C:\Users\中村拓男\AppData\Local\Python\pythoncore-3.13-64\python.exe

== ~/AppData/Local/Python/bin にあるコマンドの役割 ==

以上からわかるように python.exe, pythonw.exe, python3.exe, pythonw3.exe、python3-64.exe, pythonw3-64.exe は
常にインストールされている最新のpythonを起動するのに対し、
python<バージョン>.exe, python<バージョン>-64.exe, pythonw<バージョン>.exe, pythonw<バージョン>-64.exe は
バージョンで指定されたバージョンの python を起動します。

旧来の python launcher では古いpythonを起動するのに py -3.12 とかしていましたが、
PIM版では python3.12 でも起動できるようになりました。

===注意===

uv でインストールする python ランタイムは ~/.local/bin に python<バージョン>.exe をインストールしますが
PIM版のランタイムと名称が競合します。また uv で --default 付きで pythonランタイムをインストールすると
~/.local/bin に python.exe, python3.exe をインストールするので名称が競合します。
どちらが起動されるかは PATH の設定次第です。

できれば PIM版とUV版のランタイムを同時に使用しない方が良いでしょう。

:UVは PIM版のランタイムを問題なく扱えます。

==パッケージのコマンドの扱いの違い==

Python のパッケージには、Pythonの実行環境にコマンドを追加するものが有ります。
PIM版の Pythonランタイムでも、パッケージをインストールすると、パッケージによってはコマンドが pythonランタイムに追加されますが、
それは、Pythonランタイムの '''Scripts''' ディレクトリに置かれます。

例えば pythonに jupyter を pip でインストールすると、'''Scriptsディレクトリ'''に
jupyter.exe をはじめたくさんのコマンドが追加されます。これは旧来の pythonでも PIM版のpythonランタイムでも同じです。

但し、PIM版の pythonランタイムは複数同時にインストール可能なため、'''Scriptsディレクトリ'''には '''Path が通っていません'''。
このため、パッケージのコマンドは '''PATH の通っている''' '''~/AppData/Local/Python/bin''' に置かれます。

このディレクトリは一つしかないので、複数のpythonランタイムに同じ名前のパッケージのコマンドがインストールされると
名前が衝突してしまいます。そこで、PIM ではインストールされている pythonランタイムの中でより新しいもののパッケージの
コマンドを優先します。

ここで注意すべきなのは、パッケージのコマンドは '''~/AppData/Local/Python/bin''' に自動的には置かれないことです。
パッケージを pip でインストールした時点ではコマンドは '''Scriptsディレクトリ''' に置かれますが　'''~/AppData/Local/Python/bin'''　には'''置かれません'''。
py install --refresh
が叩かれると、PIM は各pythonランタイムの '''Scriptsディレクトリ'''の状況を調べ、'''~/AppData/Local/Python/bin''' に置くべき
コマンドを選んで置きます。従って、パッケージをインストールしても、'''py install --refresh''' を実行しないとコマンドは使えません。

PIMを使いだすと、パッケージのコマンドが使えず困った経験がある人は多いでしょう。すぐに py install --refresh を打ってください。

現在パッケージは仮想環境にインストールすることが当たり前になりつつありますが、
pipxなどシステムpythonに直接インストールしたいパッケージもごく少数有るので、
PIM版でもシステムpythonにパッケージをインストール
できるようにしています。しかし、名前の重複はいかんともしがたいので、この複雑さは諦めましょう。

基本、パッケージは仮想環境にインストールすべきです。
仮想環境ならば '''Scriptsディレクトリ''' に PATHは通っているので問題なく使えます。
システムpython を複数インストールするのは、仮想環境の親のシステムpython を複数用意するためなのです。

===注意===

この話は uv pip XXXX --system で PIM版のシステムpython にパッケージを追加した場合も同じです。
パッケージ追加後, パッケージのコマンドを有効にするには py install --refresh が必要ですので注意してください。

==まとめ==

以上の説明からお分かりかと思いますが、pythonのインストーラーはバージョン毎に別々のインストーラー用意されることは近い将来なくなり、その代わりに、PIMで複数のバージョンを自在にインストールできるようになりました。

これにより pythonのバージョンに依存するアプリケーションを実行することが容易になりました。

その分パッケージのコマンドの管理がややこしくなりました。