3

Pythonのコマンドで使用される -m が意味するものっていったい何なんでしょうか。

例えば、仮想環境を作るときに使う以下のコマンドで使用されている ―m のことです。

$ python3 -m venv [newenvname]

具体的な意味などあれば教えてください。

2 件の回答 2

2

-m モジュール名 で指定することでそのモジュールを実行します。
パッケージ名を指定した場合はそのパッケージの__main__.pyを実行します。

例えば
$ python3 -m venv [newenvname]
の場合は venvパッケージの__main__.pyを実行することになります。https://github.com/python/cpython/blob/3.9/Lib/venv/__main__.py

また別の例としてtimeitモジュールの場合は
$ python3 -m timeit -h
としたときに、timeit.pyを実行することになります。
https://github.com/python/cpython/blob/3.9/Lib/timeit.py

この -m の意味としては、
「モジュール名(またはパッケージ名)の指定で実行できるため、どこにインストールしているか知らなくてもファイルのパスを指定することなく実行できる」ことです。

もし -m が使えなかったら、「Pythonをインストールしたパス配下のlib/venv/__main__.pyを実行して」みたいになります。

$ python3 (Pythonをインストールしたパス)/lib/venv/__main__.py

2
  • $ python3 -m timeit -hの場合、なぜ__main__.pyじゃないのでしょうか。
    – milk
    Commented 2021年9月7日 21:39
  • timeitのほうはリンク貼った実装の方を見るとtimeit.tyというモジュールでできていますのでこれを指定して実行した事になります。venvの方はパッケージでファイルシステム上ではディレクトリになってます。なのでそのディレクトリの__main__.pyが実行されます。どうしてパッケージとして作られたか、1ファイルのモジュールとして作られたかは設計意図は私には分かりませんが、単純なものはモジュールとして1ファイルで作られたのではないかと思います。
    – civi
    Commented 2021年9月8日 1:11
0

ドキュメントに書いてありますよ。おそらく module の最初の文字を取ったものでしょう。

1.1.1. インターフェイスオプション - 1. コマンドラインと環境

  • -m モジュール名 として Python モジュールパスにあるモジュールを指定された場合、そのモジュールをスクリプトとして実行します。

-m <module-name>

sys.path から指定されたモジュール名のモジュールを探し、その内容を __main__ モジュールとして実行します。
引数は module 名なので、拡張子 (.py) を含めてはいけません。モジュール名は有効な Python の絶対モジュール名 (absolute module name) であるべきですが、実装がそれを強制しているとは限りません (例えば、ハイフンを名前に含める事を許可するかもしれません)。
...以下続くが省略

使用しているOS上のPATHではなく、Pythonのモジュールパスに存在するモジュールを指定して実行するためのものでしょう。

例えば pip はインストールしたOS上でPATHにあるディレクトリにあれば実行できるものと、Pythonのモジュールパスに存在するものの2つがあり、だいたいは pip とパラメータだけで動作しますが、pip自身を新しい版数にアップグレードする場合は、その単独で動作するプログラムも上書きして更新する必要があるために、Pythonモジュールを呼び出す形の Python -m pip install --upgrade pip として実行させます。

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。