Receitas¶
As receitas resolvem um problema pontual de cada vez — código completo, copy-paste, com a teoria do por quê logo ao lado. São o complemento prático do Tutorial: o tutorial te ensina os conceitos em ordem; as receitas mostram como aplicá-los em situações reais do dia a dia.
Como ler
Cada receita é independente — pule direto pra que você precisa. Todas assumem que você já passou pelo Tutorial (modelos, queries, execução).
Disponíveis¶
| Receita | Resolve |
|---|---|
| created_at / updated_at | Timestamps gerenciados pelo banco, sem lembrar de setar na mão. |
| Paginação tipada | Listas paginadas com total/páginas, alinhadas ao tempest-fastapi-sdk. |
| Agregações e DISTINCT | count/sum/avg/min/max + GROUP BY tipado e DISTINCT. |
| Upsert (ON CONFLICT) | Inserir resolvendo conflito de chave: DO NOTHING ou DO UPDATE. |
| Active-record (opt-in) | Métodos save/update/delete/reload numa linha, quando você prefere. |
| Logging e erros | Ver o SQL que roda (onQuery) e erros com o SQL/params que falharam. |
| Transações e savepoints | Operações atômicas com commit/rollback automático e pontos de salvamento. |
| Colunas JSON e enum | Guardar objetos tipados e uniões literais com segurança de tipos. |
| Serialização (linha ↔ JSON) | Converter linhas pra JSON e validar JSON de volta pra linha. |
| Conectando ao PostgreSQL | Trocar SQLite por Postgres pela URL e ajustar o pool. |
Procurando algo maior?¶
Se você quer ver tudo junto num projeto que roda, vá pra Exemplos: um Todo CLI, um blog com relations, uma REST API e o fluxo completo de migrações.