generate-endpoint

Génération Endpoint FastAPI

Tu es un développeur Python senior. Tu dois générer un endpoint FastAPI complet avec validation Pydantic, gestion d'erreurs et tests.

Arguments

$ARGUMENTS

Arguments :

• Nom de la ressource (ex: user, product, order)
• (Optionnel) Type (crud, list, detail, action)

Exemple : /python:generate-endpoint user crud

MISSION

Étape 1 : Structure de l'Endpoint

app/
├── api/
│   └── v1/
│       └── endpoints/
│           └── {resource}.py
├── schemas/
│   └── {resource}.py
├── crud/
│   └── {resource}.py
├── models/
│   └── {resource}.py
└── tests/
    └── api/
        └── v1/
            └── test_{resource}.py

Étape 2 : Modèle SQLAlchemy

# app/models/{resource}.py
from datetime import datetime
from typing import Optional
from sqlalchemy import Column, String, DateTime, Boolean, Text
from sqlalchemy.dialects.postgresql import UUID
import uuid

from app.db.base_class import Base


class {Resource}(Base):
    __tablename__ = "{resource}s"

    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
    name = Column(String(255), nullable=False, index=True)
    description = Column(Text, nullable=True)
    is_active = Column(Boolean, default=True)
    created_at = Column(DateTime, default=datetime.utcnow)
    updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)

    def __repr__(self) -> str:
        return f"<{Resource}(id={self.id}, name={self.name})>"

Étape 3 : Schémas Pydantic

# app/schemas/{resource}.py
from datetime import datetime
from typing import Optional
from uuid import UUID
from pydantic import BaseModel, Field, ConfigDict


class {Resource}Base(BaseModel):
    """Schéma de base pour {Resource}."""
    name: str = Field(..., min_length=1, max_length=255, description="Nom de la ressource")
    description: Optional[str] = Field(None, description="Description optionnelle")
    is_active: bool = Field(True, description="Statut actif/inactif")


class {Resource}Create({Resource}Base):
    """Schéma pour la création."""
    pass


class {Resource}Update(BaseModel):
    """Schéma pour la mise à jour (tous les champs optionnels)."""
    name: Optional[str] = Field(None, min_length=1, max_length=255)
    description: Optional[str] = None
    is_active: Optional[bool] = None


class {Resource}InDB({Resource}Base):
    """Schéma pour la lecture depuis la DB."""
    model_config = ConfigDict(from_attributes=True)

    id: UUID
    created_at: datetime
    updated_at: datetime


class {Resource}Response({Resource}InDB):
    """Schéma de réponse API."""
    pass


class {Resource}List(BaseModel):
    """Schéma pour la liste paginée."""
    items: list[{Resource}Response]
    total: int
    page: int
    size: int
    pages: int