¿Alguna vez has intentado leer un libro sin puntos, comas ni párrafos? Cansa, ¿verdad? Lo mismo sucede con el código.

Cuando empezamos a programar en Python, nos obsesionamos con que el código “funcione”. Pero hay algo igual de importante: que el código se pueda entender. Aquí es donde entra PEP 8.

¿Qué es PEP 8 y por qué debería importarte?

PEP significa Python Enhancement Proposal. El número 8 es específicamente la propuesta que define cómo debe verse el código Python.

No es una regla que el lenguaje te imponga (tu código funcionará aunque no la sigas), pero es el estándar que siguen empresas como Google, Netflix y la propia comunidad de Python. Seguir PEP 8 te hace “hablar el mismo idioma” que otros desarrolladores.

1. Nombres de variables: El estilo snake_case

En Python, no usamos espacios ni mayúsculas locas para las variables. Usamos minúsculas y separamos las palabras con guiones bajos.

# Mal escrito
NombreUsuario = "Miguel"
nombreusuario = "Miguel"

# Estilo PEP 8 (Correcto)
nombre_usuario = "Miguel"
puntaje_maximo = 100

Tip: Los nombres de las variables deben ser descriptivos. Evita nombres como x, y o data1. Es mejor precio_dolar que simplemente p.

2. La sangría (Indentación) es sagrada

En otros lenguajes usas llaves {}, pero en Python usas espacios. PEP 8 dicta que debemos usar 4 espacios por nivel.

# Correcto
if puntaje > 10:
    print("¡Ganaste!") # 4 espacios de sangría

Tip: Configura tu editor (como VS Code) para que la tecla “Tab” inserte automáticamente 4 espacios. Nunca mezcles tabuladores con espacios; es la receta perfecta para errores imposibles de encontrar.

3. Espacios en blanco: Deja que el código respire

No amontones todo. El código necesita aire para ser legible.

# Difícil de leer
x=5+y*(z/2)

# Estilo PEP 8 (Legible)
x = 5 + y * (z / 2)

Regla rápida: Pon espacios alrededor de los operadores de asignación (=) y de comparación (==, >, <), pero no dentro de los paréntesis.

4. Longitud de línea: No escribas “testamentos”

PEP 8 recomienda que ninguna línea de código supere los 79 caracteres. ¿Por qué? Porque permite tener dos archivos abiertos uno al lado del otro en la pantalla sin tener que hacer scroll horizontal.

Si tu línea es muy larga, divídela usando paréntesis o saltos de línea naturales.

5. El orden de los imports

Los import siempre van al principio del archivo, agrupados de la siguiente manera:

  1. Librerías estándar de Python (ej: os, sys).
  2. Librerías de terceros (ej: pandas, numpy).
  3. Tus propios módulos locales.
import os
import sys

import pandas as pd

from mi_proyecto import utilidades

Conclusión: Tu checklist de legibilidad

Escribir código limpio es una muestra de respeto hacia tus compañeros y hacia tu “yo del futuro”. Antes de terminar tu próximo script, verifica:

  1. ¿Mis variables usan snake_case y son descriptivas?
  2. ¿Estoy usando 4 espacios para la indentación?
  3. ¿He dejado espacios alrededor de mis operadores?
  4. ¿Mis líneas son cortas y fáciles de leer?

Recuerda: “El código se lee mucho más a menudo de lo que se escribe”. Haz que esa lectura sea agradable.

Siguiente paso recomendado: ¿Es la programación para ti?