Аннотации типов: первое знакомство
Аннотации типов — это подсказки о том, какие значения принимает и возвращает функция. Python их не проверяет, но редакторы и инструменты вроде mypy — да. Здесь самое необходимое для старта.
Аннотации параметров и результата
После имени параметра ставится двоеточие и тип, а тип результата указывается после стрелки ->:
def greet(name: str, times: int = 1) -> str:
return ("Привет, " + name + "! ") * times
print(greet("Анна", 2))
# Привет, Анна! Привет, Анна!
def log(message: str) -> None:
print("LOG:", message)
log("готово") # LOG: готово
-> None говорит, что функция ничего полезного не возвращает. Значение по умолчанию пишется после типа: times: int = 1.
Python не проверяет типы сам
def double(x: int) -> int:
return x * 2
print(double(4)) # 8
print(double("ab")) # abab - ошибки нет!
Код выполнится: аннотации лишь документация. Ошибку покажет редактор или проверка mypy, запущенная отдельно.
Типы коллекций
С Python 3.9 встроенные типы можно параметризовать напрямую:
def total(numbers: list[int]) -> int:
return sum(numbers)
def word_count(words: list[str]) -> dict[str, int]:
result: dict[str, int] = {}
for w in words:
result[w] = result.get(w, 0) + 1
return result
print(total([1, 2, 3])) # 6
print(word_count(["да", "нет", "да"])) # {'да': 2, 'нет': 1}
Аннотацию можно ставить и переменной: result: dict[str, int] = {}.
Необязательное значение и несколько типов
Оператор | (Python 3.10+) означает «или»:
def find_index(items: list[str], target: str) -> int | None:
if target in items:
return items.index(target)
return None
def to_number(value: int | str) -> int:
return int(value)
print(find_index(["a", "b"], "b")) # 1
print(find_index(["a", "b"], "z")) # None
print(to_number("42")) # 42
Зачем это нужно
- Читая сигнатуру, сразу понятно, что передавать и что вернётся.
- Редактор подсказывает методы и ловит опечатки до запуска.
- Аннотации видны через
greet.__annotations__.
Не нужно аннотировать всё сразу. Начните с сигнатур функций — это даёт больше всего пользы при наименьших усилиях.
Добавьте аннотации в свою функцию average из урока про *args и в функцию stats из урока про возвращаемые значения. Затем напишите first_word(text: str) -> str | None, возвращающую первое слово строки или None для пустой строки.
Оглавление курса
Модуль 1Старт10
- 1Что такое Python и где он применяется
- 2Установка Python: Windows, Linux, macOS
- 3Несколько версий Python: pyenv и uv
- 4Интерактивная консоль: REPL и IPython
- 5Первый скрипт: print и запуск файла
- 6Редактор: VS Code и PyCharm
- 7pip и виртуальные окружения venv
- 8Комментарии и стиль кода: PEP 8
- 9Как читать документацию: help и docs.python.org
- 10Дзен Python и «питонический» код
Модуль 2Данные и операторы10
Модуль 3Управление потоком10
Модуль 4Коллекции10
Модуль 5Функции10
Модуль 6Строки и файлы10
Модуль 7Объекты и классы10
Модуль 8Наследование и протоколы10
Модуль 9Ошибки и отладка10
Модуль 10Продвинутые возможности10
Модуль 11Современный Python10
- 101Pattern matching: match / case
- 102Аннотации типов и mypy
- 103Generics, Protocol и TypedDict
- 104Современный синтаксис: |, :=, positional-only
- 105asyncio: основы
- 106async / await: паттерны и gather
- 107Потоки: threading
- 108Процессы: multiprocessing
- 109GIL, память и сборщик мусора
- 110Новое в Python: free-threading и JIT
