Pythonのパス設定ファイル

パス設定ファイルは name.pth という形式の名前をもつファイルで、上の4つのディレクトリのひとつにあります。その内容は sys.path に追加される追加項目(一行に一つ)です。

import で始まる(そしてその後ろにスペースかタブが続く)行は実行されます。

.pth ファイル内の実行可能な行は、特定のモジュールが実際に使用されるかどうかに関係なく、Pythonの起動時に毎回実行されます。

例えば、 sys.prefix と sys.exec_prefix が /usr/local に設定されていると仮定します。そのときPython X.Y ライブラリは /usr/local/lib/pythonX.Y にインストールされています。ここにはサブディレクトリ /usr/local/lib/pythonX.Y/site-packages があり、その中に三つのサブディレクトリ foo, bar および spam と二つのパス設定ファイル foo.pth と bar.pth をもつと仮定します。

code:foo.pth

foo

bar

bletch

code:bar.pth

bar

次のバージョンごとのディレクトリが sys.path へこの順番で追加されます:

code:txt

/usr/local/lib/pythonX.Y/site-packages/bar

/usr/local/lib/pythonX.Y/site-packages/foo

bletch は存在しないため省略されるということに注意してください。

bar ディレクトリは foo ディレクトリの前に来ます。なぜなら、 bar.pth がアルファベット順で foo.pth の前に来るからです。

また、 spam はどちらのパス設定ファイルにも記載されていないため、省略されます。

IMO：通常のpip installでは、.pthファイルを使う必要はないのでは？（editable installで使っているのかな？ TODO）