Boas práticas, erros comuns e testabilidade

🎯 Boas práticas e erros comuns

Nesse módulo, vamos aprender a tornar o código condicional mais claro e resistente. Um dos primeiros erros que aparecem é a indentação irregular, que leva a erros de sintaxe ou a blocos de código mal definidos. (1) A prática recomendada é manter uma indentação consistente (geralmente 4 espaços) e evitar ifs aninhados profundamente; quando a lógica fica complexa, é sinal de que podemos extrair parte dela para funções separadas. (2) Outra fonte comum de problemas são condições muito longas que dificultam a leitura; dividi-las em variáveis temporárias com nomes descritivos pode ajudar. (3) Para tornar o código mais confiável, vale testar cenários simples com asserts ou pequenos casos de teste que demonstrem entradas esperadas e não esperadas. (3) A documentação oficial reforça que manter o fluxo de controle claro reduz erros e facilita manutenção (1)(4).

PEP 8
The designer of Python, Guido van Rossum, at PyCon US 2024

Desafio: escreva uma função que recebe uma nota e retorna o status: 'Aprovado' se nota >= 60, 'Aprovado com ressalvas' se nota >= 75, 'Reprovado' caso contrário. Em seguida, crie uma segunda versão usando uma expressão condicional para reduzir o número de linhas. Comente o raciocínio em 2–3 linhas.

graph TD; A[Entrada] --> B{Condição nota}; B -- >=60 --> C1[Aprovado]; B -- >=75 --> C2[Aprovado com ressalvas]; B -- <60 --> C3[Reprovado];