pip¶

コンソールロギング¶

pipはコンソールログレベルを制御する -v, --verbose、と -q, --quiet を提供します。

ファイルロギング¶

pipは冗長ログを最大限に保存するファイルを指定するための --log オプションを提供します。このオプションはデフォルトでは空です。このログは以前のログに追加されます。

すべてのpipオプションと同様に、--log は環境変数として設定することも、pip設定ファイルに配置することもできます。コンフィグレーション セクションを参照してください。

Setuptoolsインジェクション¶

上記のように、サポートされているビルドシステムは setuptools です。ただし、すべてのパッケージがビルドスクリプトで setuptools を使用するわけではありません。"pure distutils" を使用するプロジェクトをサポートするため、pipは setup.py を呼び出す前に setuptools を sys.modules に注入（インジェクション）します。インジェクションは distutils ベースのプロジェクトに対して透過的でなければなりませんが、pipが必要なコマンドをエミュレートする setup.py を提供したいサードパーティ製のビルドツールは、インジェクションを実行することを意識する必要があります。

今後の展開¶

PEP426 notes that the intention is to add hooks to project metadata in version 2.1 of the metadata spec, to explicitly define how to build a project from its source. Once this version of the metadata spec is final, pip will migrate to using that interface. At that point, the setup.py interface documented here will be retained solely for legacy purposes, until projects have migrated.

Specifically, applications should not expect to rely on there being any form of backward compatibility guarantees around the setup.py interface.

ビルドオプション¶

pip install と pip wheel の --global-option 引数と --build-option 引数は、setup.py` コマンドに追加引数を挿入します。（--build-option は pip wheel でのみ使用できます）これらの引数は、次のようにコマンドに含まれています。:

python setup.py <global_options> BUILD COMMAND <build_options>

オプションは変更されずに渡され、現在はdistutilsのコマンドラインに直接アクセスできます。--global-option と --build-option` の使用は、ビルドシステムに依存している必要があります。pipに別のビルドシステムのサポートが追加されていれば、現在の形式ではサポートされていない可能性があります。