pip¶
使用方法¶
python -m pip <command> [options]
py -m pip <command> [options]
説明¶
ログ¶
コンソールログ¶
pipは-v, --verboseと-q, --quietを使用してコンソールログレベルを制御できます。デフォルトでは、一部のメッセージ（エラーと警告）はターミナルで色付きで表示されます。色付きの出力を抑制するには--no-colorを使用してください。
ファイルログ¶
pipは、最大詳細度のログを保持するファイルを指定するための--logオプションを提供します。このオプションはデフォルトでは空です。このログは、以前のログに追加されます。
すべてのpipオプションと同様に、--logも環境変数として設定するか、pip設定ファイルに配置できます。設定セクションを参照してください。
--exists-action オプション¶
このオプションは、パスが既に存在する場合のデフォルトの動作を指定します。可能性のあるケース：インストールのためのファイルのダウンロードまたはリポジトリのチェックアウト、アーカイブの作成。--exists-actionが定義されていない場合、pipは決定が必要なときにプロンプトを表示します。
- (s)witch
VCSチェックアウトにのみ関連します。チェックアウトを適切なURLおよび/またはリビジョンに切り替えることを試みます。
- (i)gnore
現在の操作を中止します（例：ファイルをコピーしない、アーカイブを作成しない、チェックアウトを変更しない）。
- (w)ipe
新しいファイルまたはVCSチェックアウトを作成、ダウンロード、またはチェックアウトする前に、ファイルまたはVCSチェックアウトを削除します。
- (b)ackup
ファイルまたはチェックアウトの名前を
{name}{'.bak' * n}に変更します。ここでnは.bak拡張子の数です。ファイルがいつか存在しなかったことを意味します。したがって、最新のバックアップは.bakの後に最も大きい数値が付いているものになります。- (a)bort
pipを中止し、ゼロ以外の終了ステータスを返します。
ビルドシステムインターフェース
これは、ビルドシステムインターフェースで説明されています。
一般的なオプション¶
- -h, --help¶
ヘルプを表示します。
(環境変数：
PIP_HELP)
- --debug¶
未処理の例外をメインサブルーチン外に伝播させ、stderrにログに記録する代わりにします。
(環境変数：
PIP_DEBUG)
- --isolated¶
分離モードでpipを実行し、環境変数とユーザー設定を無視します。
(環境変数：
PIP_ISOLATED)
- --require-virtualenv¶
仮想環境でのみpipを実行できるようにします。それ以外の場合はエラーで終了します。
(環境変数：
PIP_REQUIRE_VIRTUALENV、PIP_REQUIRE_VENV)
- --python <python>¶
指定されたPythonインタープリターでpipを実行します。
(環境変数：
PIP_PYTHON)
- -v, --verbose¶
より多くの出力を提供します。オプションは加算的で、最大3回まで使用できます。
(環境変数：
PIP_VERBOSE)
- -V, --version¶
バージョンを表示して終了します。
(環境変数：
PIP_VERSION)
- -q, --quiet¶
出力を少なくします。オプションは加算的で、最大3回まで使用できます（WARNING、ERROR、CRITICALログレベルに対応）。
(環境変数：
PIP_QUIET)
- --log <path>¶
詳細なログを追加するパス。
(環境変数：
PIP_LOG、PIP_LOG_FILE、PIP_LOCAL_LOG)
- --no-input¶
入力のプロンプトを無効にします。
(環境変数：
PIP_NO_INPUT)
- --keyring-provider <keyring_provider>¶
ユーザー入力が許可されている場合、keyringライブラリを介した資格情報の検索を有効にします。使用するメカニズムを指定します[disabled、import、subprocess]。（デフォルト：disabled）
(環境変数：
PIP_KEYRING_PROVIDER)
- --proxy <proxy>¶
scheme://[user:passwd@]proxy.server:port形式でプロキシを指定します。
(環境変数：
PIP_PROXY)
- --retries <retries>¶
各接続が試行する最大再試行回数（デフォルト5回）。
(環境変数：
PIP_RETRIES)
- --timeout <sec>¶
ソケットタイムアウトを設定します（デフォルト15秒）。
(環境変数：
PIP_TIMEOUT、PIP_DEFAULT_TIMEOUT)
- --exists-action <action>¶
パスが既に存在する場合のデフォルトのアクション：(s)witch、(i)gnore、(w)ipe、(b)ackup、(a)bort。
(環境変数：
PIP_EXISTS_ACTION)
- --trusted-host <hostname>¶
有効なHTTPSがなくても、このホストまたはホスト:ポートペアを信頼済みとしてマークします。
(環境変数:
PIP_TRUSTED_HOST)
- --cert <path>¶
PEM エンコードされた CA 証明書バンドルのパス。指定された場合は、デフォルト設定を上書きします。詳細については、pip ドキュメントの「SSL 証明書検証」を参照してください。
(環境変数:
PIP_CERT)
- --client-cert <path>¶
SSL クライアント証明書のパス。秘密鍵と証明書を PEM 形式で含む単一ファイルです。
(環境変数:
PIP_CLIENT_CERT)
- --cache-dir <dir>¶
キャッシュデータを <dir> に保存します。
(環境変数:
PIP_CACHE_DIR)
- --no-cache-dir¶
キャッシュを無効にします。
(環境変数:
PIP_NO_CACHE_DIR)
- --disable-pip-version-check¶
pip の新しいバージョンがダウンロード可能かどうかを定期的に PyPI に確認しません。--no-index と共に使用される場合、このオプションは暗黙的に設定されます。
(環境変数:
PIP_DISABLE_PIP_VERSION_CHECK)
- --no-color¶
カラー出力を使用しません。
(環境変数:
PIP_NO_COLOR)
- --no-python-version-warning¶
今後サポートされなくなる Python バージョンに関する非推奨警告を表示しません。
(環境変数:
PIP_NO_PYTHON_VERSION_WARNING)
- --use-feature <feature>¶
下位互換性がない可能性のある新しい機能を有効にします。
(環境変数:
PIP_USE_FEATURE)
- --use-deprecated <feature>¶
将来削除される非推奨機能を有効にします。
(環境変数:
PIP_USE_DEPRECATED)