Revisor Sênior de Código Python e Aprimorador

Aqui está a tradução para o português brasileiro, preservando todos os placeholders, nomes de marcas/modelos, flags de parâmetros, chaves de código/JSON e estrutura, conforme solicitado: --- **ETAPA 1 - Auditoria de Documentação (Docstrings e Comentários)** - Se as docstrings estiverem AUSENTES: Adicione docstrings adequadas a todas as funções, classes e módulos usando o estilo Google ou NumPy. - Se as docstrings estiverem PRESENTES: Revise-as quanto à precisão, completude e clareza. - Revise comentários inline: Remova os redundantes, adicione comentários significativos onde a lógica não for trivial. - Adicione ou melhore as dicas de tipo (type hints) onde apropriado. **ETAPA 2 - Verificação de Conformidade PEP8** - Identifique e corrija todas as violações PEP8, incluindo convenções de nomenclatura, indentação, comprimento de linha, espaços em branco e ordenação de importações. - Remova importações não utilizadas e agrupe as importações como: biblioteca padrão, depois terceiros, depois locais. - Destaque cada correção feita com uma justificativa de uma linha. **ETAPA 3 - Plano de Melhoria de Desempenho** Antes de modificar o código, liste todos os problemas de desempenho encontrados usando este formato: | # | Área | Problema | Correção Sugerida | Gravidade | Impacto na Complexidade | |---|------|----------|-------------------|-----------|--------------------------| Gravidade: [crítico] / [moderado] / [menor] Impacto na Complexidade: Observe a mudança no Big O quando aplicável (ex.: O(n^2) para O(n)) Também destaque a falta de tratamento de erros se o código realizar operações arriscadas. **ETAPA 4 - Código Melhorado Completo** Agora forneça o código Python reescrito por completo, incorporando todas as correções das Etapas 1, 2 e 3. - O código deve estar limpo, pronto para produção e totalmente comentado. - Garanta que o código reescrito seja modular e testável. - Não omita nenhuma parte do código. Sem placeholders como "# igual ao anterior". **ETAPA 5 - Cartão de Resumo** Forneça um resumo conciso antes/depois neste formato: | Área | O que Mudou | Impacto Esperado | |-------------------|-------------------------------------|-------------------------| | Documentação | ... | ... | | PEP8 | ... | ... | | Desempenho | ... | ... | | Complexidade | Antes: O(?) para Depois: O(?) | ... | Aqui está o meu código Python: ${cole_seu_codigo_aqui}