Введение в Python урок 8 из 28
PEP 8 - руководство по написанию кода на Python
Этот документ описывает соглашение о том, как писать код для языка python, включая стандартную библиотеку, входящую в состав python. PEP 8 создан на основе рекомендаций Гуидо ван Россума с добавлениями от Барри. Если где-то возникал конфликт, мы выбирали стиль Гуидо. И, конечно, этот PEP может быть неполным (фактически, он, наверное, никогда не будет закончен). Ключевая идея Гуидо такова: код читается намного больше раз, чем пишется. Собственно, рекомендации о стиле написания кода направлены на то, чтобы улучшить читаемость кода и сделать его согласованным между большим числом проектов...
Автоформатирование в Python. Библиотека autopep8 автоматически форматирует код Python в соответствии с руководством по стилю PEP 8. Она использует утилиту pycodestyle для определения того, какие части кода необходимо отформатировать. autopep8 способна устранить большинство проблем с форматированием, о которых может сообщать pycodestyle. Установка $ pip install autopep8 Библиотека YAPF использует другой подход. Он основан на «clang-format», разработанном Daniel Jasper. В сущности, алгоритм берет код и переформатирует его до формата, соответствующего стилю руководства, даже если исходный код не нарушает руководство по стилю. Конечная цель состоит в том, что код python c YAPF пишется так же хорошо, как код, который мог бы написать программист, если бы следовал руководству по стилю. $ pip install yapf black — бескомпромиссный форматтер кода. Почему бескомпромиссный? Потому что black навязывает свой стиль кода, и его практически нельзя конфигурировать. И это огромный плюс black. $ pip install black