Python 3.14+ エキスパート ベストプラクティス

シンプルで、実用的で、意見的。本番級の Python コードを書くために必要なことだけ。

適用場面

以下の場合にこれらのガイドラインを参照してください:

• Python の関数、クラス、またはモジュールを記述する
• エラーハンドリング問題について Python コードをレビューする
• 既存の Python コードベースをリファクタリングする
• データ検証と API 境界を実装する
• エラー検出とデバッグパターンを最適化する

優先度別ルールカテゴリ

クイックリファレンス

• dict-required-keys - 必須の辞書キーに対して d[key] を使い、KeyError で高速に失敗させる
• no-mutable-defaults - 関数/メソッドパラメータで可変型のデフォルト値を使用しない
• operators-return-notimplemented - サポートされていないオペランド型に対して NotImplemented を返す。+ と += の動作を意図的に設計する
• no-generic-except - 予期しないエラーを隠さないようにジェネリックな except 句を避ける
• listcomp-no-side-effects - リスト内包表記は使用する値を生成する必要がある（副作用のあるリスト内包表記は避ける）
• no-inline-imports - すべてのインポートステートメントをファイルの最上部に配置する
• avoid-explanatory-comments - 自己説明的なコードには不要なコメントを避ける
• unnecessary-else-blocks - return/break/continue ステートメント後の不要な else ブロックを避ける

使い方

詳細な説明とコード例は、個別のルールファイルを参照してください:

rules/dict-required-keys.md
rules/no-mutable-defaults.md
rules/operators-return-notimplemented.md
rules/no-generic-except.md
rules/listcomp-no-side-effects.md
rules/no-inline-imports.md
rules/avoid-explanatory-comments.md
rules/unnecessary-else-blocks.md

各ルールファイルには以下が含まれます:

• 重要な理由の簡潔な説明
• パターンを使用する場合と使用しない場合
• 実装要件
• 不正なコード例と説明
• 正しいコード例と説明
• 追加のコンテキストと参考資料