Как понять что код хороший

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

1. Читаемость – код легко понять даже без комментариев. Используются осмысленные имена переменных/функций, соблюдается PEP 8.
2. Поддерживаемость – код легко изменять и расширять. Нет дублирования (DRY принцип).
3. Эффективность – адекватная производительность без избыточной оптимизации.
4. Тестируемость – код модульный, с минимальными зависимостями, покрыт тестами.

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

def calculate_discount(price: float, discount_percent: float) -> float:
    """Calculate final price after discount."""
    if discount_percent < 0 or discount_percent > 100:
        raise ValueError("Discount must be between 0 and 100")
    return price * (1 - discount_percent / 100)

Плохой вариант той же функции:

def calc(p, d):  # Неясные имена
    return p - p*d/100  # Нет проверок, нет докстринга

Хороший код – это баланс между простотой, надежностью и гибкостью.