Объясните назначение аннотаций типов в Python и приведите пример функции с аннотациями типов?

Question

Accepted Answer

Аннотации типов описывают ожидаемые типы аргументов и возвращаемых значений. Они улучшают автозаполнение, статический анализ и читаемость API.

## Пример

```python
def process_users(users: list[dict[str, object]]) -> list[str]:
    return [str(user["name"]) for user in users if bool(user.get("active"))]
```

## Разбор

Аннотации сами по себе не выполняют проверку во время выполнения, но помогают находить ошибки во время CI до `mypy` или `pyright`.

**Суммируя:**

- Подсказки типов документируют контракт функции.
- Они обеспечивают раннее обнаружение ошибок посредством статической проверки.
- Они улучшают качество API в больших базах кода.

## Итог

Аннотации типов описывают ожидаемые типы аргументов и возвращаемых значений.