Какие знаешь рекомендации при написании функции

1. Одна функция — одна задача: Функция должна выполнять только одну операцию. Это упрощает тестирование и переиспользование.
2. Читаемость имен: Имя функции должно четко отражать её назначение (например, calculate_total_price вместо calc).
3. Лимит аргументов: Старайтесь не передавать больше 3-4 параметров. Для многих параметров используйте *args/**kwargs или объекты.
4. Документирование: Используйте docstrings (PEP 257) для описания функции, её параметров и возвращаемого значения.
5. Избегайте побочных эффектов: Функция не должна изменять глобальные переменные или входные аргументы (если это не ожидается).

Пример:

def format_user_name(first_name: str, last_name: str) -> str:
    """Возвращает полное имя пользователя в формате 'Фамилия Имя'."""
    return f"{last_name} {first_name}"

6. Обработка ошибок: Явно проверяйте входные данные и выбрасывайте исключения (ValueError, TypeError).
7. Длина функции: Оптимально — не более 10-15 строк. Если больше — стоит разбить на подфункции.