Как в SQLAlchemy используется модуль typing

SQLAlchemy активно использует модуль typing для аннотации типов, что улучшает поддержку IDE и статических анализаторов (например, mypy). Основные применения:

1. Аннотации моделей – для указания типов колонок:

from sqlalchemy import Column, Integer, String
from typing import Optional

class User(Base):
tablename = 'users'
id: int = Column(Integer, primary_key=True)
name: str = Column(String)
age: Optional[int] = Column(Integer, nullable=True)

2. **Типы запросов** – для аннотации результатов:
```python
from sqlalchemy.orm import Session
from typing import List

def get_users(session: Session) -> List[User]:
    return session.query(User).all()

3. Специальные типы SQLAlchemy:

from sqlalchemy.sql.selectable import Select
from typing import Any

def build_query() -> Select[Any]:
    return select(User)

Особенности:

• Optional для nullable полей
• Any для сложных SQL-выражений
• Mapped (в SQLAlchemy 2.0+) для более точной аннотации моделей