assert-what-the-generator-found

Has escrito algo que lee una representación y emite otra: un volcado de esquema, un extractor de referencias, una migración, un scraper, un generador de índices. Cualquier cosa cuya salida nadie lee por completo porque hay demasiada.

No aplica a una función que devuelve un único valor que puedes verificar a simple vista. El riesgo aquí es específico de una salida lo bastante grande como para que «parece correcto» sea la única revisión que jamás recibirá.

1. Antes de escribir la prueba, nombra la cantidad. ¿Cuántos comandos, filas, archivos o campos deberían salir? Obtén ese número de algún lugar distinto del generador — la fuente, la documentación, un conteo manual.
2. Verifica la cantidad, o un piso sobre ella. assert len(groups) >= 10, no assert result.
3. Verifica la presencia de elementos específicos y nombrados que sabes que deben existir. Tres o cuatro son suficientes, y elige unos de distintas formas de entrada.
4. Si el generador clasifica cosas, verifica que cada clase no esté vacía. Un clasificador que pone todo en un solo grupo es el fallo que esto detecta.

Codificar una cantidad exacta convierte la prueba en una tarea de mantenimiento: cada comando añadido legítimamente la pone en rojo. Prefiere un piso (>= 10) más elementos nombrados, y reserva las cantidades exactas para cosas que genuinamente no deberían cambiar sin una decisión.

También hay un límite. Estas verificaciones detectan un generador que descartó toda una categoría. No detectan uno que se equivoca en un solo campo de un solo elemento, y fingir lo contrario es su propio tipo de falsa confianza.