Lección 4: Configuración y ejecución de Python: Estrategia de refactorización

Explicación del concepto

Esta lección trata sobre cómo limpiar código funcional sin cambiar lo que el programa realmente hace. Suena simple, pero los principiantes a menudo cometen el mismo error aquí: comienzan a refactorizar y, al mismo tiempo, cambian silenciosamente el comportamiento. Una vez que eso sucede, se vuelve difícil saber si el script está más limpio o simplemente roto de una nueva manera. Una buena refactorización mantiene el resultado igual mientras hace que el código sea más fácil de leer, más fácil de explicar y más fácil de extender más adelante. En esta lección, tomarás un script pequeño con formato repetido y lo convertirás en algo más estructurado moviendo la lógica repetida a una función auxiliar y manteniendo el punto de entrada pequeño. Al final de esta lección, podrás: • explicar qué significa refactorizar sin cambiar el comportamiento, • identificar el formato repetido o la construcción de cadenas repetida en un script pequeño, • mover esa repetición a una función auxiliar con un nombre claro. Por qué esto importa: una vez que tus archivos crecen más allá de unas pocas líneas, el código desordenado te ralentiza más que la sintaxis difícil. Aprender a limpiar el código temprano te ahorrará tiempo en cada lección después de esta.

Dónde poner el código

1. Define variables de color y posición al principio.
2. Crea la lógica de dibujo o posicionamiento de formas en el medio.
3. Renderiza la salida (impresión, canvas, SVG o bloque con estilo) al final.

Referencia de comandos

• Refactoriza una cosa pequeña a la vez, luego ejecuta el archivo de nuevo antes de tocar cualquier otra cosa.
• Cuando el mismo formato aparezca más de una vez, muévelo a una función auxiliar en lugar de reconstruirlo en múltiples lugares.
• Mantén `main()` enfocado en la orquestación: prepara valores, llama a funciones auxiliares e imprime el resultado final.
• Si la salida cambia durante una refactorización, detente y compara las versiones antigua y nueva antes de continuar.

Guía paso a paso

1. Ejecuta el script una vez y anota las dos líneas exactas que imprime.
2. Busca la parte del código que se volvería molesta de repetir si necesitaras cinco nombres más.
3. Renombra la función auxiliar y las variables para que su propósito sea obvio incluso sin comentarios.
4. Agrega un tercer nombre de ejemplo con espacios adicionales y asegúrate de que la salida siga siendo limpia y consistente.
5. Escribe una oración explicando qué se mantuvo igual después de la refactorización y qué se volvió más fácil de leer.

Ejercicios prácticos

• Toma un script corto que escribiste antes y encuentra una cadena repetida o un patrón de impresión repetido que puedas mover a una función auxiliar.
• Explica por qué `DEFAULT_NAME` es más fácil de mantener que escribir el mismo valor de respaldo en múltiples lugares.
• Cambia el formato del banner una vez y confirma que cada resultado impreso se actualiza automáticamente porque la lógica reside en un solo lugar.

Retos de código

• Agrega una segunda función auxiliar que devuelva una línea de saludo simple, luego llama a ambas funciones auxiliares desde `main()` sin hacer que el archivo sea más difícil de leer.
• Refactoriza el script para que un futuro compañero de equipo pueda cambiar el estilo del banner en un solo lugar, sin cambios en las llamadas a `print`.

Mini tareas de práctica

• Usa la función de renombrar de tu editor una vez en lugar de renombrar manualmente en todas partes.
• Ejecuta el archivo después de cada pequeño cambio en lugar de esperar hasta el final.
• Escribe una nota para ti mismo: el código limpio debe ser más fácil de entender, no solo más corto.