Найти тему
Programmer's Road

Как писать понятный и красивый код на Python?

Зачем писать чистый код?

Если у тебя большой проект или программа, то скорее всего ты будешь его дописывать и дорабатывать. Чем понятнее код, тем быстрее ты сможешь разобраться в нём (или даже коллеги). В Python есть большая документация по рекомендациям написания чистого кода(PEP-8) и вот несколько пунктов:

1.
Переменные
Называйте переменные и функции максимально понятно, полно и сжато, они должны передавать названием их полное содержание, тогда можно будет понять код даже без строчек присваивания.

2.
Отступы

Запись математических вычислений с числами в основном влезает в одну строку, а вот с переменными уже нет, поэтому лучше записывать каждый операнд выражения с переменными на отдельной строке. При присваивании значения необязательным аргументам sep и end нежелательно ставить пробел(Правильно: sep="!". Неправильно: sep = "!")

3.
Комментарии

Комментарии пишутся после знака решётки(#), для комментария на строчке кода нужно сделать внушительный отступ(2+).

3.
Импортирование модулей

Импортировать модули нужно всегда вначале кода и делать пустую строчку между кодом и импортированием), причём импортировать нужно по одному модулю и в таком порядке: import (название модуля) *Пустая строка* from *название модуля* import (название отдельных частей модуля или *) *Весь остальной код*
5.
Как выглядит лучший код?

Если код выглядит как текст на английском языке - это идеально.

Я веду свой телеграм канал про мой путь разработчика! Я предлагаю к решению разные задачки, рассказываю интересные лайфхаки и обсуждаю истории из моего обучения! Жду всех -
https://t.me/vm_programmer