generated from gilles/template-webapp
61 lines
1.7 KiB
Python
61 lines
1.7 KiB
Python
"""Schémas Pydantic communs.
|
|
|
|
Définit les schémas réutilisables (pagination, erreurs, etc.).
|
|
"""
|
|
|
|
from typing import Generic, TypeVar
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
T = TypeVar("T")
|
|
|
|
|
|
class PaginationParams(BaseModel):
|
|
"""Paramètres de pagination."""
|
|
|
|
page: int = Field(default=1, ge=1, description="Numéro de page (commence à 1)")
|
|
page_size: int = Field(default=20, ge=1, le=100, description="Nombre d'éléments par page")
|
|
|
|
@property
|
|
def offset(self) -> int:
|
|
"""Calcule l'offset pour la requête SQL."""
|
|
return (self.page - 1) * self.page_size
|
|
|
|
|
|
class PaginatedResponse(BaseModel, Generic[T]):
|
|
"""Réponse paginée générique."""
|
|
|
|
items: list[T]
|
|
total: int = Field(..., description="Nombre total d'éléments")
|
|
page: int = Field(..., description="Page actuelle")
|
|
page_size: int = Field(..., description="Taille de la page")
|
|
pages: int = Field(..., description="Nombre total de pages")
|
|
|
|
@classmethod
|
|
def create(
|
|
cls, items: list[T], total: int, page: int, page_size: int
|
|
) -> "PaginatedResponse[T]":
|
|
"""Crée une réponse paginée."""
|
|
pages = (total + page_size - 1) // page_size if page_size > 0 else 0
|
|
return cls(
|
|
items=items,
|
|
total=total,
|
|
page=page,
|
|
page_size=page_size,
|
|
pages=pages,
|
|
)
|
|
|
|
|
|
class ErrorResponse(BaseModel):
|
|
"""Schéma de réponse d'erreur."""
|
|
|
|
detail: str = Field(..., description="Message d'erreur")
|
|
type: str = Field(..., description="Type d'erreur")
|
|
|
|
|
|
class SuccessResponse(BaseModel):
|
|
"""Schéma de réponse de succès."""
|
|
|
|
message: str = Field(..., description="Message de succès")
|
|
id: int | None = Field(None, description="ID de l'élément concerné")
|