Temario Lección 241 de 250 · Proyecto final: publícalo (empaqueta tu proyecto)
Proyecto final: publícalo (empaqueta tu proyecto)

Escribe un banco de pruebas

Una carpeta tests/ vacía no engaña a nadie. En cuanto quien revisa ve pruebas reales, pasan dos cosas: confía más en el código, y confía más en ti, porque las pruebas demuestran que pensaste qué significa "correcto". En el repositorio real las ejecutarás con pytest (un comando, lo vemos en la próxima lección). Pero por dentro, un framework de pruebas no es magia -> es un bucle que ejecuta tu función con entradas conocidas y comprueba la salida. Construir ese bucle tú mismo, una vez, desmitifica todo el asunto.

Así que esta lección trata las pruebas como código determinista simple. Escribes un pequeño banco de pruebas:

  • run_checks(fn, cases) -> cases es una lista de pares (args_tuple, expected). Llama a fn(*args) en cada caso, compara el resultado con expected y devuelve una lista de {"args": args, "ok": bool} que registra qué casos pasaron. Si fn lanza una excepción al llamarla, ese caso es un fallo (ok=False), no un cuelgue que tumba toda la ejecución -> un ejecutor de pruebas real informa del fallo y sigue.
  • all_pass(results) -> True solo si hay al menos un resultado y todos tienen ok=True. Una lista de resultados vacía significa que en realidad no se verificó nada, así que no es un aprobado. Esta es la señal de "compilación en verde": un booleano que dice que toda la batería está bien.

Por qué importa la regla de "al menos uno": una batería de pruebas que ejecuta cero pruebas sin avisar y dice que todo va bien es peor que no tener pruebas, porque da una falsa confianza. Proteger el caso vacío es la diferencia entre un banco de pruebas que significa algo y uno que siempre dice que sí.

Ejemplo resuelto. Supón que tu proyecto expone add(a, b). Escribes los casos [((1, 2), 3), ((0, 0), 0), ((5, 5), 10)]. Un sumador correcto pasa los tres -> all_pass es True. Una versión con un fallo que resta devuelve -1, 0, 0 -> fallan dos casos, all_pass es False, y tu banco de pruebas acaba de atrapar una regresión. Ese es todo el valor de las pruebas en una frase: una función correcta y una rota te dan respuestas distintas, de forma automática.

Constrúyelo con un try/except sencillo alrededor de la llamada para que una función que lanza una excepción cuente como caso fallido. Pulsa Ejecutar para pasar un sumador correcto por el banco de pruebas y ver todos los casos en verde.

Tu turno

Construye un banco de pruebas mínimo. Escribe run_checks(fn, cases), donde cases es una lista de (args_tuple, expected): llama a fn(*args) en cada uno y devuelve una lista de {"args": args, "ok": bool} que marque qué casos coinciden con expected (una función que lanza una excepción deja ese caso en ok=False, sin colgarse). Escribe all_pass(results), que devuelva True solo cuando haya al menos un resultado y todos los ok sean True (una lista vacía es False). Una función correcta y una con un fallo deben recibir veredictos distintos.

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.