Объясните, что означает контракт между модулями при взаимодействии в Python и как он реализуется

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

В Python контракт реализуется неформально через документацию (docstrings), соглашения о наименованиях и типах данных (часто с помощью аннотаций типов). Также можно использовать абстрактные базовые классы (ABC) и интерфейсы для более строгого определения контрактов.

Пример простого контракта через функцию с аннотациями и docstring:

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

Здесь контракт — функция принимает два целых числа и возвращает целое число. Другой модуль, вызывая эту функцию, ожидает именно такое поведение.