Melhores Práticas de Iteradores e Decorators

Diretrizes para iteração preguiçosa, higiene de decorators e pipelines composáveis - os padrões que mantêm os serviços Python seguros em memória e depuráveis.

Como Usar Esta Lista

• Revise ao construir pipelines ETL ou processadores de logs.
• Aplique em frameworks com muitos decorators (autenticação, retentativa, métricas).
• Combine com profiling quando as cadeias de iteradores ficarem profundas.
• Use em revisão de código para lambda em loops e @wraps ausentes.

A - Iteração

• Use geradores ou expressões geradoras para streams maiores que a memória. Materialize apenas no consumidor final quando necessário.
• Componha pipelines como pequenas funções geradoras. Cada estágio faz uma transformação - testes mais fáceis.
• Prefira itertools para chain, islice, groupby, product. Testados em batalha e preguiçosos.
• Ordene antes de groupby quando agrupar por chave. O requisito de chave consecutiva é fácil de esquecer.
• Documente iteradores de passagem única. Chamadores não devem assumir repetição sem tee ou list().

B - Geradores e Recursos

• Use try/finally ou @contextmanager dentro de geradores que detêm arquivos/sockets. Consumidores podem parar cedo.
• Feche geradores com .close() em testes quando a limpeza for importante. Dispara GeneratorExit no yield.
• Evite efeitos colaterais na definição do gerador - efeitos são executados no consumo. Semântica preguiçosa surpreende novatos.
• Use yield from em vez de loops for/yield manuais. Delegação e propagação de retorno mais claras.
• Limite iteradores infinitos com islice ou condições de break. count() e cycle() nunca param sozinhos.

C - Decorators

• Sempre aplique @functools.wraps em funções wrapper. Preserva __name__, documentação e anotações.
• Mantenha pilhas de decorators rasas e ordenadas consistentemente. Documente a ordem de classmethod/staticmethod.
• Parametrize via fábricas de decorators (def retry(n):). Evite configuração mutável global em decorators.
• Não engula exceções, a menos que o propósito do decorator seja supressão. Re-lance ou encadeie com from.
• Prefira middleware/Depends do FastAPI para escopo de requisição. Decorators de função para utilitários puros.

D - functools e Caching

• Cacheie apenas funções puras com argumentos hashable (lru_cache). Chame cache_clear quando as entradas mudarem externamente.
• Defina maxsize em lru_cache para espaços de chave ilimitados. Previne vazamentos de memória.
• Use singledispatch para extensão aberta por tipo. Não longas cadeias isinstance em um módulo.
• Use partial para vincular configuração, não para ocultar parâmetros obrigatórios. Mantenha assinaturas públicas legíveis.

E - Gerenciadores de Contexto

• Use with para arquivos, locks, transações de DB e configuração temporária. Não abra sem um caminho de fechamento.
• Use ExitStack quando o número de contextos for determinado em tempo de execução. Listas de arquivos dinâmicas, pilhas de plugins.
• Retorne False de __exit__ a menos que esteja deliberadamente suprimindo. Falhas ocultas corrompem o estado.
• Prefira @contextmanager para configuração/desmontagem simples com menos de 15 linhas. Baseado em classe para objetos reutilizáveis.
• Teste caminhos de rollback injetando exceções dentro do bloco with.

FAQs

Relacionados

• Geradores & yield - pipelines preguiçosos
• Escrevendo Decorators - wraps e fábricas
• Gerenciadores de Contexto - protocolo de limpeza
• Comprehensions & Expressões Geradoras - noções básicas de genexp

Versões do Stack: Esta página foi escrita para Python 3.14.0 (estável 3.14, manutenção 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, e uv 0.6+.