Minha foto

Riverfount

Desenvolvedor Python & entusiasta de open source

Posts Recentes

Seu datetime.utcnow() pode estar mentindo sobre o fuso horário

Seu datetime.utcnow() pode estar mentindo sobre o fuso horário

Cenário fictício, mas plausível em qualquer time que já mexeu em coluna de timestamp num banco em produção: pedidos criados às 21h aparecem no painel administrativo com horário de 18h do mesmo dia. Não é só uma questão de exibição no frontend, o valor gravado no banco já chega errado, e a diferença é sempre a mesma, três horas, exatamente o offset entre UTC e o horário de Brasília. A investigação leva até uma migração recente que trocou o tipo da coluna criado_em de TIMESTAMP para TIMESTAMP WITH TIME ZONE, parte de um trabalho maior para dar suporte a clientes em fusos diferentes. Ninguém precisou mexer no modelo em si para isso funcionar. ...

16 de setembro de 2026 · 6 min · 1177 words · Riverfount
O CI trava em lint antes de chegar no teste

O CI trava em lint antes de chegar no teste

Um pipeline de CI que ajudei a diagnosticar recentemente levava quatro minutos e meio para chegar no primeiro teste. Não quatro minutos e meio de suíte de testes: quatro minutos e meio de lint. flake8 rodando as regras de estilo, black --check validando formatação, isort --check conferindo ordem de imports, pylint fechando a lista com suas próprias verificações de design. Quatro processos Python inicializando, cada um lendo a árvore inteira do projeto, cada um com seu próprio cache (quando tinha cache configurado), cada um bloqueando o passo seguinte do workflow. O problema não é que essas ferramentas sejam ruins. black formata bem, isort organiza imports de forma previsível, pylint pega coisas que o resto ignora. O problema é a soma: quatro binários Python, quatro tempos de inicialização do interpretador, quatro passadas pela árvore de arquivos, para resolver um conjunto de checagens que, na prática, se sobrepõe bastante. ...

14 de setembro de 2026 · 5 min · 924 words · Riverfount
mongo_bakery: o fim da factory que você escrevia pra cada Document do MongoEngine

mongo_bakery: o fim da factory que você escrevia pra cada Document do MongoEngine

O teste queria garantir uma coisa só: cancelar um pedido pendente devolve 200. Pra chegar até essa asserção, ele teve que passar por isso primeiro: ...

16 de agosto de 2026 · 7 min · 1437 words · Riverfount
asyncio.TaskGroup: quando gather não é suficiente

asyncio.TaskGroup: quando gather não é suficiente

Um endpoint de checkout dispara três operações concorrentes com asyncio.gather: cobra o cartão, reserva o estoque, envia a notificação de confirmação do pedido. O serviço de pagamento cai no meio da chamada e lança uma exceção. gather propaga esse erro imediatamente para quem está aguardando. O handler captura a exceção, devolve um 500 para o cliente, registra a falha no log. Para quem está de plantão, o sistema reagiu do jeito certo. ...

12 de agosto de 2026 · 7 min · 1351 words · Riverfount
Protocol: duck typing com garantias em tempo de análise

Protocol: duck typing com garantias em tempo de análise

Você herdou um sistema de cálculo de descontos. Não tem classe base, não tem ABC, não tem interface formal nenhuma. Cada tipo de desconto (cupom, fidelidade, campanha sazonal) é só uma classe qualquer com um método aplicar(pedido) que devolve o valor final. O código que orquestra isso nem sabe que tipo de objeto está recebendo, só chama desconto.aplicar(pedido) e segue em frente. Duck typing raiz: se anda como pato e grasna como pato, aplica desconto como pato. ...

22 de julho de 2026 · 6 min · 1198 words · Riverfount
Ver todos os posts →