[Projeto] Avaliação do Projeto - Saborexpress API (curso Python 3)

Oi, Carloslessa! Como vai?

Sua implementação da Saborexpress API ficou muito bem estruturada! Chamou atenção o cuidado com a validação via Pydantic, o uso de herança e polimorfismo e a cobertura de 94% nos testes, além da preocupação com a PEP 8 e type hints.

Uma dica interessante para o futuro é explorar o uso de response_model no FastAPI para garantir que as respostas das suas rotas sigam um formato bem definido e validado automaticamente. Veja este exemplo:

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Restaurante(BaseModel):
    nome: str
    ativo: bool

@app.get("/restaurantes", response_model=Restaurante)
def listar_restaurante():
    return {"nome": "Saborexpress", "ativo": True}

Esse código define um modelo de resposta para a rota, garantindo que o FastAPI só retorne dados no formato esperado.

Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!

Obrigado, Armano Júnior,

Eu acreditei ter implementado o response_model.

Aqui no schema pydantic:

# schemas/schemas.py

from pydantic import BaseModel


class RestaurantSummary(BaseModel):
    model_config = ConfigDict(
        validate_by_name=True,
        json_schema_extra={
            "example": {
                "nome": "Sabor & Cia",
                "categoria": "Brasileira",
                "media_avaliacoes": 4.5,
                "ativo": True,
            }
        },
    )

E a etapa no main.py

# main.py
from fastapi import FastAPI

from schemas.schemas import  RestaurantSummary


@app.get(
    "/restaurants/summary",
    response_model=List[RestaurantSummary],
    summary="Lista sumarizada de restaurantes",
)
async def summary_restaurants():
    """Retorna resumo (nome, categoria, situaçao e média de avaliações)"""
    return [
        {
            "nome": r._nome,
            "categoria": r._categoria,
            "ativo": r.ativo,
            "media_avaliacoes": r.media_avaliacoes,
        }
        for r in Restaurante.restaurantes
    ]

Alguma correção?

Boa tarde, Carlos!

Acabei deixando esses pontos passarem quando estava escrevendo a dica, realmente já estava em uso no seu projeto.

No mais, não tenho nenhuma sugestão de correção para ser feita!

Obrigado pelo feedback, Armano Júnior!