PEP 8 - Guia de estilo para código Python

Este artigo é uma tradução/adaptação da PEP 8 - Style Guide for Python Code, de Guido van Rossum e Barry Warsaw, que mostra as convenções para escrever código Python.

[ Hits: 63.210 ]

Por: Artur Gaspar em 20/04/2010


Espaços em branco



Evite espaços em branco nas seguintes situações:

Imediatamente dentro de parênteses, colchetes e chaves.

Sim: spam(ham[1], {eggs: 2})
Não: spam( ham[ 1 ], { eggs: 2 } )

Imediatamente antes de vírgula, ponto-e-vírgula e dois-pontos:

Sim: if x == 4: print x, y; x, y = y, x
Não: if x == 4 : print x , y ; x , y = y , x

Imediatamente antes do parêntese de abertura da lista de argumentos de uma função:

Sim: spam(1)
Não: spam (1)

Imediatamente antes do colchete de índices/fatias:

Sim: dict['key'] = list[index]
Não: dict ['key'] = list [index]

Mais de um espaço em volta de um operador para alinhar com os outros.

Sim:

x = 1
y = 2
long_variable = 3

Não:

x             = 1
y             = 2
long_variable = 3

Outras recomendações:
  • Sempre coloque espaços em volta de operadores
  • Não use espaços em volta do '=' quando é uma palavra-chave de um argumento ou um valor padrão para um parâmetro.

Sim:

def complex(real, imag=0.0):
    return magic(r=real, i=imag)

Não:

def complex(real, imag = 0.0):
    return magic(r = real, i = imag)

Statements em uma só linha são desencorajados.

Sim:

if foo == 'blah':
    do_blah_thing()
do_one()
do_two()
do_three()

Preferivelmente não:

if foo == 'blah': do_blah_thing()
do_one(); do_two(); do_three()

Enquanto não há problemas em usar if/for/while pequenos em uma só linha.

Preferivelmente não:

if foo == 'blah': do_blah_thing()
for x in lst: total += x
while t < 10: t = delay()

Definitivamente não:

if foo == 'blah': do_blah_thing()
else: do_non_blah_thing()
try: something()
finally: cleanup()
do_one(); do_two(); do_three(long, argument,
                             list, like, this)
if foo == 'blah': one(); two(); three()

Página anterior     Próxima página

Páginas do artigo
   1. Introdução
   2. Tamanho da linha e linhas em branco
   3. Codificação e importações
   4. Espaços em branco
   5. Comentários e docstrings
   6. Escrituração de versão e convenções de nomenclatura
   7. Recomendações de programação
   8. PEP 20 - The Zen of Python - de Tim Peters
Outros artigos deste autor

Instalando e configurando o VirtualBox

Leitura recomendada

Embutindo imagens nos scripts Python para aplicações Tkinter

Clicador automático de Tinder com Python

Port Scanner com Python

Criando Speed Test com Python

Criando um leitor de RSS com Python

  
Comentários
[1] Comentário enviado por removido em 20/04/2010 - 12:00h

Muito bom.


Contribuir com comentário




Patrocínio

Site hospedado pelo provedor RedeHost.
Linux banner

Destaques

Artigos

Dicas

Tópicos

Top 10 do mês

Scripts