Escribir tests unitarios para código heredado antes de tocarlo

Prompt

Actúa como desarrollador sénior experto en trabajar con código heredado y en testing (técnicas de tests de caracterización y puntos de separación o «seams»).

Contexto:
- Lenguaje y framework de tests: {{lenguaje}}
- Dependencias difíciles que usa el código (base de datos, fecha actual, red, ficheros, variables globales): {{dependencias}}
- Mi objetivo después de tener tests: {{objetivo}}
- Código:
```
{{codigo}}
```

Entregables:
1. Mapa del comportamiento: entradas, salidas, efectos secundarios y ramas del código, en una lista breve.
2. Puntos de separación: dónde y cómo aislar cada dependencia con el cambio mínimo y seguro (inyección por parámetro, envolver la llamada, reloj falso), sin alterar el comportamiento.
3. Tests de caracterización que fijen el comportamiento ACTUAL, incluso si parece un error. Marca con un comentario «POSIBLE BUG» los casos sospechosos en lugar de corregirlos.
4. Casos límite: valores vacíos, nulos, extremos, errores de las dependencias.
5. Qué cobertura de ramas se consigue y qué queda sin cubrir y por qué.
6. Plan de refactor en pasos pequeños, cada uno verificable con los tests, orientado a {{objetivo}}.

Restricciones:
- No cambies la lógica del código en los tests ni en los puntos de separación.
- No inventes el resultado esperado de un caso si no puede deducirse del código: márcalo como [COMPLETAR: ejecutar y copiar la salida real] y explica cómo obtenerla.
- Usa nombres de test descriptivos (dado / cuando / entonces).
- Si falta código del que depende la función, pídemelo antes.

Formato: secciones numeradas y bloques de código listos para ejecutar.

Cómo usarlo

Ejemplo de uso

Resultado de ejemplo

<?php
use PHPUnit\Framework\TestCase;

final class CalcularDescuentoTest extends TestCase
{
    private PDO $pdo;

    protected function setUp(): void
    {
        $this->pdo = new PDO('sqlite::memory:');
        // Esquema mínimo que imita la tabla real: [COMPLETAR]
        $this->pdo->exec('CREATE TABLE pedidos (cliente_id INT, total REAL, creado_en TEXT)');
    }

    public function test_dado_cliente_sin_pedidos_cuando_total_100_entonces_resultado_actual(): void
    {
        $ahora = new DateTimeImmutable('2025-03-15 10:00:00');

        $resultado = calcularDescuento(['id' => 42], 100.0, $this->pdo, $ahora);

        $this->assertSame(0.0, $resultado); // [COMPLETAR: ejecuta y pega la salida real]
    }

    public function test_dado_total_negativo_entonces_no_lanza_excepcion(): void
    {
        // POSIBLE BUG: un total negativo no se rechaza; fijamos el comportamiento actual
        $resultado = calcularDescuento(['id' => 42], -50.0, $this->pdo, new DateTimeImmutable());
        $this->assertIsFloat($resultado);
    }
}

Datos clave

Categoría

Programación y desarrollo · Refactorización

Tipo de resultado

Código

Nivel

Intermedio

Pensado para

ChatGPT, Claude, Gemini y Microsoft Copilot

Verificado en

Pendiente de verificación editorial

Variables

Lenguaje y framework de tests, Dependencias difíciles, Objetivo posterior y Código

Idioma

Español

Precio

Gratis, sin registro

Actualizado

07/11/2026

Preguntas frecuentes