Что такое аннотация типа

Аннотация типа (type hint) — это указание ожидаемого типа данных для переменных, аргументов функций и возвращаемых значений. Это помогает статическим анализаторам (например, mypy) находить ошибки, улучшает читаемость кода и документирует его.

Пример с функцией:

def greet(name: str) -> str:
    return f"Hello, {name}"

Здесь:

• name: str — аргумент name должен быть строкой.
• -> str — функция возвращает строку.

Для сложных типов используют модуль typing:

from typing import List, Dict

def process_data(data: List[Dict[str, int]]) -> None:
    for item in data:
        print(item)

Аннотации не влияют на выполнение кода (Python их игнорирует в runtime), но полезны для разработчиков и инструментов.