typing — Поддержка аннотаций типов

from typing import List, Dict, Optional, Union, Callable

Базовые аннотации

name: str = "Алиса"
age: int = 30

def greet(name: str) -> str:
    return f"Привет, {name}!"

Коллекции

# Python 3.9+
names: list[str] = ["Алиса", "Боб"]
scores: dict[str, int] = {"Алиса": 95}
coords: tuple[float, float] = (3.14, 2.71)

Optional и Union

from typing import Optional, Union

def find_user(user_id: int) -> Optional[str]:
    return "Алиса" if user_id == 1 else None

# Python 3.10+
def process(value: str | int) -> str:
    return str(value)

Callable

from typing import Callable

def apply(func: Callable[[int, int], int], a: int, b: int) -> int:
    return func(a, b)

TypedDict

from typing import TypedDict

class UserDict(TypedDict):
    name: str
    age: int

Важно

• Аннотации не проверяются при выполнении — только для инструментов
• Используйте mypy для проверки типов
• Python 3.10+: X | Y вместо Union[X, Y]

Официальная документация

typing — Support for type hints

Полный справочник API (API Reference)

Базовые типы

Специальные конструкции