PEP 8: Style Guide for
Python Code
por quê um guia de
estilo?
Uma Consistência Tosca é o Bicho-
Papão das Pequenas Mentes
Formatação do Código
Indentação
Tabulações ou espaços
Comprimento máximo de linhas
Linhas em branco
Imports
Espaços em expressões e instruções
if x == 4 : print x , y ; >> if x == 4: print x, y;
spam( ham[ 1 ], { eggs: 2 } ) >> spam(ham[1], {eggs: 2})
spam (1) >> spam(1)
dict ['key'] = list [index] >> dict['key'] = list[index]
x = 1
y = 2
long_variable = 3
x = 1
y = 2
long_variable = 3
Comentários
Comentários que contradizem o código são piores do que
nenhum comentário
Escrevam seus comentários em inglês, a menos que você
tenha 120% de certeza de que o código jamais será lido por
pessoas que não falam sua língua
Não comente o óbvio
x = x + 1 # Increment x
x = x + 1 # Compensate for border
não faça isso ->
isso é mais útil ->
Docstrings
Escreva docstrings para todo módulo, função,
classe e método público
"""Return a foobang
Optional plotz says to frobnicate
the bizbaz first.
"""
Nomes e Identificadores
CapWords: nome de classes
nome_funcao: nome de função
__dois_underscores_no_início: atributo privado da classe
__dois_underscores_no_início_e_no_fim__: atributos ou objetos especiais
CONSTANTES:
Obrigado
http://www.python.org/dev/peps/pep-0008/
http://www.python.org.br/wiki/GuiaDeEstilo

Lighting talk PEP 8