Некоторые основные рекомендации по форматированию кода, содержащиеся в PEP8:
- Структура кода. 1 Внутренние блоки кода выделяются отступами, размер отступа — четыре пробела, табуляция не используется. 1 Длина строк не должна превышать 79 символов. 2
- Имена. 2 Имена функций, переменных и атрибутов должны следовать формату lowercase_underscore (нижний регистр букв, разделение слов символами подчёркивания). 2 Имена классов и исключений должны следовать формату CapitalizeWord (каждое слово начинается с прописной буквы). 2
- Комментарии. 13 Нужно писать полные предложения с заглавной буквы, ставить два пробела после точки в комментариях, кроме последнего предложения. 1 Блочные комментарии выравнивать на том же уровне и начинать каждую строку с # и пробела. 1
- Отступы. 2 Между определениями функций и классов в файлах следует вставлять две пустые строки, между определениями методов в классах — одну пустую строку. 2