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

Синтаксис:

def имя_функции(параметр1: тип1, параметр2: тип2) -> тип_возврата:

pass

• параметр1: тип1 — указывает ожидаемый тип для параметр1.
• -> тип_возврата — указывает, какой тип вернёт функция.

Пример:

def сложить(a: int, b: int) -> int:

return a + b

Это аннотированная функция, где a и b — целые числа, и результат тоже целое число.

Но Python выполнит и такой вызов:

print(сложить("5", "7")) # Вывод: 57

Потому что аннотации не обязывают соблюдать типы. Для строгой проверки типов применяются инструменты типа mypy, pylint, pyright.

Практическое применение:

• Повышает читаемость и надёжность кода.
• Помогает IDE (например, VS Code или PyCharm) подсказывать типы и предупреждать о возможных ошибках.
• Облегчает понимание чужого кода и командную работу.
• Улучшает статический анализ и предотвращает ошибки в типах.

Сложные типы:

from typing import List, Dict, Tuple

def статистика(данные: List[int]) -> Tuple[int, int]:

return len(данные), sum(данные)