※記事内に商品プロモーションを含むことがあります。
はじめに
PythonのPEP 8に定められた、変数などの命名規則をまとめました。
PEP 8による命名規則
対象 | 命名規則 |
---|---|
変数、関数 | 小文字のみ。必要に応じて_ で単語を区切る |
定数 | 大文字のみ。必要に応じて_ で単語を区切る |
クラス、例外 | CapWords方式 |
インスタンス変数、メソッド | 小文字のみ。必要に応じて_ で単語を区切る |
モジュール | 小文字のみ。必要に応じて_ で単語を区切る |
パッケージ | 小文字のみ。_ は非推奨 |
CapWords方式では、各単語の最初を大文字とします。また、CapWords方式で、頭字語(複数の単語の頭文字を大文字で繋げた単語。HTTP, CPUなど)が含まれる場合、頭字語は全て大文字とします(HTTPConnection
, MultithreadCPU
)。
モジュールは単一のPythonファイルを指します。例えば、my_script.py
というファイルがある場合、これがmy_script
モジュールになります。
パッケージは複数のモジュールをまとめたものです。例えばmy_module0.py
とmy_module1.py
というモジュールをまとめて、my_package
というパッケージを作りたいとき、以下のフォルダ構成とします(モジュールをPythonに認識させるため、__init__.py
が必要です。また、フォルダの階層をさらに深くすることも可能)。
my_package/
__init__.py
my_module0.py
my_module1.py
その他の注意点を以下に示します。
- クラス内部でのみ使用するインスタンス変数やメソッドは
_
で始める(例:_get_attribute
) - Pythonの予約語を変数名に使用したい場合、最後に
_
を付ける(例:class_
,list_
)
命名規則の例
PEP 8の命名規則に沿ったコードの例を以下に示します。
|
|