Consejos Python

Cómo escribir correctamente tus programas en Python

Espacios:

• 4 espacios por cada nivel de indentación.
• Evita los caracteres de tabulación.
• Nunca mezcles caracteres de tabulación y espacios.
• Una línea en blanco entre funciones.
• Dos líneas en blanco entre clases.
• Añade un espacio después de las comas “,” en diccionarios, listas, tuplas, y listas de parámetros, y después de los dos puntos “:” en los diccionarios, pero no antes.
• Pon espacios alrededor de las asignaciones y las comparaciones (excepto en las listas de parámetros).
• No coloques espacios justo después de abrir un paréntesis o antes de cerrar un paréntesis o justo antes de una lista de parámetros.
• No dejes espacios al inicio o final de las cadenas de documentación.

Nombres

• minusculas_con_guiones para funciones, métodos, atributos
• minusculas_con_guiones o TODO_MAYUSCULAS para las constantes
• PalabrasEnMayusculas para las clases
• camelCase sólo si es necesario adaptarse a convenciones que ya se utilizaban en el código
• Atributos: interfaz, _interno, __privado
• Pero intenta evitar la forma __privado. Yo en particular nunca la utilizo. Creeme. Si la usas, en el futuro lo lamentarás.

Líneas largas

• Mantén las líneas de código por debajo de los 80 caracteres.
• Aprovecha que las sentencias continúan en la siguiente línea de forma implícita dentro de paréntesis/llaves/corchetes:

def __init__(self, primero, segundo, tercero,
cuarto, quinto, sexto):
    salida = (primero + segundo + tercero
    + cuarto + quinto + sexto)

• Utiliza las barras invertidas como último recurso:

ParteIzquierda.muy_larga \
    = parte_derecha.incluso_mas()

Las barras invertidas no son un mecanismo robusto; tienen que situarse al final de la línea. Si añadieras un espacio después de la barra invertida, dejaría de funcionar. Además, afean el código.