Что такое хороший код

Хороший код обладает следующими характеристиками:

1. Читаемость - понятные названия переменных/функций, соблюдение PEP8, логичная структура
2. Поддерживаемость - легко вносить изменения, есть комментарии где нужно
3. Эффективность - оптимальные алгоритмы, но без преждевременной оптимизации
4. Тестируемость - модульность, отсутствие скрытых зависимостей
5. Надежность - обработка ошибок, edge cases

Пример хорошего кода:

def calculate_average(numbers: list[float]) -> float:
    """Возвращает среднее значение списка чисел."""
    if not numbers:
        raise ValueError("Список чисел не может быть пустым")
    return sum(numbers) / len(numbers)

Плохой код (для контраста):

def avg(x):
    return sum(x)/len(x)  # нет проверок, непонятные названия

Хороший код экономит время и нервы всей команды в долгосрочной перспективе.