El Estilo del Código (PEP 8)

Fig. 3.2: El mismo código, apretado y con aire (PEP 8).

Dos programas pueden hacer exactamente lo mismo y verse completamente distintos: uno apretado y sin aire, otro ordenado y fácil de seguir. Python tiene una guía de estilo oficial, la PEP 8, para que el código de todo el mundo se parezca y cualquiera pueda leer el tuyo sin tropezar. Es como exigir que todos los almacenes etiqueten las cajas igual: nadie se pierde al entrar a uno nuevo.

No tienes que memorizarla. Son un puñado de costumbres que, una vez agarradas, ya no sueltas.

Lo que importa desde hoy

Nombres. Variables y funciones en snake_case: minúsculas con guion bajo entre palabras, como precio_final o calcular_iva. Las constantes, esas que no cambian nunca, van en mayúsculas: IVA = 0.16.

Indentación. Cuatro espacios por nivel. Ni dos, ni un tabulador. Ya lo viste: en Python la indentación no es decoración, es parte de la sintaxis.

Espacios que respiran. Deja un espacio alrededor de los operadores y después de las comas (compara los dos estilos en la Fig. 3.2):

# Apretado, cuesta leerlo
total=precio*cantidad+envio

# Con aire, se entiende de un vistazo
total = precio * cantidad + envio

Líneas en blanco. Separa tus funciones con una o dos líneas en blanco. Un bloque pegado a otro cansa la vista. El espacio agrupa ideas y le da ritmo al archivo.

Líneas cortas. Mantén cada línea por debajo de unos 80 caracteres. Una línea larguísima obliga a desplazarse de lado para leerla, y ni siquiera entra completa en una hoja impresa. Cuando una se estira demasiado, casi siempre es la señal de que conviene partirla en dos.

Por qué molestarse

Nada de esto cambia lo que hace el programa. Cambia quién puede leerlo, y qué tan rápido. Y ese “quién” casi siempre eres tú, abriendo un archivo que ya no recuerdas: el estilo es lo que hace que se relea sin esfuerzo.

Una última cosa: no te obsesiones. Tu editor puede aplicar casi todas estas reglas por ti con un atajo. Absorbe las básicas, deja que la herramienta haga el resto, y vuelve a lo importante, que es resolver el problema.

Resumen del Capítulo

• print() envía un mensaje a pantalla; el REPL (python sin archivo) ejecuta órdenes al instante, útil para probar ideas rápido.
• La indentación (4 espacios) no es decoración: define qué líneas pertenecen a qué bloque, y los dos puntos (:) anuncian dónde empieza uno.
• Python distingue mayúsculas de minúsculas: nombre, Nombre y NOMBRE son variables distintas.
• Un SyntaxError es el “formulario rechazado”: el mensaje llega en inglés y señala la línea y el motivo exactos.
• Los comentarios (#) documentan el por qué, no el qué; los docstrings ("""…""") documentan funciones, clases o módulos completos y quedan accesibles en tiempo de ejecución.
• PEP 8 estandariza el estilo: nombres en snake_case, constantes en MAYÚSCULAS, espacio alrededor de los operadores y líneas cortas, para que el código de cualquiera se lea igual.