【Python】コードの記述方法（コーディング規約：PEP8）

PEP8とは

PEP8（Python Enhancement Proposal #8）とは、Pythonでのコードの記述方法を記したガイドライン（コーディング規約）です。

PEP8は必ず従わなければいけないものではないです。しかしPEP8に従うことによって次のようなメリットを享受できます。

• コードの可読性が上がる
• 他のPythonプログラマと同じスタイルで記述できる
• 他のPythonプログラムが理解しやすくなる
• コードの変更作業が簡単になる

基本的にはPEP8に従ってコードを記述することをお勧めします。

特にチームで作業を行っている場合は、チームメンバーが読みやすいコードを書く必要がありますので、PEP8に従いましょう。
もちろんチーム（プロジェクト）で独自の規則があるならば、そちらを優先してください。

PEP8に記載されているコーディング規約

PEP8で定められているコーディング規約は大きく分けると次のようになります。
（実際にはもっとありますが、重要な部分のみを抜粋しています。）

• レイアウト
• 式と文
• インポート
• 命名規則

次項よりそれぞれの規約について詳しく解説していきます。

インデント

Pythonにおいてインデント（字下げ）は非常に重要な意味を持ちます。

C言語では、複数の文を１つのブロックとして記述するときに「{}」（波かっこ）を利用します。

if (x > y) {
    printf("x > y");
} else {
    printf("x < y");
}

Pythonでは波かっこは使わずにインデントでブロックを表します。

if x > y:
    print('x > y')
else:
    print('x < y')

このインデントが間違っているとIndentationErrorが発生します。

規約にはインデントにはタブではなく空白を使うこと、そしてインデントに４個の空白を使うことが明示されています。

改行後のインデント

Pythonでは改行は文の終わりを意味します。

C言語やJavaではセミコロンが文の終わりを意味していたので、それら言語に慣れている人はよく間違えます。

しかしPythonでも文の途中で改行してもよい場面があります。
それは括弧を使いブロックを明示しているときです。

１文の途中で改行した場合は、インデントの方法がいくつかあります。

まず１つ目に、次のようにインデントを開始区切り文字に合わせます。

def function(first_name, last_name,
        age, address):
    return first_name

２つ目に、次のように開始区切り文字の直後に改行を行い、１つインデントを加えます。

def function(
        first_name, last_name,
        age, address):
    return first_name

person = function(
    office, five, 54, Japan)

そのため次のような記述はPEP8では間違いです。

# 区切り文字に続けて引数を指定する場合、改行後は区切り文字に揃える
person = function(office, five,
    54, Japan)

# 引数のインデントをもう一つ深くする
def function(
    first_name, last_name,
    age, address):
    return first_name

リストの場合は以下どちらの記述方法でも構わないです。

list1 = [
    1, 2, 3,
    4, 5, 6,
    ]

list2 = [
    1, 2, 3,
    4, 5, 6,
]

１行の長さ

コードの１行の長さは79文字以下にします。

ですが無理やり79文字以下にしなくてもかまいません。また１文が79文字以上になる場合、バックスラッシュを差し込むことで改行は許容されます。

空白行

コードの可読性を上げるために空白行を入れることはとても重要です。

空白行の重要な使い方の一つにトップレベルの関数とクラスの間に２つの空白行を挿入するというのがあります。

class ClassOne:
    pass


class ClassTwo:
    pass


def my_function():
    return None

次にクラス内の関数はそれぞれ１つの空白行を挿入します。

class ClassOne:
    def method_one(self):
        return None

    def method_two(self):
        return None

演算子

代入演算子や比較演算子、ブール値（and、or、not）の前後には１つのスペースを入れます。

しかし引数にデフォルト値を代入する場合はスペースは必要ありません。

式中に複数の演算子が存在する場合は、最も優先度が低い演算子の前後に空白を入れます。

# 正しい
y = (x+y) - (y-x)
if y>5 and y<15:
    print(y)
# 間違え
y = (x + y) - (y - x)
if y > 5 and y < 15:
    print(y)

括弧・ブランケット・波括弧

開始記号の直後や終了記号の直前にスペースは入れないようにしましょう。

# 正しい
function(office[54], {y:2})
five = (5,)

# 間違え
function( office[ 54 ], { y:2 } )
five = (5, )

カンマ・コロン・セミコロン

カンマ・コロン・セミコロンの直前にはスペースは入れず直後にスペースを入れます。

# 正しい
if y == 5: print y, x + y; x, y = y, x

# 間違え
if y == 5 : print x , x + y ; x , y = y , x

スライスの場合は前後にスペースは入れません。

# 正しい
office[4:5]

# 間違え
office[4: 5]

式の否定

notで式を否定する場合、if a is not bの形を使う。

# 正しい
if y is not None:
    pass

# 間違い
if not y is None:
    pass

if a is not bとif not a is bは機能面は同じですが、可読性の良い前者を利用するようにしましょう。

空値のチェック

空値かどうかを確認する際に、シーケンス（リストや文字列など）の長さをチェックはせずに、Falseであるかでチェックします。

# 正しい
if not mylist:
    pass

# 間違い
if len(mylist) == 0:
    pass

ブール値の確認

式がブール値のTrueまたはFalseかを確認するときに比較演算子（==）は使用しません。

# 正しい
if bool_value:
    return 'True'

# 間違い
if if bool_value == True:
    return 'True'

先頭に記入

import文は特別なことがない限り、スクリプトの先頭に記入します。

import文の順番は次の流れで記載し、グループで分けます。

1. 標準ライブラリ
2. サードパーティー
3. 自作したモジュール

それぞれのグループは１行の空行を入れます。またグループの中でも、アルファベット順に記載します。

行を分ける

１つのimport文で複数のライブラリをインポートしないようにします。

# 正しい
import openpyxl
import os

# 間違え
import openpyxl, os

モジュールの絶対名を使う

モジュールの絶対名でインポートを行うようにします。

例えばパッケージofficeからモジュールfiveをインポートする際は次のように記述します。

from office import five

クラスと例外

クラスと例外の名前は、単語の先頭を大文字にして繋げる方式（CapitalizedWords）を使用します。
このスタイルをキャメルケースと呼びます。

クラス名はアンダースコアで区切ることはしません。

パッケージ名とモジュール名

Pythonのパッケージとモジュールにはすべて小文字の短い名前にします。

モジュールに関しては、名前にアンダーバーを使っても大丈夫です。

関数と変数

関数と変数の名前は、すべて小文字にする、またはすべて小文字にして単語をアンダーバーで繋げます。