できない.dev

PyPI

別名: Python Package Index / パイピーアイ

pip が既定で参照する、Python パッケージの公式リポジトリ。
誰でも公開・取得でき、依存解決の起点になる。

公開:

定義

PyPI(Python Package Index)は、Python パッケージを公開・配布する公式リポジトリである。
pip install は、既定でこの PyPI から目的のパッケージとその依存を取得する。

詳細

PyPI には sdist(ソース配布)と wheel(ビルド済み配布)の 2 形式が登録されている。
pip は、互換 wheel があればそちらを優先する。

社内ミラーや代替インデックスを使うときは、--index-url や --extra-index-url で参照先を切り替える。
pip install が失敗するときは、原因が PyPI への到達(プロキシ・SSL)にあるのか、パッケージ名・バージョン指定にあるのかを先に切り分けると早く片付く。

よくある誤解

  • pip と PyPI は同じものではない。
    pip は取得・導入を行うツール、PyPI はその取得先となる配布所で、役割が異なる。
  • import 名が PyPI のパッケージ名と同じだとは限らない。
    配布名とインポート名が一致しないパッケージもある。

関連

導入ツールについては pip の項で説明している。
取得が SSL 証明書エラーで失敗する例は、pip install が SSL 証明書エラーで失敗する で扱っている。