/python-project-styles

Opinionated python linting/formatting styles

Linting and formatting

Welcome to the opinionated python linting/formatting styles.

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

Предлагаемые инструменты призваны способствовать отлавливанию потенциальных ошибок в коде, в отличие от использования авто-форматирующих вспомогательных инструментов, которые не уберегут нас от ошибок, а вдобавок могут и привнести таковых в код.

А, главное, снижается время на чтение/разбор кода, в т.ч.:

- сокращается время на рецензирование кода (code review) другими членами команды;
- самим автором, вернувшимся к исходному коду по прошествии какого-то времени, кода уже сам забыл, что писал.

Кстати, слово linting означает корпение. Корпия - нащипанные из льняных (linen) тряпок нитки для перевязки, обработки ран. Отсюда устоявшееся выражение: "щипать корпию".