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

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

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

def greet(name: str, age: int) -> str:
    return f"Привет, {name}! Тебе {age} лет."

Где:

• name: str — аргумент name ожидается как строка
• age: int — аргумент age ожидается как целое число
• -> str — функция возвращает строку

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

from typing import List, Dict

def process_data(data: List[Dict[str, int]]) -> None:
    ...

Аннотации проверяются такими инструментами, как mypy, pyright или IDE (PyCharm, VSCode). Они не обязательны, но улучшают читаемость и поддерживаемость кода.