PEP 8 - Руководство по стилю для кода Python


Основная документация стандарта PEP 8

Cоглашения о кодировании для кода Python, составляющего стандартную библиотеку в основном дистрибутиве Python

Это руководство по стилю со временем развивается по мере того, как выявляются дополнительные соглашения, а прежние соглашения становятся устаревшими из-за изменений в самом языке
Основные правила
1. Не используйте более 79 символов в строке кода. Более короткие строки лучше смотрятся в редакторах кода.
2. Избегайте лишних пробелов перед скобками и после
Хорошо
print('Hello!')
Плохо
print ( 'Hello!' )
3. Используйте 4 пробела на каждый уровень отступа.
Строки продолжения должны выравнивать обернутые элементы либо вертикально, используя неявное соединение строк Python внутри скобок, скобок и фигурных скобок, либо используя выступающий отступ
Пример
# Выровнено по открывающему разделителю.
foo = long_function_name (var_one, var_two,
                         var_three, var_four)

# Добавьте 4 пробела (дополнительный уровень отступа), чтобы отличать аргументы от остальных.
def long_function_name (
        var_one, var_two, var_three,
        var_four):
    печать (var_one)

# Висячие отступы должны добавлять уровень.
foo = long_function_name (
    var_one, var_two,
    var_three, var_four)
4. Окружите определения функций и классов верхнего уровня двумя пустыми строками. Определения методов внутри класса заключаются в одну пустую строку.