PEP 8

Python, подібно до живого організму, розвивається і набуває нових можливостей завдяки численній міжнародній спільноті згідно з певними правилами та стандартами PEP. PEP - Python Enhancement Proposal, пропозиції щодо розвитку Python. Ці стандарти дозволяють створювати уніфіковану проектну документацію для нових затверджених можливостей мови Python. Найвідоміший PEP має восьмий порядковий номер. PEP 8 містить перелік принципів написання красивого та лаконічного програмного коду на мову Python.

Єдиний стиль оформлення робить код зрозумілим для самого програміста та його колег із різним рівнем підготовки.

В ідеалі найбільш складний фрагмент коду має бути зрозумілим з першого прочитання. Це спрощує командну розробку та навчання новачків, що дозволяє вам швидко повертатися до власних давніх проектів.

PEP 8 зачіпає структуру та зовнішній вигляд коду:

вибір кодування вихідного коду;

групування інструкцій з імпорту модулів;

максимальну довжину рядка коду – рекомендується до 79 знаків, а для рядків документації (docstring) – 72 знаки;

використання відступів - табуляції та пробілів;

використання порожніх рядків для розбивки коду на блоки та виділення функцій верхнього рівня;

використання коментарів;

найменування змінних, констант, класів та екземплярів, функцій, аргументів, модулів, пакетів;

вибір рівня доступності класів та методів (public, private, API-підкласи), а також порядку їх успадкування.