23. Robustez, idempotência e recuperação

Falhas inevitáveis não precisam produzir duplicidade nem obrigar o reinício completo. Idempotência, retentativas e checkpoints permitem continuar com segurança.

Este é o capítulo 23 de 25 da apostila Python para Automação e Scripts. Ele aproveita a base construída em Programação assíncrona com asyncio e dá mais um passo no desenvolvimento da automação. Ao final, estaremos preparados para estudar Segurança de scripts Python.

Começando pela situação real

Nos capítulos finais, tratamos a execução como um serviço que precisa conviver com concorrência, interrupções, repetição e entradas hostis. As decisões anteriores passam a ser avaliadas em conjunto. Em Robustez, idempotência e recuperação, observaremos como essa parte se liga ao conjunto, mantendo claros o contrato de entrada, o processamento, os efeitos e a conferência do resultado.

Ao ler os exemplos, não tente decorar chamadas isoladas. Pergunte o que entra, qual estado muda, o que sai e como a falha aparece. Essa sequência aproxima a sintaxe do problema que ela resolve e cria uma base que continuará útil quando a biblioteca ou o ambiente mudar.

Operação idempotente

O primeiro conceito do capítulo é Operação idempotente. Ele fornece a base para interpretar os demais recursos sem confundir o nome de uma ferramenta com o comportamento que ela realmente oferece.

Operação idempotente pode ser repetida com a mesma intenção sem criar efeitos adicionais indevidos. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.

Na prática, consultar estado, usar upsert ou chave de idempotência e registrar resultado. Transforme essa orientação em passos visíveis: defina a entrada, aplique a operação, observe a saída e registre a condição de sucesso. Assim, o código continua ligado à finalidade da tarefa.

Uma forma de conferir o entendimento é observar o seguinte critério: repetição após falha incerta converge sem duplicar efeito. Esse critério deve aparecer em um teste, em uma saída controlada ou em outro efeito que possa ser reproduzido.

Retry com backoff

Depois de compreender Operação idempotente, podemos avançar para Retry com backoff. As duas ideias se conectam porque uma automação precisa preservar o contrato à medida que os dados percorrem novas etapas.

Retry com backoff repete somente falhas transitórias com espera crescente, jitter e limite. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.