O que significa para si um 'código correto'?

Para mim, um "código correto" é aquele que atende aos seguintes critérios, por ordem de prioridade:

1. Funcionalidade e correção: O código resolve a tarefa atribuída, funciona sem erros e atende aos requisitos.
2. Legibilidade e clareza: O código é fácil de entender para outros desenvolvedores (e para mim no futuro). Isso é alcançado por:
   • Nomes significativos de variáveis, funções e classes.
   • Estilo de formatação consistente (PEP 8 em Python).
   • Divisão em blocos lógicos.
   • Uso mínimo de "magia", a menos que justificado.
3. Manutenção: O código é fácil de modificar, ampliar e depurar. Isso está relacionado à legibilidade, mas também inclui:
   • Baixo acoplamento de componentes.
   • Modularidade.
   • Cobertura de testes.
4. Desempenho (se necessário): O código é eficiente em termos de uso de recursos (tempo e memória), quando isso é crítico para a tarefa. Otimizações prematuras não são incentivadas.
5. Testabilidade: O código é projetado de modo que possa ser facilmente coberto por testes automatizados.

Exemplo de código simples, mas "correto", que ilustra legibilidade e clareza:

# Função para calcular a área de um retângulo
def calculate_rectangle_area(width, height):
    # Verificação de valores não negativos, embora simplificada
    return width * height

# Uso da função
rectangle_width = 10
rectangle_height = 5
area = calculate_rectangle_area(rectangle_width, rectangle_height)
# print(f"Área do retângulo: {area}") # Para exibir

Exemplo de código menos "correto" (menos legível):

def calc(w, h): # Nomes de funções e parâmetros pouco claros
    return w * h

Resumindo, "código correto" é um equilíbrio entre funcionalidade, clareza e capacidade de evolução futura.