Какие знаешь правила хорошего кода

1. Читаемость: код должен быть понятным без лишних комментариев. Используй осмысленные имена переменных/функций (calculate_total вместо calc).
2. DRY (Don't Repeat Yourself): избегай дублирования кода. Выноси повторяющиеся части в функции/классы.
3. KISS (Keep It Simple, Stupid): чем проще решение, тем лучше. Избегай излишней сложности.
4. SOLID:
   • Single Responsibility: одна функция/класс — одна задача.
   • Open/Closed: классы должны быть открыты для расширения, но закрыты для изменений.
   • Liskov Substitution: наследники должны заменять родителей без ошибок.
   • Interface Segregation: много специализированных интерфейсов лучше одного общего.
   • Dependency Inversion: завись от абстракций, а не от деталей.

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

def f(x, y):
    return x + y  # Что складываем? Непонятно.

Пример улучшенного:

def calculate_sum(a: int, b: int) -> int:
    """Возвращает сумму двух чисел."""
    return a + b

5. Тестируемость: код должен легко покрываться тестами (избегай глобальных состояний).
6. PEP 8: соблюдай стиль (отступы, пробелы, длина строки).
7. Документирование: пиши docstrings и комментарии там, где логика неочевидна.