Código limpo desde o início: os hábitos do PEP 8

O que é o PEP 8 e por que ele existe

Código é lido muito mais vezes do que é escrito. Essa frase está na abertura do PEP 8, o guia de estilo que a comunidade Python segue desde 2001, escrito em parte pelo próprio criador da linguagem. PEP significa Python Enhancement Proposal, proposta de melhoria do Python; a de número 8 trata de estilo: onde pôr espaços, como nomear as coisas, que tamanho de linha evitar. Nada ali é exigência técnica. Um programa fora do padrão roda igual. O que muda é o custo de leitura, e leitura é onde o tempo de programador realmente vai.

O documento completo é extenso e cobre situações que você ainda nem conhece. Ninguém espera que um iniciante o leia de ponta a ponta, e este curso não vai fingir o contrário. Vamos recortar os quatro hábitos que fazem diferença no seu nível de hoje, com print e comentários, e que valem para todo o resto da trilha.

Os quatro hábitos que bastam por enquanto

Primeiro hábito: nomes em minúsculas. Você já pratica sem saber, escrevendo print em vez de Print. Quando criar os próprios nomes, no módulo 4, a convenção continua: tudo minúsculo, com palavras separadas por sublinhado, como nome_completo. Segundo hábito: espaço depois da vírgula, nunca antes. Igualzinho ao português escrito. Terceiro: uma instrução por linha. O Python até aceita duas instruções espremidas com ponto e vírgula, mas o guia desaconselha, e a leitura agradece. Quarto: linhas de tamanho razoável; o PEP 8 sugere o máximo de 79 caracteres, e a ideia prática é não deixar a linha fugir da tela.

# Fora do padrão (funciona, mas cansa o olho):
print("Ana","Bia" , "Caio"); print("fim")

# No padrão PEP 8:
print("Ana", "Bia", "Caio")
print("fim")

Mesmo resultado na tela. A segunda versão se lê de relance; a primeira exige decifração.

Uma nota sobre o limite de 79 caracteres: ele nasceu numa época de telas pequenas e segue útil por outra razão, a de permitir dois arquivos abertos lado a lado. Muitas equipes hoje adotam 88 ou 100. O número exato importa menos que o princípio: linha que obriga rolagem horizontal é linha que ninguém lê direito. No seu cartão de visitas da próxima aula, nenhuma linha chega perto do limite, e é assim que se começa bem.

Consistência vale mais que regra decorada

Se o PEP 8 tem centenas de recomendações e você conhece quatro, está em desvantagem? Não, e o próprio guia explica o motivo. Ele dedica uma seção inteira, com o título bem-humorado de a consistência tola é o duende das mentes pequenas, a dizer que as regras servem à legibilidade, e que julgamento vale mais que obediência cega. O pior estilo não é o que ignora uma regra: é o que muda de padrão a cada linha, ora aspas simples, ora duplas, ora espaço, ora não. O leitor gasta energia se readaptando em vez de entender o programa.

Por isso o conselho desta aula é modesto e poderoso: escolha o seu padrão dentro do que aprendeu e não desvie. Aspas duplas em todo o programa. Espaço depois de toda vírgula. Um print por linha, sempre. Quando o programa cresce, seus olhos param de conferir formato e passam a enxergar a lógica, que é onde os problemas de verdade moram. Estilo consistente é o primeiro degrau da habilidade mais valiosa do ofício: ler o próprio código com conforto.