Типичные улучшения

Для поиска по тегу начните название тега с символа '@'.

Улучшения, показаны 21 из 21.

Избавьтесь от лишних функций

Если функция не упрощает код, то от нее лучше избавиться. Лишняя абстракция затруднит понимание и …

Используйте None как пустое значение

В Python есть специальный объект для обозначения пустого значения — `None`. Его возвращают функции, когда …

Сделайте функцию требовательной к качеству входных данных

Функция не обязана работать с абсолютно любыми входными данными. Правильно и удобно делать часть аргументов …

Соберите код cli в одном месте

Функции не годятся для повторного использования, если внутри них прячутся вызовы `print`, `input` или `argparse`. …

Используйте в названиях правильный регистр букв

Верхний и нижний регистр букв в названиях имеют значение. По ним программист узнает тип сущности: …

Избавьтесь от дубликатов функций

Дублирование кода приводит к быстрому росту его объема. А чем больше кода, тем сложнее его …

Укажите все аргументы функции

Функция может получать настройки из нескольких источников: из полученных аргументов и из глобальных констант и …

Начните название функции с глагола

Каждая функция — это действие, поэтому название должно содержать глагол. Еще лучше, если название начинается …

Вынесите решение проблемы наружу функции

Порой функция обещает вернуть полезные данные, но сделать этого не может — не нашла файл, …

Откажитесь от модификации входных аргументов

У Python есть интересная особенность — при вызове функция получает не копию аргументов, а их …

Укажите default value для аргумента функции

В Python для функции можно задать опциональный аргумент, указав для него значение по умолчанию — …

Разбейте функцию на части

Функции — это строительные блоки вашей программы. Они похожи на детали конструктора Lego — из …

Изолируйте функцию от внешнего окружения

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

Очистите функции

В программировании есть такое понятие — *чистая функция*. От прочих она отличается тем, что не …

Уточните название функции

Названия функций важны. Хорошее название подсказывает программисту, что делает код функции и что он вернёт …

Вынесите копипасту в функцию

Копипаста кода — это плохо. Во-первых, если код нужно будет поменять — придётся искать все …

Предупредите код снаружи функции о проблеме

Если функция не справилась со своей задачей, то внешнему коду полезно об этом знать. Вдруг, …

Разбейте большой блок кода на функции

Когда блок кода перестаёт умещаться в половину экрана монитора приходит пора бить его на функции. …

Распакуйте параметры функции

Функции созданы для того, чтобы ими пользоваться. А чтобы функцией пользоваться, надо выяснить какие данные …

Отделите обработку данных от ввода вывода

Функцию удобно использовать, когда она делает что-то одно - скачивает информацию из сети, либо читает …

deprecated
Привяжите функцию к предметной области

Абстрактную функцию легко приладить к решению новых задач, но если перегнуть палку и сделать её …

deprecated