Ir para o conteúdo

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.