aula006_pep8.py

"""
PEP8 - Python Enhancement Proposal
São propostas de melhoria para a linguagem Python
The Zen of Python: import this

A ideia da PEP8 é que possamos escrever códigos Python de forma Pythônica.

[1] - Utilize Camel Case para nomes de classes:
class Calculadora:
    pass
class CalculadoraCientifica:
    pass

[2] - Utilize nomes em minúsculo, separados por underline para funções ou variáveis:
def soma():
    pass
def soma_dois():
    pass
numero = 4
numero_impar = 5

[3] - Utilize 4 espaços para identação (NÃO use tab):
if 'a' in 'banana':
    print('tem')

[4] - Linhas em branco:
 - Separar funções e definições de classe com duas linhas em branco.
 - Métodos dentro de uma classe deve ser serarado com uma única linha em branco.

 [5] - Imports
 - Imports devem ser sempre feitos em linhas separadas.

# Import errado:
import sys, os

# Import certo:
import sys
import os

# Não tem problemas em utilizar:
from types import StringType, ListType

# Caso tenha muitos imports de um mesmo pacote, recomenda-se fazer assim:
from types import (
    StringType,
    ListType,
    SetType,
    OutroType
)

# imports devem ser colocados no topo do arquivo, logo depois de quaisquer comentários ou docstrings e antes de
 constantes ou variáveis globais.


[6] - Espaços em expressões e instruções
# Não faça:
funcao( algo[ 1 ], { outro: 2 } )
# Faça:
funcao(algo[1], {outro: 2})
# Não faça:
algo (1)
# Faça:
algo(1)
# Não faça:
dict ['chave'] = list [indice]
# Faça:
dict['chave'] = list[indice]
# Não faça:
x              = 1
y              = 2
variavel_longa = 3
# Faça:
x = 1
y = 2
variavel_longa = 3

[7] - Termine sempre uma instrução com uma nova linha
"""

import this