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 の項で説明している。