できない.dev

PEP

別名: Python Enhancement Proposal / PEP 8 / PEP 668

Python の仕様変更や指針を提案・記録する文書。
番号で識別され、採択された PEP が言語やツールの実際の挙動を決める。
エラーメッセージや公式ドキュメントが根拠として PEP 番号を示すことが多い。

公開:

定義

PEP(Python Enhancement Proposal)は、Python への変更提案や設計方針をまとめた文書である。
PEP 8 のように連番で識別され、その位置づけと手続き自体も PEP 1 で定義されている。
採択(Accepted / Final)された PEP は、言語処理系やパッケージングツールの実際の挙動になる。
そのため、エラーメッセージや公式ドキュメントが根拠として PEP 番号だけを示すことがある。

詳細

PEP の種類は、言語や標準ライブラリの仕様を変える Standards Track、開発プロセスを定める Process、指針を示す Informational の 3 つである。
状態も Draft / Accepted / Final / Rejected / Withdrawn / Superseded と移り変わるので、番号を見つけたら本文の冒頭にある Status を確かめる。

トラブルシューティングでよく出会う PEP には、次のものがある。

  • PEP 8: コードスタイルの指針である。
    インデントや空白に関する lint の指摘は、ここが出所になっている。
  • PEP 517 / PEP 518: ビルドバックエンドと pyproject.toml の仕様である。
    ソース配布物のビルド失敗は、この仕組みの上で起きる。
  • PEP 668: OS 管理の Python 環境を「externally managed」と印付けし、pip install を既定で拒否する仕組みである。

よくある誤解

  • PEP は公式ドキュメントの別名ではない。
    PEP は提案と決定の記録で、使い方を説明するのは公式ドキュメントの役割である。
  • 番号が新しいほど有効というわけではない。
    却下された PEP や、別の PEP に置き換えられた PEP も番号を持ったまま残る。
    Status を見ないと、有効かどうかは分からない。

関連

PEP 668 が実際に効いている状態は externally-managed-environment と pip install が externally-managed-environment で止まる で扱っている。
それを避ける隔離環境は venv の項で説明している。