Nomenclatura — Funciones y lógica en Python

• Cómo nombrar funciones en Python
  • Diferencia entre funciones y variables
• Excepciones a la regla
• Importancia de buenos nombres

Cuando escribimos código, los nombres que elegimos para las funciones son muy importantes porque nos ayudan a entender lo que hace nuestro programa. En esta lección, vamos a aprender cómo nombrar funciones de manera clara y efectiva.

Cómo nombrar funciones en Python

🐍 Los nombres de las funciones se escriben usando snake_case, lo que significa que deben estar en minúsculas y, si tienen varias palabras, se separan con un guion bajo (_).

Diferencia entre funciones y variables

Para entender cómo nombrar funciones, pensemos primero en la diferencia con las variables:

• Las funciones representan acciones, por lo que sus nombres deben sonar como comandos o instrucciones.
  
• Las variables representan entidades o cosas, por lo que sus nombres deben ser sustantivos.
  

Podemos resumir esta diferencia con esta idea clave:

⏬ Ejemplo práctico

Imagina que escribimos una función que calcula el total de un pedido después de aplicar impuestos. En lugar de llamarla calculateTotalWithTax(), que es un nombre confuso, usamos calculate_total(), que describe claramente la acción:

def calculate_total(price, tax):
    """Calcula el precio total con impuestos."""
    return price + (price * tax)

order_price = 100
tax_rate = 0.19

total = calculate_total(order_price, tax_rate)  # Llamamos a la función
print(total)  # Muestra 119.0

Aquí, calculate_total() es una función porque realiza una acción, mientras que order_price, tax_rate y total son variables porque almacenan valores.

Excepciones a la regla

En algunos casos, hay funciones que no siguen la estructura de verbo, aunque siguen siendo comunes en Python, por ejemplo:

• parent_for()
  
• child_of()
  
• price_at()
  

⚠️ Estas funciones pueden actuar como descripciones de relaciones o conceptos específicos en un sistema. Aunque lo ideal es usar verbos, estos nombres pueden ser aceptables en algunos contextos.

Importancia de buenos nombres

Cuando programas, no solo necesitas hacer que el código funcione, sino también que sea comprensible para ti y otros programadores que lo leerán en el futuro.

Si el nombre de una función no describe claramente lo que hace, puede ser difícil de entender luego.

Si vuelves a leer código que escribiste hace meses, agradecerás haber elegido nombres buenos.

Materiales adicionales

1. Nomenclatura en programación
2. Programación mental