Leccion 003 - Variables en Python: buenas practicas y convenciones de nombres

Nombrar variables bien no es decoracion. Es arquitectura de lectura. En equipos reales, un nombre bueno reduce bugs y acelera revisiones.

Regla principal

Una variable debe responder: que guarda, no como se calculo.

Mal vs bien

# Malo
x = 149.99
y = 3
z = x * y

# Bien
precio_unitario = 149.99
cantidad_productos = 3
total_compra = precio_unitario * cantidad_productos

Convenciones que usa Python (PEP 8)

• snake_case para variables y funciones: total_compra.
• Nombres descriptivos y cortos: edad_usuario.
• Evita mayusculas en variables normales.
• No uses palabras reservadas (class, for, if).

Variables que mejoran flujo de negocio

usuario_activo = True
saldo_disponible = 2500
limite_credito = 1000
puede_comprar = usuario_activo and saldo_disponible > limite_credito

print(puede_comprar)

Salida:

True

Nombres semanticos por contexto

En ecommerce:

• precio_unitario, cantidad, total.

En educacion:

• nota_final, asistencia, estado_aprobacion.

En APIs:

• status_code, payload, error_message.

Antipatrones comunes

• data, item, obj para todo.
• Reusar la misma variable para cosas distintas.
• Nombres ambiguos: valor, tmp, aux sin contexto.

Ejemplo de refactor real

def procesar(p, c, d):
    r = p * c
    return r - d

Version mantenible:

def calcular_total_con_descuento(precio_unitario, cantidad, descuento):
    subtotal = precio_unitario * cantidad
    total = subtotal - descuento
    return total

Lista de chequeo antes de cerrar un archivo

• Al leer una variable, entiendo su proposito sin adivinar.
• El nombre coincide con el tipo de dato que guarda.
• No reutilice nombres con significado distinto.
• No hay abreviaciones crpticas innecesarias.

Mini practica

Renombra estas variables con criterio profesional:

a = "ana@example.com"
b = 15
c = b * 1.22

Propuesta:

email_usuario = "ana@example.com"
precio_base = 15
precio_con_iva = precio_base * 1.22

FAQ SEO: variables en Python para principiantes

Como elegir nombres de variables en Python

Usa nombres especificos del dominio: total_pedido, fecha_entrega, email_cliente.

Importa tanto el nombre si el codigo funciona

Si. El codigo se lee mas veces de las que se escribe. Nombres claros reducen errores futuros.

Debo usar ingles o espanol en variables

Si trabajas solo, usa un idioma consistente. Si apuntas a mercado global, ingles tecnico suele facilitar colaboracion.