Как гарантировать контракт для функции в Python

В Python нет строгой проверки типов на этапе компиляции, но можно использовать следующие подходы:

1. Type Hints + mypy
   Аннотации типов + статический анализатор:
   python

   Копировать

   from typing import Protocol
   
   class Greeter(Protocol):
       def greet(self, name: str) -> str: ...
   
   def hello_world(g: Greeter) -> None:
       print(g.greet("World"))  # mypy проверит соответствие

2. Декораторы для проверки во время выполнения

   python

   Копировать

   def validate_types(func):
       def wrapper(*args, **kwargs):
           # Проверка типов args/kwargs по аннотациям func.__annotations__
           return func(*args, **kwargs)
       return wrapper
   
   @validate_types
   def process(data: list[int]) -> int: ...

3. ABC (Abstract Base Classes)

   python

   Копировать

   from abc import ABC, abstractmethod
   
   class DataProcessor(ABC):
       @abstractmethod
       def process(self, data: bytes) -> str: ...

4. Pydantic/Beartype
   Библиотеки для строгой валидации типов в runtime.

Лучший подход зависит от контекста: для API — Pydantic, для библиотек — Protocol + mypy, для критичного кода — runtime-проверки.