Что хотят услышать интервьюеры:

Аннотации в Python — это способ добавить к функциям, переменным и классам дополнительную информацию о типах или смысле данных. Чаще всего их используют для статической проверки типов, автодополнения в IDE и повышения читаемости кода. При этом сам интерпретатор Python обычно не заставляет их соблюдать — это именно метаданные.

Определение:

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

Пример использования:

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

age: int = 25

В этом примере name: str означает, что параметр ожидается как строка, а -> str — что функция должна возвращать строку. Аннотация у переменной age: int показывает предполагаемый тип значения.

Пояснение кода:

Кода достаточно минимального, чтобы показать принцип.

def greet(name: str) -> str: — функция greet принимает аргумент name, который ожидается как str.
-> str — аннотация возвращаемого значения функции; ожидается строка.
return f"Hello, {name}" — функция действительно возвращает строку, составленную через f-string.
age: int = 25 — переменная age помечена как целое число, что полезно для чтения кода и проверки инструментами.

Если запустить этот код, Python не будет автоматически запрещать передать, например, число вместо строки без дополнительных средств проверки. Аннотации в основном используются внешними инструментами, такими как type checker, линтеры и IDE.

Ключевые моменты:

Аннотации в Python — это метаданные, а не жесткая runtime-проверка типов.
Основная практическая польза — статическая проверка, автодополнение и документация кода.
Чаще всего аннотации пишут у параметров функций, возвращаемых значений и переменных.
Они улучшают читаемость и помогают поддерживать контракт между частями системы.
Для строгой проверки аннотаций обычно используют внешние инструменты, а не сам интерпретатор Python.

Можете объяснить, что такое аннотации в языке программирования Python и как они используются?