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

Аннотация — это механизм в Python для добавления метаданных к переменным, аргументам функций, возвращаемым значениям и другим элементам кода. Они не влияют на выполнение программы, но помогают в документировании и проверке типов (например, через mypy).

Пример аннотации типов:

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

Ключевые особенности:

• Поддерживаются с Python 3.0 (базовые аннотации) и улучшены в 3.5+ (typing module)
• Можно использовать встроенные типы (int, str) или сложные (List[Dict[str, int]])
• Не обязательны для выполнения кода (runtime), но полезны для статического анализа
• Можно аннотировать переменные: age: int = 25